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

# Se connecter à ClickHouse

> Connectez-vous à vos services ClickHouse BYOC via des endpoints publics, privés ou PrivateLink

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>;
};

Cette page décrit les différentes façons de vous connecter à vos services ClickHouse en BYOC. Vous pouvez choisir entre des load balancers publics, des load balancers privés ou des points de terminaison PrivateLink/Private Service Connect, selon vos exigences en matière de sécurité et de réseau.

<div id="connection-via">
  ## Sélectionner un chemin de connexion dans la console
</div>

Les informations de connexion de chaque service BYOC sont disponibles dans la console ClickHouse Cloud : ouvrez le service et cliquez sur **Connect**.

Pour les services BYOC, la boîte de dialogue **Connect** comprend une liste déroulante **Connection via**. Utilisez-la pour choisir comment vous accédez au service :

* **load balancer public** — le point de terminaison exposé à Internet.
* **load balancer privé** — le point de terminaison interne, accessible via le peering VPC ou des réseaux connectés. Il n'est affiché que lorsqu'un [load balancer privé](#private-load-balancer) est activé pour votre infrastructure.
* **PrivateLink** (AWS) / **Private Service Connect** (GCP) — le nom d'hôte du point de terminaison privé du fournisseur de cloud. Il n'est affiché que lorsque [PrivateLink ou Private Service Connect](#privatelink-or-private-service-connect) est activé.

La sélection d'un chemin met à jour le nom d'hôte dans chaque exemple de connexion de la boîte de dialogue — la commande HTTPS (`curl`), le client natif, JDBC, MySQL et les extraits des clients de langage (Python, Node.js, Java, Go et C#) — afin que vous puissiez copier une commande prête à l'emploi pour le chemin exact dont vous avez besoin, sans modifier le nom d'hôte manuellement.

La liste déroulante n'affiche que les chemins activés pour votre infrastructure, et son contenu est actualisé chaque fois que la boîte de dialogue s'ouvre — un load balancer privé ou un point de terminaison PrivateLink nouvellement activé apparaît la prochaine fois que vous ouvrez **Connect**, sans délai de propagation. Lorsqu'un seul chemin est disponible, la liste déroulante s'affiche comme désactivée, avec ce point de terminaison sélectionné.

<Image img="https://mintcdn.com/private-7c7dfe99/nS3fqaRk31wnsutS/images/cloud/reference/byoc-connect-via.png?fit=max&auto=format&n=nS3fqaRk31wnsutS&q=85&s=4028c9ccc734cae0794b4a62a7fddf4f" size="lg" alt="Boîte de dialogue Connect avec la liste déroulante Connection via développée, affichant les chemins load balancer public, load balancer privé et PrivateLink" background="black" width="1500" height="1060" data-path="images/cloud/reference/byoc-connect-via.png" />

<div id="public-load-balancer">
  ## Public Load Balancer
</div>

Un load balancer public permet d’accéder à vos services ClickHouse via Internet. Il s’agit de la configuration par défaut lorsque vous utilisez un VPC dédié géré par ClickHouse.

<div id="public-load-balancer-overview">
  ### Vue d’ensemble
</div>

* **Accès** : Accessible depuis l’Internet public
* **Cas d’utilisation** : Convient aux applications et aux utilisateurs qui doivent se connecter depuis différents lieux ou réseaux
* **Sécurité** : Protégé par le chiffrement TLS et le filtrage IP (recommandé)

<div id="connecting-via-public-load-balancer">
  ### Connexion via load balancer public
</div>

Pour vous connecter à votre service ClickHouse à l’aide du point de terminaison public :

1. **Récupérez votre point de terminaison de service** dans la console ClickHouse Cloud. Le point de terminaison s’affiche dans la section "Connect" de votre service.

<Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/reference/byoc-connect-1.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=869486bfed0c8ee1b9028e7a08948d91" size="lg" alt="connexion BYOC" background="black" width="2466" height="1742" data-path="images/cloud/reference/byoc-connect-1.webp" />

Par exemple :

```text theme={null}
sb9jmrq2ne.asf3kcggao.ap-southeast-1.aws.clickhouse-byoc.com
```

<div id="public-ip-filtering">
  ### Filtrage IP
</div>

Le filtrage IP (IP Access List) est **fortement recommandé** lorsque vous utilisez un load balancer public afin de limiter l'accès aux adresses IP ou aux plages CIDR autorisées.

Pour plus d'informations sur le filtrage IP, consultez la [documentation sur l’IP Access List](/docs/fr/products/cloud/guides/security/connectivity/setting-ip-filters).

<div id="private-load-balancer">
  ## Load balancer privé
</div>

Un load balancer privé fournit un accès interne à vos services ClickHouse, uniquement depuis vos réseaux connectés (par exemple, des VPC appairés). Il s’agit de la configuration par défaut lorsque vous utilisez un VPC géré par le client.

<div id="public-load-balancer-overview">
  ### Vue d’ensemble
</div>

* **Accès** : Accessible uniquement depuis votre infrastructure réseau privée
* **Cas d’utilisation** : Idéal pour les applications exécutées dans le même environnement Cloud ou connectées via VPC peering
* **Sécurité** : Le trafic reste sur votre réseau privé, sans exposition à l’Internet public

<div id="connecting-via-private-load-balancer">
  ### Connexion via un load balancer privé
</div>

Pour vous connecter via le point de terminaison privé :

1. **Activez le load balancer privé** (s’il n’est pas déjà activé). Contactez ClickHouse Support si vous devez [activer un load balancer privé](/docs/fr/products/bring-your-own-cloud/configuration/configurations#load-balancers) pour votre déploiement.
2. **Vérifiez la connectivité réseau** :
   * Pour le VPC peering : terminez la configuration du VPC peering (voir [Private Networking Setup](/docs/fr/products/bring-your-own-cloud/onboarding/network))
   * Pour les autres réseaux privés : assurez-vous que le routage est configuré pour atteindre le VPC BYOC
3. **Obtenez votre point de terminaison privé** :
   Le point de terminaison privé est disponible dans la console ClickHouse Cloud, dans la section « Connect » de votre service. Il suit le même format que le point de terminaison public, avec le suffixe `-private` ajouté à la partie correspondant à l’ID du service. Par exemple :

   * **Point de terminaison public** : `sb9jmrq2ne.asf3kcggao.ap-southeast-1.aws.clickhouse-byoc.com`
   * **Point de terminaison privé** : `sb9jmrq2ne-private.asf3kcggao.ap-southeast-1.aws.clickhouse-byoc.com`

   Plutôt que de reconstituer manuellement le nom d’hôte avec le suffixe `-private`, sélectionnez **Private load balancer** dans le menu déroulant **Connection via** de la boîte de dialogue **Connect** pour copier directement le point de terminaison ainsi que les commandes de connexion prêtes à l’emploi.

<div id="public-ip-filtering">
  ### Filtrage IP
</div>

Bien que les load balancers privés limitent l’accès aux seuls réseaux internes, vous pouvez tout de même configurer le filtrage IP afin de contrôler plus finement quelles sources, au sein de votre réseau privé, sont autorisées à se connecter. Le filtrage IP pour les load balancers privés repose sur le même mécanisme de configuration que pour les load balancers publics : définissez les adresses IP ou plages CIDR autorisées, et ClickHouse Cloud appliquera ces règles au type de point de terminaison approprié. La plateforme distingue automatiquement les plages CIDR publiques et privées et les associe aux points de terminaison du load balancer correspondants. Consultez la [documentation IP Access List](/docs/fr/products/cloud/guides/security/connectivity/setting-ip-filters).

<div id="security-group-configuration">
  ### Configuration du Security Group
</div>

Pour les déploiements sur AWS, le Security Group du load balancer privé détermine quels réseaux peuvent accéder au point de terminaison. Par défaut, seul le trafic provenant du VPC BYOC est autorisé.

Pour plus de détails, consultez [la configuration du Security Group du load balancer privé](/docs/fr/products/bring-your-own-cloud/configuration/configurations#private-load-balancer-security-group).

<div id="privatelink-or-private-service-connect">
  ## PrivateLink ou Private Service Connect
</div>

AWS PrivateLink et GCP Private Service Connect offrent l’option de connectivité la plus sécurisée et vous permettent d’accéder aux services ClickHouse de manière privée, sans VPC peering ni passerelle Internet.

<div id="public-load-balancer-overview">
  ### Vue d’ensemble
</div>

* **Accès** : connectivité privée via le service géré du fournisseur de cloud
* **Isolation réseau** : le trafic ne transite jamais par l’Internet public
* **Cas d’utilisation** : déploiements Enterprise nécessitant un niveau maximal de sécurité et d’isolation réseau
* **Avantages** :
  * Aucun VPC peering requis
  * Architecture réseau simplifiée
  * Amélioration de la posture de sécurité et de conformité

<div id="connecting-via-privatelink">
  ### Connexion via PrivateLink/Private Service Connect
</div>

Terminez la configuration de PrivateLink ou de Private Service Connect (voir [Private Networking Setup](/docs/fr/products/bring-your-own-cloud/onboarding/network)). Une fois la configuration terminée, vous pouvez vous connecter à votre service ClickHouse à l’aide d’un format de point de terminaison propre à PrivateLink. Le point de terminaison PrivateLink inclut un sous-domaine `vpce` pour indiquer qu’il transite par le point de terminaison VPC. La résolution DNS dans votre VPC achemine automatiquement le trafic via le point de terminaison PrivateLink.

Le format du point de terminaison PrivateLink est similaire à celui du point de terminaison public, mais inclut un sous-domaine `vpce` entre le sous-domaine du service et le sous-domaine de l’infrastructure BYOC. Par exemple :

* **Point de terminaison public** : `h5ju65kv87.mhp0y4dmph.us-west-2.aws.clickhouse-byoc.com`
* **Point de terminaison PrivateLink** : `h5ju65kv87.vpce.mhp0y4dmph.us-west-2.aws.clickhouse-byoc.com`

Une fois le point de terminaison configuré et ajouté à l’allowlist, sélectionnez **PrivateLink** (ou **Private Service Connect** sur GCP) dans la liste déroulante **Connection via** de la boîte de dialogue **Connect** pour copier directement les informations de connexion du point de terminaison privé.

<div id="endpoint-id-allowlist">
  ### Liste d’autorisation des ID de point de terminaison
</div>

Pour utiliser PrivateLink ou Private Service Connect, l’ID du point de terminaison de la connexion client doit être explicitement autorisé pour chaque service ClickHouse. Veuillez contacter ClickHouse Support et fournir vos ID de point de terminaison afin qu’ils soient ajoutés à la liste d’autorisation du service.

Pour obtenir des instructions de configuration détaillées, consultez le [guide Private Networking Setup](/docs/fr/products/bring-your-own-cloud/onboarding/network).

<div id="choosing-connection-method">
  ## Choisir la bonne méthode de connexion
</div>

| Méthode de connexion                    | Niveau de sécurité       | Exigences réseau                         | Cas d’usage                                                |
| --------------------------------------- | ------------------------ | ---------------------------------------- | ---------------------------------------------------------- |
| **Load Balancer public**                | Moyen (avec filtrage IP) | Accès à Internet                         | Applications/utilisateurs répartis sur différents sites    |
| **Load Balancer privé**                 | Élevé                    | VPC peering ou réseau privé              | Applications dans le même environnement Cloud              |
| **PrivateLink/Private Service Connect** | Le plus élevé            | Service géré par le fournisseur de Cloud | Déploiements Enterprise nécessitant une isolation maximale |

<div id="troubleshooting">
  ## Dépannage des problèmes de connexion
</div>

Si vous rencontrez des problèmes de connexion :

1. **Vérifiez l’accessibilité du point de terminaison** : assurez-vous d’utiliser le bon point de terminaison (public ou privé)
2. **Vérifiez les filtres IP** : pour les load balancers publics, vérifiez que votre adresse IP figure dans la liste d’autorisation
3. **Vérifiez la connectivité réseau** : pour les connexions privées, assurez-vous que le VPC peering ou PrivateLink est correctement configuré
4. **Vérifiez les groupes de sécurité** : pour les load balancers privés, vérifiez que les règles des groupes de sécurité autorisent le trafic depuis votre réseau source
5. **Vérifiez les groupes de sécurité** : pour PrivateLink ou Private Service Connect, vérifiez que l’ID du point de terminaison a bien été ajouté à la liste d’autorisation du service ClickHouse
6. **Vérifiez l’authentification** : assurez-vous d’utiliser les bons identifiants (username et password)
7. **Contactez le support** : si les problèmes persistent, contactez ClickHouse Support