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

> Guia para usar o ClickHouse Connector Sink totalmente gerenciado no Confluent Cloud

# Integrando o Confluent Cloud ao 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">
  ## Pré-requisitos
</div>

Pressupomos que você tenha familiaridade com:

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

<div id="the-official-kafka-connector-from-clickhouse-with-confluent-cloud">
  ## O conector Kafka oficial da ClickHouse com a Confluent Cloud
</div>

<div id="create-a-topic">
  #### Criar um tópico
</div>

Criar um tópico no Confluent Cloud é bem simples, e há instruções detalhadas [aqui](https://docs.confluent.io/cloud/current/client-apps/topics/manage.html).

<div id="important-notes">
  #### Notas importantes
</div>

* O nome do tópico do Kafka deve ser o mesmo da tabela do ClickHouse. Para ajustar isso, use um transformador (por exemplo, [`ExtractTopic`](https://docs.confluent.io/platform/current/connect/transforms/extracttopic.html)).
* Mais partições nem sempre significam mais desempenho — consulte nosso próximo guia para mais detalhes e dicas de performance.

<div id="gather-your-connection-details">
  #### Reúna os detalhes da conexão
</div>

Para se conectar ao ClickHouse via HTTP(S), você precisa das seguintes informações:

| Parâmetro(s)              | Descrição                                                                                                         |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `HOST` and `PORT`         | Normalmente, a porta é 8443 ao usar TLS ou 8123 quando não se usa TLS.                                            |
| `DATABASE NAME`           | Por padrão, há um banco de dados chamado `default`; use o nome do banco de dados ao qual você deseja se conectar. |
| `USERNAME` and `PASSWORD` | Por padrão, o nome de usuário é `default`. Use o nome de usuário apropriado para o seu caso de uso.               |

Os detalhes do seu serviço do ClickHouse Cloud estão disponíveis no console do ClickHouse Cloud.
Selecione um serviço e clique em **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="botão Connect do serviço do ClickHouse Cloud" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
  </Frame>
</div>

Escolha **HTTPS**. Os detalhes de conexão são exibidos em um comando `curl` de exemplo.

<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="detalhes de conexão HTTPS do ClickHouse Cloud" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
  </Frame>
</div>

Se você estiver usando ClickHouse autogerenciado, os detalhes de conexão são definidos pelo administrador do seu ClickHouse.

<div id="install-connector">
  #### Instale o conector
</div>

Instale o ClickHouse Sink Connector totalmente gerenciado no Confluent Cloud seguindo a [documentação oficial](https://docs.confluent.io/cloud/current/connectors/cc-clickhouse-sink-connector/cc-clickhouse-sink.html).

<div id="configure-the-connector">
  #### Configure o conector
</div>

Durante a configuração do ClickHouse Sink Connector, você precisará fornecer os seguintes detalhes:

* hostname do seu servidor ClickHouse
* porta do seu servidor ClickHouse (o padrão é 8443)
* nome de usuário e senha do seu servidor ClickHouse
* nome do banco de dados no ClickHouse em que os dados serão gravados
* nome do tópico no Kafka que será usado para gravar dados no ClickHouse

A UI do Confluent Cloud oferece opções avançadas de configuração para ajustar intervalos de polling, tamanhos de lote e outros parâmetros a fim de otimizar o desempenho.

<Note>
  No Confluent Cloud, o ajuste de determinadas configurações, como [configurações de fetch](/docs/pt-BR/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink#fetch-settings) e [configurações de polling](/docs/pt-BR/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink#poll-settings), exige a abertura de um chamado de suporte no Confluent Cloud.
</Note>

<div id="known-limitations">
  #### Limitações conhecidas
</div>

* Consulte a lista de [limitações dos conectores na documentação oficial](https://docs.confluent.io/cloud/current/connectors/cc-clickhouse-sink-connector/cc-clickhouse-sink.html#limitations)