// 무료 도구

ClickHouse 연결 문자열 빌더

하나의 양식에서 HTTP 인터페이스와 네이티브 프로토콜용 ClickHouse 연결 문자열을 만들거나, 하나를 붙여넣어 포트, 프로토콜, TLS 설정을 확인합니다. 모든 처리는 브라우저에서 이뤄집니다: 입력한 내용은 어디로도 전송되지 않습니다.

이 연결을 SQLly에서 열기

필드가 채워진 상태로 SQLly의 연결 편집기를 엽니다.

설계 단계부터 프라이버시를 지킵니다. 빌더와 디코더는 이 탭에서 돌아가는 순수 JavaScript입니다. 입력한 내용으로 요청을 하나도 보내지 않고, 아무것도 저장하지 않으며(브라우저에도 저장하지 않음), 한 번 로드되면 오프라인에서도 계속 작동합니다. SQLly에서 열기 링크는 브라우저에서 컴퓨터의 앱으로 바로 이어집니다.

ClickHouse 연결 문자열 형식

ClickHouse에는 서로 다른 포트에서 동작하는 두 가지 클라이언트 프로토콜이 있습니다: HTTP(8123, 또는 TLS 사용 시 8443)는 JDBC, clickhouse-connect, .NET 드라이버에서 사용되며, 네이티브 TCP 프로토콜(9000, 또는 TLS 사용 시 9440)은 clickhouse-client와 clickhouse-go에서 사용됩니다. 클라이언트를 다른 프로토콜의 포트에 연결하는 것이 가장 흔한 연결 오류입니다.

HTTP URL HTTP 인터페이스, curl

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

네이티브 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

다음과 같은 플레이스홀더 your_password 말 그대로 그 이상도 이하도 아닙니다. 위 양식으로 연결 문자열을 직접 만드세요. SQLly를 ClickHouse에 연결하는 방법 더 알아보기: ClickHouse용 SQLly.

ClickHouse 포트

ClickHouse의 네트워크 포트 안내에서.

키워드동의어기본값기능
8123 - - HTTP 인터페이스.
8443 - - HTTPS 인터페이스.
9000 - - 네이티브 TCP 프로토콜.
9440 - - TLS를 통한 네이티브 프로토콜.
9004 / 9005 - - MySQL 및 PostgreSQL 와이어 호환 인터페이스.

clickhouse-go v2 DSN 매개변수

clickhouse://user:password@host1:9000,host2:9000/database?param=value; http:// 그리고 https:// DSN은 HTTP 인터페이스를 사용합니다.

키워드동의어기본값기능
secure - 거짓 TLS.
skip_verify - 거짓 인증서 검사 건너뛰기.
dial_timeout - 30초 단위를 붙일 수 있는 연결 제한 시간.
read_timeout - 5분 읽기 타임아웃.
compress - - 압축 방식.
connection_open_strategy - - 호스트 선택 방법.

ClickHouse.Driver (.NET) 키

ADO.NET 스타일.

키워드동의어기본값기능
Host - localhost 서버 호스트.
Port - 8123 / 8443 HTTP(S) 포트.
Protocol - http http 또는 https.
Username - default 사용자 이름.
Password - 비어 있음 비밀번호.
Database - 비어 있음 기본 데이터베이스.
Compression - 참 트래픽 압축.
UseSession - 거짓 서버 측 세션을 사용하세요.
Timeout - 120 초.

clickhouse-client 옵션

clickhouse-client는 첫 번째 인수로 연결 문자열도 받을 수 있습니다: clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters].

키워드동의어기본값기능
--host, -h - localhost 서버 호스트.
--port - 9000 (--secure 사용 시 9440) 네이티브 포트.
--user, -u - default 사용자.
--password --ask-password - 비밀번호; --ask-password 프롬프트.
--database, -d - default 데이터베이스.
--secure, -s - - TLS; 포트 9440과 ClickHouse Cloud 호스트에서는 자동으로 켜집니다.

일반적인 ClickHouse 연결 오류

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

이유: HTTP 클라이언트(브라우저, curl, JDBC, clickhouse-connect, .NET)가 네이티브 프로토콜 포트로 접속했습니다.

해결: HTTP는 8123 포트, HTTPS는 8443 포트를 사용하세요.

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

이유: 사용자 이름 또는 비밀번호가 잘못되었거나, 해당 사용자가 현재 주소에서 로그인할 수 없습니다.

해결: 서버의 사용자 구성에서 자격 증명과 사용자의 허용 호스트를 확인하세요.

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

이유: 연결 문자열에 있는 데이터베이스가 존재하지 않습니다.

해결: 확인 SHOW DATABASES 그리고 철자도 확인하세요.

Unexpected packet / connection reset on the native port

이유: 네이티브 프로토콜 클라이언트(clickhouse-client, clickhouse-go)가 HTTP 포트와 통신 중이거나, 일반 클라이언트가 TLS 포트 9440과 통신 중입니다.

해결: TLS 없이는 9000을, 다음과 함께 TLS를 켜면 9440을 쓰세요 --secure / secure=true.

ClickHouse 연결 문자열 FAQ

ClickHouse에는 어떤 포트를 사용해야 하나요?

HTTP 클라이언트(JDBC, clickhouse-connect, .NET, curl)는 8123을 사용하거나 HTTPS의 경우 8443을 사용합니다. 네이티브 클라이언트(clickhouse-client, clickhouse-go 네이티브 DSN)는 9000을 사용하거나 TLS의 경우 9440을 사용합니다. ClickHouse Cloud는 8443과 9440을 제공합니다.

ClickHouse JDBC URL 형식은 무엇인가요?

jdbc:clickhouse:http://host:8123/database 또는 jdbc:clickhouse:https://host:8443/database?ssl=true (드라이버 0.8 이상). 드라이버는 포트로 프로토콜을 추측하지 않으니 포트를 직접 쓰세요.

HTTP URL에 비밀번호를 넣어도 되나요?

URL에 담지 마세요. URL은 로그에 남습니다. 대신 다음에 담아 보내세요 X-ClickHouse-User 그리고 X-ClickHouse-Key 헤더를 쓰거나 HTTP 기본 인증으로.

// 연결 문자열 없이

한 번 연결하세요. 그 뒤는 그냥 SQL만 쓰면 됩니다.

SQLly는 macOS, Windows, Linux용 네이티브 SQL 워크벤치입니다. 연결 편집기에 연결 문자열을 붙여넣고, 비밀번호는 시스템 키체인에 보관하고, ClickHouse 등에서 스키마 인식 IntelliSense를 사용할 수 있습니다.