-
Notifications
You must be signed in to change notification settings - Fork 984
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Native support for Azure Synapse adapter in dbt Cloud (#5435)
## What are you changing in this pull request and why? Preview launch of native support for Azure Synapse Analytics (ASA) in dbt Cloud plus other changes for May 14 launch - Full [Azure docs plan](https://www.notion.so/dbtlabs/Preview-Azure-Synapse-Analytics-in-dbt-Cloud-f24d9aff4b08472c8d3f586a091cfb62?pvs=4) in Notion - Removed "ASA coming soon" callouts - Add redirect to fix 404 with `https://docs.getdbt.com/docs/verified-adapters` (a deleted page) - Microsoft Fabric GA. Removed all remaining "Public Preview" callouts ## Checklist - [x] Review the [Content style guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md) so my content adheres to these guidelines. - [x] For [docs versioning](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#about-versioning), review how to [version a whole page](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#adding-a-new-version) and [version a block of content](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#versioning-blocks-of-content). - [x] Needs review from PM Adding: ~~- [ ] Add page in `website/sidebars.js`~~ N/A - [x] Provide a unique filename for new pages - [x] Run link testing locally with `npm run build` to update the links that point to deleted pages --------- Co-authored-by: John Rock <[email protected]> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Matt Shaver <[email protected]> Co-authored-by: Leona B. Campbell <[email protected]> Co-authored-by: Amy Chen <[email protected]>
- Loading branch information
1 parent
95c1d2c
commit 9100d28
Showing
14 changed files
with
414 additions
and
21 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
59 changes: 59 additions & 0 deletions
59
website/docs/docs/cloud/connect-data-platform/connect-azure-synapse-analytics.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,59 @@ | ||
--- | ||
title: "Connect Azure Synapse Analytics" | ||
description: "Configure Azure Synapse Analytics connection." | ||
sidebar_label: "Connect Azure Synapse Analytics" | ||
--- | ||
|
||
# Connect Azure Synapse Analytics <Lifecycle status='public preview' /> | ||
|
||
## Supported authentication methods | ||
The supported authentication methods are: | ||
- Microsoft Entra ID service principal | ||
- Active Directory password | ||
- SQL server authentication | ||
|
||
### Microsoft Entra ID service principal | ||
The following are the required fields for setting up a connection with Azure Synapse Analytics using Microsoft Entra ID service principal authentication. | ||
|
||
| Field | Description | | ||
| --- | --- | | ||
| **Server** | The service principal's **Synapse host name** value (without the trailing string `, 1433`) for the Synapse test endpoint. | | ||
| **Port** | The port to connect to Azure Synapse Analytics. You can use `1433` (the default), which is the standard SQL server port number. | | ||
| **Database** | The service principal's **database** value for the Synapse test endpoint. | | ||
| **Authentication** | Choose **Service Principal** from the dropdown. | | ||
| **Tenant ID** | The service principal's **Directory (tenant) ID**. | | ||
| **Client ID** | The service principal's **application (client) ID id**. | | ||
| **Client secret** | The service principal's **client secret** (not the **client secret id**). | | ||
|
||
|
||
### Active Directory password | ||
|
||
The following are the required fields for setting up a connection with Azure Synapse Analytics using Active Directory password authentication. | ||
|
||
| Field | Description | | ||
| --- | --- | | ||
| **Server** | The server hostname to connect to Azure Synapse Analytics. | | ||
| **Port** | The server port. You can use `1433` (the default), which is the standard SQL server port number. | | ||
| **Database** | The database name. | | ||
| **Authentication** | Choose **Active Directory Password** from the dropdown. | | ||
| **User** | The AD username. | | ||
| **Password** | The AD username's password. | | ||
|
||
|
||
### SQL server authentication | ||
|
||
The following are the required fields for setting up a connection with Azure Synapse Analytics using SQL server authentication. | ||
|
||
| Field | Description | | ||
| --- | --- | | ||
| **Server** | The server hostname or IP to connect to Azure Synapse Analytics. | | ||
| **Port** | The server port. You can use `1433` (the default), which is the standard SQL server port number. | | ||
| **Database** | The database name. | | ||
| **Authentication** | Choose **SQL** from the dropdown. | | ||
| **User** | The username. | | ||
| **Password** | The username's password. | | ||
|
||
|
||
## Configuration | ||
|
||
To learn how to optimize performance with data platform-specific configurations in dbt Cloud, refer to [Microsoft Azure Synapse DWH configurations](/reference/resource-configs/azuresynapse-configs). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.