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

​
はじめに

ClickPipes は、多様なデータソースからのデータ取り込みを、数回クリックするだけで簡単に行えるマネージドなインテグレーションプラットフォームです。最も要求の厳しいワークロード向けに設計された、堅牢かつスケーラブルな ClickPipes のアーキテクチャにより、一貫したパフォーマンスと信頼性を実現します。ClickPipes は、長期的なストリーミング用途にも、一回限りのデータロードジョブにも利用できます。 ClickPipes は、ClickPipes UI を使用して手動でデプロイおよび管理できるほか、OpenAPI や Terraform を使用してプログラムからデプロイおよび管理することもできます。

​
サポートされているデータソース

今後、さらに多くのコネクタが ClickPipes に追加される予定です。詳細は、お問い合わせください。

​
固定 IP の一覧

以下の表は、ClickPipes が外部サービスへの接続に使用する固定 NAT IP を示しています。お使いの ClickHouse Cloud サービスに対応する ClickPipes リージョンの IP を、IP の許可リストに追加してください。オブジェクトストレージのパイプの場合は、ClickHouse クラスターの IP も IP の許可リストに追加する必要があります。 以下の Google Cloud 表に記載されている Google Cloud リージョンのサービスでは、2026 年 5 月 27 日以降に作成されたサービスに限り、それらの Google Cloud IP が使用されます。これらのリージョンで 2026 年 5 月 27 日より前に作成されたサービスは、引き続き以下に記載されたデフォルトリージョンの IP を使用します。 その他のサービスでは、ClickPipes のトラフィックはサービスの場所に応じたデフォルトリージョンから発信されます。
  • eu-central-1: 明示的に記載されていないすべての EU リージョンに加え、Azure の EU リージョン、および 2026 年 5 月 27 日より前に作成された Google Cloud の EU サービス。
  • eu-west-1: AWS eu-west-1 のすべてのサービスのうち、2026 年 1 月 20 日以降に作成されたもの (この日付より前に作成されたサービスは eu-central-1 の IP を使用) 。
  • us-east-1: AWS us-east-1 のすべてのサービス。
  • ap-south-1: AWS ap-south-1 のサービスのうち、2025 年 6 月 25 日以降に作成されたもの (この日付より前に作成されたサービスは us-east-2 の IP を使用) 。
  • ap-northeast-2: AWS ap-northeast-2 のサービスのうち、2025 年 11 月 14 日以降に作成されたもの (この日付より前に作成されたサービスは us-east-2 の IP を使用) 。
  • af-south-1: AWS af-south-1 のサービスのうち、2026 年 4 月 15 日以降に作成されたもの (この日付より前に作成されたサービスは us-east-2 の IP を使用) 。
  • ap-east-1: AWS ap-east-1 のサービスのうち、2026 年 4 月 15 日以降に作成されたもの (この日付より前に作成されたサービスは us-east-2 の IP を使用) 。
  • ap-northeast-1: AWS ap-northeast-1 のサービスのうち、2026 年 4 月 15 日以降に作成されたもの (この日付より前に作成されたサービスは us-east-2 の IP を使用) 。
  • ap-southeast-1: AWS ap-southeast-1 のサービスのうち、2026 年 3 月 18 日以降に作成されたもの (この日付より前に作成されたサービスは us-east-2 の IP を使用) 。
  • ap-southeast-2: AWS ap-southeast-2 のサービスのうち、2025 年 6 月 25 日以降に作成されたもの (この日付より前に作成されたサービスは us-east-2 の IP を使用) 。
  • ap-southeast-3: AWS ap-southeast-3 のサービスのうち、2026 年 3 月 6 日以降に作成されたもの (この日付より前に作成されたサービスは us-east-2 の IP を使用) 。
  • ca-central-1: AWS ca-central-1 のサービスのうち、2026 年 4 月 15 日以降に作成されたもの (この日付より前に作成されたサービスは us-east-2 の IP を使用) 。
  • eu-north-1: AWS eu-north-1 のサービスのうち、2026 年 4 月 15 日以降に作成されたもの (この日付より前に作成されたサービスは eu-central-1 の IP を使用) 。
  • eu-west-2: AWS eu-west-2 のサービスのうち、2026 年 4 月 15 日以降に作成されたもの (この日付より前に作成されたサービスは eu-central-1 の IP を使用) 。
  • il-central-1: AWS il-central-1 のサービスのうち、2026 年 4 月 15 日以降に作成されたもの (この日付より前に作成されたサービスは us-east-2 の IP を使用) 。
  • sa-east-1: AWS sa-east-1 のサービスのうち、2026 年 4 月 15 日以降に作成されたもの (この日付より前に作成されたサービスは us-east-2 の IP を使用) 。
  • us-west-2: AWS us-west-2 のサービスのうち、2025 年 6 月 24 日以降に作成されたもの (この日付より前に作成されたサービスは us-east-2 の IP を使用) 。
  • us-east-2: 上記のルールのいずれにも一致しないその他すべてのリージョン (Azure リージョンおよび 2026 年 5 月 27 日より前に作成された Google Cloud サービスを含む) 。

