// outil gratuit

Générateur de chaînes de connexion ClickHouse

Construisez des chaînes de connexion ClickHouse pour l'interface HTTP et le protocole natif à partir d'un seul formulaire, ou collez-en une pour vérifier le port, le protocole et les paramètres TLS. Tout fonctionne dans votre navigateur : rien de ce que vous tapez n'est envoyé quelque part.

Ouvrir cette connexion dans SQLly

Ouvre l'éditeur de connexion de SQLly, prérempli.

Privé par conception. Le constructeur et le décodeur sont du JavaScript pur fonctionnant dans cet onglet. La page n'envoie aucune requête avec ce que vous tapez, ne stocke rien (pas même dans votre navigateur) et continue de fonctionner hors ligne une fois chargée. Le lien Ouvrir dans SQLly va directement de votre navigateur à l'application sur votre ordinateur.

Formats de chaînes de connexion ClickHouse

ClickHouse dispose de deux protocoles clients sur des ports différents : HTTP (8123, ou 8443 avec TLS), utilisé par JDBC, clickhouse-connect et le pilote .NET, et le protocole TCP natif (9000, ou 9440 avec TLS), utilisé par clickhouse-client et clickhouse-go. Pointer un client vers le port de l'autre protocole est l'erreur de connexion la plus courante.

URL HTTP Interface HTTP, curl

https://ch.example.com:8443/?database=analytics

DSN natif clickhouse-go v2

clickhouse://default:[email protected]:9440/analytics?secure=true

JDBC clickhouse-java 0.8+

jdbc:clickhouse:https://ch.example.com:8443/analytics?user=default&password=your_password&ssl=true

ADO.NET ClickHouse.Driver

Host=ch.example.com;Protocol=https;Username=default;Password=your_password;Database=analytics

Espaces réservés tels que your_password sont exactement cela : construisez votre propre chaîne avec le formulaire ci-dessus. Pour en savoir plus sur la connexion de SQLly à ClickHouse : SQLly pour ClickHouse.

Ports de ClickHouse

Du guide des ports réseau de ClickHouse.

Mot-cléSynonymesPar défautCe que cela fait
8123 - - Interface HTTP.
8443 - - Interface HTTPS.
9000 - - Protocole TCP natif.
9440 - - Protocole natif via TLS.
9004 / 9005 - - Interfaces compatibles avec MySQL et PostgreSQL.

Paramètres DSN de clickhouse-go v2

clickhouse://user:password@host1:9000,host2:9000/database?param=value; http:// et https:// Les DSN utilisent l'interface HTTP.

Mot-cléSynonymesPar défautCe que cela fait
secure - faux TLS.
skip_verify - faux Ignorer les vérifications de certificat.
dial_timeout - 30s Délai de connexion avec une unité.
read_timeout - 5m Délai de lecture dépassé.
compress - - Méthode de compression.
connection_open_strategy - - Comment les hôtes sont choisis.

Clés ClickHouse.Driver (.NET)

Style ADO.NET.

Mot-cléSynonymesPar défautCe que cela fait
Host - localhost Hôte du serveur.
Port - 8123 / 8443 Port HTTP(S).
Protocol - http http ou https.
Username - par défaut Nom d'utilisateur.
Password - vide Mot de passe.
Database - vide Base de données par défaut.
Compression - vrai Compresser le trafic.
UseSession - faux Utiliser une session côté serveur.
Timeout - 120 Secondes.

Options de clickhouse-client

clickhouse-client accepte également une chaîne de connexion comme premier argument : clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters].

Mot-cléSynonymesPar défautCe que cela fait
--host, -h - localhost Hôte du serveur.
--port - 9000 (9440 avec --secure) Port natif.
--user, -u - par défaut Utilisateur.
--password --ask-password - Mot de passe ; --ask-password invite.
--database, -d - par défaut Base de données.
--secure, -s - - TLS ; activé automatiquement pour le port 9440 et les hôtes ClickHouse Cloud.

Erreurs de connexion ClickHouse courantes

Port 9000 is for clickhouse-client program. You must use port 8123 for HTTP.

Pourquoi : Un client HTTP (navigateur, curl, JDBC, clickhouse-connect, .NET) a été pointé vers le port du protocole natif.

Correction : Utilisez 8123, ou 8443 pour HTTPS.

Code: 516. DB::Exception: default: Authentication failed: password is incorrect, or there is no user with such name.

Pourquoi : Utilisateur ou mot de passe incorrect, ou l'utilisateur n'est pas autorisé à se connecter depuis votre adresse.

Correction : Vérifiez les identifiants et les hôtes autorisés de l'utilisateur dans la configuration des utilisateurs du serveur.

Code: 81. DB::Exception: Database analytics does not exist. (UNKNOWN_DATABASE)

Pourquoi : La base de données indiquée dans la chaîne n'existe pas.

Correction : Vérifier SHOW DATABASES et l'orthographe.

Unexpected packet / connection reset on the native port

Pourquoi : Un client en protocole natif (clickhouse-client, clickhouse-go) s’adresse à un port HTTP, ou un client simple au port TLS 9440.

Correction : Utilisez 9000 sans TLS ou 9440 avec --secure / secure=true.

FAQ sur la chaîne de connexion ClickHouse

Quel port utiliser pour ClickHouse ?

Les clients HTTP (JDBC, clickhouse-connect, .NET, curl) utilisent 8123, ou 8443 pour HTTPS. Les clients natifs (clickhouse-client, clickhouse-go DSN natif) utilisent 9000, ou 9440 pour TLS. ClickHouse Cloud utilise 8443 et 9440.

Quel est le format de l'URL JDBC de ClickHouse ?

jdbc:clickhouse:http://host:8123/database ou jdbc:clickhouse:https://host:8443/database?ssl=true (driver 0.8+). Le pilote ne déduit pas le protocole à partir du port, donc précisez-le.

Puis-je mettre le mot de passe dans l'URL HTTP ?

Évitez ça : les URL finissent dans les logs. Envoyez-le dans les X-ClickHouse-User et X-ClickHouse-Key en-têtes, ou avec l'authentification HTTP basique.

// sans passer par les chaînes de connexion

Connectez-vous une fois. Ensuite, écrivez simplement du SQL.

SQLly est un atelier SQL natif pour macOS, Windows et Linux. Collez une chaîne de connexion dans son éditeur de connexion, gardez les mots de passe dans votre trousseau système et profitez d'un IntelliSense conscient du schéma sur ClickHouse et plus encore.