chDB는 ClickHouse v25.8.2.1 기반의 빠른 인프로세스 SQL OLAP 엔진입니다. 프로그래밍 언어 환경에서 ClickHouse 서버에 연결하지 않고도 ClickHouse의 강력한 기능을 활용하려는 경우 사용할 수 있습니다.
주요 기능
- 인프로세스 SQL OLAP 엔진 - ClickHouse 기반으로 동작하므로 ClickHouse 서버를 별도로 설치할 필요가 없습니다
- 다양한 데이터 포맷 - Parquet, CSV, JSON, Arrow, ORC 및 70개 이상의 추가 포맷에 대한 입력 및 출력 지원
- 최소화된 데이터 복사 - python memoryview를 사용해 C++에서 Python으로의 데이터 복사를 최소화합니다
- 풍부한 Python 생태계 통합 - Pandas, Arrow, DB API 2.0을 네이티브로 지원하며 기존 데이터 과학 워크플로에 자연스럽게 통합됩니다
- 의존성 없음 - 외부 데이터베이스를 별도로 설치할 필요가 없습니다
- DataStore API - SQL 최적화를 갖춘 Pandas 호환 API로, 630개 이상의 메서드를 지원합니다
DataStore: Pandas 호환 API
NEW! DataStore는 익숙한 pandas 구문과 ClickHouse의 성능을 결합한 pandas 호환 API를 제공합니다.
한 줄로 마이그레이션
# Just change your import - your pandas code works unchanged
- import pandas as pd
+ from chdb import datastore as pd
df = pd.read_csv("data.csv")
result = df[df['age'] > 25].groupby('city')['salary'].mean()성능 하이라이트
| 작업 | pandas | DataStore | 성능 향상 |
|---|---|---|---|
| GroupBy count | 347ms | 17ms | 19.93x |
| 복잡한 파이프라인 | 2,047ms | 380ms | 5.39x |
| Filter+Sort+Head | 1,537ms | 350ms | 4.40x |
1,000만 행 벤치마크
DataStore 주요 기능
- 630개 이상의 API 메서드 - 209개의 Pandas 데이터프레임 메서드, 185개 이상의 Accessor 메서드
- 지연 실행 - 연산이 최적화된 SQL로 컴파일됩니다
- SQL 푸시다운 - 필터와 집계가 데이터 소스에서 실행됩니다
- 범용 데이터 소스 - 파일, S3, 데이터베이스, 데이터 레이크에서 읽을 수 있습니다
자세히 알아보기: DataStore 문서
chDB에서 지원하는 언어는 무엇입니까?
chDB는 다음 언어 바인딩을 제공합니다:
어떻게 시작하면 되나요?
- Go, Rust, NodeJS, Bun, 또는 C 및 C++를 사용하는 경우 해당 언어 페이지를 확인하세요.
- Python을 사용하는 경우 시작하기 개발자 가이드 또는 chDB 온디맨드 과정을 확인하세요.
pandas 사용자를 위한 안내
익숙한 pandas 사용성과 ClickHouse의 성능을 함께 제공하는 DataStore API부터 시작하십시오:
- DataStore 빠른 시작 - 설치 및 한 줄로 마이그레이션
- pandas에서 마이그레이션 - 단계별 마이그레이션 가이드
- Pandas Cookbook - 일반적인 패턴
- 주요 차이점 - pandas와의 주요 차이점
- 성능 가이드 - 최적화 팁
DataStore API 참조
- 팩토리 메서드 - 파일, 데이터베이스, 클라우드 스토리지에서 생성
- 쿼리 작성 - SQL 스타일 연산
- Pandas 호환성 - 호환 메서드 209개
- Accessor - .str, .dt, .arr, .json, .url, .ip, .geo
- 구성 - 엔진, 로깅, 프로파일링
- 디버깅 - explain(), 프로파일링, 로깅
SQL API 가이드
- Python API 참조 - 전체 SQL API 문서
- JupySQL
- Pandas 쿼리하기
- Apache Arrow 쿼리하기
- S3의 데이터 쿼리하기
- Parquet 파일 쿼리하기
- 원격 ClickHouse 쿼리하기
- clickhouse-local 데이터베이스 사용하기
소개 영상
chDB의 간단한 소개를 시청하고, ClickHouse의 강력한 기능을 Python 환경으로 가져오는 방법을 알아보십시오:
성능 벤치마크
chDB는 다양한 환경에서 뛰어난 성능을 제공합니다:
- 내장 엔진의 ClickBench - SQL API 성능 비교
- DataFrame Benchmark - DataFrame 엔진 비교
- DataStore와 Pandas 비교 - 일반적인 작업에서 pandas보다 최대 20배 빠름

chDB 소개
- blog에서 chDB 프로젝트가 탄생한 전체 이야기를 읽어보세요
- Blog에서 chDB와 활용 사례를 알아보세요
- chDB 온디맨드 과정을 수강하세요
- codapi examples를 사용해 브라우저에서 chDB를 살펴보세요
- 더 많은 예시는 (https://github.com/chdb-io/chdb/tree/main/examples)에서 확인하세요
라이선스
chDB는 Apache License 2.0에 따라 제공됩니다. 자세한 내용은 LICENSE를 참조하십시오.