메인 콘텐츠로 건너뛰기
chDB-go는 chDB용 Go 바인딩을 제공하며, 이를 통해 외부 의존성 없이 Go 애플리케이션에서 ClickHouse 쿼리를 직접 실행할 수 있습니다.

설치

1

libchdb 설치

먼저 chDB 라이브러리를 설치합니다:
2

chdb-go 설치

Go 패키지를 설치합니다:
또는 go.mod에 추가합니다:

사용량

명령줄 인터페이스

chDB-go에는 쿼리를 빠르게 실행할 수 있는 CLI가 포함되어 있습니다:

Go 라이브러리 - 빠른 시작

상태를 유지하지 않는 쿼리

간단한 일회성 쿼리의 경우:

session 기반 상태 유지형 쿼리

지속적으로 유지되는 상태가 필요한 복잡한 쿼리의 경우:

SQL 드라이버 인터페이스

chDB-go는 Go의 database/sql 인터페이스를 구현합니다.

대규모 데이터셋을 위한 쿼리 스트리밍

메모리에 모두 올릴 수 없는 대규모 데이터셋을 처리하려면 스트리밍 쿼리를 사용하세요:
쿼리 스트리밍의 장점:
  • 메모리 효율성 - 모든 데이터를 메모리에 로드하지 않고도 대규모 데이터셋을 처리할 수 있습니다
  • 실시간 처리 - 첫 번째 청크가 도착하는 즉시 데이터 처리를 시작할 수 있습니다
  • 취소 지원 - Cancel()을 사용해 장시간 실행되는 쿼리를 취소할 수 있습니다
  • 오류 처리 - 스트리밍 중 Error()로 오류를 확인할 수 있습니다

API 문서

chDB-go는 고수준 API와 저수준 API를 모두 제공합니다.

시스템 요구 사항

  • Go 1.21 이상
  • Linux 및 macOS와 호환