> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> 最初の Google Cloud Storage ClickPipe を作成するためのステップバイステップガイド。

# 最初の GCS ClickPipe を作成する

GCS ClickPipe は、Google Cloud Storage (GCS) からデータを取り込むための、フルマネージドで高い耐障害性を備えた機能です。**一回限り**と**継続的インジェスト**の両方をサポートし、exactly-once セマンティクスを提供します。

<Steps>
  <Step title="データソースを選択" id="1-select-the-data-source">
    **1.** ClickHouse Cloud のメインナビゲーションメニューで **データソース** を選択し、**Create ClickPipe** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step0.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=fb04bb07245be43cb784fa68cee62287" alt="インポートを選択" width="2606" height="790" data-path="images/integrations/data-ingestion/clickpipes/cp_step0.webp" />
    </Frame>

    **2.** **Google Cloud Storage** のタイルをクリックします。

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step1.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=b9e0d4154a6e96f7acb595c81f988c15" alt="インポートを選択" width="3016" height="952" data-path="images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step1.webp" />
    </Frame>
  </Step>

  <Step title="ClickPipe 接続を設定する" id="2-setup-your-clickpipe-connection">
    **1.** 新しい ClickPipe を設定するには、オブジェクトストレージサービスへの接続方法と認証方法の詳細を指定する必要があります。

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step2.webp?fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=3da74887fe8ea9aa9c0c2b4ba67e8c7c" alt="接続情報を入力" width="3014" height="1428" data-path="images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step2.webp" />
    </Frame>

    * **GCS ファイルパス**: GCS ClickPipe は、相互運用性のために Cloud ストレージの [XML API](https://docs.cloud.google.com/storage/docs/interoperability) を使用します。このため、`storage.googleapis.com` エンドポイントが必要です。

      ```bash theme={null}
      https://storage.googleapis.com/bucket-name/key-name
      ```

      POSIX ワイルドカードを使用して、複数のファイルやプレフィックスに一致させることができます。サポートされているパターンについては、[リファレンスドキュメント](/docs/ja/integrations/clickpipes/object-storage/google-cloud-storage/overview#file-pattern-matching) を参照してください。

    **2.** **Incoming data** をクリックします。ClickPipes が次のステップに向けて、バケットからメタデータを取得します。
  </Step>

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

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=e3c03fbaec5b6db3810a4380343c42b9" alt="データフォーマットと topic を設定" width="2336" height="1566" data-path="images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.webp" />
    </Frame>
  </Step>

  <Step title="テーブル、スキーマ、設定を構成" id="5-configure-table-schema-settings">
    次のステップでは、新しい ClickHouse テーブルにデータを取り込むか、既存のテーブルを再利用するかを選択できます。
    画面の指示に従って、テーブル名、スキーマ、設定を変更してください。
    上部のサンプルテーブルで、変更内容のリアルタイムプレビューを確認できます。

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step4a.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=e0cdb9469f6867e897cc77541af7f59b" alt="テーブル、スキーマ、設定を設定" width="2734" height="1328" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a.webp" />
    </Frame>

    用意されているコントロールを使って、高度な設定をカスタマイズすることもできます。

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step4a3.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=db7cb839e136d26563b239937f029c7a" alt="高度なコントロールを設定" width="1592" height="338" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a3.webp" />
    </Frame>

    または、既存の ClickHouse テーブルにデータを取り込むこともできます。
    その場合、UI でソースのフィールドを、選択した宛先テーブル内の ClickHouse のフィールドにマッピングできます。

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step4b.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=a5cb66aa9b3855c5d53b340dbd89b108" alt="既存のテーブルを使用" width="2738" height="1322" data-path="images/integrations/data-ingestion/clickpipes/cp_step4b.webp" />
    </Frame>

    <Info>
      [仮想カラム](/docs/ja/reference/functions/table-functions/s3#virtual-columns) (`_path` や `_size` など) をフィールドにマッピングすることもできます。
    </Info>
  </Step>

  <Step title="権限を構成" id="6-configure-permissions">
    最後に、内部 ClickPipes ユーザーの権限を構成できます。

    **権限:** ClickPipes は、宛先テーブルにデータを書き込むための専用ユーザーを作成します。カスタムロール、または事前定義されたロールのいずれかを使って、この内部ユーザーに割り当てるロールを選択できます。

    * `Full access`: クラスターへのフルアクセス。宛先テーブルで materialized view または Dictionary を使用する場合に必要です。
    * `Only destination table`: 宛先テーブルに対する `INSERT` 権限のみ。

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step5.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=71ea5baaa2c38fcc83b160f4856264ab" alt="権限" width="2736" height="1318" data-path="images/integrations/data-ingestion/clickpipes/cp_step5.webp" />
    </Frame>
  </Step>

  <Step title="セットアップを完了" id="7-complete-setup">
    「Complete Setup」をクリックすると、システムに ClickPipe が登録され、サマリーテーブルに表示されるようになります。

    <div className="ch-image-sm">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_success.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=ce045b4a85e7f294d23c03897e9ce11f" alt="成功通知" width="613" height="212" data-path="images/integrations/data-ingestion/clickpipes/cp_success.webp" />
      </Frame>
    </div>

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_remove.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=83b452ee5d8017da1b1c0d50cf8a491d" alt="削除通知" width="2756" height="1320" data-path="images/integrations/data-ingestion/clickpipes/cp_remove.webp" />
    </Frame>

    サマリーテーブルには、ソースまたは ClickHouse 内の宛先テーブルからサンプルデータを表示するためのコントロールがあります。

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_destination.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=cb3ebed0c324cb30c6cbf35726b3bec7" alt="宛先を表示" width="2758" height="1316" data-path="images/integrations/data-ingestion/clickpipes/cp_destination.webp" />
    </Frame>

    また、ClickPipe を削除したり、インジェストジョブの概要を表示したりするためのコントロールもあります。

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_overview.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=1ce91f5079842cfc66a4c88919f2e061" alt="概要を表示" width="3436" height="1076" data-path="images/integrations/data-ingestion/clickpipes/cp_overview.webp" />
    </Frame>

    **おめでとうございます！** 最初の ClickPipe のセットアップが正常に完了しました。
    この ClickPipe が継続的インジェスト用に構成されている場合は、継続的に稼働し、リモートのデータソースからデータをリアルタイムで取り込み続けます。
    それ以外の場合は、Batch を取り込んで完了します。
  </Step>
</Steps>
