メインコンテンツへスキップ
このドキュメントでは、Postgres ClickPipeの各フェーズ、取り得るステータスの種類、それぞれの意味について説明します。

プロビジョニング

Create ClickPipe ボタンをクリックすると、ClickPipe は Provisioning 状態で作成されます。プロビジョニングでは、サービスの ClickPipes を実行するための基盤となるインフラストラクチャを立ち上げるとともに、そのパイプの初期メタデータをいくつか登録します。サービス内では ClickPipes のコンピュートが共有されるため、2 つ目の ClickPipe は 1 つ目よりもはるかに速く作成されます。これは、インフラストラクチャがすでに整っているためです。

セットアップ

パイプがプロビジョニングされると、Setup 状態に入ります。この状態では、宛先の ClickHouse テーブルを作成します。また、ここではソーステーブルのテーブル定義を取得して記録します。

スナップショット

セットアップが完了すると、Snapshot 状態に入ります (CDC のみのパイプは Running に移行します) 。SnapshotInitial SnapshotInitial Load (こちらのほうが一般的です) は、同じ意味で使われます。この状態では、ソースデータベースのテーブルのスナップショットを取得し、ClickHouse にロードします。この処理では論理レプリケーションは使用しませんが、この段階でレプリケーションスロットが作成されるため、max_slot_wal_keep_size とストレージ関連のパラメータは、初期ロード中のスロットの増加を見込んで設定する必要があります。初期ロードの詳細については、並列初期ロードのドキュメントを参照してください。再同期がトリガーされた場合や、既存のパイプに新しいテーブルが追加された場合にも、パイプは Snapshot 状態に入ります。

実行中

初期ロードが完了すると、パイプは Running 状態になります (スナップショット専用のパイプの場合は Completed に遷移します) 。ここでパイプは Change-Data Capture (CDC) を開始します。この状態では、ソースデータベースから ClickHouse への論理レプリケーションが開始されます。CDC の制御方法については、CDC の制御に関するドキュメントを参照してください。

一時停止

パイプがRunning状態になると、一時停止できるようになります。これにより CDC プロセスが停止し、パイプはPaused状態に入ります。この状態では、ソースデータベースから新しいデータは取り込まれませんが、ClickHouse 内の既存データはそのまま保持されます。この状態からパイプを再開できます。

一時停止

この状態は近日中に利用可能になる予定です。OpenAPI を使用している場合は、リリース後もインテグレーションが引き続き動作するよう、今のうちにこの状態への対応を追加しておくことをご検討ください。
Pause ボタンをクリックすると、パイプは Pausing 状態になります。これは一時的な状態で、CDC プロセスの停止処理が進行中であることを示します。CDC プロセスが完全に停止すると、パイプは Paused 状態になります。

変更中

この状態は近日公開予定です。OpenAPI を使用している場合は、リリース後もインテグレーションが引き続き動作するよう、今のうちにこの状態への対応を追加しておくことを検討してください。
現時点では、これはパイプがテーブルの削除処理中であることを示します。

再同期

この状態は近日中に追加される予定です。OpenAPI を使用している場合は、リリース後もインテグレーションが継続して動作するよう、今のうちにこの状態への対応を追加しておくことを検討してください。
この状態は、パイプが再同期のフェーズにあり、元のテーブルと _resync テーブルをアトミックに入れ替えていることを示します。再同期の詳細については、再同期のドキュメント を参照してください。

完了

この状態はスナップショット専用のパイプに適用され、スナップショットが完了し、これ以上行うべき作業がないことを示します。

失敗

パイプで回復不能なエラーが発生すると、Failed 状態に移行します。この状態から復旧するには、サポートに問い合わせるか、パイプを再同期してください。
最終更新日 2026年6月10日