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