메인 콘텐츠로 건너뛰기
ClickHouse CLI(clickhousectl)는 ClickHouse Cloud 리소스 관리와 로컬 환경에서의 ClickHouse 개발을 위한 통합 명령줄 도구입니다. 또한 ClickHouse Cloud Postgres 서비스 관리도 지원합니다.

설치

편의를 위해 chctl 별칭이 자동으로 함께 생성됩니다.

Cloud 관리

명령줄에서 직접 ClickHouse Cloud에 인증하고 서비스를 관리할 수 있습니다.

인증

API Key와 시크릿 입력 메시지가 표시되며, 입력한 값은 .clickhouse/credentials.json에 저장됩니다(현재 프로젝트에만 적용되며, git에서는 무시됩니다). 환경 변수도 사용할 수 있습니다:

서비스

Postgres 서비스(베타)

ClickHouse Cloud Postgres 서비스를 생성하고 관리합니다.

조직

API Keys

구성원 및 초대

백업

JSON 출력

--json 플래그를 사용하면 모든 cloud 명령의 응답을 JSON 포맷으로 받을 수 있습니다:

로컬 개발

CLI는 로컬 ClickHouse 설치와 서버도 관리합니다. 로컬 개발을 시작하려면 clickhousectl (CLI) 페이지를 확인하십시오.

요구 사항

  • macOS (aarch64, x86_64) 또는 Linux (aarch64, x86_64)
  • Cloud 명령을 실행하려면 ClickHouse Cloud API Key가 필요합니다
마지막 수정일 2026년 6월 25일