Skip to main content
S3 ClickPipe は、Amazon S3 および S3互換オブジェクトストアから ClickHouse Cloud にデータを取り込むための、フルマネージドで耐障害性に優れた仕組みです。一回限りと継続的インジェストの両方に対応し、exactly-once セマンティクスを備えています。
1

データソースを選択

1. ClickHouse Cloud のメインナビゲーションメニューで Data sources を選択し、Create ClickPipe をクリックします。
インポートを選択
2. Amazon S3 タイルをクリックします。このタイルを使用すると、ClickPipes UI に表示されていないその他の S3 互換サービスにも接続できます。
インポートを選択
オブジェクトストレージサービスプロバイダーごとに URL 形式や API 実装が異なるため、すべての S3 互換サービスがそのままサポートされているわけではありません。サポートされているデータソース に記載されていないサービスで問題が発生した場合は、当社チームまでお問い合わせください。
2

ClickPipe 接続を設定する

1. 新しい ClickPipe を設定するには、オブジェクトストレージサービスへの接続方法と認証方法に関する詳細を入力する必要があります。
接続の詳細を入力
2. Incoming data をクリックします。ClickPipes が次の手順に向けてバケットからメタデータを取得します。
3

データフォーマットを選択

UI に、指定した bucket 内のファイル一覧が表示されます。 データフォーマット (現在対応しているのは ClickHouse のフォーマットの一部です) と、継続的インジェストを有効にするかどうかを選択してください。 詳細は、概要ページの「continuous ingest」セクションを参照してください。
データフォーマットと topic を設定
4

テーブル、スキーマ、設定を構成

次のステップでは、新しい ClickHouse テーブルにデータを取り込むか、既存のテーブルを再利用するかを選択できます。 画面の指示に従って、テーブル名、スキーマ、設定を変更してください。 上部のサンプルテーブルで、変更内容のリアルタイムプレビューを確認できます。
テーブル、スキーマ、設定を設定
用意されているコントロールを使って、高度な設定をカスタマイズすることもできます。
高度なコントロールを設定
または、既存の ClickHouse テーブルにデータを取り込むこともできます。 その場合、UI でソースのフィールドを、選択した宛先テーブル内の ClickHouse のフィールドにマッピングできます。
既存のテーブルを使用
仮想カラム (_path や _size など) をフィールドにマッピングすることもできます。
5

権限を構成

最後に、内部 ClickPipes ユーザーの権限を構成できます。権限: ClickPipes は、宛先テーブルにデータを書き込むための専用ユーザーを作成します。カスタムロール、または事前定義されたロールのいずれかを使って、この内部ユーザーに割り当てるロールを選択できます。
  • Full access: クラスターへのフルアクセス。宛先テーブルで materialized view または Dictionary を使用する場合に必要です。
  • Only destination table: 宛先テーブルに対する INSERT 権限のみ。
権限
6

セットアップを完了

「Complete Setup」をクリックすると、システムに ClickPipe が登録され、サマリーテーブルに表示されるようになります。
成功通知
削除通知
サマリーテーブルには、ソースまたは ClickHouse 内の宛先テーブルからサンプルデータを表示するためのコントロールがあります。
宛先を表示
また、ClickPipe を削除したり、インジェストジョブの概要を表示したりするためのコントロールもあります。
概要を表示
おめでとうございます！ 最初の ClickPipe のセットアップが正常に完了しました。 この ClickPipe が継続的インジェスト用に構成されている場合は、継続的に稼働し、リモートのデータソースからデータをリアルタイムで取り込み続けます。 それ以外の場合は、Batch を取り込んで完了します。
最終更新日 2026年7月23日