Skip to main content
ClickHouse BYOC sur GCP prend en charge deux options de connexion privée : VPC Peering et Private Service Connect. Le trafic circule entièrement au sein du réseau GCP, sans jamais transiter par l’internet public.

​
Prérequis

Étapes communes nécessaires au VPC peering et à Private Service Connect.

​
Activer le load balancer privé pour ClickHouse BYOC

Contactez le support ClickHouse pour activer le load balancer privé.

​
Configurer le VPC peering

Veuillez vous familiariser avec la fonctionnalité de VPC peering de GCP et tenir compte de ses limites (par exemple, les plages IP des sous-réseaux ne peuvent pas se chevaucher entre des réseaux VPC en peering). ClickHouse BYOC utilise un load balancer privé pour permettre la connectivité réseau via le peering vers les services ClickHouse. Pour créer ou supprimer un VPC peering pour ClickHouse BYOC, suivez les étapes suivantes :
Les étapes ci-dessous illustrent un scénario simple. Pour des scénarios plus avancés, comme un peering avec une connectivité on-premise, certains ajustements peuvent être nécessaires.
1

Créer une connexion de peering

Dans cet exemple, nous mettons en place un peering entre le réseau VPC BYOC et un autre réseau VPC existant.
  1. Accédez à « VPC Network » dans le projet Google Cloud ClickHouse BYOC.
  2. Sélectionnez « VPC network peering ».
  3. Cliquez sur « Create connection ».
  4. Renseignez les champs nécessaires selon vos besoins. Vous trouverez ci-dessous une capture d’écran montrant la création d’un peering au sein du même projet GCP.
Le VPC peering GCP nécessite 2 connexions entre les 2 réseaux pour fonctionner (c.-à-d. une connexion du réseau BYOC vers le réseau VPC existant, et une connexion du réseau VPC existant vers le réseau BYOC). Vous devez donc créer de la même façon 1 connexion supplémentaire dans le sens inverse. Vous trouverez ci-dessous une capture d’écran de la création de la deuxième connexion de peering :Une fois les deux connexions créées, leur statut devrait passer à « Active » après actualisation de la page du Google Cloud Console :Le service ClickHouse devrait maintenant être accessible depuis le VPC en peering.
2

Accéder au service ClickHouse via une connexion de peering

Pour accéder à ClickHouse de manière privée, un load balancer privé et un endpoint sont provisionnés afin de fournir une connectivité sécurisée depuis le VPC en peering de l’utilisateur. Le private endpoint suit le format du public endpoint avec un suffixe -private. Par exemple :
  • Public endpoint : h5ju65kv87.mhp0y4dmph.us-east1.gcp.byoc.clickhouse.cloud
  • Private endpoint : h5ju65kv87-private.mhp0y4dmph.us-east1.gcp.byoc.clickhouse.cloud

​
Configurer PSC (Private Service Connect)

GCP PSC (Private Service Connect) fournit une connectivité privée et sécurisée à vos services ClickHouse BYOC, sans nécessiter de VPC peering ni de passerelles Internet.
1

Demander la mise en place du service PSC

Contactez ClickHouse Support pour demander la mise en place du service PSC pour votre déploiement BYOC. Aucune information spécifique n’est requise à ce stade — indiquez simplement que vous souhaitez mettre en place la connectivité PSC.ClickHouse Support activera les composants d’infrastructure nécessaires, notamment l’équilibreur de charge privé et le service PSC.
2

Obtenir le nom du service PSC GCP et le nom DNS

ClickHouse Support vous fournira le nom du service PSC. Vous pouvez également l’obtenir dans la console ClickHouse Cloud, sous “Organization” -> “Infrastructure” ; cliquez sur le nom de l’infrastructure pour afficher les détails.Vous pouvez également trouver le nom du service PSC dans la console Private Service Connect de GCP, sous “Published services” (filtrez par nom de service ou recherchez les services ClickHouse)
3

Créer un point de terminaison PSC dans votre réseau

Une fois que ClickHouse Support a activé le service PSC de son côté, vous devez créer un point de terminaison PSC dans le réseau de votre application cliente afin de vous connecter au service PSC de ClickHouse.
  1. Créer le point de terminaison PSC :
  • Accédez à la GCP Console -> Network Services → Private Service Connect → Connect Endpoint
  • Sélectionnez “Published service” pour “Target”, puis saisissez dans “Target details” le nom du service PSC obtenu à l’étape précédente
  • Saisissez un nom de point de terminaison valide
  • Choisissez votre réseau et sélectionnez les sous-réseaux (il s’agit du réseau à partir duquel votre application cliente se connectera)
  • Choisissez ou créez une nouvelle adresse IP pour le point de terminaison ; cette adresse IP devra être utilisée à l’étape Définir le nom DNS privé pour le point de terminaison
  • Cliquez sur “Add Endpoint”, puis attendez quelques instants que le point de terminaison soit créé.
  • L’état du point de terminaison devrait passer à “Accepted” ; contactez ClickHouse Support si ce n’est pas accepté automatiquement.
  1. Récupérer l’ID de connexion PSC :
4

Définir le nom DNS privé de l’endpoint

Il existe plusieurs façons de configurer le DNS. Configurez-le en fonction de votre cas d’usage.
Vous devez faire pointer tous les sous-domaines (wildcard) du “nom DNS”, récupéré à l’étape Obtain GCP PSC service name and DNS name, vers l’adresse IP de l’endpoint GCP PSC. Cela garantit que les services/composants de votre VPC/réseau peuvent le résoudre correctement.
5

Ajouter l'ID de connexion PSC de l'endpoint à la liste d’autorisation du service

Une fois votre endpoint PSC créé et son statut défini sur “Accepted”, vous devez ajouter l’ID de connexion PSC de l’endpoint à la liste d’autorisation de chaque service ClickHouse auquel vous souhaitez accéder via PSC.Contactez ClickHouse Support:
  • Fournissez les ID de connexion PSC de l’endpoint à ClickHouse Support
  • Précisez quels services ClickHouse doivent autoriser l’accès depuis cet endpoint
  • ClickHouse Support ajoutera les ID de connexion PSC de l’endpoint aux listes d’autorisation des services
6

Se connecter à ClickHouse via PSC

Une fois les ID de connexion de l’endpoint ajoutés à la liste d’autorisation, vous pouvez vous connecter à votre service ClickHouse à l’aide de l’endpoint PSC.Le format de l’endpoint PSC est similaire à celui de l’endpoint public, mais il inclut un sous-domaine p. Par exemple :
  • Endpoint public : h5ju65kv87.mhp0y4dmph.us-east1.gcp.clickhouse-byoc.com
  • Endpoint PSC : h5ju65kv87.p.mhp0y4dmph.us-east1.gcp.clickhouse-byoc.com
Dernière modification le 23 juillet 2026