2026Technology-Competition/data/demo-sqlfluff/reports/07_structure-review.md

代码审查报告

文件: data\demo-sqlfluff\src\07_structure.sql 语言: sql 耗时: 226.0s 分析工具: sqlfluff

---

总计: 30 | 错误: 29 | 警告: 1 | 建议: 0

静态分析 · 28 个问题

• 🔴 sqlfluff:LT05 L1 L1: 行过长（97 > 80）。 建议: 将该行注释拆分为多行或精简文字，使长度不超过 80 个字符。
• 🔴 sqlfluff:ST01 L3 L3: 不要在 CASE WHEN 语句中指定 'ELSE NULL'（冗余）。 建议: 删除 ELSE NULL 分支；当条件不满足时 CASE 会自然返回 NULL。
• 🔴 sqlfluff:ST02 L13 L13: 不必要的 CASE 语句，建议改用 COALESCE 函数。 建议: 改为 COALESCE(amount > 0, FALSE) AS positive，效果与当前 CASE 一致。
• 🔴 sqlfluff:ST03 L20 L20: 查询定义了 CTE "unused_cte" 但未使用。 建议: 删除未使用的 CTE WITH unused_cte AS (...)，直接从 SELECT 开始查询。
• 🔴 sqlfluff:LT08 L23 L23: CTE 结束括号之后应有空行，但未找到。 建议: 在 CTE 的闭合括号 ) 与后续 SELECT 之间插入一个空行。
• 🔴 sqlfluff:ST04 L32 L32: ELSE 子句中的嵌套 CASE 语句可以展平。 建议: 合并为一个 CASE：CASE WHEN a = 1 THEN b WHEN c = 1 THEN d END AS result。
• 🔴 sqlfluff:RF04 L35 L35: 不应将关键字用作标识符。 建议: 将别名 result 改为非关键字名称，例如 result_value。
• 🔴 sqlfluff:AL08 L42 L42: 列别名 'id' 与第 41 行的列名重复。 建议: 为 sub.id 指定唯一别名，例如 AS sub_id，避免结果集列名冲突。
• 🔴 sqlfluff:AM05 L45 L45: JOIN 子句应使用全限定名。 建议: 明确使用 INNER JOIN，并确保 ON 条件中的列均带表别名限定。
• 🔴 sqlfluff:ST05 L46 L46: select_statement 子句中不应包含子查询，应改用 CTE。 建议: 将 JOIN 中的派生表提取为 CTE：WITH sub AS (SELECT id FROM other_table) SELECT ... JOIN sub ON ...。
• 🔴 sqlfluff:LT02 L46 L46: 应在 'ON' 前换行，且 'ON' 前不应有缩进。 建议: 将 ON 子句放到新行，放在与 JOIN 同一层级：(SELECT ...) AS sub ON a.id = sub.id;
• 🔴 sqlfluff:ST06 L49 L49: SELECT 中应先写通配符和简单目标，再写计算与聚合。 建议: 将 * 移到最前，再写普通列，最后写 SUM(amount)，并给聚合结果命名。注意当前查询还缺少 GROUP BY 或窗口函数。
• 🔴 sqlfluff:AL03 L50 L50: 列表达式没有别名，请使用显式 AS 子句。 建议: 为 SUM(amount) 添加别名：SUM(amount) AS total_amount。
• 🔴 sqlfluff:AM05 L62 L62: JOIN 子句应使用全限定名。 建议: 将 USING (id) 改写为带表别名限定的 ON 条件，并可加上 INNER。
• 🔴 sqlfluff:LT02 L63 L63: 应在 'USING' 前换行，且不应缩进。 建议: 将 USING (id) 移到新行（若改写为 ON 也保持换行）。
• 🔴 sqlfluff:ST07 L63 L63: 发现 USING 语句，应只使用 ON 语句。 建议: 将 USING (id) 改写为 ON a.id = b.id。
• 🔴 sqlfluff:LT10 L66 L66: 'SELECT' 修饰符（如 'DISTINCT'）必须与 'SELECT' 在同一行。 建议: 将 DISTINCT 移到 SELECT 同一行：SELECT DISTINCT id。
• 🔴 sqlfluff:LT02 L67 L67: 该行不应缩进。 建议: 将 DISTINCT 移到 SELECT 同一行，消除缩进。
• 🔴 sqlfluff:LT01 L67 L67: 'DISTINCT' 关键字与左括号 '(' 之间应有单个空格。 建议: 不要使用函数式写法；最好是去掉括号写成 DISTINCT id。
• 🔴 sqlfluff:ST08 L67 L67: 'DISTINCT' 不能与括号一起使用。 建议: 去掉括号：SELECT DISTINCT id。
• 🔴 sqlfluff:AM05 L77 L77: JOIN 子句应使用全限定名。 建议: 明确写出 INNER JOIN，并保持 ON 条件使用表别名限定。
• 🔴 sqlfluff:LT02 L78 L78: 应在 'ON' 前换行，且不应缩进。 建议: 将 ON 子句放到新行：other_table AS b ON b.id = a.id;
• 🔴 sqlfluff:ST09 L78 L78: JOIN 条件应把先出现的表放在前面。 建议: 将 ON b.id = a.id 调整为 ON a.id = b.id。
• 🔴 sqlfluff:ST10 L86 L86: 冗余常量表达式。 建议: 删除 WHERE 子句，或改为 WHERE TRUE；如果动态生成条件，请不要保留恒真条件。
• 🔴 sqlfluff:ST11 L94 L94: JOIN 表 'other_table AS b' 未在查询其他位置引用。 建议: 若确实不需要该表，删除整个 LEFT JOIN；若只想判断存在性，请改用 EXISTS 子查询。
• 🔴 sqlfluff:LT02 L94 L94: 应在 'ON' 前换行，且不应缩进。 建议: 将 ON 子句放到新行：other_table AS b ON a.id = b.id;
• 🔴 sqlfluff:ST12 L100 L100: 检测到连续分号（计数 2）。 建议: 删除多余的分号，只保留一个 ;。
• 🔴 sqlfluff:LT12 L101 L101: 文件必须以单个尾随换行符结束。 建议: 确保文件末尾恰好有一个换行符，不要多出空行或缺少换行。

AI 审查 · 2 条建议

• 🔴 [AI] [bug] aggregate-without-group-by L49 聚合函数与未分组列/通配符混用 第49行的 SELECT 将 SUM(amount) 与 id、* 放在同一个 SELECT 列表中，但没有 GROUP BY，也没有把 SUM 改为窗口函数。在大多数 SQL 引擎中这是非法查询；即使某些引擎允许，也会随机返回非聚合列的任意行，结果不可预测。 建议: 如果希望保留每一行并附带总额，使用窗口函数 SUM(amount) OVER () AS total_amount；如果希望做聚合，则需要列出所有非聚合列并加 GROUP BY，或显式只保留聚合结果。
• 🟡 [AI] [bug] unused-left-join-cardinality L94 未使用的 LEFT JOIN 可能使结果行数倍增 第93-94行的 LEFT JOIN 虽然未在 SELECT 或 WHERE 中引用 other_table AS b，但 SQL 仍会执行关联；若 other_table.id 有重复值，每条匹配都会复制左表行，导致结果集意外膨胀。静态规则只报告了表未被引用，但没有强调行数变化风险。 建议: 完全移除该 LEFT JOIN；若需要检查是否存在匹配，使用 WHERE EXISTS (SELECT 1 FROM other_table b WHERE b.id = a.id)。