Skip to content

Add ClickHouse support in dbt Core 2.0 #660

Description

@koletzilla

Additional issue related to #555, created to specifically track the development of the ClickHouse adapter in dbt Core 2.0.

Small clarification

  • This repo contains the implementation for dbt Core 1.X (the Python version). This version will continue to be maintained and improved from this repository.
  • dbt Core 2.0 is a full redesign of the dbt engine and lives alongside the adapter implementations in a different repository: https://github.com/dbt-labs/dbt-core. Once production-ready, upgrading will work just like before. Simply update (or build) your dbt binary and you can continue using your existing project!
  • dbt Fusion: This is dbt Core 2.0 plus a set of interesting features, including more intelligent SQL parsing and a VS Code extension https://docs.getdbt.com/docs/fusion/about-fusion. Fusion support is being tracked here: Support dbt Fusion #555.

Current status
ClickHouse is already supported in dbt Core 2.0 and most things are working!

That said, both dbt Core 2.0 and the ClickHouse adapter for that version are in alpha and not production-ready yet. Please be careful when testing so it doesn't interfere with your production workflows or files such as manifest.json.

You can find more details about the (upcoming) upgrade guides here: https://docs.getdbt.com/docs/dbt-versions/core-upgrade/upgrading-to-v2?version=2.0&name=Fusion

What you can expect right now

  • Basic projects should work without issues, but expect some buggy behavior and some inconsistencies.
  • The materialized views (MV) implementation is fairly limited at this stage.

Next steps

  • Support dbt Core 1.12 once released, as it is a prerequisite for upgrading projects to 2.0.
  • Test all existing functionality thoroughly.
  • Complete the MV implementation.
  • Define the criteria for graduating out of the Alpha stage.

We don't have firm dates yet, but we're aiming for a production-ready version of dbt Core 2.0 in the second half of 2026. We'll keep this issue updated. Feel free to ask any questions in the meantime.

Thanks!

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions