配置 Wal2json

IBM Cloud® Databases for PostgreSQL 部署支持 wal2json 插件，可在部署上启用 逻辑解码。 该插件在 PostgreSQL 版本 9.6 和 10 上已被弃用，仅在 PostgreSQL 版本 11 和 12 上受支持。 该插件已经安装，但您必须配置部署和数据库才能使用它。

1. 首先，您需要 配置wal_level、max_replication_slots 和 max_wal_senders 设置。 将 wal_level 改为 logical。 max_replication_slots 和 max_wal_senders 都需要设置为大于 20 的值。Databases for PostgreSQL为当前和未来的运行目的保留 20 个复制插槽和 WAL 发送器。

   curl -X PATCH https://api.{region}.databases.cloud.ibm.com/v4/ibm/deployments/{id}/configuration
     -H 'Authorization: Bearer <>'
     -H 'Content-Type: application/json'
     -d '{"configuration": {
           "wal_level": "logical",
           "max_replication_slots": 21,
           "max_wal_senders": 21
           }
         }'
   

2. 为 repl 用户 设置密码。 可以使用 Cloud Databases CLI 插件 cdb deployment-user-password 命令或 Cloud Databases API /deployments/{id}/users/{username} 端点更改任何用户的密码。 repl 用户拥有 REPLICATION 权限，您为其设置密码后，wal2json 插件就会使用该用户。

3. 通过 Cloud Databases API 在数据库上创建复制插槽。 向 /deployments/{id}/postgresql/logical_replication_slots 端点发送 POST 请求。

   curl -X POST https://api.{region}.databases.cloud.ibm.com/v4/ibm/deployments/{id}/postgresql/logical_replication_slots   -H 'Authorization: Bearer <>'
     -H 'Content-Type: application/json'
     -d '{"logical_replication_slot": {
          "name": "<slot_name>",
          "database_name": "<database_name>",
          "plugin_type": "wal2json"
          }
        }'
   

   插件类型必须是 wal2json。 数据库必须是现有的数据库。 插槽名称只能包含小写字母、数字和下划线字符。 您可以通过连接任何数据库并运行

   SELECT * FROM pg_replication_slots WHERE slot_name = '<slot_name>';
   

4. 要测试插件，请从命令行运行 pg_recvlogical。 该命令在安装 PostgreSQL 时可用。 使用部署中的主机和端口，以及通过 API 创建的数据库和插槽名称、

   PGSSLMODE=require pg_recvlogical -d <DATABASE NAME> -U repl -h <HOST> -p <PORT>    --slot <SLOT NAME> --start -o pretty-print=1 -f -
   

5. 在 ibmclouddb 上创建一个表格，并插入一些数据。 确保在运行 pg_recvlogical 的命令行中进行插入。

   不显示创建表格。