​
AWS の固定 NAT IP

​
Google Cloud 固定 NAT IP

​
ClickHouse設定の調整

ClickHouse Cloud では、ほとんどのユースケースに適したデフォルト設定が提供されています。ただし、ClickPipes の宛先テーブル向けに ClickHouse設定を調整する必要がある場合は、ClickPipes 専用のロールを作成するのが最も柔軟な方法です。 手順:
  1. カスタムロール CREATE ROLE my_clickpipes_role SETTINGS ... を作成します。詳細は CREATE ROLE の構文を参照してください。
  2. ClickPipes の作成時に、Details and Settings ステップで ClickPipes ユーザーにカスタムロールを追加します。

​
ClickPipes の高度な設定の調整

ClickPipes には、ほとんどのユースケースに対応できる適切なデフォルト設定が用意されています。さらに細かく調整する必要がある場合は、以下の設定を変更できます。

​
オブジェクトストレージ 用 ClickPipes

​
ストリーミング ClickPipes

​
エラーの報告

ClickPipes は、インジェスト中に発生したエラーの種類に応じて、エラーを 2 つの別々のテーブルに保存します。

​
レコードエラー

ClickPipes は、宛先テーブルと同じ場所に、末尾が <destination_table_name>_clickpipes_error となるテーブルを作成します。このテーブルには、データ形式の不正やスキーマの不一致によって発生したエラーが格納され、無効なメッセージ全体も記録されます。このテーブルの 有効期限 (TTL) は 7 日です。

​
システムエラー

ClickPipe の動作に関連するエラーは、system.clickpipes_log テーブルに保存されます。このテーブルには、ClickPipe の動作に関するその他のエラー (ネットワークや接続など) もすべて保存されます。このテーブルの 有効期限 (TTL) は 7 日間です。 ClickPipes が 15 分以内にデータソースに接続できない場合、または 1 時間以内に宛先に接続できない場合、ClickPipes インスタンスは停止し、適切なメッセージをシステムエラーテーブルに保存します (ClickHouse インスタンスが利用可能な場合) 。

​
監視

コンソールでの監視に加えて、ClickPipes はスクレイピング用に Prometheus互換エンドポイント へメトリクスを公開しています。これらのメトリクスは、他の ClickHouse Cloud サービスのメトリクスとあわせて公開され、既存のオブザーバビリティスタック (例: Grafana、Datadog) に ClickPipes の監視を統合できます。利用可能なメトリクスの一覧については、ClickPipes の監視 を参照してください。

​
よくある質問

  • ClickPipes とは何ですか？ ClickPipes は ClickHouse Cloud の機能で、ClickHouse サービスを外部データソース、特に Kafka に簡単に接続できます。Kafka 向け ClickPipes を使うと、データを ClickHouse に継続的に簡単に取り込み、リアルタイム分析に利用できるようになります。
  • ClickPipes はデータ変換をサポートしていますか？ はい。ClickPipes は DDL を作成できるため、基本的なデータ変換をサポートしています。さらに、ClickHouse の materialized view 機能 を活用することで、ClickHouse Cloud サービス内の宛先テーブルにデータが読み込まれる際に、より高度な変換を適用できます。
  • ClickPipes を使用すると追加料金が発生しますか？ ClickPipes の課金は、取り込みデータとコンピュートの 2 つの項目に基づいて行われます。料金の詳細は このページ を参照してください。ClickPipes を実行すると、他の取り込みワークロードと同様に、宛先の ClickHouse Cloud サービスで間接的なコンピュートおよびストレージのコストが発生する場合もあります。
  • Kafka 向け ClickPipes の使用時にエラーや障害に対処する方法はありますか？ はい。Kafka からデータを取り込む際に、ネットワークや接続の問題などの運用上の理由で障害が発生した場合、Kafka 向け ClickPipes は自動的に再試行します。データの形式不正や無効なスキーマが発生した場合、ClickPipes はそのレコードを record_error テーブルに保存し、処理を継続します。
最終更新日 2026年6月12日