Airbyte同步Postgres至Clickhouse后目标表缺失问题求助

问题描述 #

我使用Airbyte将部分表从Postgres数据库同步至Clickhouse数据库，Airbyte显示同步成功且目标库已创建对应表，但查询Clickhouse时提示表不存在：

DB::Exception: Table public.contracts_shop doesn't exist. (UNKNOWN_TABLE) (version 23.4.2.11 (official build))

不过能正常查看并查询Airbyte创建的原始表（如_airbyte_raw_contracts_shop）。已知Clickhouse默认目标库为default，已确认将数据发送至public库。

排查与解决步骤 #

• 检查Airbyte归一化配置
  Airbyte同步时，原始表_airbyte_raw_*是同步的基础输出，最终结构化表（如contracts_shop）依赖归一化（Normalization）步骤生成：

  • 进入对应同步任务，查看"Normalization"设置是否开启。若为"Disabled"，Airbyte只会生成原始表，不会创建最终结构化表，开启后重新同步即可。
  • 若已开启归一化，查看归一化阶段的日志，排查是否因数据类型不兼容、字段冲突等导致表生成失败。

• 验证Clickhouse表的实际存在性
  直接在Clickhouse客户端执行命令确认public库下的表列表：

  SHOW TABLES IN public;
  

  • 如果结果中没有contracts_shop，说明归一化未生成该表，需回到Airbyte配置排查；
  • 如果结果中有该表，检查查询语法：Clickhouse中带库名的表引用需注意引号规则，正确写法为：

    SELECT * FROM `public`.`contracts_shop`;
    

    或先切换库再查询：

    USE public;
    SELECT * FROM contracts_shop;
    

• 核对Airbyte目标端配置细节

  • 确认Clickhouse目标连接器的"Default Schema"是否设置为public，避免归一化时将表误生成到default库；
  • 检查"Table Prefix"是否有额外配置，若设置了前缀，最终表名会是前缀_contracts_shop，需对应调整查询语句。

• 检查Clickhouse用户权限
  确认当前连接用户是否拥有public库的查询权限：

  SHOW GRANTS FOR currentUser();
  

  若缺少权限，执行授权命令：

  GRANT SELECT ON public.* TO your_user_name;
  

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