サポート対象のプロバイダー (サイドバーに表示) のいずれかを使用している場合は、そのプロバイダー向けの個別ガイドを参照してください。
-
Postgres インスタンスでレプリケーションを有効にするには、まず以下の設定になっていることを確認してください。
確認するには、次の SQL コマンドを実行します。出力は
logicalである必要があります。そうでない場合は、次を実行します。 -
また、Postgres インスタンスでは以下の設定にしておくことを推奨します。
確認するには、次の SQL コマンドを実行します。値が推奨値を満たしていない場合は、次の SQL コマンドを実行して設定できます。
- 上記の設定を変更した場合、変更を反映するには Postgres インスタンスを再起動する必要があります。
-
ClickPipes 専用のユーザーを作成します。
-
前の手順で作成したユーザーに、スキーマレベルの読み取り専用アクセスを付与します。次の例は
publicスキーマに対する権限を示しています。レプリケートしたいテーブルを含む各スキーマに対して、これらのコマンドを繰り返してください。 -
ユーザーにレプリケーション権限を付与します。
- レプリケートしたいテーブルを含む パブリケーション を作成します。パフォーマンスのオーバーヘッドを避けるため、パブリケーション には必要なテーブルのみを含めることを強く推奨します。
-
特定のテーブルに対する パブリケーション を作成するには:
-
特定のスキーマ内のすべてのテーブルに対する パブリケーション を作成するには:
-
特定のスキーマ内のすべてのテーブルに対する パブリケーション を作成するには:
clickpipes パブリケーション は、変更イベントが ClickPipes にストリーミングされるテーブルの集合を定義します。すべてのテーブルをレプリケートする場合を除き、FOR ALL TABLES の使用は推奨しません。不要なテーブルを含めると、Postgres から ClickPipes への WAL トラフィックが増加し、レプリケーション全体の効率が低下するためです。
セルフホスト環境では、以下の手順に従って、ClickPipes の IP アドレスから ClickPipes ユーザーへの接続を許可する必要があります。マネージドサービスを使用している場合も、プロバイダーのドキュメントに従って同様に設定できます。
-
pg_hba.confファイルに必要な変更を加え、ClickPipes の IP アドレスから ClickPipes ユーザーへの接続を許可します。pg_hba.confファイルのエントリ例は次のとおりです。 -
変更を反映するには、PostgreSQL インスタンスをリロードします。
postgresql.conf ファイルを更新して、PostgreSQL インスタンスの max_slot_wal_keep_size パラメータをより大きな値 (少なくとも 100GB または 102400) に引き上げることができます。
この値のより適切な推奨値については、ClickPipes チームにお問い合わせください。