Windows 사용자ClickHouse는 Linux 및 macOS에서 네이티브로 실행됩니다. Windows에서는
Windows Subsystem for Linux (WSL)
환경에서 다음 단계를 실행하십시오.
clickhousectl, 별칭 chctl)는 로컬 ClickHouse 버전을 설치 및 관리하고,
로컬 ClickHouse 및 Postgres 서버를 실행하며, 쿼리를 실행하고, ClickHouse Cloud를 관리합니다.
이 페이지에서는 CLI를 설치하고, 로컬 ClickHouse 서버를 시작하고, 서버에 연결하는 방법을 안내합니다.
빠른 설치 스크립트를 사용했다면
clickhousectl이 이미 설치되어 있으므로
ClickHouse 설치 단계로 바로 이동하십시오.
1
ClickHouse CLI를 설치하십시오
설치 스크립트는 x86_64 및 ARM64 아키텍처의 macOS와 Linux를 지원합니다.이 스크립트는
최신 CLI 릴리스를 확인하고 설치하려면 다음 명령을 실행하세요:
clickhousectl을 ~/.local/bin에 설치하고 같은 위치에 chctl
별칭을 생성합니다. 스크립트에서 ~/.local/bin이 PATH에 없다는 메시지가 표시되면 해당 경로를 PATH에 추가하고,
이후 세션에서도 적용되도록 셸 프로필(~/.bashrc, ~/.zshrc)에도 같은 줄을
추가하십시오.기타 설치 방법
기타 설치 방법
chctl 별칭은 설치 스크립트 또는 npm으로 설치한 경우에만 생성됩니다.2
ClickHouse 설치
ClickHouse 최신 버전을 설치하고 기본 버전으로 설정하세요:다운로드 가능한 마이너 버전과 현재 설치된 버전을
확인하려면 다음 명령을 실행하십시오:
local use는 해당 버전이 아직 설치되어 있지 않으면 설치한 뒤 기본 버전으로 설정하고,
~/.local/bin에 clickhouse 심볼릭 링크를 생성하므로 clickhouse 바이너리를
바로 실행할 수 있습니다. 따라서 ~/.local/bin이 PATH에 포함되어 있다면, 이 문서의 이후 단계에서
실행하는 모든 clickhouse 명령이 별도 수정 없이 그대로 동작합니다.최신 장기 지원(LTS) 릴리스나 특정
버전을 선택할 수도 있습니다.use와 install의 차이
clickhousectl local use <version>은 버전을 설치하는 동시에 해당 버전을
기본 버전으로 설정하고 clickhouse 심볼릭 링크를 업데이트합니다. clickhousectl local install <version>은
버전을 다운로드하기만 합니다. 아직 기본 버전이 없을 때에만 기본 버전으로 설정되며,
심볼릭 링크는 업데이트하지 않습니다. 심볼릭 링크를 생성하거나 업데이트하지 않고
기본 버전만 설정하려면 clickhousectl local use <version> --no-global을 사용하십시오.3
clickhouse-server 시작
clickhousectl은 명령을 실행한 디렉터리 단위로 로컬 서버를 관리합니다. 프로젝트
디렉터리를 생성한 후 해당 디렉터리에서 서버를 시작하세요:default입니다. 서버 데이터는
./.clickhouse/에 저장되므로 이후 clickhousectl local 명령어도 같은
디렉터리에서 실행하십시오. clickhousectl은 상위 디렉터리를 검색하지 않습니다. 서버는
HTTP 포트 8123과 TCP 포트 9000에서 수신 대기하며, 해당 포트가 이미 사용 중이면 비어 있는 다른 포트를 사용합니다.
포트를 직접 지정하려면 --http-port와 --tcp-port를 사용하십시오. 서버를 2개 이상
실행하려면 clickhousectl local server start dev와 같이 서버마다 이름을 지정하십시오.서버가 실행 중인지 확인하려면 다음을 실행하십시오:4
clickhouse-client 시작
같은 디렉터리에서 이제 ClickHouse에 SQL 명령어를 보낼 준비가 되었습니다! 클라이언트를 종료하려면
clickhouse-client로 서버에 연결하십시오:local client는 default라는 이름의 서버에 연결하며, 해당 서버와 동일한
ClickHouse 버전을 사용합니다. 다른 서버에 연결하려면 clickhousectl local client dev와 같이
서버 이름을 인수로 지정하십시오. 다음과 비슷한 출력이 표시됩니다:exit를
입력하십시오.대화형 세션을 시작하지 않고 쿼리 하나만 실행하려면 -q 옵션을 사용하십시오:5
서버를 중지하십시오
서버는 중지하기 전까지 백그라운드에서 계속 실행됩니다. 서버를 시작한
디렉터리에서 다음과 같이 서버를 중지하십시오.서버를 중지해도 데이터는 보존되므로, 다음에
clickhousectl local server start를 실행하면 기존 데이터를 그대로 사용할 수 있습니다.다음 단계
-
로컬에서 Postgres 실행하기. Docker가 실행 중인 상태에서 로컬 Postgres 서버를 시작한 후
psql로 연결하십시오. -
ClickHouse Cloud에 연결하기. 계정을 새로 만들거나 기존 계정으로
로그인하십시오. 브라우저 로그인은 읽기 전용이므로 Cloud 리소스를 생성하거나 변경하려면
API Key가 필요합니다.
clickhousectl cloud auth login --interactive를 실행하면 API Key를 입력하라는 메시지가 표시됩니다. -
CLI의 다른 기능 알아보기. clickhousectl 참고 문서를 확인하거나
clickhousectl --help를 실행하십시오.