为什么首次运行dbt run正常，第二次执行就触发编译报错

你收到的完整报错如下：

Compilation Error in model database.schema.model_name
 When searching for a relation, dbt found an approximate match. Instead of guessing 
  which relation to use, dbt will move on. Please delete database.schema.model_name, or rename it to be less ambiguous.

核心原因 #

该报错本质是dbt在扫描目标库的schema时，识别到了2个及以上和你的模型名称近似的relation（表/视图等对象），无法确定要操作哪个对象，因此终止运行，和默认的先删后建逻辑不冲突，具体触发场景分为以下几类：

• 同名不同大小写的对象共存：dbt默认对对象名大小写不敏感，如果你首次运行创建了model_name表，后续有其他操作（手动建表、其他任务运行）在同schema下创建了MODEL_NAME或Model_Name的表/视图，dbt扫描时会识别为近似匹配的两个对象，无法判断要删除重建哪一个，就会抛出该错误。
• 同名不同类型的对象共存：如果你之前将该模型配置为view类型运行过，生成了同名视图，后续改回table类型后没有删除旧的视图，同schema下就会同时存在同名的表和视图，dbt匹配时会判定为近似冲突。
• dbt本地缓存残留旧对象信息：如果之前运行生成的target目录中残留了旧的对象元数据缓存，即便你已经手动删除了重复对象，dbt仍可能读取缓存中的旧信息识别出不存在的近似对象，触发报错。
• 名称近似的不同对象共存：如果你的项目开启了模糊匹配relation的配置，同schema下有名称高度相似的对象（比如user_order和user_orders），也会被dbt判定为近似匹配触发冲突。

解决方案 #

• 先查询目标schema下的重复对象，执行SQL：select table_name, table_type from information_schema.tables where table_schema = '<你的schema名>' and lower(table_name) = '<你的模型名小写>'，找到所有匹配对象后删除不需要的即可。
• 清理本地缓存：删除项目根目录下的target文件夹后重新运行。
• 如果是名称近似导致的冲突，可以在模型的配置块中新增alias参数指定唯一的别名，避免名称重复。
• 单次重建可以执行命令：dbt run --full-refresh --select <你的模型名>，强制dbt跳过部分缓存检查重建对象。

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