メインコンテンツへスキップ
メインコンテンツへスキップ

RDS Postgres ソース設定ガイド

サポートされている Postgres のバージョン​

ClickPipes は Postgres バージョン 12 以降をサポートしています。

論理レプリケーションを有効にする​

お使いの RDS インスタンスですでに次の設定が行われている場合、このセクションはスキップできます。

  • rds.logical_replication = 1
  • wal_sender_timeout = 0

これらの設定は、以前に別のデータレプリケーションツールを使用していた場合、あらかじめ設定済みであることが一般的です。

postgres=> SHOW rds.logical_replication ;
 rds.logical_replication
-------------------------
 on
(1 row)

postgres=> SHOW wal_sender_timeout ;
 wal_sender_timeout
--------------------
 0
(1 row)

まだ設定していない場合は、次の手順に従ってください。

  1. 使用している Postgres のバージョン向けに、以下の設定を含む新しいパラメータグループを作成します:
    • rds.logical_replication を 1 に設定
    • wal_sender_timeout を 0 に設定
RDS で Parameter groups を確認できる場所
rds.logical_replication の設定変更
wal_sender_timeout の設定変更
  1. 新しいパラメータグループを RDS Postgres データベースに適用します
新しいパラメータグループを RDS Postgres に適用
  1. 変更を反映するために RDS インスタンスを再起動します
RDS Postgres の再起動

データベースユーザーの設定​

管理者権限を持つユーザーで RDS Postgres インスタンスに接続し、次のコマンドを実行します。

  1. ClickPipes 用の専用ユーザーを作成します：

    CREATE USER clickpipes_user PASSWORD 'some-password';

  2. スキーマの権限を付与します。次の例では、public スキーマに対する権限を示しています。レプリケーションしたい各スキーマに対して、これらのコマンドを繰り返してください：

    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;

  3. レプリケーション権限を付与します：

    GRANT rds_replication TO clickpipes_user;

  4. レプリケーション用のパブリケーションを作成します：

    CREATE PUBLICATION clickpipes_publication FOR ALL TABLES;

ネットワークアクセスを設定する​

IP ベースのアクセス制御​

RDS インスタンスへのトラフィックを制限する場合は、ドキュメントで定義されている固定 NAT IP アドレス を、RDS セキュリティグループの Inbound rules に追加してください。

RDS Postgres でセキュリティグループを確認できる場所
上記のセキュリティグループのインバウンドルールを編集する

RDS インスタンスへプライベートネットワーク経由で接続するには、AWS PrivateLink を使用できます。接続を設定するには、ClickPipes 向け AWS PrivateLink セットアップガイド に従ってください。

RDS Proxy の回避策​

RDS Proxy はロジカルレプリケーション接続をサポートしていません。RDS の IP アドレスが動的で、DNS 名や Lambda 関数を利用できない場合は、次のような代替策があります。

  1. cron ジョブを使用して、RDS エンドポイントの IP を定期的に名前解決し、変更されている場合は NLB を更新する。
  2. EventBridge/SNS と連携した RDS Event Notifications を使用する。AWS RDS のイベント通知を使って更新を自動的にトリガーする。
  3. 固定の EC2 インスタンス: ポーリングサービスまたは IP ベースのプロキシとして動作する EC2 インスタンスをデプロイする。
  4. Terraform や CloudFormation などのツールを使用して、IP アドレス管理を自動化する。

次のステップ​

これで、ClickPipe を作成し、Postgres インスタンスから ClickHouse Cloud へデータの取り込みを開始できます。 ClickPipe を作成する際に必要になるため、Postgres インスタンスをセットアップしたときに使用した接続情報は必ず控えておいてください。