Set up docs MCP사전 요구 사항
To successfully follow this guide, you’ll need the following:
- A running ClickHouse Cloud service. If you don’t have one yet, complete the ClickHouse Cloud quick start first.
또한 연결 정보를 가져오려면 기존 ClickHouse Cloud 서비스가 필요하므로, ClickHouse Cloud 빠른 시작도 완료해야 합니다.
만들 내용
이 빠른 시작에서는 외부 클라이언트, CLI 도구 또는 애플리케이션에서 연결하는 데 필요한 ClickHouse Cloud 서비스의 연결 정보, 즉 호스트명, 포트 번호, 사용자 이름, 비밀번호를 찾는 방법을 알아봅니다.
이 과정을 마치면 Cloud 콘솔에서 이러한 정보를 어디서 확인할 수 있는지와 간단한 curl 명령으로 연결을 검증하는 방법을 알게 되므로 clickhouse-local, clickhouse-client 또는 다른 ClickHouse 드라이버에서 연결할 준비를 마치게 됩니다.
Cloud 콘솔 열기
ClickHouse Cloud 콘솔로 이동한 다음 계정에 로그인하십시오.
기본 대시보드에서 연결하려는 서비스를 찾으십시오. 서비스가 유휴(idled) 상태이면 해당 서비스를 클릭한 뒤 다시 활성화될 때까지 기다렸다가 진행하십시오. 이후 단계에서 연결을 확인하려면 서비스가 실행 중이어야 합니다.
연결 정보 찾기
서비스를 클릭해 세부 정보 페이지를 연 다음, 왼쪽 사이드바에서 Connect 버튼을 클릭하십시오:
이 버튼을 처음 클릭하면 자격 증명이 표시된 대화 상자가 나타납니다:
| 세부 정보 | 설명 |
|---|---|
| Username | 사용자 이름(일반적으로 default) |
| Password | 서비스용으로 생성된 비밀번호 |
또한 여러 프로토콜과 인터페이스(clickhouse-client, HTTPS, JDBC 등)에 맞게 미리 구성된 예시 연결 문자열이 포함된 드롭다운도 제공되며, 이를 바로 복사할 수 있습니다.
서비스 세부 정보 페이지에서 서비스 호스트명도 확인할 수 있습니다(예: abc123.us-east-1.aws.clickhouse.cloud). 자격 증명과 함께 이 값도 복사하십시오. 남은 단계 전체와 이후 빠른 시작에서도 계속 필요합니다.
연결 프로토콜 이해하기
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의 네이티브 프로토콜을 사용합니다.
재사용할 수 있도록 연결 정보 저장하기
이러한 연결 정보는 빠른 시작 전반에서 자주 사용됩니다. 매번 다시 입력하지 않으려면 터미널 세션에서 환경 변수로 내보낼 수 있습니다:
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 뒤에 나오는 호스트명을 복사하십시오.
다음 단계
이제 외부 도구에서 ClickHouse Cloud 서비스에 연결하는 데 필요한 모든 연결 정보를 갖추었습니다. 여기서 확인한 호스트명, 포트, 사용자 이름, 비밀번호는 이후 빠른 시작 시리즈 전반에서 사용됩니다.
다음 빠른 시작도 확인해 보십시오:
또는 참고 문서를 통해 더 자세히 살펴보십시오:
