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 を実行しているコマンドラインで行われることを確認してください。

   テーブルの作成が表示されない。