> ## 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.

> ClickPipes を介して Estuary と ClickHouse をインテグレーションする

# ClickPipes を使用して Estuary のデータを取り込む

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </svg>
            </div>
            パートナーインテグレーション
        </div>;
};

<PartnerBadge />

Estuary は、Kafka ClickPipe を介して ClickHouse に接続できます。

このインテグレーションでは、独自の Kafka エコシステムを運用する必要はありません。代わりに、Estuary は Kafka メッセージのように新しいデータを送信します。Kafka ClickPipe を設定し、Estuary のブローカーおよびスキーマレジストリの情報を使用して、これらのメッセージをコンシュームできます。

代替手段については、[Estuary の ClickHouse 直接インテグレーション](/docs/ja/integrations/connectors/data-ingestion/community-integrations/estuary-native)を参照してください。

<div id="setup-guide">
  ## セットアップガイド
</div>

**前提条件**

以下が必要です。

* [Estuary アカウント](https://dashboard.estuary.dev/register)
* 目的のソースからデータを取り込む、Estuary の 1 つ以上の [**キャプチャ**](https://docs.estuary.dev/concepts/captures/)
* ClickPipe 権限を持つ ClickHouse Cloud アカウント

<Steps>
  <Step title="Estuary マテリアライゼーションを作成する" id="1-create-an-estuary-materialization">
    Estuary のソースコレクションから ClickHouse にデータを移行するには、まず **マテリアライゼーション**を作成する必要があります。

    1. Estuary ダッシュボードで、[Destinations](https://dashboard.estuary.dev/materializations) ページに移動します。
    2. **+ New Materialization** をクリックします。
    3. **ClickHouse Kafka API** コネクタを選択します。
    4. Materialization、Endpoint、Source Collections の各セクションで詳細を入力します。
       * **Materialization Details:** マテリアライゼーションに一意の名前を付け、データプレーン (クラウドプロバイダーとリージョン) を選択します
       * **Endpoint Config:** 安全な **Auth Token** を指定します
       * **Source Collections:** 既存の **キャプチャ**をリンクするか、ClickHouse に公開するデータコレクションを選択します
    5. **Next**、**Save and Publish** の順にクリックします。
    6. マテリアライゼーションの詳細ページで、ClickHouse マテリアライゼーションの完全名を控えます。`your-tenant/your-unique-name/dekaf-clickhouse` のような形式です。

    Estuary は選択したコレクションの Kafka メッセージのストリーミングを開始します。ClickHouse は、Estuary のブローカー情報と指定した認証トークンを使用して、Kafka ClickPipe 経由でこのデータにアクセスできます。
  </Step>

  <Step title="Kafka 接続情報を入力する" id="2-enter-kafka-connection-details">
    ClickHouse で新しい Kafka ClickPipe を設定し、接続情報を入力します。

    1. ClickHouse Cloud ダッシュボードで、**Data sources** を選択します。
    2. 新しい **ClickPipe** を作成します。
    3. データソースとして **Apache Kafka** を選択します。
    4. Estuary のブローカーおよびレジストリ情報を使用して、Kafka 接続情報を入力します。
       * ClickPipe の名前を指定します
       * ブローカーには `dekaf.estuary-data.com:9092` を使用します
       * 認証はデフォルトの `SASL/PLAIN` のままにします
       * ユーザーには、Estuary のマテリアライゼーションの完全名 (`your-tenant/your-unique-name/dekaf-clickhouse` など) を入力します
       * パスワードには、マテリアライゼーションに指定した認証トークンを入力します
    5. スキーマレジストリオプションを有効にします。
       * スキーマ URL には `https://dekaf.estuary-data.com` を使用します
       * スキーマキーはブローカーユーザー (マテリアライゼーション名) と同じです
       * シークレットはブローカーパスワード (認証トークン) と同じです
  </Step>

  <Step title="受信データを設定する" id="3-configure-incoming-data">
    1. Kafka **トピック**の 1 つ (Estuary のデータコレクションの 1 つ) を選択します。
    2. **オフセット**を選択します。
    3. ClickHouse がトピックメッセージを検出します。**Parse information** セクションに進み、テーブル情報を設定できます。
    4. 新しいテーブルを作成するか、対応する既存のテーブルにデータを読み込むかを選択します。
    5. ソースフィールドをテーブルのカラムにマッピングし、カラム名、型、NULL 許容かどうかを確認します。
    6. 最後の **Details and settings** セクションで、専用データベースユーザーの権限を選択できます。

    設定内容に問題がなければ、ClickPipe を作成します。

    ClickHouse は新しいデータソースをプロビジョニングし、Estuary からのメッセージのコンシュームを開始します。必要に応じて ClickPipe を作成し、目的のすべてのデータコレクションからストリーミングします。
  </Step>
</Steps>

<div id="additional-resources">
  ## その他のリソース
</div>

Estuary との ClickPipe インテグレーションの設定について詳しくは、Estuary のドキュメントを参照してください。

* ClickPipes インテグレーションについては、Estuary の [ClickHouse マテリアライゼーション ドキュメント](https://docs.estuary.dev/reference/Connectors/materialization-connectors/Dekaf/clickhouse/)を参照してください。
* Estuary は **Dekaf** を使用してデータを Kafka メッセージとして公開します。Dekaf の詳細については、[Estuary ガイド](https://docs.estuary.dev/guides/dekaf_reading_collections_from_kafka/)を参照してください。