// kostenloses Werkzeug

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.

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üsselwortSynonymeStandardWas 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üsselwortSynonymeStandardWas 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üsselwortSynonymeStandardWas 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üsselwortSynonymeStandardWas 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.

// ganz ohne Verbindungszeichenfolgen

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.