メインコンテンツへスキップ
ClickHouse Managed Postgres は、ClickHouse Cloud で提供される完全マネージド型の Postgres サービスです。ClickPipes に接続する Postgres ソースとしては最も手軽で、すべてのインスタンスで論理レプリケーションが有効になっており、ClickPipes IP アドレスもデフォルトで許可されています。また、接続情報は ClickHouse サービスと同じコンソールで確認できます。 ClickHouse Managed Postgres インスタンスからレプリケーションを開始する方法は 3 つあります。いずれの方法でも通常の Postgres ClickPipe が作成されるため、パイプが稼働を開始した後は Postgres ClickPipe のドキュメント の内容がそのまま適用されます。

オプション 1: Postgres サービスから ClickHouse へ同期する

ClickHouse Cloud コンソールで ClickHouse Managed Postgres サービスを開き、サイドバーの Sync to ClickHouse をクリックします。ウィザードではソース接続があらかじめ入力されており、宛先となる ClickHouse サービス、レプリケーション方式、レプリケーション対象のテーブルを選択できます。ユーザー、publication、ネットワークの設定は一切不要です。 手順の詳細については、Sync to ClickHouse ガイドを参照してください。低レイテンシのレプリケーションを求める場合は、ファイルシステムレベルで読み取りを行うネイティブなレプリケーションエンジンである WalShadow を選択することもできます (現在プライベートプレビュー) 。

オプション2: ClickPipes でソースとして ClickHouse Managed Postgres を選択する

宛先側から始めたい場合は、対象の ClickHouse サービスを開き、Data Sources に移動して、ソースの一覧から ClickHouse Managed Postgres を選択します。あとは、他の Postgres ソースの場合と同様に、Postgres インスタンスの接続情報を入力するだけです。

接続情報

ClickHouse Managed Postgres サービスを開き、Connect をクリックすると、ホスト、ポート、データベース、ユーザー、パスワードを確認できます。via PgBouncer のトグルは使わず、Postgres への直接接続を使用してください。ClickPipes は PgBouncer やその他の接続プーラーを経由したレプリケーションをサポートしていません。詳細は Connection を参照してください。 clickhousectl を使用する場合は、clickhousectl cloud postgres get <postgres-id> でホスト名とユーザー名を確認できます。ただし、このコマンドではパスワードは表示されません。パスワードは cloud postgres create の実行時に一度だけ表示されます。新しいパスワードを設定するには、clickhousectl cloud postgres reset-password <postgres-id> --generate を実行してください。

権限を持つユーザーの作成

デフォルトの postgres ユーザーで接続できます。本番環境では、他の Postgres ソースと同様に、専用の読み取り専用レプリケーションユーザーを使用することを推奨します。psql でインスタンスに接続し、次を実行します。
  1. ClickPipes 用の専用ユーザーを作成します:
  2. ユーザーにスキーマレベルの読み取り専用アクセスを付与します。次の例では public スキーマに対する権限を示しています。レプリケーション対象のテーブルを含むスキーマごとに、これらのコマンドを繰り返し実行してください:
  3. ユーザーにレプリケーション権限を付与します:
  4. レプリケーション対象のテーブルを含む パブリケーション を作成します。パフォーマンス上のオーバーヘッドを避けるため、パブリケーション には必要なテーブルのみを含めることを強く推奨します。
パブリケーション に含まれるテーブルには、主キー が定義されているか、または replica identity が FULL に設定されている必要があります。スコープの決め方については Postgres のよくある質問 を参照してください。
  • 特定のテーブルに対して パブリケーション を作成する場合:
  • 特定のスキーマ内のすべてのテーブルに対して パブリケーション を作成する場合:

論理レプリケーション

論理レプリケーションは、すべての ClickHouse Managed Postgres インスタンスであらかじめ有効になっています。wal_level 設定やパラメータグループを変更する必要はありません。次のコマンドで確認できます:

ネットワークアクセス

ClickHouse Managed Postgres は、デフォルトで ClickPipes からの接続を受け付けます。Postgres サービスに IP フィルタ を設定している場合は、ClickHouse サービス のリージョンに対応する ClickPipes の静的 IP アドレス を許可リストに追加してください。clickhousectl を使用する場合は、Postgres の直接接続用ポートに対してアドレスごとにルールを 1 つずつ追加し、clickhousectl cloud postgres get <postgres-id> を実行して結果を確認します。

TLS

ClickHouse Managed Postgres インスタンスは、インスタンスごとに固有で、かつ公的には信頼されていない CA によって署名された証明書を提示します。ClickPipes はデフォルトで証明書検証を有効にしているため、以下のいずれかを実施するまで接続チェックは失敗します。
  • Postgres サービスの Settings タブから CA 証明書バンドルをダウンロードし、ClickPipe の接続設定の Upload CA で指定します。こちらが推奨される方法です。バンドルの入手先については 検証済み TLS 接続 を参照してください。
  • ClickPipe の接続設定で Skip certificate verification を有効にします。接続は暗号化されたままですが、サーバーの identity は検証されません。
clickhousectl でパイプを作成する場合は、オプション 3 に示すように、バンドルを取得して --ca-certificate で渡します。

オプション 3: clickhousectl でパイプを作成する

clickhousectl を使用すると、同じパイプをコマンドラインから作成できます。まず、オプション 2 と同様の手順でユーザーと clickpipes パブリケーションを設定してください。代わりにデフォルトの postgres ユーザーを使用する場合は、--publication-name を省略してください。その場合、CLI がマッピング対象のテーブル用のパブリケーションを自動的に作成します。パイプの作成には APIキー が必要です。OAuth ログインでは読み取り専用の操作しか行えません。 ホスト名を確認してから、インスタンスの CA バンドルを保存します。
--ca-certificate で CA バンドルを指定し、宛先の ClickHouse サービスにパイプを作成します:
このパイプは ReplacingMergeTree テーブルを作成します。現在のステートを読み取るには、SELECT ... FROM events FINAL WHERE _peerdb_is_deleted = 0 を使用します。パイプが Running になるまで待機する手順やデータの検証方法を含む詳細な手順については、Postgres ClickPipe ガイドの CLI ビューを参照してください。

次のステップ

これでClickPipeを作成し、ClickHouse Managed PostgresインスタンスからClickHouse Cloudへのデータ取り込みを開始できます。ClickHouse Managed PostgresからClickHouseへのNative CDCは追加費用なしでご利用いただけます。詳細は料金をご覧ください。