如何使用SQLFluff对dbt宏执行Lint代码检查？

问题原因解析 #

1. 当配置templater = dbt时，SQLFluff默认会跳过宏文件——它将dbt宏视为工具类文件，不纳入Lint范围，因此你会收到Skipped file /macros/mymacros.sql because it is a macro的警告。
2. 切换到templater = jinja并加载宏路径后，无法检查宏内SQL函数大小写，是因为jinja模板器的处理逻辑针对渲染后的完整SQL，对宏内部的原生SQL片段解析支持不足，导致规则无法生效。
3. 有人将macros/加入.sqlfluffignore，是因为早期SQLFluff对dbt宏的Lint支持不完善，处理宏文件会产生大量无效报错，用户选择忽略；但新版本SQLFluff已支持对宏的Lint检查，无需再忽略。

解决方案 #

要对dbt宏执行Lint检查并强制函数名大写，按以下步骤配置：

1. 修改.sqlfluff配置文件，使用dbt模板器并关闭宏跳过机制：

[sqlfluff]
templater = dbt
# 启用函数/关键词大小写规则（L010）
rules = L010

[sqlfluff:templater:dbt]
# 设置为False，让SQLFluff不跳过宏文件
skip_macros = False

[sqlfluff:rule:L010]
# 指定大写规则
capitalisation_policy = upper

2. 执行Lint命令：

sqlfluff lint macros/mymacros.sql

此时SQLFluff会检测到宏内的to_varchar，提示你将其改为大写的TO_VARCHAR。

3. 自动修复（可选）：如果需要自动将函数名转为大写，运行：

sqlfluff fix macros/mymacros.sql

注意事项 #

• 确保使用较新版本的SQLFluff（推荐v2.0+），旧版本对dbt宏的Lint支持有限。
• 根据你使用的数据库（如Snowflake、BigQuery等），可能需要调整对应规则配置，确保L010规则适配数据库语法。

内容的提问来源于stack exchange，提问作者dominikkoller