Skip to main content
PlanetScale for Postgres は現在、早期アクセス版です。

​
サポート対象のPostgresバージョン

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

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

  1. Postgresインスタンスでレプリケーションを有効にするには、まず以下の設定になっていることを確認する必要があります。
    これを確認するには、次のSQLコマンドを実行します。
    デフォルトでは、出力は logical になっているはずです。そうでない場合は、PlanetScaleコンソールにログインし、Cluster configuration->Parameters に移動して Write-ahead log までスクロールし、設定を変更してください。
PlanetScaleコンソールでこの設定を変更すると、再起動が発生します。
  1. また、設定 max_slot_wal_keep_size はデフォルトの4GBから増やすことを推奨します。これも PlanetScaleコンソールで Cluster configuration->Parameters に移動し、Write-ahead log までスクロールして設定します。新しい値の決め方については、こちらを参照してください。

​
権限と publication を持つユーザーの作成

デフォルトの postgres.<...> ユーザーを使用して PlanetScale Postgres インスタンスに接続し、以下のコマンドを実行します。
  1. ClickPipes 専用のユーザーを作成します:
  2. 前の手順で作成したユーザーに、スキーマレベルの読み取り専用アクセス権を付与します。以下の例は、public スキーマに対する権限を示しています。レプリケートしたいテーブルを含む各スキーマに対して、これらのコマンドを繰り返してください:
  3. ユーザーにレプリケーション権限を付与します:
  4. レプリケートしたいテーブルを含む publication を作成します。パフォーマンス上のオーバーヘッドを避けるため、publication には必要なテーブルだけを含めることを強く推奨します。
publication に含めるテーブルには、主キー が定義されているか、または replica identity が FULL に設定されている必要があります。スコープ設定のガイドについては、Postgres よくある質問 を参照してください。
  • 特定のテーブルに対する publication を作成するには:
    • 特定のスキーマ内のすべてのテーブルに対する publication を作成するには:
clickpipes publication は、変更イベントが ClickPipes にストリーミングされる対象テーブルの集合を定義します。すべてのテーブルをレプリケートする予定でない限り、FOR ALL TABLES の使用は推奨しません。不要なテーブルを含めると、Postgres から ClickPipes への WAL トラフィックが増加し、レプリケーション全体の効率が低下するためです。

​
注意事項

  1. PlanetScale Postgres に接続するには、現在のブランチを先ほど作成したユーザー名の末尾に追加する必要があります。たとえば、作成したユーザー名が clickpipes_user の場合、ClickPipe の作成時に指定する実際のユーザー名は clickpipes_user.branch である必要があります。ここで branch は、現在の PlanetScale Postgres ブランチの “id” を指します。これをすばやく確認するには、先ほどユーザー作成時に使用した postgres ユーザーのユーザー名を参照してください。ピリオド以降の部分がブランチ ID です。
  2. PlanetScale Postgres に接続する CDC パイプでは、PSBouncer ポート (現在は 6432) を使用しないでください。通常のポート 5432 を使用する必要があります。初回ロードのみのパイプでは、どちらのポートも使用できます。
  3. 接続先は必ずプライマリ インスタンスのみにしてください。現在、レプリカ インスタンスへの接続はサポートされていません。

​
次は？

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