From 2ae834061f313252ac12b364fb6d21969640c60f Mon Sep 17 00:00:00 2001 From: bentsileviav Date: Tue, 3 Nov 2026 11:04:42 +0200 Subject: [PATCH 1/2] docs: clarify what Beta means for the dbt v2 adapter Replace the blanket "not production-ready" warning with a concrete statement: dbt Core 1.x is GA, dbt v2 is Beta with pending features tracked in the parity table, and GA depends on the next steps already on the page. --- docs/dbt-core-v2-fusion-and-platform.mdx | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/dbt-core-v2-fusion-and-platform.mdx b/docs/dbt-core-v2-fusion-and-platform.mdx index b98540eb..eb8c92f2 100644 --- a/docs/dbt-core-v2-fusion-and-platform.mdx +++ b/docs/dbt-core-v2-fusion-and-platform.mdx @@ -18,7 +18,9 @@ dbt is being rebuilt on a new engine, and ClickHouse is part of that from the st ClickHouse is the first community adapter on dbt OSS, dbt v2 and the dbt platform. dbt's own first-party adapters are launching alongside us; we are the first from outside dbt Labs. The dbt Core 1.x Python adapter, `dbt-clickhouse`, is not going away: we keep it current with dbt 1.x releases and maintain both adapters in parallel. -**Not production-ready.** The ClickHouse adapter for dbt OSS and dbt v2, and the dbt platform connection, are not yet generally available (GA). Use them only in development or staging projects. +**Beta, not yet GA.** The ClickHouse adapter for dbt OSS and dbt v2 is in Beta, and the dbt platform connection is in Private Beta. The dbt Core 1.x adapter, `dbt-clickhouse`, is GA and supported for production use; nothing on this page changes that. + +Beta means that every materialization (including `incremental` with all its strategies), model contracts, data and unit tests and the ClickHouse Cloud feature set work today and pass the dbt Core 1.x integration test suite. The features that are still pending are listed in [v1 vs v2 parity](#parity) and that list shrinks with every release. We recommend evaluating dbt v2 in development or staging first, and keeping production on dbt Core 1.x if your project depends on any of the pending features or you need the guarantees of a GA release. @@ -54,7 +56,7 @@ We measure the dbt v2 adapter against the dbt Core 1.x integration test suite of **Next steps**: `ON CLUSTER` DDL and the distributed materializations for self-managed clusters, grants, `dbt clone`, `dbt source freshness` from table metadata, fixes for the remaining bugs and passing the full v1 test suite to ensure full parity. The progress of all of these is tracked in [ClickHouse/dbt-clickhouse#660](https://github.com/ClickHouse/dbt-clickhouse/issues/660), with one sub-issue per area. -GA is on the roadmap and will come soon. We'll update the docs once it's ready. +GA follows once the next steps above are complete and the full v1 test suite passes. Progress is public in [ClickHouse/dbt-clickhouse#660](https://github.com/ClickHouse/dbt-clickhouse/issues/660), and we'll update this page when it's ready. ### Out of scope for Beta {#out-of-scope} From 05bf872989e16646150ec9059b5e29819d78af3a Mon Sep 17 00:00:00 2001 From: bentsileviav Date: Tue, 3 Nov 2026 11:08:22 +0200 Subject: [PATCH 2/2] docs: keep the GA timeline open --- docs/dbt-core-v2-fusion-and-platform.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/dbt-core-v2-fusion-and-platform.mdx b/docs/dbt-core-v2-fusion-and-platform.mdx index eb8c92f2..f2b0d440 100644 --- a/docs/dbt-core-v2-fusion-and-platform.mdx +++ b/docs/dbt-core-v2-fusion-and-platform.mdx @@ -56,7 +56,7 @@ We measure the dbt v2 adapter against the dbt Core 1.x integration test suite of **Next steps**: `ON CLUSTER` DDL and the distributed materializations for self-managed clusters, grants, `dbt clone`, `dbt source freshness` from table metadata, fixes for the remaining bugs and passing the full v1 test suite to ensure full parity. The progress of all of these is tracked in [ClickHouse/dbt-clickhouse#660](https://github.com/ClickHouse/dbt-clickhouse/issues/660), with one sub-issue per area. -GA follows once the next steps above are complete and the full v1 test suite passes. Progress is public in [ClickHouse/dbt-clickhouse#660](https://github.com/ClickHouse/dbt-clickhouse/issues/660), and we'll update this page when it's ready. +GA is on the roadmap. We are working with dbt Labs on the timeline and will update this page when it's ready. ### Out of scope for Beta {#out-of-scope}