> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/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-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/cp_step0.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=275437c400afd56e6808a20a266c9d7a" 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-vortex-format/mRaTj__cZTg8Xed9/images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step1.webp?fit=max&auto=format&n=mRaTj__cZTg8Xed9&q=85&s=24a9ff1845e8cb9b7df9e596325ecd34" 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-vortex-format/mRaTj__cZTg8Xed9/images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step2.webp?fit=max&auto=format&n=mRaTj__cZTg8Xed9&q=85&s=f24aaf722b396ce9ed0c46a54411b70e" 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 ワイルドカードを使用して、複数のファイルやプレフィックスに一致させることができます。サポートされているパターンについては、[リファレンスドキュメント](/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-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=1b5bb0f4c602b9662608631fc23ae448" 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-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/cp_step4a.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=2e7deef33ae050e3a21591d7913ba8c8" alt="テーブル、スキーマ、設定を設定" width="2734" height="1328" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a.webp" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/cp_step4a3.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=31f492f080e8703a703670a32ce9cbc4" 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-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/cp_step4b.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=0f6f8320e5ce05e590810e637300f751" alt="既存のテーブルを使用" width="2738" height="1322" data-path="images/integrations/data-ingestion/clickpipes/cp_step4b.webp" />
    </Frame>

    <Info>
      [仮想カラム](/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-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/cp_step5.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=ac9fe916e6c9fe09445c8b9fe0f3934f" 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-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/cp_success.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=3c1eea1c5a2b2c3ebf383e18671e9968" 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-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/cp_remove.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=8fe01d6260e42e4a9dde9a1e040e93e2" 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-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/cp_destination.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=3d56c9f3457a8c0e0c37731d3b24e36f" 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-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/cp_overview.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=556f0e192c4b566d50be4a76ae831a05" alt="概要を表示" width="3436" height="1076" data-path="images/integrations/data-ingestion/clickpipes/cp_overview.webp" />
    </Frame>

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