퀵 설치
퀵 설치 (Quick install)
한 줄짜리 curl 명령으로 ClickHouse 단일 바이너리를 빠르게 설치해 로컬에서 바로 실험해 보는 방법을 소개합니다. 프로덕션 설치가 필요하지 않을 때 가장 간단한 시작 방법이에요.
출처: 문서
본문
프로덕션용으로 ClickHouse를 설치할 필요가 없다면 curl을 이용한 설치 스크립트를 실행하면 됩니다. 이 스크립트가 사용자 OS에 적합한 바이너리를 결정해 줍니다.
- curl로 ClickHouse 설치
운영 체제에 맞는 단일 바이너리를 내려받으려면 다음 명령을 실행하세요.
curl https://clickhouse.com/ | sh
Linux와 macOS에서는 이 명령이 clickhousectl, 즉 ClickHouse CLI를 ~/.local/bin(chctl 별칭 포함)에 함께 설치합니다. clickhousectl은 여러 로컬 ClickHouse 버전의 설치·관리, 백그라운드 서버 실행, ClickHouse Cloud 관리를 도와줍니다. CLI 기반 워크플로는 clickhousectl 설치 페이지를 참고하세요. clickhousectl 없이 clickhouse 바이너리만 설치하려면 CLICKHOUSE_ONLY=1을 설정하세요:
curl https://clickhouse.com/ | CLICKHOUSE_ONLY=1 sh
Mac 사용자: 바이너리 개발자 인증을 확인할 수 없다는 오류가 발생하면 여기를 참고하세요.
- clickhouse-local 시작
clickhouse-local은 설정 없이 ClickHouse의 강력한 SQL 문법으로 로컬·원격 파일을 처리할 수 있게 해 줍니다. 테이블 데이터는 임시 위치에 저장되므로 clickhouse-local을 재시작하면 이전에 만든 테이블은 더 이상 사용할 수 없습니다. clickhouse-local을 시작하려면 다음 명령을 실행하세요:
./clickhouse
- clickhouse-server 시작
데이터를 영속화하려면 clickhouse-server를 실행하는 것이 좋습니다. 다음 명령으로 ClickHouse 서버를 시작할 수 있습니다:
./clickhouse server
- clickhouse-client 시작
서버가 실행된 상태에서 새 터미널 창을 열고 다음 명령으로 clickhouse-client를 실행하세요:
./clickhouse client
다음과 같은 화면이 보일 것입니다:
./clickhouse client
ClickHouse client version 24.5.1.117 (official build).
Connecting to localhost:9000 as user default.
Connected to ClickHouse server version 24.5.1.
local-host :)
테이블 데이터는 현재 디렉터리에 저장되며 ClickHouse 서버를 재시작해도 계속 사용할 수 있습니다. 필요하다면 ./clickhouse server에 추가 명령줄 인자로 -C config.xml을 넘겨 설정 파일에서 추가 구성을 제공할 수 있습니다. 사용 가능한 모든 설정 항목은 여기와 예제 설정 파일 템플릿에 문서화되어 있습니다. 이제 ClickHouse에 SQL 명령을 보내기 시작할 준비가 되었습니다!
Quick Start 문서가 테이블 생성과 데이터 삽입 단계를 안내합니다.