ClickHouse-Verbindungszeichenfolgen-Generator
ClickHouse-Verbindungszeichenfolgen für die HTTP-Schnittstelle und das native Protokoll in einem Formular erstellen, oder eine einfügen, um Port, Protokoll und TLS-Einstellungen zu prüfen. Alles läuft in deinem Browser: Nichts, was du eingibst, wird irgendwohin gesendet.
Diese Verbindung in SQLly öffnen
Öffnet den Verbindungseditor von SQLly mit vorausgefüllten Angaben.
Diese Verbindung in SQLly öffnen
Privat von Grund auf. Der Builder und der Decoder sind einfaches JavaScript, das in diesem Tab läuft. Die Seite sendet keine Anfrage mit dem, was du eingibst, speichert nichts (nicht einmal in deinem Browser) und funktioniert weiter offline, sobald sie geladen ist. Der Link „In SQLly öffnen“ geht direkt von deinem Browser zur App auf deinem Computer.
ClickHouse-Verbindungszeichenfolgenformate
ClickHouse hat zwei Client-Protokolle auf verschiedenen Ports: HTTP (8123 oder 8443 mit TLS), verwendet von JDBC, clickhouse-connect und dem .NET-Treiber, und das native TCP-Protokoll (9000 oder 9440 mit TLS), verwendet von clickhouse-client und clickhouse-go. Einen Client auf den Port des anderen Protokolls zu richten, ist der häufigste Verbindungsfehler.
HTTP URL HTTP-Schnittstelle, curl
https://ch.example.com:8443/?database=analytics
Native DSN 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
Platzhalter wie your_password sind genau das: Stell deine eigene Verbindungszeichenfolge mit dem Formular oben zusammen. Mehr dazu, wie du SQLly mit ClickHouse verbindest: SQLly für ClickHouse.
ClickHouse-Ports
Aus ClickHouses Leitfaden zu den Netzwerkports.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
8123 |
- | - | HTTP-Schnittstelle. |
8443 |
- | - | HTTPS-Schnittstelle. |
9000 |
- | - | Natives TCP-Protokoll. |
9440 |
- | - | Natives Protokoll über TLS. |
9004 / 9005 |
- | - | MySQL- und PostgreSQL-Kompatibilitätsschnittstellen. |
clickhouse-go v2 DSN-Parameter
clickhouse://user:password@host1:9000,host2:9000/database?param=value; http:// und https:// DSNs verwenden die HTTP-Schnittstelle.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
secure |
- | falsch | TLS. |
skip_verify |
- | falsch | Zertifikatsprüfungen überspringen. |
dial_timeout |
- | 30s | Verbindungs-Timeout mit einer Einheit. |
read_timeout |
- | 5m | Lese-Timeout. |
compress |
- | - | Komprimierungsmethode. |
connection_open_strategy |
- | - | Wie Hosts ausgewählt werden. |
ClickHouse.Driver (.NET)-Schlüssel
ADO.NET-Stil.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
Host |
- | localhost | Server-Host. |
Port |
- | 8123 / 8443 | HTTP(S)-Port. |
Protocol |
- | http | http oder https. |
Username |
- | Standard | Benutzername. |
Password |
- | leer | Passwort. |
Database |
- | leer | Standarddatenbank. |
Compression |
- | wahr | Datenverkehr komprimieren. |
UseSession |
- | falsch | Serverseitige Sitzung verwenden. |
Timeout |
- | 120 | Sekunden. |
clickhouse-client-Optionen
clickhouse-client nimmt auch eine Verbindungszeichenfolge als erstes Argument: clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters].
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
--host, -h |
- | localhost | Server-Host. |
--port |
- | 9000 (9440 mit --secure) | Nativer Port. |
--user, -u |
- | Standard | Benutzer. |
--password |
--ask-password | - | Passwort; --ask-password fragt ab. |
--database, -d |
- | Standard | Datenbank. |
--secure, -s |
- | - | TLS; wird automatisch für Port 9440 und ClickHouse Cloud-Hosts aktiviert. |
Häufige ClickHouse-Verbindungsfehler
Port 9000 is for clickhouse-client program. You must use port 8123 for HTTP.
Warum: Ein HTTP-Client (Browser, curl, JDBC, clickhouse-connect, .NET) wurde auf den Port des nativen Protokolls ausgerichtet.
Lösung: Verwende 8123 oder 8443 für HTTPS.
Code: 516. DB::Exception: default: Authentication failed: password is incorrect, or there is no user with such name.
Warum: Falscher Benutzer oder falsches Passwort, oder der Benutzer darf sich von deiner Adresse aus nicht anmelden.
Lösung: Prüfe die Anmeldedaten und die erlaubten Hosts des Benutzers in der Benutzerkonfiguration des Servers.
Code: 81. DB::Exception: Database analytics does not exist. (UNKNOWN_DATABASE)
Warum: Die Datenbank in der Zeichenfolge existiert nicht.
Lösung: Prüfen SHOW DATABASES und die Schreibweise.
Unexpected packet / connection reset on the native port
Warum: Ein Native-Protocol-Client (clickhouse-client, clickhouse-go) verbindet sich mit einem HTTP-Port oder ein einfacher Client mit dem TLS-Port 9440.
Lösung: Verwende 9000 ohne TLS oder 9440 mit --secure / secure=true.
ClickHouse-Verbindungszeichenfolgen-FAQ
Welchen Port sollte ich für ClickHouse verwenden?
HTTP-Clients (JDBC, clickhouse-connect, .NET, curl) verwenden 8123 oder 8443 für HTTPS. Native Clients (clickhouse-client, clickhouse-go native DSN) verwenden 9000 oder 9440 für TLS. ClickHouse Cloud bietet 8443 und 9440 an.
Wie lautet das ClickHouse JDBC-URL-Format?
jdbc:clickhouse:http://host:8123/database oder jdbc:clickhouse:https://host:8443/database?ssl=true (Treiber 0.8+). Der Treiber errät das Protokoll nicht am Port, also gib es an.
Kann ich das Passwort in der HTTP-URL angeben?
Vermeiden Sie dies: URLs landen in Logs. Schicken Sie es in den X-ClickHouse-User und X-ClickHouse-Key Headern oder mit HTTP-Basis-Authentifizierung.
Andere Engines
- SQL Server-Verbindungszeichenfolgen
- PostgreSQL-Verbindungszeichenfolgen
- MySQL-Verbindungszeichenfolgen
- MariaDB-Verbindungszeichenfolgen
- SQLite-Verbindungszeichenfolgen
- Oracle-Verbindungszeichenfolgen
- Redis-Verbindungszeichenfolgen
- DuckDB-Verbindungszeichenfolgen
- libSQL-Verbindungszeichenfolgen
- Alle Engines und Formate
- SQL-Formatter
- Alle kostenlosen Tools
Einmal verbinden. Dann einfach SQL schreiben.
SQLLY ist eine native SQL-Workbench für macOS, Windows und Linux. Füge eine Verbindungszeichenfolge in den Verbindungseditor ein, speichere Passwörter in deinem System-Schlüsselbund, und erhalte schemabewusstes IntelliSense für ClickHouse und mehr.