メインコンテンツへスキップ
GCP 上の ClickHouse BYOC は、VPC Peering と Private Service Connect という 2 つのプライベート接続オプションをサポートしています。トラフィックはすべて GCP ネットワーク内で完結し、パブリックインターネットを経由することはありません。

​
前提条件

VPC ピアリング と Private Service Connect の両方に共通して必要な手順です。

​
ClickHouse BYOC のプライベートロードバランサーを有効にする

プライベートロードバランサーを有効にするには、ClickHouse Support までお問い合わせください。

​
VPC ピアリングを設定する

事前に GCP VPC peering 機能を確認し、VPC ピアリングの制限事項 (たとえば、ピアリングされた VPC ネットワーク間ではサブネットの IP 範囲を重複させることはできません) に注意してください。ClickHouse BYOC では、ピアリング経由で ClickHouseサービス へのネットワーク接続を可能にするために、プライベートロードバランサーを使用します。 ClickHouse BYOC の VPC ピアリングを作成または削除するには、次の手順に従ってください。
この手順例はシンプルなシナリオを対象としています。オンプレミス接続とのピアリングなど、より高度なシナリオでは調整が必要になる場合があります。
1

​
ピアリング接続を作成する

この例では、BYOC VPC ネットワークと、既存の別の VPC ネットワークの間でピアリングを設定します。
  1. ClickHouse BYOC Google Cloud Project の “VPC Network” に移動します。
  2. “VPC network peering” を選択します。
  3. “Create connection” をクリックします。
  4. 要件に応じて必要なフィールドを入力します。以下は、同じ GCP project 内でピアリングを作成する場合のスクリーンショットです。
GCP VPC ピアリングを機能させるには、2 つのネットワーク間に 2 つの接続が必要です (つまり、BYOC ネットワークから既存の VPC ネットワークへの接続と、既存の VPC ネットワークから BYOC ネットワークへの接続) 。そのため、同様に逆方向でもう 1 つ接続を作成する必要があります。以下は、2 つ目のピアリング接続を作成する際のスクリーンショットです。両方の接続を作成すると、Google Cloud Console の Web ページを更新したあと、2 つの接続のステータスは “Active” になるはずです。これで、ClickHouseサービス はピアリングされた VPC からアクセスできるようになります。
2

​
ピアリング接続経由で ClickHouseサービス にアクセスする

ClickHouse にプライベートにアクセスするため、ユーザーのピアリング済み VPC から安全に接続できるよう、プライベートロードバランサーとエンドポイントがプロビジョニングされます。プライベート エンドポイントは、公開エンドポイントの形式に -private 接尾辞を付けたものです。例:
  • 公開エンドポイント: h5ju65kv87.mhp0y4dmph.us-east1.gcp.byoc.clickhouse.cloud
  • プライベート エンドポイント: h5ju65kv87-private.mhp0y4dmph.us-east1.gcp.byoc.clickhouse.cloud

​
PSC (Private Service Connect) を設定する

GCP PSC (Private Service Connect) を使用すると、VPC ピアリング やインターネットゲートウェイを使わずに、ClickHouse BYOC サービスに安全なプライベート接続を確立できます。
1

​
PSC サービスのセットアップを依頼する

BYOC デプロイメント向けに PSC サービスのセットアップを依頼するには、ClickHouse Support に連絡してください。この段階では、特に追加情報は必要ありません。PSC 接続を設定したい旨を伝えるだけで十分です。ClickHouse Support が、プライベート ロードバランサー や PSC Service など、必要なインフラストラクチャ コンポーネントを有効にします。
2

​
GCP PSC のサービス名と DNS 名を取得する

ClickHouse Support から PSC サービス名が提供されます。ClickHouse Cloud console で「Organization」->「Infrastructure」と進み、インフラ名をクリックして詳細を表示することでも確認できます。PSC サービス名は、GCP Private Service Connect console の「Published services」でも確認できます (サービス名で絞り込むか、ClickHouse のサービスを探してください) 。
3

​
ネットワーク内に PSC エンドポイントを作成する

ClickHouse Support 側で PSC サービスが有効化されたら、ClickHouse の PSC サービスに接続するために、クライアントアプリケーションのネットワーク内に PSC エンドポイントを作成する必要があります。
  1. PSC エンドポイントを作成する:
  • GCP Console -> Network Services → Private Service Connect → Connect Endpoint に移動します
  • “Target” で “Published service” を選択し、前の手順で取得した PSC サービス名を “Target details” に入力します
  • 有効なエンドポイント名を入力します
  • ネットワークを選択し、サブネットを選択します (これはクライアントアプリケーションの接続元となるネットワークです)
  • エンドポイント用の IP アドレスを選択するか、新しく作成します。この IP アドレスは、手順 エンドポイントのプライベート DNS 名を設定する で使用します
  • “Add Endpoint” をクリックし、エンドポイントが作成されるまで少し待ちます。
  • エンドポイントの status は “Accepted” になるはずです。自動的に承認されない場合は ClickHouse Support にお問い合わせください。
  1. PSC Connection ID を取得する:
4

​
エンドポイントのプライベート DNS 名を設定する

DNS の設定方法はいくつかあります。ご利用のユースケースに応じて DNS を設定してください。
Obtain GCP PSC service name and DNS name の手順で取得した「DNS 名」のすべてのサブドメイン (ワイルドカード) が GCP PSC エンドポイントの IP アドレスを指すように設定する必要があります。これにより、VPC/ネットワーク内のサービスやコンポーネントがその名前を正しく解決できるようになります。
5

​
エンドポイントのPSC接続IDをサービスの許可リストに追加する

PSCエンドポイントが作成され、ステータスが”Accepted”になったら、PSC経由でアクセスする各 ClickHouseサービスの許可リストに、そのエンドポイントのPSC接続IDを追加する必要があります。ClickHouse Supportに連絡してください:
  • エンドポイントのPSC接続IDをClickHouse Supportに提供します
  • このエンドポイントからのアクセスを許可するClickHouseサービスを指定します
  • ClickHouse Supportがエンドポイントの接続IDをサービスの許可リストに追加します
6

​
PSC 経由で ClickHouse に接続する

Endpoint Connection ID が許可リストに追加されると、PSC エンドポイントを使用して ClickHouse サービスに接続できます。PSC エンドポイントの形式はパブリックエンドポイントと似ていますが、p サブドメインが含まれます。例:
  • Public endpoint: h5ju65kv87.mhp0y4dmph.us-east1.gcp.clickhouse-byoc.com
  • PSC endpoint: h5ju65kv87.p.mhp0y4dmph.us-east1.gcp.clickhouse-byoc.com
最終更新日 2026年7月2日