dbt-clickhouse, não será descontinuado: nós o mantemos atualizado com os lançamentos do dbt 1.x e mantemos ambos os adaptadores em paralelo.
A documentação do dbt Core 1.x também se aplica ao dbt OSS e ao dbt v2. O adaptador se comporta da mesma forma em ambos os motores: os profiles, configurações de model, materializations e macros descritos nas demais páginas do dbt funcionam sem alterações no dbt OSS, no dbt v2 e na plataforma dbt. As exceções estão documentadas na tabela paridade entre v1 e v2 abaixo.
dbt OSS é a compilação de código aberto (Apache 2.0) do motor v2. Consulte terminologia e disponibilidade para entender como ele se relaciona com o dbt v2 e a plataforma dbt.
Experimente o ClickHouse na plataforma dbt
Se você tiver interesse em testar o beta privado, inscreva-se pelo formulário de beta privado da dbt Labs. O formulário pertence à dbt Labs, portanto as informações enviadas vão para a dbt Labs, e não para a ClickHouse. Depois de habilitado o acesso, siga Connect ClickHouse na documentação do dbt para configurar a conexão.Terminologia e disponibilidade
O dbt está disponível em diversas formas, e o mesmo adapter pode ser executado em mais de uma delas. Esta tabela explica cada nome e o nível atual de suporte do ClickHouse.Status Beta
Avaliamos o adapter dbt v2 em relação ao test suite de integração do dbt Core 1.x dodbt-clickhouse. Beta significa que os workflows principais do dbt e o conjunto de recursos do ClickHouse Cloud funcionam dentro dos limites documentados; a paridade total com a v1 e o suporte a cluster autogerenciado virão depois.
Hoje, o adapter passa em mais de 81% do suite completo da v1 e em 92% dos testes que se aplicam ao ClickHouse Cloud. Todas as materializations estão em paridade (view, table, incremental, materialized_view, dictionary, snapshot, seed, ephemeral), com o conjunto completo de configs de table, contratos de model, testes de dados e unit tests, persistência de documentação, clickhouse_s3source() e as settings de connection do dbt Core 1.x. As falhas restantes estão relacionadas ao trabalho de cluster autogerenciado listado abaixo e a algumas diferenças do lado do motor. Consulte paridade entre v1 e v2 para o panorama recurso por recurso.
Próximos passos: DDL com ON CLUSTER e as materializações distribuídas para clusters autogerenciados, grants, dbt clone, dbt source freshness a partir de metadata de table, correções para os bugs restantes e aprovação no test suite completo da v1 para garantir paridade total. O progresso de tudo isso é acompanhado em ClickHouse/dbt-clickhouse#660, com um sub-issue por área.
GA está no roadmap e chegará em breve. Atualizaremos a documentação assim que estiver pronto.
Fora do escopo do Beta
Além das lacunas de paridade com a v1 listadas abaixo, alguns recursos exclusivos da v2 estão fora do escopo atual, mas chegarão em breve:- Semantic Layer / MetricFlow. O suporte ao ClickHouse ainda não foi adicionado. Acompanhado em dbt-labs/metricflow#2124.
- Inteligência de ClickHouse SQL no dbt v2 (validação com reconhecimento de dialect, análise estática, LSP, reconhecimento de colunas na extensão do VS Code). Atualmente, o adapter é executado com o binary do dbt v2, mas ainda não inclui esses recursos. Até lá, a análise estática é forçada para
offem projetos ClickHouse e o motor não grava linhagem em nível de coluna. Acompanhado em #736. - Métodos de autenticação adicionais além de username e password na plataforma dbt.
Paridade entre v1 e v2
As tabelas abaixo comparam os recursos disponíveis nodbt-clickhouse (v1) com seu status no adapter do dbt v2. Todos os recursos listados são compatíveis na v1, salvo indicação em contrário nas notas; a coluna de status refere-se ao dbt v2 e aplica-se igualmente ao dbt OSS. A evolução de cada item pendente é acompanhada em ClickHouse/dbt-clickhouse#660.
compatível já funciona · parcial funciona com limitações · ainda não implementação pendente.