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

サポート対象バージョン

ClickPipes を使用して AlloyDB インスタンスから ClickHouse Cloud にデータを連携するには、インスタンスで論理レプリケーションが設定されている必要があります。これは AlloyDB Version 14 以降でサポートされています。

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

AlloyDB インスタンスで論理レプリケーションが有効になっているかを確認するには、プライマリインスタンスに対して次のクエリを実行します。
結果が logical の場合は、論理レプリケーションはすでに有効になっているため、次の手順に進んでください。結果が replica の場合は、プライマリ インスタンスで alloydb.enable_pglogical フラグと alloydb.logical_decoding フラグを on に設定する必要があります。
AlloyDB flags documentation にあるとおり、論理レプリケーションを有効にするフラグの変更には、プライマリ インスタンスの再起動が必要です。
これらのフラグを有効にするには、次の手順を実行します。
  1. Google Cloud Console で AlloyDB の Clusters ページに移動します。プライマリ インスタンスの Actions メニューから Edit をクリックします。
    プライマリ インスタンスの構成を編集
  2. 下にスクロールして Advanced configuration options セクションを展開します。Flags で Add a database flag をクリックします。
    allowdb.enable_pglogical フラグと alloydb.logical_decoding フラグを on に設定
  3. Update instance をクリックして構成変更を保存します。この操作により、プライマリ インスタンスが再起動される点に注意してください。
  4. インスタンスのステータスが Updating から Ready に変わったら、次のクエリをプライマリ インスタンスに対して実行し、論理レプリケーションが有効になっていることを確認します。
    結果は logical になるはずです。
    論理レプリケーションが有効になっていることを確認

ClickPipes ユーザーを作成し、レプリケーション権限を管理する

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

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

次に、ClickPipes が AlloyDB インスタンスに接続する方法を選択します。
GCP でホストされている ClickHouse Cloud サービスからプライベート接続するには、GCP Private Service Connect ガイドに従って、AlloyDB インスタンス用のリバース プライベート エンドポイントを設定します。

次のステップ

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