如何在Snowflake中为dbt创建自定义序列物化？含问题排查与方案咨询

问题背景 #

使用dbt对接Snowflake时，因内置物化仅支持表和视图，自定义序列物化后出现报错：

The materialization ("sequences") did not explicitly return a list of relations to add to the cache.
（中文释义：物化（"sequences"）未显式返回需添加至缓存的关系列表）

修复自定义物化代码 #

dbt的自定义物化必须返回包含relations字段的字典，用于更新dbt的关系缓存。同时优化代码以支持读取模型中的序列配置参数，最终代码如下：

{%- materialization sequences, default -%}
  {%- set target_relation = this %}

  -- 读取模型内定义的序列配置语句
  {% set sequence_config = model['raw_sql'] | trim %}

  -- 拼接完整的序列创建SQL，支持替换已有序列
  {% set sequence_creation_sql %}
    CREATE OR REPLACE SEQUENCE {{ target_relation.schema }}.{{ target_relation.identifier }}
    {{ sequence_config }}
  {% endset %}

  -- 执行序列创建/替换语句
  {% call statement('main') -%}
    {{ sequence_creation_sql }}
  {%- endcall %}

  -- 返回需纳入缓存的关系，解决报错问题
  {% do return({'relations': [target_relation]}) %}
{%- endmaterialization -%}

调整模型代码 #

模型文件只需定义序列的参数部分，序列名称由dbt模型名自动映射，无需重复编写：

{{ config(
    schema="dwh_in",
    materialized='sequences'
) }}

start with 22036057 increment by 1 noorder

替代管理方案 #

如果不想自定义物化，也可以通过以下方式管理Snowflake序列：

• 通用宏实现：编写可复用宏来封装序列创建逻辑，在需要的地方直接调用
• run-operation执行：通过dbt run-operation命令调用自定义宏，适合一次性或脚本化的序列管理操作
• 表内嵌序列：创建表时直接绑定序列（如id NUMBER DEFAULT 序列名.NEXTVAL），后续通过修改表结构调整序列参数

内容的提问来源于stack exchange，提问作者Sh'Jil