Cloud 연결 정보 확인 - ClickHouse Documentation

실시간 분석데이터 웨어하우징관측성AI/MLCloud

사전 요구 사항

To successfully follow this guide, you’ll need the following:

A running ClickHouse Cloud service. If you don’t have one yet, complete the Create your first Cloud service quickstart first.

또한 연결 정보를 가져오려면 기존 ClickHouse Cloud 서비스가 필요하므로, 첫 번째 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). 자격 증명과 함께 이 값도 복사하십시오. 남은 단계 전체와 이후 빠른 시작에서도 계속 필요합니다.

비밀번호를 분실한 경우 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 뒤에 나오는 호스트명을 복사하십시오.

이러한 환경 변수는 현재 터미널 세션에서만 유지됩니다. 비밀번호를 셸 프로필 파일(.bashrc, .zshrc)에 저장하거나 버전 관리에 커밋하지 마십시오.

다음 단계

이제 외부 도구에서 ClickHouse Cloud 서비스에 연결하는 데 필요한 모든 연결 정보를 갖추었습니다. 여기서 확인한 호스트명, 포트, 사용자 이름, 비밀번호는 이후 빠른 시작 시리즈 전반에서 사용됩니다. 다음 빠른 시작도 확인해 보십시오:

또는 참고 문서를 통해 더 자세히 살펴보십시오:

ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level — Check out the ClickHouse academy for on-demand and live training

모든 빠른 시작

​사전 요구 사항

​만들 내용

​Cloud 콘솔 열기

​연결 정보 찾기

​연결 프로토콜 이해하기

​재사용할 수 있도록 연결 정보 저장하기

​다음 단계

사전 요구 사항

만들 내용

Cloud 콘솔 열기

연결 정보 찾기

연결 프로토콜 이해하기

재사용할 수 있도록 연결 정보 저장하기

다음 단계