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

> Руководство по использованию полностью управляемого ClickHouse Connector Sink в Confluent Cloud

# Интеграция 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/ru/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink)
* Confluent Cloud

<div id="the-official-kafka-connector-from-clickhouse-with-confluent-cloud">
  ## Официальный коннектор Kafka от ClickHouse для Confluent Cloud
</div>

<div id="create-a-topic">
  #### Создайте топик
</div>

Создать топик в Confluent Cloud довольно просто, а подробные инструкции доступны [здесь](https://docs.confluent.io/cloud/current/client-apps/topics/manage.html).

<div id="important-notes">
  #### Важные примечания
</div>

* Имя Kafka топика должно совпадать с именем таблицы ClickHouse. Это можно изменить с помощью преобразователя (например, [`ExtractTopic`](https://docs.confluent.io/platform/current/connect/transforms/extracttopic.html)).
* Большее число партиций не всегда означает более высокую производительность — подробности и рекомендации по оптимизации см. в нашем будущем руководстве.

<div id="gather-your-connection-details">
  #### Подготовьте сведения о подключении
</div>

Чтобы подключиться к ClickHouse по HTTP(S), вам понадобится следующая информация:

| Параметр(ы)               | Описание                                                                                                               |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `HOST` and `PORT`         | Обычно используется порт 8443 при использовании TLS и 8123 без TLS.                                                    |
| `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">
  #### Установите коннектор
</div>

Установите ClickHouse Sink Connector с полным управлением в Confluent Cloud, следуя [официальной документации](https://docs.confluent.io/cloud/current/connectors/cc-clickhouse-sink-connector/cc-clickhouse-sink.html).

<div id="configure-the-connector">
  #### Настройте коннектор
</div>

При настройке ClickHouse Sink Connector вам потребуется указать следующие данные:

* имя хоста вашего сервера ClickHouse
* порт вашего сервера ClickHouse (по умолчанию — 8443)
* имя пользователя и пароль для вашего сервера ClickHouse
* имя базы данных в ClickHouse, в которую будут записываться данные
* имя топика в Kafka, который будет использоваться для записи данных в ClickHouse

Интерфейс Confluent Cloud поддерживает расширенные параметры конфигурации, позволяющие настраивать интервалы опроса, размеры батча и другие параметры для оптимизации производительности.

<Note>
  В Confluent Cloud изменение некоторых настроек, таких как [параметры fetch](/docs/ru/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink#fetch-settings) и [параметры poll](/docs/ru/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink#poll-settings), требует создания обращения в поддержку через Confluent Cloud.
</Note>

<div id="known-limitations">
  #### Известные ограничения
</div>

* См. список [ограничений коннекторов в официальной документации](https://docs.confluent.io/cloud/current/connectors/cc-clickhouse-sink-connector/cc-clickhouse-sink.html#limitations)