如何在dbt-clickhouse中启用allow_nullable_key设置？

核心解决方案 #

将allow_nullable_key配置到model的settings参数中，而非直接作为顶层config参数，修改后的model配置如下：

{{
    config(
        materialized = "incremental",
        engine = "ReplicatedMergeTree",
        unique_key = "transaction_id",
        order_by = "last_mod",
        indexes=[
          {'columns': ['transaction_id'], 'type': 'btree', 'unique': True },
          {'columns': ['merchant_id'], 'type': 'btree'},
          {'columns': ['shop_id'], 'type': 'btree'},
          {'columns': ['last_mod'], 'type': 'btree'}
        ],
        settings = {
            "allow_nullable_key": 1
        }
    )
}}

为什么之前的配置不生效？ #

1. Model顶层config不支持该参数：dbt-clickhouse的model config顶层并未直接暴露allow_nullable_key参数，需要通过settings字段传递ClickHouse的表级设置。
2. Profile的custom_settings作用范围有限：profile里的custom_settings属于连接会话级设置，但ReplicatedMergeTree引擎要求allow_nullable_key需在CREATE TABLE语句中显式指定为表级参数，会话级设置无法覆盖这一要求。

额外检查项 #

• 确认transaction_id字段的定义确实为Nullable类型，若字段本身是非Nullable，该设置不会产生实际效果。
• 若使用旧版本dbt-clickhouse插件，可能存在参数传递bug，建议升级至最新稳定版。

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