ClickHouse Cloud 연결 정보 얻기
ClickHouse Cloud 연결 정보 얻기
외부 클라이언트, CLI 도구, 애플리케이션에서 ClickHouse Cloud 서비스에 연결하려면 호스트명·포트·사용자명·비밀번호가 필요해요. 이 퀵스타트에서 Cloud 콘솔에서 그 연결 정보를 찾고, curl 명령으로 연결을 검증하는 방법을 배워요.
본문
사전 요구사항 (Prerequisites)
이 가이드를 성공적으로 따라 하려면 다음이 필요해요:
- 실행 중인 ClickHouse Cloud 서비스. 아직 없다면 ClickHouse Cloud 퀵 스타트를 먼저 완료하세요.
만들게 될 것 (What you'll build)
이 퀵스타트에서는 ClickHouse Cloud 서비스의 연결 정보 — 호스트명, 포트 번호, 사용자명, 비밀번호 — 를 찾는 방법을 배워요. 이 값들은 어떤 외부 클라이언트, CLI 도구, 애플리케이션에서 연결할 때 필요한 것들이에요. 끝나면 Cloud 콘솔에서 이 정보들을 어디서 찾을 수 있는지, 그리고 간단한 curl 명령으로 연결을 어떻게 검증하는지 알게 되어, clickhouse-local, clickhouse-client, 또는 어떤 ClickHouse 드라이버에서든 연결할 준비가 돼요.
1. Cloud 콘솔 열기
ClickHouse Cloud 콘솔로 이동해서 계정에 로그인하세요. 메인 대시보드에서 연결하려는 서비스를 찾으세요. 서비스가 idle 상태라면 클릭해서 깨어날 때까지 기다린 뒤 진행하세요 — 이후 단계에서 연결을 검증할 때 실행 중이어야 하니까요.
2. 연결 정보 찾기
서비스를 클릭해 상세 페이지를 열고, 왼쪽 사이드바의 Connect 버튼을 클릭하세요. 이 버튼을 처음 클릭하면 자격 증명을 보여 주는 대화상자가 나타나요:
| 세부 항목 | 설명 |
|---|---|
| Username | 사용자 이름 (보통 default) |
| Password | 서비스에 대해 생성된 비밀번호 |
또한 다른 프로토콜·인터페이스(예: clickhouse-client, HTTPS, JDBC 등)에 대한 사전 포맷된 예시 연결 문자열이 있는 드롭다운도 있어요. 그대로 복사할 수 있죠.
자격 증명 파일을 내려받거나 비밀번호를 복사해서 안전한 곳에 보관하세요. 이 대화상자를 닫으면 비밀번호를 다시 볼 수 없어요.
서비스 상세 페이지에서 hostname도 찾을 수 있어요 (예: abc123.us-east-1.aws.clickhouse.cloud). 이를 자격 증명과 함께 복사하세요 — 이후 단계와 후속 퀵스타트에서 둘 다 필요해요.
비밀번호를 잊었다면 Cloud 콘솔 서비스의 Settings 탭에서 재설정할 수 있어요.
3. 연결 프로토콜 이해하기
ClickHouse Cloud는 각각 고유한 포트를 가진 두 가지 주요 네트워크 프로토콜을 노출해요:
- 네이티브 프로토콜 (포트 9440) —
clickhouse-client,clickhouse-local, 대부분의 언어별 드라이버가 사용하는 바이너리 프로토콜. 가장 빠른 옵션이고 모든 ClickHouse 기능을 지원해요. Cloud에서는 TLS가 필수예요. - HTTPS 프로토콜 (포트 8443) — REST 클라이언트,
curl, 웹 기반 도구, HTTP를 선호하는 드라이버에 유용한 HTTP 기반 인터페이스. Cloud에서도 TLS가 필요해요.
두 프로토콜 모두 ClickHouse Cloud에 연결할 때 TLS 암호화가 필요해요 — 평문(plaintext)으로는 연결할 수 없어요. 대부분의 도구는 올바른 포트를 지정하면 이를 자동으로 처리하지만, 클라이언트에 따라 --secure 플래그를 넘기거나 ssl=true를 설정해야 할 수도 있어요. 이 시리즈의 대부분의 퀵스타트와 CLI 워크플로에서는 포트 9440의 네이티브 프로토콜을 사용할 거예요.
4. 연결 정보 저장해서 재사용하기
이 연결 정보는 여러 퀵스타트에서 자주 사용할 거예요. 매번 다시 입력하지 않도록 터미널 세션의 환경 변수로 내보낼 수 있어요:
export CLICKHOUSE_HOST=YOUR_HOST.clickhouse.cloud
export CLICKHOUSE_USER=default
export CLICKHOUSE_PASSWORD=YOUR_PASSWORD
값을 실제 호스트명, 사용자명, 비밀번호로 바꾸세요. clickhouse-client나 clickhouse-local로 Cloud 서비스에 연결한다면, "Connect with:" 옆의 드롭다운에서 'Native'를 선택해 호스트명을 얻으세요. 보이는 연결 예시에서 --host 뒤에 나오는 호스트명을 복사하세요.
이 환경 변수는 현재 터미널 세션에서만 유지돼요. 비밀번호를 셸 프로파일 파일(.bashrc, .zshrc)에 저장하거나 버전 관리에 커밋하지 마세요.
다음 단계 (Next steps)
이제 어떤 외부 도구에서든 ClickHouse Cloud 서비스에 연결하는 데 필요한 모든 연결 정보가 준비됐어요. 여기서 찾은 호스트명, 포트, 사용자명, 비밀번호는 퀵스타트 시리즈의 나머지 전체에서 사용돼요. 다음 퀵스타트를 계속 진행해 보세요:
또는 레퍼런스 문서로 더 깊이 들어가 보세요: