ClickHouse client
client-v2라는 새로운 구성 요소로 리팩터링했습니다. 이 구성 요소는 더 명확한 API, 더 가벼운 코드베이스, 더 뛰어난 성능, 그리고 ClickHouse 포맷(RowBinary 및 Native 중심)에 대한 더 나은 지원을 제공합니다. JDBC도 가까운 시일 내에 이 클라이언트를 사용할 예정입니다.
지원되는 데이터 타입
ClickHouse 데이터 타입
부분 지원
- AggregateFunction — 직접 바이너리 읽기에는
groupBitmap만 지원됩니다. 다른 집계 함수(min,max,avg등)의 경우 쿼리에서-Mergecombinator(예:minMerge(),avgMerge())를 사용해 서버 측에서 상태를 해소해야 합니다.AggregateFunction타입 컬럼에는SELECT * FROM table ...를 지원하지 않습니다.
데이터 타입 참고 사항
- Decimal — 일관성을 위해 21.9+에서는
SET output_format_decimal_trailing_zeros=1을 사용합니다. - Enum — 문자열과 정수로 모두 처리할 수 있습니다.
- UInt64 — client-v1에서는
long에 매핑됩니다.
기능
JDBC 드라이버는 기반 클라이언트 구현과 동일한 기능을 지원합니다. 다른 JDBC 기능은 해당 페이지에 나와 있습니다.
호환성
- 이 리포지토리의 모든 프로젝트는 ClickHouse의 모든 현재 활성 LTS 버전에서 테스트됩니다.
- 지원 정책
- 보안 수정과 새로운 개선 사항을 놓치지 않도록 클라이언트를 지속적으로 업그레이드할 것을 권장합니다.
- v2 API로 마이그레이션하는 과정에서 문제가 발생하면 이슈를 생성하세요. 응답해 드리겠습니다.
로깅
Logback이나 Log4j와 같은 SLF4J 호환 로깅 프레임워크는 모두 사용할 수 있습니다.
예를 들어 Maven을 사용하는 경우 pom.xml 파일에 다음 의존성을 추가할 수 있습니다:
pom.xml
로깅 구성
Logback을 사용한다면 logback.xml이라는 파일에서 로깅을 구성할 수 있습니다:
logback.xml