Skip to content

Commit b5c27c9

Browse files
authored
Fast-follows for MS Fabric docs (#4538)
## What are you changing in this pull request and why? Microsoft Fabric docs fast-follows - Create new dbt Cloud MS Fabric connect page and link to it from https://docs.getdbt.com/docs/cloud/connect-data-platform/about-connections - Add new dbt Cloud MS Fabric connect page to sidebar - Update this page https://docs.getdbt.com/docs/core/connect-data-platform/fabric-setup to say it's supported in dbt Cloud - Add link to MS Fabric on https://docs.getdbt.com/docs/core/connect-data-platform/about-core-connections - Update tile in verified adapters to point to new connect page - Update quickstart - Update release note ## 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). - [ ] Needs review from DX Adding new pages (delete if not applicable): - [x] Add page to `website/sidebars.js` - [x] Provide a unique filename for the new page
2 parents f484d26 + 43a0e13 commit b5c27c9

File tree

8 files changed

+62
-11
lines changed

8 files changed

+62
-11
lines changed

website/docs/docs/cloud/connect-data-platform/about-connections.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,15 @@ title: "About data platform connections"
33
id: about-connections
44
description: "Information about data platform connections"
55
sidebar_label: "About data platform connections"
6-
pagination_next: "docs/cloud/connect-data-platform/connect-starburst-trino"
6+
pagination_next: "docs/cloud/connect-data-platform/connect-microsoft-fabric"
77
pagination_prev: null
88
---
99
dbt Cloud can connect with a variety of data platform providers including:
1010
- [Amazon Redshift](/docs/cloud/connect-data-platform/connect-redshift-postgresql-alloydb)
1111
- [Apache Spark](/docs/cloud/connect-data-platform/connect-apache-spark)
1212
- [Databricks](/docs/cloud/connect-data-platform/connect-databricks)
1313
- [Google BigQuery](/docs/cloud/connect-data-platform/connect-bigquery)
14+
- [Microsoft Fabric](/docs/cloud/connect-data-platform/connect-microsoft-fabric)
1415
- [PostgreSQL](/docs/cloud/connect-data-platform/connect-redshift-postgresql-alloydb)
1516
- [Snowflake](/docs/cloud/connect-data-platform/connect-snowflake)
1617
- [Starburst or Trino](/docs/cloud/connect-data-platform/connect-starburst-trino)
Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
---
2+
title: "Connect Microsoft Fabric"
3+
description: "Configure Microsoft Fabric connection."
4+
sidebar_label: "Connect Microsoft Fabric"
5+
---
6+
7+
## Supported authentication methods
8+
The supported authentication methods are:
9+
- Azure Active Directory (Azure AD) service principal
10+
- Azure AD password
11+
12+
SQL password (LDAP) is not supported in Microsoft Fabric Synapse Data Warehouse so you must use Azure AD. This means that to use [Microsoft Fabric](https://www.microsoft.com/en-us/microsoft-fabric) in dbt Cloud, you will need at least one Azure AD service principal to connect dbt Cloud to Fabric, ideally one service principal for each user.
13+
14+
### Active Directory service principal
15+
The following are the required fields for setting up a connection with a Microsoft Fabric using Azure AD service principal authentication.
16+
17+
| Field | Description |
18+
| --- | --- |
19+
| **Server** | The service principal's **host** value for the Fabric test endpoint. |
20+
| **Port** | The port to connect to Microsoft Fabric. You can use `1433` (the default), which is the standard SQL server port number. |
21+
| **Database** | The service principal's **database** value for the Fabric test endpoint. |
22+
| **Authentication** | Choose **Service Principal** from the dropdown. |
23+
| **Tenant ID** | The service principal's **Directory (tenant) ID**. |
24+
| **Client ID** | The service principal's **application (client) ID id**. |
25+
| **Client secret** | The service principal's **client secret** (not the **client secret id**). |
26+
27+
28+
### Active Directory password
29+
30+
The following are the required fields for setting up a connection with a Microsoft Fabric using Azure AD password authentication.
31+
32+
| Field | Description |
33+
| --- | --- |
34+
| **Server** | The server hostname to connect to Microsoft Fabric. |
35+
| **Port** | The server port. You can use `1433` (the default), which is the standard SQL server port number. |
36+
| **Database** | The database name. |
37+
| **Authentication** | Choose **Active Directory Password** from the dropdown. |
38+
| **User** | The AD username. |
39+
| **Password** | The AD username's password. |
40+
41+
## Configuration
42+
43+
To learn how to optimize performance with data platform-specific configurations in dbt Cloud, refer to [Microsoft Fabric DWH configurations](/reference/resource-configs/fabric-configs).

website/docs/docs/core/connect-data-platform/about-core-connections.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ dbt Core can connect with a variety of data platform providers including:
1414
- [Apache Spark](/docs/core/connect-data-platform/spark-setup)
1515
- [Databricks](/docs/core/connect-data-platform/databricks-setup)
1616
- [Google BigQuery](/docs/core/connect-data-platform/bigquery-setup)
17+
- [Microsoft Fabric](/docs/core/connect-data-platform/fabric-setup)
1718
- [PostgreSQL](/docs/core/connect-data-platform/postgres-setup)
1819
- [Snowflake](/docs/core/connect-data-platform/snowflake-setup)
1920
- [Starburst or Trino](/docs/core/connect-data-platform/trino-setup)

website/docs/docs/core/connect-data-platform/fabric-setup.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ meta:
88
github_repo: 'Microsoft/dbt-fabric'
99
pypi_package: 'dbt-fabric'
1010
min_core_version: '1.4.0'
11-
cloud_support: Not Supported
11+
cloud_support: Supported
1212
platform_name: 'Microsoft Fabric'
1313
config_page: '/reference/resource-configs/fabric-configs'
1414
---

website/docs/docs/dbt-versions/release-notes/02-Nov-2023/microsoft-fabric-support-rn.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,9 @@ date: 2023-11-28
99

1010
Public Preview is now available in dbt Cloud for Microsoft Fabric!
1111

12-
To learn more, check out the [Quickstart for dbt Cloud and Microsoft Fabric](/guides/microsoft-fabric?step=1). The guide walks you through:
12+
To learn more, refer to [Connect Microsoft Fabric](/docs/cloud/connect-data-platform/connect-microsoft-fabric) and [Microsoft Fabric DWH configurations](/reference/resource-configs/fabric-configs).
13+
14+
Also, check out the [Quickstart for dbt Cloud and Microsoft Fabric](/guides/microsoft-fabric?step=1). The guide walks you through:
1315

1416
- Loading the Jaffle Shop sample data (provided by dbt Labs) into your Microsoft Fabric warehouse.
1517
- Connecting dbt Cloud to Microsoft Fabric.

website/docs/guides/microsoft-fabric-qs.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ recently_updated: true
99
---
1010
## Introduction
1111

12-
In this quickstart guide, you'll learn how to use dbt Cloud with Microsoft Fabric. It will show you how to:
12+
In this quickstart guide, you'll learn how to use dbt Cloud with [Microsoft Fabric](https://www.microsoft.com/en-us/microsoft-fabric). It will show you how to:
1313

1414
- Load the Jaffle Shop sample data (provided by dbt Labs) into your Microsoft Fabric warehouse.
1515
- Connect dbt Cloud to Microsoft Fabric.
@@ -27,7 +27,7 @@ A public preview of Microsoft Fabric in dbt Cloud is now available!
2727
### Prerequisites
2828
- You have a [dbt Cloud](https://www.getdbt.com/signup/) account.
2929
- You have started the Microsoft Fabric (Preview) trial. For details, refer to [Microsoft Fabric (Preview) trial](https://learn.microsoft.com/en-us/fabric/get-started/fabric-trial) in the Microsoft docs.
30-
- As a Microsoft admin, you’ve enabled service principal authentication. For details, refer to [Enable service principal authentication](https://learn.microsoft.com/en-us/fabric/admin/metadata-scanning-enable-read-only-apis) in the Microsoft docs. dbt Cloud needs these authentication credentials to connect to Microsoft Fabric.
30+
- As a Microsoft admin, you’ve enabled service principal authentication. You must add the service principal to the Microsoft Fabric workspace with either a Member (recommended) or Admin permission set. For details, refer to [Enable service principal authentication](https://learn.microsoft.com/en-us/fabric/admin/metadata-scanning-enable-read-only-apis) in the Microsoft docs. dbt Cloud needs these authentication credentials to connect to Microsoft Fabric.
3131

3232
### Related content
3333
- [dbt Courses](https://courses.getdbt.com/collections)
@@ -54,8 +54,8 @@ A public preview of Microsoft Fabric in dbt Cloud is now available!
5454
CREATE TABLE dbo.customers
5555
(
5656
[ID] [int],
57-
[FIRST_NAME] [varchar] (8000),
58-
[LAST_NAME] [varchar] (8000)
57+
\[FIRST_NAME] [varchar](8000),
58+
\[LAST_NAME] [varchar](8000)
5959
);
6060

6161
COPY INTO [dbo].[customers]
@@ -72,7 +72,7 @@ A public preview of Microsoft Fabric in dbt Cloud is now available!
7272
[USER_ID] [int],
7373
-- [ORDER_DATE] [int],
7474
[ORDER_DATE] [date],
75-
[STATUS] [varchar] (8000)
75+
\[STATUS] [varchar](8000)
7676
);
7777

7878
COPY INTO [dbo].[orders]
@@ -87,8 +87,8 @@ A public preview of Microsoft Fabric in dbt Cloud is now available!
8787
(
8888
[ID] [int],
8989
[ORDERID] [int],
90-
[PAYMENTMETHOD] [varchar] (8000),
91-
[STATUS] [varchar] (8000),
90+
\[PAYMENTMETHOD] [varchar](8000),
91+
\[STATUS] [varchar](8000),
9292
[AMOUNT] [int],
9393
[CREATED] [date]
9494
);
@@ -108,6 +108,9 @@ A public preview of Microsoft Fabric in dbt Cloud is now available!
108108
2. Enter a project name and click **Continue**.
109109
3. Choose **Fabric** as your connection and click **Next**.
110110
4. In the **Configure your environment** section, enter the **Settings** for your new project:
111+
- **Server** — Use the service principal's **host** value for the Fabric test endpoint.
112+
- **Port** — 1433 (which is the default).
113+
- **Database** — Use the service principal's **database** value for the Fabric test endpoint.
111114
5. Enter the **Development credentials** for your new project:
112115
- **Authentication** — Choose **Service Principal** from the dropdown.
113116
- **Tenant ID** — Use the service principal’s **Directory (tenant) id** as the value.

website/sidebars.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,7 @@ const sidebarSettings = {
5454
link: { type: "doc", id: "docs/cloud/connect-data-platform/about-connections" },
5555
items: [
5656
"docs/cloud/connect-data-platform/about-connections",
57+
"docs/cloud/connect-data-platform/connect-microsoft-fabric",
5758
"docs/cloud/connect-data-platform/connect-starburst-trino",
5859
"docs/cloud/connect-data-platform/connect-snowflake",
5960
"docs/cloud/connect-data-platform/connect-bigquery",

website/snippets/_adapters-verified.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@
4646

4747
<Card
4848
title="Microsoft Fabric"
49-
body="<a href='/guides/microsoft-fabric?step=1'><img src='/img/icons/dbt-bit.svg' width='7%'/>Set up in dbt Cloud </a> <br /><a href='/docs/core/connect-data-platform/fabric-setup'><img src='/img/icons/dbt-bit.svg' width='7%'/>Install with dbt Core </a> <br /><br /> <a href=https://badge.fury.io/py/dbt-fabric><img src=https://badge.fury.io/py/dbt-fabric.svg/></a>"
49+
body="<a href='/docs/cloud/connect-data-platform/connect-microsoft-fabric'><img src='/img/icons/dbt-bit.svg' width='7%'/>Set up in dbt Cloud </a> <br /><a href='/docs/core/connect-data-platform/fabric-setup'><img src='/img/icons/dbt-bit.svg' width='7%'/>Install with dbt Core </a> <br /><br /> <a href=https://badge.fury.io/py/dbt-fabric><img src=https://badge.fury.io/py/dbt-fabric.svg/></a>"
5050
icon="fabric"/>
5151
<Card
5252
title="Azure Synapse"

0 commit comments

Comments
 (0)