> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 最初の Amazon S3 ClickPipe を作成するためのステップごとのガイド。

# 最初の Amazon S3 ClickPipe を作成する

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const props_0 = undefined

export const provider_0 = "s3"

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

<Steps>
  <Step>
    ## データソースを選択する

    **1.** ClickHouse Cloud のメインナビゲーションメニューで **Data sources** を選択し、**Create ClickPipe** をクリックします。

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step0.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=8604d9b9df8655f1edcdc73536e5def1" alt="インポートを選択" size="lg" border width="2606" height="790" data-path="images/integrations/data-ingestion/clickpipes/cp_step0.png" />

    {props_0.provider_0 === 's3' && <S3DataSource />}

    {props_0.provider_0 === 'gcs' && <GCSSDataSource />}
  </Step>

  <Step>
    ## ClickPipe 接続を設定する

    **1.** 新しい ClickPipe を設定するには、オブジェクトストレージサービスへの接続方法と認証情報を指定する必要があります。

    {props_0.provider_0 === 's3' && <S3Connection />}

    {props_0.provider_0 === 'gcs' && <GCSConnection />}

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

  <Step>
    ## データフォーマットを選択する

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=4376b8bfb59f04113f532eb0a420072c" alt="データフォーマットと topic を設定" size="lg" border width="2336" height="1566" data-path="images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.png" />
  </Step>

  <Step>
    ## テーブル、スキーマ、設定を構成する

    次のステップでは、新しい ClickHouse テーブルにデータを取り込むか、既存のテーブルを再利用するかを選択できます。
    画面の指示に従って、テーブル名、スキーマ、設定を変更してください。
    上部のサンプルテーブルで、変更内容をリアルタイムでプレビューできます。

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step4a.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=b7af999c6e0a73c262f056e55751dba4" alt="テーブル、スキーマ、設定を行う" size="lg" border width="2734" height="1328" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a.png" />

    提供されているコントロールを使って、詳細設定をカスタマイズすることもできます。

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step4a3.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=62cb085edcb38779bf897cee66e60043" alt="詳細コントロールを設定" size="lg" border width="1592" height="338" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a3.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step4b.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=5fcb518694a73232d0a0ea7a56a31b81" alt="既存のテーブルを使用" size="lg" border width="2738" height="1322" data-path="images/integrations/data-ingestion/clickpipes/cp_step4b.png" />

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

  <Step>
    ## 権限を設定する

    最後に、ClickPipes の内部ユーザーに対する権限を設定できます。

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step5.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=26bdb80d849f8e306831cc8b95559738" alt="権限" size="lg" border width="2736" height="1318" data-path="images/integrations/data-ingestion/clickpipes/cp_step5.png" />
  </Step>

  <Step>
    ## セットアップを完了する

    「Complete Setup」をクリックすると、システムに ClickPipe が登録され、一覧テーブルに表示されるようになります。

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_success.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=d018023601453375093404901348444f" alt="成功通知" size="sm" border width="613" height="212" data-path="images/integrations/data-ingestion/clickpipes/cp_success.png" />

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_remove.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=a076de091319cd10a2891b7653b59e99" alt="削除通知" size="lg" border width="2756" height="1320" data-path="images/integrations/data-ingestion/clickpipes/cp_remove.png" />

    一覧テーブルには、ソースまたは ClickHouse 内の宛先テーブルのサンプルデータを表示するためのコントロールが用意されています。

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_destination.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=16249fc3debb01d3cfb83f78d10ec18d" alt="宛先を表示" size="lg" border width="2758" height="1316" data-path="images/integrations/data-ingestion/clickpipes/cp_destination.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_overview.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=6d118b6e76a5320b0204eea68147b689" alt="概要を表示" size="lg" border width="3436" height="1076" data-path="images/integrations/data-ingestion/clickpipes/cp_overview.png" />

    **おめでとうございます！** これで最初の ClickPipe の設定は完了です。
    継続的インジェスト用に構成された ClickPipe の場合は継続的に実行され、リモートのデータソースからリアルタイムでデータを取り込みます。
    そうでない場合は、バッチを取り込んで完了します。
  </Step>
</Steps>
