Skip to main content

The Clickhouse plugin for dbt (data build tool)

Project description

clickhouse dbt logo

dbt-clickhouse

This plugin ports dbt functionality to Clickhouse.

Documentation

See the ClickHouse website for the full documentation entry.

Installation

Use your favorite Python package manager to install the app from PyPI, e.g.

pip install dbt-core dbt-clickhouse

NOTE: Beginning in v1.8, dbt-core and adapters are decoupled. Therefore, the installation mentioned above explicitly includes both dbt-core and the desired adapter.If you use a version prior to 1.8.0 the pip installation command should look like this:

pip install dbt-clickhouse

Supported features

  • Table materialization
  • View materialization
  • Incremental materialization
  • Microbatch incremental materialization
  • Materialized View materializations (uses the TO form of MATERIALIZED VIEW, experimental)
  • Seeds
  • Sources
  • Docs generate
  • Tests
  • Snapshots
  • Most dbt-utils macros (now included in dbt-core)
  • Ephemeral materialization
  • Distributed table materialization (experimental)
  • Distributed incremental materialization (experimental)
  • Contracts
  • ClickHouse-specific column configurations (Codec, TTL...)
  • ClickHouse-specific table settings (indexes, projections...)

All features up to dbt-core 1.10 are supported, including --sample flag and all deprecation warnings fixed for future releases. Catalog integrations (e.g., Iceberg) introduced in dbt 1.10 are not yet natively supported in the adapter, but workarounds are available. See the Catalog Support section for details.

This adapter is still not available for use inside dbt Cloud, but we expect to make it available soon. Please reach out to support to get more information on this.

Contributing

We welcome contributions from the community to help improve the dbt-ClickHouse adapter. Whether you’re fixing a bug, adding a new feature, or enhancing documentation, your efforts are greatly appreciated!

Please take a moment to read our Contribution Guide to get started. The guide provides detailed instructions on setting up your environment, running tests, and submitting pull requests.

Original Author

ClickHouse wants to thank @silentsokolov for creating this connector and for their valuable contributions.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dbt_clickhouse-1.9.7.tar.gz (48.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dbt_clickhouse-1.9.7-py2.py3-none-any.whl (63.0 kB view details)

Uploaded Python 2Python 3

File details

Details for the file dbt_clickhouse-1.9.7.tar.gz.

File metadata

  • Download URL: dbt_clickhouse-1.9.7.tar.gz
  • Upload date:
  • Size: 48.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for dbt_clickhouse-1.9.7.tar.gz
Algorithm Hash digest
SHA256 63012e44e8112a81f281bf92d30a8a4e03d11e1f46cac3b64ac98c96538936a2
MD5 ab68868140217b2bd5406d3e74c97351
BLAKE2b-256 667e75f20a3b72e9d780233a686d5fefbb95c3a96865716aaeacf5a068fb9493

See more details on using hashes here.

File details

Details for the file dbt_clickhouse-1.9.7-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for dbt_clickhouse-1.9.7-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 33ef74bf88e66c3ea58ce2df19845f36c10133abce9341123c772331887093c3
MD5 5ac54aa8eacdb2205cbb009375d382af
BLAKE2b-256 5b3f250558afa725455158709529133e46e0a53f9e0d6c25a432723ea03dfc91

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page