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

> Utilisation de ClickHouse Connector Sink avec Kafka Connect et ClickHouse

# Intégration de Confluent Platform à 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érequis
</div>

Nous supposons que vous connaissez :

* [ClickHouse Connector Sink](/docs/fr/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink)
* Confluent Platform et [Custom Connectors](https://docs.confluent.io/cloud/current/connectors/bring-your-connector/overview.html).

<div id="the-official-kafka-connector-from-clickhouse-with-confluent-platform">
  ## Le connecteur Kafka officiel de ClickHouse pour Confluent Platform
</div>

<div id="installing-on-confluent-platform">
  ### Installation sur Confluent Platform
</div>

Ce guide a été conçu pour vous aider à démarrer rapidement avec le ClickHouse Sink Connector sur Confluent Platform.
Pour plus de détails, veuillez consulter la [documentation officielle de Confluent](https://docs.confluent.io/cloud/current/connectors/bring-your-connector/custom-connector-qs.html#uploading-and-launching-the-connector).

<div id="create-a-topic">
  #### Créer un topic
</div>

La création d’un topic sur Confluent Platform est assez simple, et des instructions détaillées sont disponibles [ici](https://docs.confluent.io/cloud/current/client-apps/topics/manage.html).

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

* Le nom du topic Kafka doit être identique à celui de la table ClickHouse. Pour le modifier, utilisez un transformateur (par exemple [`ExtractTopic`](https://docs.confluent.io/platform/current/connect/transforms/extracttopic.html)).
* Un plus grand nombre de partitions n’améliore pas toujours les performances ; consultez notre prochain guide pour plus de détails et de conseils d’optimisation.

<div id="install-connector">
  #### Installer le connecteur
</div>

Vous pouvez télécharger le connecteur depuis notre [dépôt](https://github.com/ClickHouse/clickhouse-kafka-connect/releases) — n'hésitez pas non plus à y soumettre vos commentaires et tickets !

Accédez à "Connector Plugins" -> "Add plugin", puis utilisez les paramètres suivants :

```text theme={null}
'Connector Class' - 'com.clickhouse.kafka.connect.ClickHouseSinkConnector'
'Connector type' - Sink
'Sensitive properties' - 'password'. This will ensure entries of the ClickHouse password are masked during configuration.
```

Exemple :

<Image img="https://mintcdn.com/private-7c7dfe99/pIetLsS_hOGHqoPJ/images/integrations/data-ingestion/kafka/confluent/AddCustomConnectorPlugin.webp?fit=max&auto=format&n=pIetLsS_hOGHqoPJ&q=85&s=5fdb90da6ed384d7e4560bce54acf8ee" size="md" alt="UI de Confluent Platform montrant les paramètres pour ajouter un connecteur ClickHouse personnalisé" border width="552" height="850" data-path="images/integrations/data-ingestion/kafka/confluent/AddCustomConnectorPlugin.webp" />

<div id="gather-your-connection-details">
  #### Récupérez vos informations de connexion
</div>

Pour vous connecter à ClickHouse via HTTP(S), vous avez besoin des informations suivantes :

| Paramètre(s)              | Description                                                                                                                                    |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `HOST` and `PORT`         | En général, le port est 8443 lors de l’utilisation de TLS, ou 8123 sans TLS.                                                                   |
| `DATABASE NAME`           | Par défaut, une base de données nommée `default` est disponible ; utilisez le nom de la base de données à laquelle vous voulez vous connecter. |
| `USERNAME` and `PASSWORD` | Par défaut, le nom d’utilisateur est `default`. Utilisez le nom d’utilisateur adapté à votre cas d’usage.                                      |

Les informations de votre service ClickHouse Cloud sont disponibles dans la console ClickHouse Cloud.
Sélectionnez un service, puis cliquez sur **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="Bouton Connect du service ClickHouse Cloud" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
  </Frame>
</div>

Choisissez **HTTPS**. Les détails de connexion s’affichent dans un exemple de commande `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="Détails de connexion HTTPS ClickHouse Cloud" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
  </Frame>
</div>

Si vous utilisez ClickHouse autogéré, les détails de connexion sont définis par votre administrateur ClickHouse.

<div id="configure-the-connector">
  #### Configurer le connecteur
</div>

Accédez à `Connectors` -> `Add Connector` et utilisez les paramètres suivants (les valeurs ci-dessous sont données à titre d’exemple uniquement) :

```json theme={null}
{
  "database": "<DATABASE_NAME>",
  "errors.retry.timeout": "30",
  "exactlyOnce": "false",
  "schemas.enable": "false",
  "hostname": "<CLICKHOUSE_HOSTNAME>",
  "password": "<SAMPLE_PASSWORD>",
  "port": "8443",
  "ssl": "true",
  "topics": "<TOPIC_NAME>",
  "username": "<SAMPLE_USERNAME>",
  "key.converter": "org.apache.kafka.connect.storage.StringConverter",
  "value.converter": "org.apache.kafka.connect.json.JsonConverter",
  "value.converter.schemas.enable": "false"
}
```

<div id="specify-the-connection-endpoints">
  #### Spécifiez les endpoints de connexion
</div>

Vous devez spécifier la liste d’autorisation des endpoints auxquels le connecteur peut accéder.
Vous devez utiliser un nom de domaine complet (FQDN) lorsque vous ajoutez les endpoints de sortie réseau.
Example: `u57swl97we.eu-west-1.aws.clickhouse.com:8443`

<Note>
  Vous devez spécifier un port HTTP(S). Le connecteur ne prend pas encore en charge le protocole natif.
</Note>

[Lisez la documentation.](https://docs.confluent.io/cloud/current/connectors/bring-your-connector/custom-connector-qs.html#cc-byoc-endpoints)

Tout est prêt !

<div id="known-limitations">
  #### Limitations connues
</div>

* Les Custom Connectors doivent utiliser des endpoints accessibles via l'internet public. Les adresses IP statiques ne sont pas prises en charge.
* Vous pouvez redéfinir certaines propriétés des Custom Connectors. Consultez la [liste dans la documentation officielle.](https://docs.confluent.io/cloud/current/connectors/bring-your-connector/custom-connector-manage.html#override-configuration-properties)
* Les Custom Connectors sont disponibles uniquement dans [certaines régions AWS](https://docs.confluent.io/cloud/current/connectors/bring-your-connector/custom-connector-fands.html#supported-aws-regions)
* Consultez la liste des [limitations des Custom Connectors dans la documentation officielle](https://docs.confluent.io/cloud/current/connectors/bring-your-connector/custom-connector-fands.html#limitations)