dbt-clickhouse는 중단되지 않습니다. dbt 1.x 릴리스에 맞춰 최신 상태로 유지하며, 두 어댑터를 병행하여 관리합니다.
dbt Core 1.x 문서는 dbt OSS 및 dbt v2에도 적용됩니다. 어댑터는 두 엔진에서 동일하게 동작합니다. 다른 dbt 페이지에 설명된 프로필, 모델 구성, 머티리얼라이즈, 매크로는 dbt OSS, dbt v2 및 dbt 플랫폼에서 변경 없이 동작합니다. 예외 사항은 아래의 v1 대 v2 동등성 표에 정리되어 있습니다.
dbt OSS는 v2 엔진의 오픈소스(Apache 2.0) 빌드입니다. dbt v2 및 dbt 플랫폼과의 관계는 용어 및 제공 범위를 참조하십시오.
dbt 플랫폼에서 ClickHouse 사용해 보기
프라이빗 베타 테스트에 관심이 있다면 dbt Labs 프라이빗 베타 양식을 통해 신청하십시오. 이 양식은 dbt Labs가 운영하므로, 제출한 정보는 ClickHouse가 아닌 dbt Labs로 전달됩니다. 기능이 활성화되면 dbt 문서의 Connect ClickHouse를 참고하여 연결을 설정하십시오.용어 및 제공 현황
dbt는 여러 형태로 제공되며, 동일한 어댑터가 둘 이상의 형태에서 실행될 수 있습니다. 아래 표는 각 명칭과 현재 ClickHouse 지원 수준을 설명합니다.베타 상태
dbt v2 어댑터는dbt-clickhouse의 dbt Core 1.x 통합 테스트 스위트를 기준으로 검증하고 있습니다. 베타는 핵심 dbt 워크플로와 ClickHouse Cloud 기능 집합이 문서화된 제약 범위 내에서 동작함을 의미하며, 완전한 v1 동등성과 자가 관리형 클러스터 지원은 이후에 제공됩니다.
현재 어댑터는 전체 v1 테스트 스위트의 81% 이상, ClickHouse Cloud에 해당하는 테스트의 92%를 통과합니다. 모든 머티리얼라이즈 방식(view, table, incremental, materialized_view, dictionary, snapshot, seed, ephemeral)이 v1과 동등한 수준이며, 전체 테이블 구성 집합, 모델 계약, 데이터 테스트 및 단위 테스트, 문서 영속화, clickhouse_s3source(), dbt Core 1.x 연결 설정도 모두 지원됩니다. 남은 실패 항목은 아래에 나열된 자가 관리형 클러스터 작업과 일부 엔진 측 차이에서 비롯된 것입니다. 기능별 상세 내용은 v1 대 v2 동등성을 참조하십시오.
다음 단계: 자가 관리형 클러스터를 위한 ON CLUSTER DDL 및 분산 머티리얼라이즈, 권한 부여, dbt clone, 테이블 메타데이터 기반 dbt source freshness, 남은 버그 수정, 그리고 완전한 동등성을 보장하기 위한 전체 v1 테스트 스위트 통과입니다. 이 모든 작업의 진행 상황은 ClickHouse/dbt-clickhouse#660에서 영역별 하위 이슈로 추적되고 있습니다.
일반 제공은 로드맵에 포함되어 있으며 곧 제공될 예정입니다. 준비가 완료되면 문서를 업데이트하겠습니다.
베타 범위에서 제외되는 항목
아래에 나열된 v1 기능 격차 외에도, v2에만 있는 일부 기능은 현재 범위에 포함되지 않지만 곧 제공될 예정입니다:- Semantic Layer / MetricFlow. ClickHouse 지원은 아직 추가되지 않았습니다. dbt-labs/metricflow#2124에서 추적 중입니다.
- dbt v2의 ClickHouse SQL 인텔리전스(방언 인식 유효성 검사, 정적 분석, LSP, VS Code 확장 기능의 컬럼 인식). 어댑터는 현재 dbt v2 바이너리로 실행되지만 아직 이러한 기능은 포함하지 않습니다. 그전까지 ClickHouse 프로젝트에서는 정적 분석이
off로 강제되며, 엔진은 컬럼 수준 계보를 기록하지 않습니다. #736에서 추적 중입니다. - dbt 플랫폼에서 username 및 password 외의 추가 인증 방식.
v1 대 v2 기능 동등성
아래 표는dbt-clickhouse(v1)에서 제공되는 기능과 dbt v2 어댑터에서의 지원 상태를 비교한 것입니다. 참고 사항에 별도로 명시하지 않은 한, 나열된 모든 기능은 v1에서 지원됩니다. 상태 컬럼은 dbt v2를 기준으로 하며, dbt OSS에도 동일하게 적용됩니다. 미구현 항목의 진행 상황은 모두 ClickHouse/dbt-clickhouse#660에서 추적됩니다.
지원됨 현재 동작함 · 부분 지원 제한적으로 동작함 · Not yet 구현 대기 중.