dbt-firebolt
The dbt adapter for Firebolt. dbt-firebolt offers the following benefits to Firebolt customers:
- SQL-based data transformation
- Life cycle management for native Firebolt objects (fact tables, dimension tables, primary indexes, aggregating indexes, join indexes, etc.)
- Declarative, version-controlled data modeling
- Auto-generated data lineage and documentation
dbt-firebolt supports dbt 1.0+.
Installation
Install the dbt-firebolt package from PyPI:
pip install dbt-firebolt
Setup
Connecting to Firebolt
To connect to Firebolt from dbt, you'll need to add a new Firebolt profile to your profiles.yml file. Please see the dbt documentation on Firebolt profiles to set it up.
Setup Recommendations
For the best experience we recommend that you make the following changes to your dbt project:
Feature Support
The table below shows which dbt and Firebolt features are supported by the adapter. dbt-firebolt is under active development and will be gradually unlocking more features over time.
| Feature | Supported |
|---|---|
| Table materializations | ✅ |
| Ephemeral materializations | ✅ |
| View materializations | ✅ |
| Incremental materializations - append | ✅ |
| Incremental materializations - insert_overwrite | ✅ |
| Incremental materializations - delete+insert | ✅ |
| Incremental materializations - merge | ❌ |
| Snapshots | ❌ |
| Seeds | ✅ |
| Tests | ✅ |
| Documentation | ✅ |
| Custom schemas | ❌ (see workaround) |
| Custom databases | ❌ |
| Source freshness | ✅ |
| External tables | ✅ |
| Primary indexes | ✅ |
| Aggregating indexes | ✅ |
| Join indexes | ❌ (syntax supported, but not effective) |
Constraints support
More on constraints in Platform constraint support
| Constraint type | Support | Platform enforcement |
|---|---|---|
| not_null | ✅ Supported | ✅ Enforced |
| primary_key | ❌ Not Supported | ❌ Not enforced |
| foreign_key | ❌ Not Supported | ❌ Not enforced |
| unique | ✅ Supported | ❌ Not enforced |
| check | ❌ Not supported | ❌ Not enforced |
Using dbt-firebolt
For information on configuring dbt models and external tables for Firebolt, see the dbt documentation for Firebolt configurations.
Contributing
See: CONTRIBUTING.MD
Changelog
See our changelog or our release history for more information.
3 maintainers
Metadata
3 maintainers
Release files for dbt-firebolt 1.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dbt_firebolt-1.8.0.tar.gz | 29.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dbt_firebolt-1.8.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 75.7 kB
Release files / dbt_firebolt-1.8.0.tar.gz
| Download URL | dbt_firebolt-1.8.0.tar.gz |
|---|---|
| Size | 29.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
25245279bfc109d492234a42ab918a4512191a601fd52799f32c4bf56576e392
|
|
BLAKE2b-256 checksum How to use checksums |
460abcba9b241d12ec2eba2bdd97afc86af35aad13013bac3b2583fe31b3d970
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.7.17
|
Release files / dbt_firebolt-1.8.0-py3-none-any.whl
| Download URL | dbt_firebolt-1.8.0-py3-none-any.whl |
|---|---|
| Size | 45.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7053d9219bc7ab76ba61e6802cf5943305f2b4106414fadf7d93b0f37d04a875
|
|
BLAKE2b-256 checksum How to use checksums |
fe9015192f4ed65a091712e8ccae104772880bf2c1078eb10ca436512c71a755
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.7.17
|
