Skip to main content
Estuary propose un connecteur de matérialisation directe avec ClickHouse, qui utilise le protocole natif et le format natif de ClickHouse. Cela permet à Estuary de :
  • Matérialiser les données dans des instances auto-hébergées et ClickHouse Cloud
  • Gérer automatiquement des tâches telles que la création de tables et l’évolution du schéma
  • Prendre en charge les suppressions logiques ou physiques
  • Utiliser ReplacingMergeTree pour les mises à jour par fusion standard ou MergeTree pour les mises à jour delta
  • Assurer une livraison exactement une fois
Consultez l’intégration Kafka ClickPipe d’Estuary pour un workflow ClickPipes.

Guide de configuration

Prérequis Vous aurez besoin des éléments suivants :
  • Un compte Estuary
  • Une ou plusieurs captures dans Estuary, qui extraient des données des sources de votre choix
  • Une instance ClickHouse auto-hébergée ou un compte ClickHouse Cloud
  • Un utilisateur de base de données ClickHouse disposant des identifiants nécessaires
1

Configurer ClickHouse pour l’intégration

Pour configurer le connecteur ClickHouse d’Estuary, vous devez recueillir certaines informations sur votre instance ClickHouse et configurer les autorisations de l’utilisateur.
  1. Copiez l’endpoint hôte de votre base de données. Pour le port, utilisez 9440 si TLS est activé ou 9000 s’il est désactivé. L’hôte et le port forment ensemble l’adresse à fournir à Estuary.
  2. Accordez les autorisations nécessaires à l’utilisateur de base de données qu’Estuary utilisera. Pour créer et gérer automatiquement les tables, Estuary doit disposer des autorisations CREATE, SELECT, INSERT, etc. sur votre base de données cible, ainsi que des autorisations nécessaires à la découverte des métadonnées et à la gestion des partitions. Vous pouvez accorder toutes les autorisations requises en exécutant les commandes SQL suivantes et en remplaçant <database> et <user> par vos propres valeurs :
  3. Vous pouvez éventuellement limiter l’accès aux tables système de l’utilisateur à la seule base de données cible. Pour ce faire, utilisez des politiques au niveau des lignes. Par exemple :
Vous pouvez ensuite passer à Estuary pour terminer la configuration.
2

Créer une matérialisation Estuary

  1. Dans le tableau de bord Estuary, accédez à la page Destinations.
  2. Cliquez sur + New Materialization.
  3. Sélectionnez le connecteur ClickHouse.
  4. Renseignez la section Materialization Details :
    • Attribuez un nom unique à votre matérialisation
    • Choisissez un plan de données (fournisseur Cloud et région)
  5. Renseignez les détails de Endpoint Config afin qu’Estuary puisse se connecter à votre instance ClickHouse :
    • Address : l’hôte et le port de votre instance
    • Database : le nom de la base de données cible
    • Authentication : le nom d’utilisateur et le mot de passe de l’utilisateur de base de données
    Vous pouvez également configurer des paramètres facultatifs, comme l’utilisation de suppressions définitives et le mode SSL à utiliser.
3

Configurer les collections source

Dans la section Source Collections, choisissez les sources que vous souhaitez matérialiser dans ClickHouse.
  1. Associez une capture existante ou ajoutez des collections de données individuelles à matérialiser dans ClickHouse.
  2. Sélectionnez une collection de données dans la liste pour la configurer davantage si nécessaire. Les options de personnalisation incluent :
    • Choisir un autre nom de table pour la collection
    • Sélectionner le comportement de fusion de la collection (utilisation ou non du mode de mises à jour delta)
    • Personnaliser le comportement de sélection des champs afin de déterminer quels champs sont matérialisés
  3. Une fois satisfait de la manière dont les données seront matérialisées dans ClickHouse, cliquez sur Next, puis sur Save and Publish.
Estuary commencera à charger les données historiques des collections sélectionnées dans ClickHouse, puis diffusera les mises à jour à mesure qu’elles se produisent.

Ressources supplémentaires

Pour en savoir plus sur la configuration d’un connecteur ClickHouse avec Estuary, consultez la documentation d’Estuary :
Dernière modification le 14 août 2026