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

> はじめての Kafka ClickPipe を作成するための手順を順を追って説明するガイド。

# はじめての Kafka ClickPipe の作成

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

> このガイドでは、はじめての Kafka ClickPipe を作成する手順を順を追って説明します。

Kafka ClickPipes は、ClickPipes UI を使用して手動でデプロイおよび管理できるほか、[OpenAPI](/ja/integrations/clickpipes/programmatic-access/openapi) や [Terraform](/ja/integrations/clickpipes/programmatic-access/terraform) を使用してプログラムからデプロイおよび管理することもできます。

<Steps>
  <Step>
    ## データソースへ移動

    左側のメニューで `Data Sources` ボタンを選択し、"Set up a ClickPipe" をクリックします。

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/CELXicearGcsITlZ/images/integrations/data-ingestion/clickpipes/cp_step0.png?fit=max&auto=format&n=CELXicearGcsITlZ&q=85&s=699a7d63bc1bce4213f48f5e58acdfc7" alt="インポートを選択" size="md" width="2606" height="790" data-path="images/integrations/data-ingestion/clickpipes/cp_step0.png" />
  </Step>

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

    一覧からKafkaのデータソースを選択します。

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/CELXicearGcsITlZ/images/integrations/data-ingestion/clickpipes/cp_step1.png?fit=max&auto=format&n=CELXicearGcsITlZ&q=85&s=25f0745a3ac0e797ad7f6ed7c035ebe6" alt="データソースの種類を選択" size="md" width="2600" height="1890" data-path="images/integrations/data-ingestion/clickpipes/cp_step1.png" />
  </Step>

  <Step>
    ## データソースを設定する

    ClickPipe の名前、説明 (任意) 、認証情報、その他の接続情報を入力してフォームを完成させます。

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/CELXicearGcsITlZ/images/integrations/data-ingestion/clickpipes/cp_step2.png?fit=max&auto=format&n=CELXicearGcsITlZ&q=85&s=a65e239172be0c69f6c0c158610f93de" alt="接続情報を入力" size="md" width="1896" height="1370" data-path="images/integrations/data-ingestion/clickpipes/cp_step2.png" />
  </Step>

  <Step>
    ## スキーマレジストリを設定する (任意)

    Avro および Protobuf のトピックでは、有効なスキーマが必要です。スキーマレジストリの設定方法について詳しくは、[スキーマレジストリ](/ja/integrations/clickpipes/kafka/schema-registries) を参照してください。
  </Step>

  <Step>
    ## リバース プライベート エンドポイントを設定する (任意)

    ClickPipes が AWS PrivateLink 経由で Kafka クラスターに接続できるよう、リバース プライベート エンドポイントを設定します。
    詳細については、[AWS PrivateLink ドキュメント](/ja/integrations/clickpipes/aws-privatelink)を参照してください。
  </Step>

  <Step>
    ## SSH トンネリングを設定する (任意)

    Kafka ブローカーにパブリックにアクセスできない場合は、SSH トンネリングを使用できます。ClickPipes は直接接続する代わりに、踏み台サーバー (ネットワーク内にあり、パブリックにアクセス可能なサーバー) への SSH 接続を確立し、その接続を経由してプライベートネットワーク上の Kafka ブローカーにトラフィックを転送します。

    1. "SSH Tunnel" トグルを有効にします。
    2. SSH 接続の詳細を入力します。
       * **SSH Host**: 踏み台サーバーのホスト名または IP アドレス。プライベートネットワークへのゲートウェイとして機能する、パブリックにアクセス可能なサーバーです。
       * **SSH Port**: 踏み台サーバーの SSH ポート (デフォルトは `22`) 。
       * **SSH User**: 踏み台サーバーで認証に使用するユーザー名。

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/CELXicearGcsITlZ/images/integrations/data-ingestion/clickpipes/cp_ssh_tunnel.png?fit=max&auto=format&n=CELXicearGcsITlZ&q=85&s=1aa242bb0bda099db7960bf0662f629c" alt="SSH トンネル設定" size="md" width="1810" height="1510" data-path="images/integrations/data-ingestion/clickpipes/cp_ssh_tunnel.png" />

    3. 鍵ベース認証を使用するには、"Revoke and regenerate key pair" をクリックして新しい鍵ペアを生成し、生成された公開鍵を SSH サーバーの `~/.ssh/authorized_keys` にコピーします。
    4. "Verify Connection" をクリックして接続を確認します。

    <Note>
      ClickPipes が SSH トンネルを確立できるように、SSH 踏み台サーバーのファイアウォールルールで [ClickPipes IP addresses](/ja/integrations/clickpipes/home#list-of-static-ips) を許可してください。
    </Note>
  </Step>

  <Step>
    ## トピックを選択

    トピックを選択すると、UI にそのトピックのサンプルドキュメントが表示されます。

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/CELXicearGcsITlZ/images/integrations/data-ingestion/clickpipes/cp_step3.png?fit=max&auto=format&n=CELXicearGcsITlZ&q=85&s=d379207db738cbb82cd87ab4340166ab" alt="トピックを選択" size="md" width="2380" height="1956" data-path="images/integrations/data-ingestion/clickpipes/cp_step3.png" />
  </Step>

  <Step>
    ## 宛先テーブルを設定する

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/CELXicearGcsITlZ/images/integrations/data-ingestion/clickpipes/cp_step4a.png?fit=max&auto=format&n=CELXicearGcsITlZ&q=85&s=2bc60b4a8c796303598dba2438c13340" alt="テーブル、スキーマ、設定を指定する" size="md" width="2734" height="1328" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/CELXicearGcsITlZ/images/integrations/data-ingestion/clickpipes/cp_table_settings.png?fit=max&auto=format&n=CELXicearGcsITlZ&q=85&s=daae813e1ed6dbf9d533d0514abbfc1d" alt="詳細設定を行うためのコントロール" size="md" width="1592" height="338" data-path="images/integrations/data-ingestion/clickpipes/cp_table_settings.png" />
  </Step>

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

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/CELXicearGcsITlZ/images/integrations/data-ingestion/clickpipes/cp_step5.png?fit=max&auto=format&n=CELXicearGcsITlZ&q=85&s=dc0d8f9d427540e05d9c83bc2dc6afde" alt="権限" size="md" width="2736" height="1318" data-path="images/integrations/data-ingestion/clickpipes/cp_step5.png" />
  </Step>

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

    "Create ClickPipe" をクリックすると、ClickPipe が作成されて起動します。作成後は、Data Sources セクションに表示されます。

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/CELXicearGcsITlZ/images/integrations/data-ingestion/clickpipes/cp_overview.png?fit=max&auto=format&n=CELXicearGcsITlZ&q=85&s=55c86550a8af06c2171b2f793dc14c10" alt="概要を表示" size="md" width="3436" height="1076" data-path="images/integrations/data-ingestion/clickpipes/cp_overview.png" />
  </Step>
</Steps>
