infra-postgres

clickhousectl を使った Postgres

clickhousectl は、次の 2 つの環境で Postgres を管理します。

• ローカル — 開発用の、ユーザーのマシン上で Docker を使用する名前付き Postgres インスタンスです。
• クラウド — 本番環境向けの、ClickHouse Cloud のマネージド Postgres サービス（ベータ版）です。HA、読み取りレプリカ、ポイントインタイムリストアに対応しています。

このファイルでは、適切なリファレンスを案内します。手順を追ったワークフローは ref/local.md、ref/cloud.md、ref/migrate.md にあります。コマンドを実行する前に、ユーザーの状況に合ったものをお読みください。

参照先の選び方

ユーザーの目的	読むファイル
ローカルで開発またはプロトタイプを作成する、Postgres を使ってテスト／CI を実行する（クラウドアカウントは不要）	ref/local.md
本番環境に移行する、マネージド Postgres をホストする、または ClickHouse Cloud を明示的に使用する	ref/cloud.md
既存のクラウドサービスを運用する（パスワード、TLS、設定、レプリカ、フェイルオーバー、リストア）	ref/cloud.md
既存の Postgres（Neon、Supabase、RDS など）を ClickHouse Cloud Postgres に移行する	ref/migrate.md
今すぐローカルで開発し、後から本番環境にデプロイする	ref/local.md から始めてください。本番環境に移行する段階になったら、ref/cloud.md を参照できます

「アプリ用に Postgres をセットアップしたい」のように、目的が本当に曖昧な場合は、開発作業ならローカルを選び、クラウド上に何かを作成する前に確認してください。クラウドサービスには料金がかかります。

前提条件（どちらのワークフローでも共通）

clickhousectl がインストールされていることを確認してください。

which clickhousectl

見つからない場合は、インストールしてください。

curl -fsSL https://clickhouse.com/cli | sh

~/.local/bin/clickhousectl にインストールされます（chctl エイリアスも設定されます）。それでもコマンドが見つからない場合は、export PATH="$HOME/.local/bin:$PATH" を実行するか、新しいターミナルを開くよう案内してください。

すべてのコマンドで、機械可読な出力を得るために --json を指定できます。終了コードは gh の規約に準拠します。0 は成功、1 はエラー、2 はキャンセル、4 は認証が必要な状態です。

関連項目

• 分析用に Postgres のデータを ClickHouse にレプリケートするには、ClickPipes を参照してください（clickhousectl cloud clickpipe --help）。ClickPipes は Postgres サービスをターゲットにできません。Postgres から Postgres への移行には ref/migrate.md を使用してください。
• ClickHouse 自体（ローカル開発または ClickHouse Cloud サービス）には、infra-clickhouse スキルを使用してください。