使用dbt_utils.generate_surrogate_key时如何修复“行过长”Linter错误？

方案1：用indent宏配合字段列表换行 #

无需修改原生宏，调用时给字段列表手动换行，并通过indent宏添加缩进，编译后会自动生成带换行的SQL：

{{ dbt_utils.generate_surrogate_key([
    indent(1, "'user_id'"),
    indent(1, "'order_id'"),
    indent(1, "'created_at'")
]) }}

方案2：调整sqlfluff配置 #

直接修改.sqlfluff配置文件，绕过行过长检查：

• 提高行长度阈值：在[sqlfluff]段修改max_line_length = 150（根据需求调整数值）
• 忽略行过长规则：在[sqlfluff:rules:L016]段添加exclude_rules: L016，或针对特定模型文件设置例外

方案3：自定义封装宏（推荐） #

基于原宏封装自动处理换行的版本，避免重复编写缩进逻辑：

{% macro generate_surrogate_key_with_newline(fields) %}
    {{ dbt_utils.generate_surrogate_key(fields | map('indent', 1) | list) }}
{% endmacro %}

调用时直接传入字段列表即可：

{{ generate_surrogate_key_with_newline(['user_id', 'order_id', 'created_at']) }}

方案4：使用format_sql宏（适配器依赖） #

部分dbt适配器（如Snowflake、BigQuery）支持format_sql宏，可自动格式化生成的SQL：

{{ format_sql(dbt_utils.generate_surrogate_key(['user_id', 'order_id', 'created_at'])) }}

注意：该方法仅适配支持此宏的数据库。

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