From 928c42b5cdb9df56ece7142fd7f2c4d15d73cea4 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Tue, 24 Mar 2026 02:52:46 +0000 Subject: [PATCH 1/2] docs: Add Fabric cloud integration content (replace 'Coming soon') Co-Authored-By: Itamar Hartstein --- docs/cloud/integrations/dwh/fabric.mdx | 43 ++++----------------- docs/snippets/cloud/integrations/fabric.mdx | 39 +++++++++++++++++++ 2 files changed, 46 insertions(+), 36 deletions(-) create mode 100644 docs/snippets/cloud/integrations/fabric.mdx diff --git a/docs/cloud/integrations/dwh/fabric.mdx b/docs/cloud/integrations/dwh/fabric.mdx index 26f3c4abd..8510b2058 100644 --- a/docs/cloud/integrations/dwh/fabric.mdx +++ b/docs/cloud/integrations/dwh/fabric.mdx @@ -3,39 +3,10 @@ title: "Connect to Fabric" sidebarTitle: "Fabric" --- - - - - - - - - - - - - - - - - - - - - - - -} -> - Coming soon - +import Fabric from '/snippets/cloud/integrations/fabric.mdx'; +import OnboardingHelp from '/snippets/cloud/integrations/onboarding-help.mdx'; + + + + + diff --git a/docs/snippets/cloud/integrations/fabric.mdx b/docs/snippets/cloud/integrations/fabric.mdx new file mode 100644 index 000000000..d0dab88fd --- /dev/null +++ b/docs/snippets/cloud/integrations/fabric.mdx @@ -0,0 +1,39 @@ +import IpAllowlist from '/snippets/cloud/integrations/ip-allowlist.mdx'; + +This guide contains the necessary steps to connect a Microsoft Fabric environment to your Elementary account. + +### Prerequisites + +- A Microsoft Fabric workspace with a warehouse or lakehouse SQL endpoint. +- An Azure AD (Entra ID) app registration (service principal) with access to your Fabric workspace. +- ODBC Driver 18 for SQL Server is used under the hood — no action needed on your side, it is pre-installed in Elementary Cloud. + +### Create an Azure AD service principal + +If you don't already have a service principal configured: + +1. In the [Azure portal](https://portal.azure.com), go to **Azure Active Directory** > **App registrations** > **New registration**. +2. Give it a name (e.g. `elementary-fabric`) and register it. +3. Note the **Application (client) ID** and **Directory (tenant) ID**. +4. Go to **Certificates & secrets** > **New client secret**, create a secret, and copy the **Value**. +5. In your Fabric workspace, grant the service principal access (e.g. add it as a **Contributor** or **Member** in the workspace settings). + +### Fill the connection form + +In the Elementary platform, go to **Environments** in the left menu, and click on the **Create Environment** button. +Choose a name for your environment, and then choose **Fabric** as your data warehouse type. + +Provide the following fields: + +- **Server**: The Fabric SQL connection endpoint. You can find this in the Fabric portal under your warehouse settings. It typically looks like `.datawarehouse.fabric.microsoft.com`. +- **Port**: The port to connect to. Default is `1433`. +- **Tenant ID**: The Azure AD (Entra ID) Directory (tenant) ID. +- **Client ID**: The Azure AD Application (client) ID of the service principal. +- **Client Secret**: The client secret value you generated for the service principal. + +Then, for each dbt project in your environment, provide: + +- **Database name**: The name of the Fabric warehouse or lakehouse SQL endpoint. +- **Elementary schema**: The name of your Elementary schema. Usually `[your dbt target schema]_elementary`. + + From 1629b2f22d7afba59b335d825c6166842bca8e92 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Tue, 24 Mar 2026 12:41:42 +0000 Subject: [PATCH 2/2] docs: Emphasize minimal permissions and add GRANT statements for Fabric - Changed workspace role from Contributor/Member to Viewer (minimum needed) - Added 'Grant minimal permissions' section with SQL GRANT statements - Imported and included PermissionsAndSecurity snippet - Follows the same minimal-permissions pattern as other adapters Co-Authored-By: Itamar Hartstein --- docs/snippets/cloud/integrations/fabric.mdx | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/docs/snippets/cloud/integrations/fabric.mdx b/docs/snippets/cloud/integrations/fabric.mdx index d0dab88fd..ab5c68457 100644 --- a/docs/snippets/cloud/integrations/fabric.mdx +++ b/docs/snippets/cloud/integrations/fabric.mdx @@ -1,4 +1,5 @@ import IpAllowlist from '/snippets/cloud/integrations/ip-allowlist.mdx'; +import PermissionsAndSecurity from '/snippets/cloud/integrations/permissions-and-security.mdx'; This guide contains the necessary steps to connect a Microsoft Fabric environment to your Elementary account. @@ -16,7 +17,25 @@ If you don't already have a service principal configured: 2. Give it a name (e.g. `elementary-fabric`) and register it. 3. Note the **Application (client) ID** and **Directory (tenant) ID**. 4. Go to **Certificates & secrets** > **New client secret**, create a secret, and copy the **Value**. -5. In your Fabric workspace, grant the service principal access (e.g. add it as a **Contributor** or **Member** in the workspace settings). +5. In your Fabric workspace, add the service principal as a **Viewer** in the workspace settings. This is the minimum workspace-level role required for connectivity. + +### Grant minimal permissions + +Elementary Cloud only requires **read-only access to the Elementary schema** and **metadata access** (e.g. `INFORMATION_SCHEMA`). We recommend granting only the minimum permissions needed. + +After the service principal can connect, run the following statements in your Fabric warehouse with admin permissions: + +```sql +-- Grant read-only access to the Elementary schema +GRANT SELECT ON SCHEMA :: [] TO []; + +-- Grant access to view metadata (table definitions, columns, etc.) +GRANT VIEW DEFINITION ON SCHEMA :: [] TO []; +``` + +Replace `` with the name of your Elementary schema (usually `[your dbt target schema]_elementary`), and `` with the display name of your service principal. + + ### Fill the connection form