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

> 在 Confluent Cloud 上使用全托管 ClickHouse Connector Sink 的指南

# 将 Confluent Cloud 与 ClickHouse 集成

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<div class="vimeo-container">
  <Frame>
    <iframe
      src="//www.youtube.com/embed/SQAiPVbd3gg"
      frameborder="0"
      allow="autoplay;
fullscreen;
picture-in-picture"
      allowfullscreen
    />
  </Frame>
</div>

<div id="prerequisites">
  ## 前置条件
</div>

我们假定你已熟悉以下内容：

* [ClickHouse Connector Sink](/docs/zh/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink)
* Confluent Cloud

<div id="the-official-kafka-connector-from-clickhouse-with-confluent-cloud">
  ## ClickHouse 官方 Kafka 连接器与 Confluent Cloud 集成
</div>

<div id="create-a-topic">
  #### 创建 Topic
</div>

在 Confluent Cloud 上创建 topic 非常简单，详细说明请参见[此处](https://docs.confluent.io/cloud/current/client-apps/topics/manage.html)。

<div id="important-notes">
  #### 重要说明
</div>

* Kafka topic 名称必须与 ClickHouse 表名保持一致。如需调整，可使用转换器 (例如 [`ExtractTopic`](https://docs.confluent.io/platform/current/connect/transforms/extracttopic.html)) 。
* 分区更多并不一定意味着性能更高——更多详情和性能优化建议，请参阅我们即将发布的指南。

<div id="gather-your-connection-details">
  #### 准备连接信息
</div>

要通过 HTTP(S) 连接到 ClickHouse，你需要以下信息：

| Parameter(s)              | Description                                |
| ------------------------- | ------------------------------------------ |
| `HOST` and `PORT`         | 通常，使用 TLS 时端口为 8443；不使用 TLS 时端口为 8123。     |
| `DATABASE NAME`           | 默认情况下，存在一个名为 `default` 的数据库。请使用你要连接的数据库名称。 |
| `USERNAME` and `PASSWORD` | 默认情况下，用户名为 `default`。请根据你的使用场景使用相应的用户名。    |

你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。
选择一个服务，然后点击 **Connect**：

<div className="ch-image-md">
  <Frame>
    <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="ClickHouse Cloud 服务连接按钮" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
  </Frame>
</div>

选择 **HTTPS**。连接信息会显示在示例 `curl` 命令中。

<div className="ch-image-md">
  <Frame>
    <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="ClickHouse Cloud HTTPS 连接信息" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
  </Frame>
</div>

如果你使用的是自管理 ClickHouse，则连接信息由你的 ClickHouse 管理员配置。

<div id="install-connector">
  #### 安装 Connector
</div>

按照[官方文档](https://docs.confluent.io/cloud/current/connectors/cc-clickhouse-sink-connector/cc-clickhouse-sink.html)中的说明，在 Confluent Cloud 上安装全托管的 ClickHouse Sink Connector。

<div id="configure-the-connector">
  #### 配置 Connector
</div>

在配置 ClickHouse Sink Connector 时，您需要提供以下信息：

* 您的 ClickHouse server 的 hostname
* 您的 ClickHouse server 的端口 (默认为 8443)
* 您的 ClickHouse server 的用户名和密码
* ClickHouse 中用于写入数据的 database 名称
* Kafka 中用于将数据写入 ClickHouse 的 topic 名称

Confluent Cloud UI 支持高级配置选项，可用于调整轮询间隔、批次大小和其他参数，以优化性能。

<Note>
  在 Confluent Cloud 上，调整某些设置 (例如 [拉取设置](/docs/zh/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink#fetch-settings) 和 [轮询设置](/docs/zh/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink#poll-settings)) 需要通过 Confluent Cloud 提交支持工单。
</Note>

<div id="known-limitations">
  #### 已知限制
</div>

* 请参阅[官方文档中的 Connectors 限制列表](https://docs.confluent.io/cloud/current/connectors/cc-clickhouse-sink-connector/cc-clickhouse-sink.html#limitations)