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.
Ouvrir cette connexion dans SQLly
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é | Synonymes | Par défaut | Ce 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é | Synonymes | Par défaut | Ce 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é | Synonymes | Par défaut | Ce 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é | Synonymes | Par défaut | Ce 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.
Autres moteurs
- Chaînes de connexion SQL Server
- Chaînes de connexion PostgreSQL
- Chaînes de connexion MySQL
- Chaînes de connexion MariaDB
- Chaînes de connexion SQLite
- Chaînes de connexion Oracle
- Chaînes de connexion Redis
- Chaînes de connexion DuckDB
- Chaînes de connexion libSQL
- Tous les moteurs et formats
- Formateur SQL
- Tous les outils gratuits
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.