MaterializedPostgreSQL

Experimental feature. Learn more.

Not supported in ClickHouse Cloud

备注

建议 ClickHouse Cloud 用户使用 ClickPipes 将数据从 PostgreSQL 复制到 ClickHouse。这本地支持 PostgreSQL 的高性能变更数据捕获（CDC）。

创建 ClickHouse 表，并以 PostgreSQL 表的初始数据转储开始复制过程，即它在后台执行一个作业，以应用在远程 PostgreSQL 数据库中 PostgreSQL 表上发生的新更改。

备注

此表引擎是实验性的。要使用它，请在您的配置文件中将 allow_experimental_materialized_postgresql_table 设置为 1，或使用 SET 命令：

如果需要多个表，强烈建议使用 MaterializedPostgreSQL 数据库引擎，而不是表引擎，并使用 materialized_postgresql_tables_list 设置，该设置指定要复制的表（也将可以添加数据库 schema）。在 CPU 使用、连接数量和远程 PostgreSQL 数据库中的复制槽数量方面，这种方法效果会更好。

创建表

引擎参数

• host:port — PostgreSQL 服务器地址。
• database — 远程数据库名称。
• table — 远程表名称。
• user — PostgreSQL 用户。
• password — 用户密码。

要求

1. PostgreSQL 配置文件中的 wal_level 设置必须设为 logical，并且 max_replication_slots 参数的值必须至少为 2。

2. MaterializedPostgreSQL 引擎的表必须有主键 —— 与 PostgreSQL 表的副本标识索引相同（默认情况下为：主键）（请参阅 副本标识索引的详细信息）。

3. 仅允许数据库 Atomic。

4. MaterializedPostgreSQL 表引擎仅适用于 PostgreSQL 版本 >= 11，因为该实现需要 pg_replication_slot_advance PostgreSQL 函数。

虚拟列

• _version — 事务计数器。类型：UInt64。

• _sign — 删除标记。类型：Int8。可能的值：

  • 1 — 行未被删除，
  • -1 — 行已被删除。

在创建表时不需要添加这些列。它们在 SELECT 查询中始终可以访问。 _version 列等于 WAL 中的 LSN 位置，因此可以用来检查复制的最新状态。

备注

不支持 TOAST 值的复制。将使用数据类型的默认值。