跳到主要内容
跳到主要内容

PlanetScale for Postgres 数据源设置指南

参考资料

PlanetScale for Postgres 目前处于早期试用阶段。

支持的 Postgres 版本​

ClickPipes 支持 Postgres 12 及更高版本。

启用逻辑复制​

  1. 要在 Postgres 实例上启用复制，需要确保将以下参数设置为：

    wal_level = logical

    要检查当前设置，可以运行以下 SQL 命令：

    SHOW wal_level;

    输出默认应为 logical。如果不是，请登录 PlanetScale 控制台，进入 Cluster configuration->Parameters，向下滚动到 Write-ahead log 进行修改。

在 PlanetScale 控制台中调整 wal_level
注意

在 PlanetScale 控制台中更改此项将会触发重启。

  1. 此外，建议将 max_slot_wal_keep_size 从默认的 4GB 提高。你也可以通过 PlanetScale 控制台来完成：进入 Cluster configuration->Parameters，然后向下滚动到 Write-ahead log。如需帮助确定新的取值，请查看这里。
在 PlanetScale 控制台中调整 max_slot_wal_keep_size

创建具有权限和发布的用户​

现在为 ClickPipes 创建一个新用户，授予适用于 CDC 的必要权限， 并创建一个我们将用于复制的发布（publication）。

为此，你可以使用默认的 postgres.<...> 用户连接到你的 PlanetScale Postgres 实例，并运行以下 SQL 命令：

  CREATE USER clickpipes_user PASSWORD 'clickpipes_password';
  GRANT USAGE ON SCHEMA "public" TO clickpipes_user;
-- 根据要迁移的表,可能需要在更多架构上授予这些权限
  GRANT SELECT ON ALL TABLES IN SCHEMA "public" TO clickpipes_user;
  ALTER DEFAULT PRIVILEGES IN SCHEMA "public" GRANT SELECT ON TABLES TO clickpipes_user;

-- 为该用户授予复制权限
  ALTER USER clickpipes_user REPLICATION;

-- 创建发布。创建 ClickPipe 时将使用此发布
-- 向 ClickPipe 添加新表时,还需要手动将它们添加到该发布中。 
  CREATE PUBLICATION clickpipes_publication FOR TABLE <...>, <...>, <...>;
注意

请务必将 clickpipes_user 和 clickpipes_password 替换为您期望设置的用户名和密码。

注意事项​

  1. 要连接到 PlanetScale Postgres，需要在前面创建的用户名后追加当前分支名。例如，如果创建的用户为 clickpipes_user，则在创建 ClickPipe 时实际提供的用户名需要为 clickpipes_user.branch，其中 branch 指的是当前 PlanetScale Postgres branch 的 “id”。要快速确定这一点，可以查看你之前用于创建该用户的 postgres 用户名，句点后的部分即为 branch id。
  2. 不要为连接到 PlanetScale Postgres 的 CDC 管道使用 PSBouncer 端口（当前为 6432），必须使用常规端口 5432。对于仅用于初始加载的管道，可以使用任一端口。
  3. 请确保你只连接到主实例，目前不支持连接到副本实例。

后续步骤​

您现在可以创建 ClickPipe，并开始将 Postgres 实例中的数据摄取到 ClickHouse Cloud。 请务必记录在设置 Postgres 实例时使用的连接信息，因为在创建 ClickPipe 时将需要这些信息。