https://github.com/microsoft/dbt-synapse

dbt adapter for Azure Synapse Dedicated SQL Pools
https://github.com/microsoft/dbt-synapse

azure-sql azure-sql-database azure-sql-datawarehouse synapse-analytics tsql

Last synced: 2 days ago
JSON representation

dbt adapter for Azure Synapse Dedicated SQL Pools

• Host: GitHub
• URL: https://github.com/microsoft/dbt-synapse
• Owner: microsoft
• License: mit
• Created: 2020-05-26T23:22:37.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-11-15T18:36:42.000Z (2 months ago)
• Last Synced: 2025-01-22T15:07:12.987Z (4 days ago)
• Topics: azure-sql, azure-sql-database, azure-sql-datawarehouse, synapse-analytics, tsql
• Language: Python
• Homepage: https://dbt-msft.github.io/dbt-msft-docs/docs/dbt-synapse/overview
• Size: 693 KB
• Stars: 70
• Watchers: 9
• Forks: 35
• Open Issues: 22
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

• awesome-synapse - dbt-msft/dbt-synapse - dbt adapter for Synapse Dedicated SQL Pools. (Repositories / Tools & Samples)

README

        
# dbt-synapse

[dbt](https://www.getdbt.com) adapter for Azure Synapse Dedicated SQL Pool (Azure Synapse Data Warehouse).

The adapter supports dbt-core 0.18 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:

* [Profile setup & authentication](https://docs.getdbt.com/reference/warehouse-profiles/azuresynapse-profile)

* [Adapter-specific configuration](https://docs.getdbt.com/reference/resource-configs/azuresynapse-configs)

Join us on the [dbt Slack](https://getdbt.slack.com/archives/C01DRQ178LQ) to ask questions, get help, or to discuss the project.

## Installation

This adapter requires the Microsoft ODBC driver to be installed:

[Windows](https://docs.microsoft.com/nl-be/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-ver16#download-for-windows) |

[macOS](https://docs.microsoft.com/nl-be/sql/connect/odbc/linux-mac/install-microsoft-odbc-driver-sql-server-macos?view=sql-server-ver16) |

[Linux](https://docs.microsoft.com/nl-be/sql/connect/odbc/linux-mac/installing-the-microsoft-odbc-driver-for-sql-server?view=sql-server-ver16)

Debian/Ubuntu



Make sure to install the ODBC headers as well as the driver linked above:

```shell

sudo apt-get install -y unixodbc-dev

```



Latest version: ![PyPI](https://img.shields.io/pypi/v/dbt-synapse?label=latest%20stable&logo=pypi)

```shell

pip install -U dbt-synapse

```

Latest pre-release: ![GitHub tag (latest SemVer pre-release)](https://img.shields.io/github/v/tag/dbt-msft/dbt-synapse?include_prereleases&label=latest%20pre-release&logo=pypi)

```shell

pip install -U --pre dbt-synapse

```

## Changelog

See [the changelog](CHANGELOG.md)

## Contributing

[![Integration tests on Azure](https://github.com/microsoft/dbt-synapse/actions/workflows/integration-tests-azure.yml/badge.svg)](https://github.com/dbt-msft/dbt-sqlserver/actions/workflows/integration-tests-azure.yml)

This adapter is managed by Microsoft.

You are welcome to contribute by creating issues, opening or reviewing pull requests or helping other users in Slack channel.

If you're unsure how to get started, check out our [contributing guide](CONTRIBUTING.md).

This adapter uses the [dbt-sqlserver](https://github.com/dbt-msft/dbt-sqlserver) adapter underneath so make sure to check out that repository as well.

## License

[![PyPI - License](https://img.shields.io/pypi/l/dbt-synapse)](https://github.com/dbt-msft/dbt-synapse/blob/master/LICENSE)

## Code of Conduct

This project and everyone involved is expected to follow the [dbt Code of Conduct](https://community.getdbt.com/code-of-conduct).