From b86332bd608c916ad551d72db495763b6f3ab52a Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Mon, 27 Nov 2023 12:07:05 -0800 Subject: [PATCH 1/9] Fast-follows for MS Fabric docs --- .../about-connections.md | 3 ++- .../connect-microsoft-fabric.md | 27 +++++++++++++++++++ .../about-core-connections.md | 1 + .../connect-data-platform/fabric-setup.md | 2 +- .../microsoft-fabric-support-rn.md | 6 +++-- website/docs/guides/microsoft-fabric-qs.md | 3 +++ website/sidebars.js | 1 + website/snippets/_adapters-verified.md | 2 +- 8 files changed, 40 insertions(+), 5 deletions(-) create mode 100644 website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md diff --git a/website/docs/docs/cloud/connect-data-platform/about-connections.md b/website/docs/docs/cloud/connect-data-platform/about-connections.md index 1329d179900..93bbf83584f 100644 --- a/website/docs/docs/cloud/connect-data-platform/about-connections.md +++ b/website/docs/docs/cloud/connect-data-platform/about-connections.md @@ -3,7 +3,7 @@ title: "About data platform connections" id: about-connections description: "Information about data platform connections" sidebar_label: "About data platform connections" -pagination_next: "docs/cloud/connect-data-platform/connect-starburst-trino" +pagination_next: "docs/cloud/connect-data-platform/connect-microsoft-fabric" pagination_prev: null --- dbt Cloud can connect with a variety of data platform providers including: @@ -11,6 +11,7 @@ dbt Cloud can connect with a variety of data platform providers including: - [Apache Spark](/docs/cloud/connect-data-platform/connect-apache-spark) - [Databricks](/docs/cloud/connect-data-platform/connect-databricks) - [Google BigQuery](/docs/cloud/connect-data-platform/connect-bigquery) +- [Microsoft Fabric](/docs/cloud/connect-data-platform/connect-microsoft-fabric) - [PostgreSQL](/docs/cloud/connect-data-platform/connect-redshift-postgresql-alloydb) - [Snowflake](/docs/cloud/connect-data-platform/connect-snowflake) - [Starburst or Trino](/docs/cloud/connect-data-platform/connect-starburst-trino) diff --git a/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md b/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md new file mode 100644 index 00000000000..0fe36bf3976 --- /dev/null +++ b/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md @@ -0,0 +1,27 @@ +--- +title: "Connect Microsoft Fabric" +description: "Configure Microsoft Fabric connection." +sidebar_label: "Connect Microsoft Fabric" +--- + +The following are the required fields for setting up a connection with a [Microsoft Fabric](https://docs.starburst.io/starburst-enterprise/index.html) using service principal authentication. + +| Field | Description | +| --- | --- | +| **Server** | The service principal's **host** value for the Fabric test endpoint. | +| **Port** | The port to connect to Microsoft Fabric. By default, it's 1433 for the standard SQL server port number. | +| **Database** | The service principal's **database** value for the Fabric 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**). | + + +## Supported authentication methods + +- Service principal in Azure Active Directory (AAD) +- Username/password in Azure Active Directory (AAD) + +## Configuration + +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). diff --git a/website/docs/docs/core/connect-data-platform/about-core-connections.md b/website/docs/docs/core/connect-data-platform/about-core-connections.md index 492e5ae878a..61a7805d232 100644 --- a/website/docs/docs/core/connect-data-platform/about-core-connections.md +++ b/website/docs/docs/core/connect-data-platform/about-core-connections.md @@ -14,6 +14,7 @@ dbt Core can connect with a variety of data platform providers including: - [Apache Spark](/docs/core/connect-data-platform/spark-setup) - [Databricks](/docs/core/connect-data-platform/databricks-setup) - [Google BigQuery](/docs/core/connect-data-platform/bigquery-setup) +- [Microsoft Fabric](/docs/core/connect-data-platform/fabric-setup) - [PostgreSQL](/docs/core/connect-data-platform/postgres-setup) - [Snowflake](/docs/core/connect-data-platform/snowflake-setup) - [Starburst or Trino](/docs/core/connect-data-platform/trino-setup) diff --git a/website/docs/docs/core/connect-data-platform/fabric-setup.md b/website/docs/docs/core/connect-data-platform/fabric-setup.md index 11a8cf6f98b..deef1e04b22 100644 --- a/website/docs/docs/core/connect-data-platform/fabric-setup.md +++ b/website/docs/docs/core/connect-data-platform/fabric-setup.md @@ -8,7 +8,7 @@ meta: github_repo: 'Microsoft/dbt-fabric' pypi_package: 'dbt-fabric' min_core_version: '1.4.0' - cloud_support: Not Supported + cloud_support: Supported platform_name: 'Microsoft Fabric' config_page: '/reference/resource-configs/fabric-configs' --- diff --git a/website/docs/docs/dbt-versions/release-notes/02-Nov-2023/microsoft-fabric-support-rn.md b/website/docs/docs/dbt-versions/release-notes/02-Nov-2023/microsoft-fabric-support-rn.md index 13aefa80ffc..66295d079ad 100644 --- a/website/docs/docs/dbt-versions/release-notes/02-Nov-2023/microsoft-fabric-support-rn.md +++ b/website/docs/docs/dbt-versions/release-notes/02-Nov-2023/microsoft-fabric-support-rn.md @@ -8,11 +8,13 @@ tags: [Nov-2023] Public Preview is now available in dbt Cloud for Microsoft Fabric! -To learn more, check out the [Quickstart for dbt Cloud and Microsoft Fabric](/guides/microsoft-fabric?step=1). The guide walks you through: +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). + +Also, check out the [Quickstart for dbt Cloud and Microsoft Fabric](/guides/microsoft-fabric?step=1). The guide walks you through: - Loading the Jaffle Shop sample data (provided by dbt Labs) into your Microsoft Fabric warehouse. - Connecting dbt Cloud to Microsoft Fabric. - Turning a sample query into a model in your dbt project. A model in dbt is a SELECT statement. - Adding tests to your models. - Documenting your models. -- Scheduling a job to run. \ No newline at end of file +- Scheduling a job to run \ No newline at end of file diff --git a/website/docs/guides/microsoft-fabric-qs.md b/website/docs/guides/microsoft-fabric-qs.md index c7c53a2aac7..6b194f0baf7 100644 --- a/website/docs/guides/microsoft-fabric-qs.md +++ b/website/docs/guides/microsoft-fabric-qs.md @@ -108,6 +108,9 @@ A public preview of Microsoft Fabric in dbt Cloud is now available! 2. Enter a project name and click **Continue**. 3. Choose **Fabric** as your connection and click **Next**. 4. In the **Configure your environment** section, enter the **Settings** for your new project: + - **Server** — Use the service principal's **host** value for the Fabric test endpoint. + - **Port** — 1433 (which is the default). + - **Database** — Use the service principal's **database** value for the Fabric test endpoint. 5. Enter the **Development credentials** for your new project: - **Authentication** — Choose **Service Principal** from the dropdown. - **Tenant ID** — Use the service principal’s **Directory (tenant) id** as the value. diff --git a/website/sidebars.js b/website/sidebars.js index 720b752ed41..01a41c5a552 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -54,6 +54,7 @@ const sidebarSettings = { link: { type: "doc", id: "docs/cloud/connect-data-platform/about-connections" }, items: [ "docs/cloud/connect-data-platform/about-connections", + "docs/cloud/connect-data-platform/connect-microsoft-fabric", "docs/cloud/connect-data-platform/connect-starburst-trino", "docs/cloud/connect-data-platform/connect-snowflake", "docs/cloud/connect-data-platform/connect-bigquery", diff --git a/website/snippets/_adapters-verified.md b/website/snippets/_adapters-verified.md index b9a71c67c36..c3607b50125 100644 --- a/website/snippets/_adapters-verified.md +++ b/website/snippets/_adapters-verified.md @@ -46,7 +46,7 @@ Date: Mon, 27 Nov 2023 12:15:25 -0800 Subject: [PATCH 2/9] Update website/docs/docs/dbt-versions/release-notes/02-Nov-2023/microsoft-fabric-support-rn.md typo --- .../release-notes/02-Nov-2023/microsoft-fabric-support-rn.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/dbt-versions/release-notes/02-Nov-2023/microsoft-fabric-support-rn.md b/website/docs/docs/dbt-versions/release-notes/02-Nov-2023/microsoft-fabric-support-rn.md index 66295d079ad..9197fb54c11 100644 --- a/website/docs/docs/dbt-versions/release-notes/02-Nov-2023/microsoft-fabric-support-rn.md +++ b/website/docs/docs/dbt-versions/release-notes/02-Nov-2023/microsoft-fabric-support-rn.md @@ -17,4 +17,4 @@ Also, check out the [Quickstart for dbt Cloud and Microsoft Fabric](/guides/micr - Turning a sample query into a model in your dbt project. A model in dbt is a SELECT statement. - Adding tests to your models. - Documenting your models. -- Scheduling a job to run \ No newline at end of file +- Scheduling a job to run. \ No newline at end of file From 0d51f2e6336596c544ec8e7deeafc04920334667 Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Mon, 27 Nov 2023 12:26:33 -0800 Subject: [PATCH 3/9] update supported auth methods section --- .../cloud/connect-data-platform/connect-microsoft-fabric.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md b/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md index 0fe36bf3976..649bd92b5b3 100644 --- a/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md +++ b/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md @@ -18,9 +18,11 @@ The following are the required fields for setting up a connection with a [Micros ## Supported authentication methods +The two supported authentication methods are: +- AAD service principal +- AAD password -- Service principal in Azure Active Directory (AAD) -- Username/password in Azure Active Directory (AAD) +SQL password (LDAP) is not supported in Fabric Synapse so you must use Azure Active Directory (AAD). This means that to use Microsoft Fabric in dbt Cloud, you will need at least one AAD service principal to connect dbt Cloud to Fabric, ideally one service principal for each user. ## Configuration From 437ce90181cb97e907d62c59051bcdf8a4ba5d4b Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Wed, 29 Nov 2023 09:22:02 -0800 Subject: [PATCH 4/9] fold in feedback from DX --- .../connect-microsoft-fabric.md | 26 ++++++++++++++----- 1 file changed, 20 insertions(+), 6 deletions(-) diff --git a/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md b/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md index 649bd92b5b3..bd42a217001 100644 --- a/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md +++ b/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md @@ -4,7 +4,15 @@ description: "Configure Microsoft Fabric connection." sidebar_label: "Connect Microsoft Fabric" --- -The following are the required fields for setting up a connection with a [Microsoft Fabric](https://docs.starburst.io/starburst-enterprise/index.html) using service principal authentication. +## Supported authentication methods +The two supported authentication methods are: +- Azure Active Directory service principal +- Azure Active Directory password + +SQL password (LDAP) is not supported in Microsoft Fabric Synapse Data Warehouse so you must use Azure Active Directory (Azure AD). This means that to use 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. + +### Active Directory service principal +The following are the required fields for setting up a connection with a [Microsoft Fabric](https://docs.starburst.io/starburst-enterprise/index.html) using Azure AD service principal authentication. | Field | Description | | --- | --- | @@ -17,12 +25,18 @@ The following are the required fields for setting up a connection with a [Micros | **Client secret** | The service principal's **client secret** (not the **client secret id**). | -## Supported authentication methods -The two supported authentication methods are: -- AAD service principal -- AAD password +### Active Directory password + +The following are the required fields for setting up a connection with a [Microsoft Fabric](https://docs.starburst.io/starburst-enterprise/index.html) using Azure AD password authentication. -SQL password (LDAP) is not supported in Fabric Synapse so you must use Azure Active Directory (AAD). This means that to use Microsoft Fabric in dbt Cloud, you will need at least one AAD service principal to connect dbt Cloud to Fabric, ideally one service principal for each user. +| Field | Description | +| --- | --- | +| **Server** | The server hostname. | +| **Port** | The server port. By default, it's 1433 for 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. | ## Configuration From 05a8c33680b8464e90e1bf4815861734349e0c81 Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Wed, 29 Nov 2023 09:28:06 -0800 Subject: [PATCH 5/9] Minor nits --- .../connect-microsoft-fabric.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md b/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md index bd42a217001..2896839813d 100644 --- a/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md +++ b/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md @@ -5,11 +5,11 @@ sidebar_label: "Connect Microsoft Fabric" --- ## Supported authentication methods -The two supported authentication methods are: -- Azure Active Directory service principal -- Azure Active Directory password +The supported authentication methods are: +- Azure Active Directory (Azure AD) service principal +- Azure AD password -SQL password (LDAP) is not supported in Microsoft Fabric Synapse Data Warehouse so you must use Azure Active Directory (Azure AD). This means that to use 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. +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 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. ### Active Directory service principal The following are the required fields for setting up a connection with a [Microsoft Fabric](https://docs.starburst.io/starburst-enterprise/index.html) using Azure AD service principal authentication. @@ -17,7 +17,7 @@ The following are the required fields for setting up a connection with a [Micros | Field | Description | | --- | --- | | **Server** | The service principal's **host** value for the Fabric test endpoint. | -| **Port** | The port to connect to Microsoft Fabric. By default, it's 1433 for the standard SQL server port number. | +| **Port** | The port to connect to Microsoft Fabric. You can use `1433` (the default), which is the standard SQL server port number. | | **Database** | The service principal's **database** value for the Fabric test endpoint. | | **Authentication** | Choose **Service Principal** from the dropdown. | | **Tenant ID** | The service principal's **Directory (tenant) ID**. | @@ -31,8 +31,8 @@ The following are the required fields for setting up a connection with a [Micros | Field | Description | | --- | --- | -| **Server** | The server hostname. | -| **Port** | The server port. By default, it's 1433 for the standard SQL server port number. | +| **Server** | The server hostname to connect to Microsoft Fabric. | +| **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. | From 01aea7a1924640869984bc4ccf7b686f26eb57bb Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Wed, 29 Nov 2023 09:36:38 -0800 Subject: [PATCH 6/9] Fix links --- .../cloud/connect-data-platform/connect-microsoft-fabric.md | 6 +++--- website/docs/guides/microsoft-fabric-qs.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md b/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md index 2896839813d..e9d67524e89 100644 --- a/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md +++ b/website/docs/docs/cloud/connect-data-platform/connect-microsoft-fabric.md @@ -9,10 +9,10 @@ The supported authentication methods are: - Azure Active Directory (Azure AD) service principal - Azure AD password -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 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. +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. ### Active Directory service principal -The following are the required fields for setting up a connection with a [Microsoft Fabric](https://docs.starburst.io/starburst-enterprise/index.html) using Azure AD service principal authentication. +The following are the required fields for setting up a connection with a Microsoft Fabric using Azure AD service principal authentication. | Field | Description | | --- | --- | @@ -27,7 +27,7 @@ The following are the required fields for setting up a connection with a [Micros ### Active Directory password -The following are the required fields for setting up a connection with a [Microsoft Fabric](https://docs.starburst.io/starburst-enterprise/index.html) using Azure AD password authentication. +The following are the required fields for setting up a connection with a Microsoft Fabric using Azure AD password authentication. | Field | Description | | --- | --- | diff --git a/website/docs/guides/microsoft-fabric-qs.md b/website/docs/guides/microsoft-fabric-qs.md index 6b194f0baf7..592dd1d6a8b 100644 --- a/website/docs/guides/microsoft-fabric-qs.md +++ b/website/docs/guides/microsoft-fabric-qs.md @@ -9,7 +9,7 @@ recently_updated: true --- ## Introduction -In this quickstart guide, you'll learn how to use dbt Cloud with Microsoft Fabric. It will show you how to: +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: - Load the Jaffle Shop sample data (provided by dbt Labs) into your Microsoft Fabric warehouse. - Connect dbt Cloud to Microsoft Fabric. From 6c8e886bf700da79a7ff45b6d1cf390c0ac3b4ac Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Wed, 29 Nov 2023 10:00:01 -0800 Subject: [PATCH 7/9] Fixed whitspace issue by escaping chars --- website/docs/guides/microsoft-fabric-qs.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/website/docs/guides/microsoft-fabric-qs.md b/website/docs/guides/microsoft-fabric-qs.md index 592dd1d6a8b..5342ee5be7d 100644 --- a/website/docs/guides/microsoft-fabric-qs.md +++ b/website/docs/guides/microsoft-fabric-qs.md @@ -54,8 +54,8 @@ A public preview of Microsoft Fabric in dbt Cloud is now available! CREATE TABLE dbo.customers ( [ID] [int], - [FIRST_NAME] [varchar] (8000), - [LAST_NAME] [varchar] (8000) + \[FIRST_NAME] [varchar](8000), + \[LAST_NAME] [varchar](8000) ); COPY INTO [dbo].[customers] @@ -72,7 +72,7 @@ A public preview of Microsoft Fabric in dbt Cloud is now available! [USER_ID] [int], -- [ORDER_DATE] [int], [ORDER_DATE] [date], - [STATUS] [varchar] (8000) + \[STATUS] [varchar](8000) ); COPY INTO [dbo].[orders] @@ -87,8 +87,8 @@ A public preview of Microsoft Fabric in dbt Cloud is now available! ( [ID] [int], [ORDERID] [int], - [PAYMENTMETHOD] [varchar] (8000), - [STATUS] [varchar] (8000), + \[PAYMENTMETHOD] [varchar](8000), + \[STATUS] [varchar](8000), [AMOUNT] [int], [CREATED] [date] ); From 81edd340ab968d5fd8e3c01ea22291c992644308 Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Wed, 29 Nov 2023 13:12:02 -0800 Subject: [PATCH 8/9] Feedback --- website/docs/guides/microsoft-fabric-qs.md | 1 + 1 file changed, 1 insertion(+) diff --git a/website/docs/guides/microsoft-fabric-qs.md b/website/docs/guides/microsoft-fabric-qs.md index 5342ee5be7d..aaf7074cd36 100644 --- a/website/docs/guides/microsoft-fabric-qs.md +++ b/website/docs/guides/microsoft-fabric-qs.md @@ -28,6 +28,7 @@ A public preview of Microsoft Fabric in dbt Cloud is now available! - You have a [dbt Cloud](https://www.getdbt.com/signup/) account. - 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. - 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. + - The service principal must be added to the Microsoft Fabric workspace with either a Member (recommended) or Admin permission set. ### Related content - [dbt Courses](https://courses.getdbt.com/collections) From edf806e540f20c39d3b2c954ae710bd716f2501e Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Wed, 29 Nov 2023 13:17:06 -0800 Subject: [PATCH 9/9] Minor change --- website/docs/guides/microsoft-fabric-qs.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/website/docs/guides/microsoft-fabric-qs.md b/website/docs/guides/microsoft-fabric-qs.md index aaf7074cd36..1d1e016a6f1 100644 --- a/website/docs/guides/microsoft-fabric-qs.md +++ b/website/docs/guides/microsoft-fabric-qs.md @@ -27,8 +27,7 @@ A public preview of Microsoft Fabric in dbt Cloud is now available! ### Prerequisites - You have a [dbt Cloud](https://www.getdbt.com/signup/) account. - 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. -- 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. - - The service principal must be added to the Microsoft Fabric workspace with either a Member (recommended) or Admin permission set. +- 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. ### Related content - [dbt Courses](https://courses.getdbt.com/collections)