DBT增量模型运行时自动添加(None)过滤条件引发BigQuery SQL报错

该异常由DBT 0.11.1旧版本的增量模型渲染逻辑导致：当增量模型未显式声明增量运行时的范围过滤条件时，DBT生成增量SQL的WHERE子句时会将未定义的过滤参数渲染为None值，直接输出到最终执行的SQL中，触发BigQuery语法错误。非增量场景、--full-refresh场景下不会触发增量逻辑渲染，因此不会出现该问题。

• 方案1（推荐：标准增量逻辑配置）
  在你的增量模型SQL代码中补充增量场景的范围过滤逻辑，示例如下：

  {{ config(materialized='incremental', alias='some_name', unique_key='替换为你的表唯一键字段名') }}
  
  select 
    字段1,
    字段2,
    替换为你的增量时间字段 -- 比如create_time、update_time等用来判断增量范围的时间字段
  from 你的源表名
  {% if is_incremental() %}
  -- 增量运行时只处理大于目标表最新时间的新数据
  where 替换为你的增量时间字段 > (select max(替换为你的增量时间字段) from {{ this }})
  {% endif %}
  

  其中{{ this }}是DBT内置变量，指代当前增量模型对应的目标表。

• 方案2（全量合并场景适用）
  如果你不需要按范围过滤增量数据，每次运行都要合并全量源数据，可以直接在增量判断块中写恒真条件，避免渲染出None：

  {% if is_incremental() %}
  where 1=1
  {% endif %}
  

• 临时排查方案
  无需修改模型代码，运行时添加--full-refresh参数即可跳过增量逻辑，直接全量重建目标表，仅适合临时验证使用，不推荐日常生产使用。

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