Skip to main content

Prérequis

Nous supposons que vous connaissez :
Cette page explique comment téléverser vous-même le connector dans Confluent Cloud. Si vous n’avez besoin ni d’une version précise du connector ni de paramètres personnalisés, le connector entièrement géré est plus simple à mettre en place.

Le connector Kafka officiel de ClickHouse en tant que Custom Connector

Installation en tant que Custom Connector

Ce guide a été conçu pour vous aider à démarrer rapidement avec le ClickHouse Sink Connector en tant que Custom Connector sur Confluent Cloud. Pour plus de détails, veuillez consulter la documentation officielle de Confluent.

Créer un topic

La création d’un topic sur Confluent Cloud est assez simple, et des instructions détaillées sont disponibles ici.

Notes importantes

  • Le nom du topic Kafka doit être identique à celui de la table ClickHouse. Pour le modifier, utilisez un transformateur (par exemple ExtractTopic).
  • 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.

Installer le connecteur

Vous pouvez télécharger le connecteur depuis notre dépôt — n’hésitez pas non plus à y soumettre vos commentaires et tickets ! Accédez à “Connector Plugins” -> “Add plugin”, puis utilisez les paramètres suivants :
Exemple :

Récupérez vos informations de connexion

Pour vous connecter à ClickHouse via HTTP(S), vous avez besoin des informations suivantes : Les informations de votre service ClickHouse Cloud sont disponibles dans la console ClickHouse Cloud. Sélectionnez un service, puis cliquez sur Connect :
Bouton Connect du service ClickHouse Cloud
Choisissez HTTPS. Les détails de connexion s’affichent dans un exemple de commande curl.
Détails de connexion HTTPS ClickHouse Cloud
Si vous utilisez ClickHouse autogéré, les détails de connexion sont définis par votre administrateur ClickHouse.

Configurer le connecteur

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

Spécifiez les endpoints de connexion

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
Vous devez spécifier un port HTTP(S). Le connecteur ne prend pas encore en charge le protocole natif.
Lisez la documentation. Tout est prêt !

Limitations connues