ClickHouse CLI로 설치하기

ClickHouse CLI로 설치하기 (Install with the ClickHouse CLI)

오피셜 CLI clickhousectl로 로컬 ClickHouse 버전과 서버를 설치·관리하는 방법을 안내합니다. 로컬 개발 환경을 빠르고 반복적으로 세팅할 때 특히 편리해요.

출처: 문서

본문

Windows 사용자: ClickHouse는 Linux와 macOS에서 네이티브로 동작합니다. Windows에서는 이 단계들을 Windows Subsystem for Linux (WSL) 안에서 실행하세요.

ClickHouse CLI(clickhousectl)는 로컬 ClickHouse 버전을 설치·관리하고, 서버를 실행하고, 쿼리를 실행하는 것을 도와줍니다.

  1. ClickHouse CLI 설치
curl https://clickhouse.com/cli | sh

편의를 위해 chctl 별칭(alias)도 자동으로 생성됩니다.

  1. ClickHouse 설치

최신 버전의 ClickHouse를 설치하고 기본값으로 지정합니다:

clickhousectl local use latest

local use는 아직 없으면 해당 버전을 설치하고 기본값으로 설정하며, ~/.local/bin(PATH에 포함)에 clickhouse 심링크를 만들어 clickhouse 바이너리를 직접 호출할 수 있게 합니다. 이후 이 문서에서 실행하는 모든 clickhouse 명령이 그대로 동작합니다. 특정 버전을 선택할 수도 있습니다:

clickhousectl local use 26.5            # Latest 26.5.x.x
clickhousectl local use 26.5.2.39       # Exact version

Use vs install: clickhousectl local use <version>은 버전을 설치하고 그리고 기본값으로 지정해 PATHclickhouse 심링크를 갱신합니다. 기본값을 바꾸거나 심링크를 갱신하지 않고 버전만 내려받으려면 clickhousectl local install <version>을 사용하세요.

  1. clickhouse-server 시작
clickhousectl local server start

서버는 백그라운드에서 실행됩니다. 실행 여부를 확인하려면:

clickhousectl local server list
  1. clickhouse-client 시작
clickhousectl local 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에 SQL 명령을 보내기 시작할 준비가 되었습니다!

Quick Start 문서가 테이블 생성과 데이터 삽입 단계를 안내합니다.

더 알아보기 (Learn more)