Skip to main content
clickhouse-local은 ClickHouse가 내장된 CLI 도구입니다. 서버를 설치하지 않고도 ClickHouse의 강력한 기능을 사용할 수 있습니다. 이 가이드에서는 chDB를 통해 clickhouse-local 데이터베이스를 사용하는 방법을 알아봅니다.

준비

먼저 가상 환경을 생성합니다:
이제 chDB를 설치하겠습니다. 버전이 2.0.2 이상인지 확인하십시오:
이제 ipython을 설치합니다:
이 가이드의 나머지 부분에서 사용할 명령은 ipython으로 실행하며, 다음을 실행해 시작할 수 있습니다:

clickhouse-local 설치

clickhouse-local의 다운로드 및 설치 방법은 ClickHouse 다운로드 및 설치와 동일합니다. 다음 명령을 실행하십시오.
데이터를 디렉터리에 유지되도록 clickhouse-local을 실행하려면 --path를 지정해야 합니다:

clickhouse-local에 데이터 수집하기

기본 데이터베이스는 데이터를 메모리에만 저장하므로, 수집한 데이터가 디스크에 영구적으로 저장되도록 이름이 있는 데이터베이스를 만들어야 합니다.
테이블(table)을 생성하고 임의의 숫자를 몇 개 삽입해 보겠습니다:
어떤 데이터가 있는지 확인해 보기 위해 쿼리를 작성해 보겠습니다:
이 작업을 완료한 후에는 이 디렉터리의 잠금을 한 번에 하나의 프로세스만 획득할 수 있으므로, CLI에서 반드시 exit;로 종료하십시오. 그렇지 않으면 chDB에서 데이터베이스에 연결하려고 할 때 다음과 같은 오류가 발생합니다:

clickhouse-local 데이터베이스에 연결하기

ipython 셸로 돌아가 chDB에서 session 모듈을 불러옵니다:
demo.chdb를 대상으로 세션을 초기화합니다:
이제 숫자의 분위수를 반환하는 동일한 쿼리를 실행할 수 있습니다:
chDB를 사용해 이 데이터베이스에 데이터를 삽입할 수도 있습니다:
이제 chDB 또는 clickhouse-local에서 분위수 쿼리를 다시 실행할 수 있습니다.
마지막 수정일 2026년 7월 3일