Skip to main content

dbt-fabric

dbt adapter for Microsoft Fabric Synapse Data Warehouse.

The adapter supports dbt-core 1.4 or newer and follows the same versioning scheme. E.g. version 1.1.x of the adapter will be compatible with dbt-core 1.1.x.

Documentation

We've bundled all documentation on the dbt docs site

Installation

This adapter uses mssql-python to connect to Fabric, which bundles its own driver.

Latest version: PyPI

pip install -U dbt-fabric

Performance guidance for large projects

Fabric Warehouse DDL operations (e.g. CREATE TABLE, sp_rename) hold catalog locks that can block sys.tables/sys.views reads from concurrent dbt sessions. With many models and high thread counts this causes list_<schema> steps to stall for minutes.

Strongly recommended for projects with 500+ models or concurrent dbt runs:

# profiles.yml
my_fabric_project:
  target: dev
  outputs:
    dev:
      type: fabric
      # ... connection settings ...
      threads: 4          # keep low (4–8) to reduce catalog lock pressure
      query_timeout: 30   # fail fast on blocked catalog reads (seconds)

In your dbt_project.yml:

flags:
  cache_selected_only: true  # only list schemas for models in the current run

Or pass --no-populate-cache on the CLI for a single run. This prevents dbt from listing every schema in the warehouse upfront, significantly reducing catalog read pressure during concurrent runs.

Changelog

See the changelog

Contributing

Unit tests Integration tests on Azure Publish Docker images for CI/CD

This adapter is Microsoft-maintained. You are welcome to contribute by creating issues, opening or reviewing pull requests. If you're unsure how to get started, check out our contributing guide.

License

PyPI - License

Code of Conduct

This project and everyone involved is expected to follow the Microsoft Code of Conduct.

Download files

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

Source Distribution

dbt_fabric-1.11.0.tar.gz (145.5 kB view details)

Uploaded Source

Built Distribution

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

dbt_fabric-1.11.0-py3-none-any.whl (126.4 kB view details)

Uploaded Python 3

File details

Details for the file dbt_fabric-1.11.0.tar.gz.

File metadata

  • Download URL: dbt_fabric-1.11.0.tar.gz
  • Upload date:
  • Size: 145.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for dbt_fabric-1.11.0.tar.gz
Algorithm Hash digest
SHA256 d719bfb1e09917ad2a1ca48eb73246107afa99808b1ae54b5cb78c86de0435b6
MD5 a1e7abbe7657aa9b700b34adb5d5e81a
BLAKE2b-256 719951194b9e4a709f023c743eb88bbd7d06b70dc6695a6b3a54594c5a5e0641

See more details on using hashes here.

File details

Details for the file dbt_fabric-1.11.0-py3-none-any.whl.

File metadata

  • Download URL: dbt_fabric-1.11.0-py3-none-any.whl
  • Upload date:
  • Size: 126.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for dbt_fabric-1.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d6dbf8303f32fd046534e6e4daf7ac28aa2a3c9fb58b43667abb2dfd0b0cde31
MD5 10153dc386dca546bfb1af48e78bce33
BLAKE2b-256 483bc4daeb3cc3da474ea776b88e21719dea3d1757488b482dacb7ebff8d7d57

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