diff --git a/docs/sql/SYS_DOC_INDEX.sql b/docs/sql/SYS_DOC_INDEX.sql new file mode 100644 index 0000000..9842e5e --- /dev/null +++ b/docs/sql/SYS_DOC_INDEX.sql @@ -0,0 +1,34 @@ +-- ============================================================================ +-- 性能索引脚本:SYS_DOC 附件按业务实体检索(WS-D I1) +-- ---------------------------------------------------------------------------- +-- 归属:platform-metadata(GET /api/file/list,附件查看态只读下载列表)。 +-- 背景:sys_doc 33.8 万行,原仅 PK 索引(sys_doc_id)。/api/file/list 按 +-- tablename + businesskey 列附件,amis service 容器每次附件页渲染都打本端点。 +-- 原查询 WHERE UPPER(tablename)=? AND TRIM(businesskey)=? AND isactive=1 —— 列被 +-- 函数包裹(非 sargable)→ Parallel Seq Scan 全表 33.8 万行(EXPLAIN cost ~18572)。 +-- +-- 修: +-- 1) tablename 列本就全大写(DB 实测:sys_doc.tablename<>upper(tablename) 计数 0), +-- app 侧已 tableName.trim().toUpperCase(),查询去 UPPER 改 tablename = ?(sargable)。 +-- 2) businesskey 列 varchar(100) 存 CHAR(36) 补白遗留:DB 实测 13000 行为 +-- 「32 位 UUID(去横线)+ 4 空格 padding 至 36」。不能简单 businesskey = trimmed +-- (会漏这 13000 行)→ 保留 trim 语义,查询用 rtrim(businesskey) = ?,并配 +-- 函数式索引(索引 key 同为 rtrim(businesskey))使其 sargable。 +-- 3) 部分索引(WHERE isactive=1)与 list 查询条件一致,索引更小更贴。 +-- +-- 验证(eip4dev 实测,2026-06-14): +-- EXPLAIN 走 Index Scan using ix_sys_doc_biz,cost 18572 → 8.44, +-- actual Execution Time 0.038 ms(补白键 OA_NOTICEMANAGE + 横线键 OA_NEWSMANAGE 均命中)。 +-- +-- 【Flyway 待办(P5)】同 SYS_PAGE_SCHEMA.sql:本工程当前未引入 Flyway,本脚本即 +-- 「生产建表/建索引脚本」。客户库排切流窗口执行(CREATE INDEX 默认持表锁;若需在线 +-- 无锁建索引可改 CREATE INDEX CONCURRENTLY,但不能在事务/Flyway 事务内执行)。 +-- P5 引入 Flyway 时原样改名 V{n}__create_ix_sys_doc_biz.sql 纳入 db/migration 即可。 +-- ============================================================================ + +CREATE INDEX IF NOT EXISTS ix_sys_doc_biz + ON eip3.sys_doc (tablename, rtrim(businesskey)) + WHERE isactive = 1; + +COMMENT ON INDEX eip3.ix_sys_doc_biz IS + 'WS-D I1:/api/file/list 按 tablename + rtrim(businesskey) 检索附件的 sargable 函数式部分索引(isactive=1)'; diff --git a/platform-converter/src/main/java/com/eip4/platform/converter/TemplateToAmisConverter.java b/platform-converter/src/main/java/com/eip4/platform/converter/TemplateToAmisConverter.java index e1862ac..2045a84 100644 --- a/platform-converter/src/main/java/com/eip4/platform/converter/TemplateToAmisConverter.java +++ b/platform-converter/src/main/java/com/eip4/platform/converter/TemplateToAmisConverter.java @@ -1026,6 +1026,9 @@ public class TemplateToAmisConverter { service.put("type", "service"); // 业务键绑表单主键;空主键(新增态)时 list 端点返空,不误列 service.put("api", "get:/api/file/list?tableName=" + upperTable + "&businessKey=${" + pkCol + "}"); + // M4:service.name 与内层 input-file 同名(皆 DOCUMENT)。service.name 仅作布局归位 key + // (供