{"title":"Set up data mirroring from Business Central to Microsoft Fabric","url":"https://jonas-paprotka.de/docs/admin-set-up-fabric-mirroring/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/admin-set-up-fabric-mirroring, MicrosoftDocs/dynamics365smb-docs at 46907ac (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/admin-set-up-fabric-mirroring","source":{"name":"Business Central application docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-docs","commit":"46907ace177f8d31deba47a2fdb57c3336e66252","date":"2026-11-19"},"checked":"2026-11-19","description":"Prepare Microsoft Fabric, connect Business Central to an open mirrored database, and select the companies and tables to synchronize.","date":"2026-10-29","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Set up data mirroring from Business Central to Microsoft Fabric","slug":"set-up-data-mirroring-from-business-central-to-microsoft-fabric","at":0,"chars":18004},{"level":2,"title":"Prerequisites","slug":"prerequisites","at":689,"chars":1270},{"level":2,"title":"Prepare an open-mirrored database in Microsoft Fabric","slug":"prepare-an-open-mirrored-database-in-microsoft-fabric","at":1959,"chars":670},{"level":2,"title":"Set up authentication","slug":"set-up-authentication","at":2629,"chars":6693},{"level":3,"title":"Understand the Microsoft-provided application","slug":"understand-the-microsoft-provided-application","at":3346,"chars":917},{"level":3,"title":"Create a service principal","slug":"create-a-service-principal","at":4263,"chars":3678},{"level":4,"title":"Azure Cloud Shell (recommended)<#tab/cloudshell>","slug":"azure-cloud-shell-recommendedtabcloudshell","at":4975,"chars":619},{"level":4,"title":"Azure CLI<#tab/cli>","slug":"azure-clitabcli","at":5594,"chars":548},{"level":4,"title":"Microsoft Graph PowerShell<#tab/graphps>","slug":"microsoft-graph-powershelltabgraphps","at":6142,"chars":923},{"level":4,"title":"Graph Explorer<#tab/graphexplorer>","slug":"graph-explorertabgraphexplorer","at":7065,"chars":876},{"level":3,"title":"Find the Object ID later","slug":"find-the-object-id-later","at":7941,"chars":387},{"level":3,"title":"Grant workspace access directly in Fabric (optional)","slug":"grant-workspace-access-directly-in-fabric-optional","at":8328,"chars":994},{"level":2,"title":"Connect the Business Central environment to Fabric","slug":"connect-the-business-central-environment-to-fabric","at":9322,"chars":3449},{"level":3,"title":"Connect with the assisted setup guide","slug":"connect-with-the-assisted-setup-guide","at":10113,"chars":1418},{"level":3,"title":"Connect from the setup page","slug":"connect-from-the-setup-page","at":11531,"chars":1240},{"level":2,"title":"Confirm setup and start synchronization","slug":"confirm-setup-and-start-synchronization","at":12771,"chars":1762},{"level":3,"title":"Understand the setup and export status","slug":"understand-the-setup-and-export-status","at":13587,"chars":946},{"level":2,"title":"Modify the mirroring setup","slug":"modify-the-mirroring-setup","at":14533,"chars":648},{"level":2,"title":"Secure the Fabric connection","slug":"secure-the-fabric-connection","at":15181,"chars":202},{"level":2,"title":"Troubleshoot setup","slug":"troubleshoot-setup","at":15383,"chars":2148},{"level":3,"title":"Business Central can't get an access token for Fabric","slug":"business-central-cant-get-an-access-token-for-fabric","at":15405,"chars":627},{"level":3,"title":"Setup doesn't complete, or synchronization doesn't behave as expected","slug":"setup-doesnt-complete-or-synchronization-doesnt-behave-as-expected","at":16032,"chars":622},{"level":3,"title":"Reset the connection after an update or failed setup","slug":"reset-the-connection-after-an-update-or-failed-setup","at":16654,"chars":877},{"level":2,"title":"Related information","slug":"related-information","at":17531,"chars":473}],"text":"# Set up data mirroring from Business Central to Microsoft Fabric\n[This article is prerelease documentation and is subject to change.]\nConnect Business Central online to an open mirrored database in Microsoft Fabric. Use the Connect to Microsoft Fabric (Preview) assisted setup guide or the Microsoft Fabric Mirroring Setup (Preview) page. Choose the companies and tables to synchronize, and make their data available in OneLake for use with Fabric IQ, Power BI, Data Factory, and other analytics experiences.\n> IMPORTANT\n > This is a production-ready preview feature.\n > Production-ready previews are subject to supplemental terms of use<https://go.microsoft.com/fwlink/?linkid=2189520>.\n## Prerequisites\nBefore you begin, make sure the following requirements are met.\nBusiness Central requirements\n Your Business Central online environment is version 29.1 or later.\n The Business Central Mirroring to Fabric extension is installed on the environment. Download the app from the Microsoft Marketplace<https://go.microsoft.com/fwlink/?LinkId=2384210>. See Install extensions (apps) in Business Central<ui-extensions-install-uninstall>.\n Your user account has the MS Fabric Mirroring - Admin permission set or equivalent permissions.\nMicrosoft Fabric requirements\nYou have a Fabric workspace to receive the Business Central data that meets these requirements:\n The workspace is assigned to an active Microsoft Fabric capacity. A paused or deleted capacity stops Fabric replication. See Manage your capacities in the Admin portal<https://learn.microsoft.com/fabric/admin/capacity-settings>.\n The workspace is in the same Microsoft Entra tenant as your Business Central environment.\n You have at least the Member role in the workspace so that you can add the mirroring service principal and assign it the Contributor role.\nSee https://learn.microsoft.com/fabric/fundamentals/create-workspaces and https://learn.microsoft.com/fabric/fundamentals/roles-workspaces.\n## Prepare an open-mirrored database in Microsoft Fabric\nCreate the open mirrored database to receive your Business Central data.\n1. Sign in to Microsoft Fabric<https://app.fabric.microsoft.com/>.\n1. Open the workspace that you want to use for the Business Central data.\n1. Select + New item or Create.\n1. Find and select the Mirrored Database.\n1. Enter a name for the database, and then select Create.\n1. Wait until Fabric finishes creating the database.\nSee Tutorial: Configure Microsoft Fabric open mirrored databases<https://learn.microsoft.com/fabric/mirroring/open-mirroring-tutorial> or https://learn.microsoft.com/fabric/fundamentals/create-items-in-workspaces.\n## Set up authentication\nTo authenticate with Microsoft Fabric, Business Central uses the Dynamics 365 Business Central Fabric Export application in Microsoft Entra ID. To set up your Business Central tenant to use this app, complete these two tasks:\n1. Create a service principal for the application in the Microsoft Entra tenant used by the Business Central environment. #create-a-service-principal.\n1. Give the service principal access to the Fabric workspace that receives the mirrored data. Grant at least Contributor access. Use the Add to workspace action during connection setup in Business Central<#connect-the-business-central-environment-to-fabric>, or #grant-workspace-access-directly-in-fabric-optional.\n### Understand the Microsoft-provided application\nMicrosoft owns and manages the app registration for Dynamics 365 Business Central Fabric Export in its own Microsoft Entra ID tenant. The registration defines the application's identity and authentication settings. The service principal you create in the Microsoft Entra tenant for Business Central represents that application in your tenant and appears under Enterprise applications in the Microsoft Entra admin center.\nUse these details during setup:\nItem|Value\nApp name|Dynamics 365 Business Central Fabric Export\nApplication (client) ID|`dcc80069-ba40-4ad9-ba8c-60001cea3497`\nService principal Object ID|Unique to your Microsoft Entra tenant. Needed only when you use Add to workspace in Business Central.\nSee Application and service principal objects in Microsoft Entra ID<https://learn.microsoft.com/entra/identity-platform/app-objects-and-service-principals>.\n### Create a service principal\nUse one of the following methods to create the service principal or find it if it already exists. The Cloud Shell, Azure CLI, and Microsoft Graph PowerShell methods reuse the service principal if it already exists. The Graph Explorer method includes a separate request to retrieve an existing service principal. Each method shows the service principal's Object ID, which you need to enter in Business Central only if you grant workspace access from Business Central.\nBefore you start, ensure that:\n You sign in to the Microsoft Entra tenant connected to Business Central.\n You have at least the Application Administrator or Cloud Application Administrator role in Microsoft Entra.\n#### Azure Cloud Shell (recommended)<#tab/cloudshell>\nWith this method, you don't need to install any tools.\n1. Sign in to the https://portal.azure.com as an admin of the tenant connected to Business Central.\n1. Select Cloud Shell (the `>_` icon at the top of the portal), and then select Bash.\n1. Run the following commands:\n ```bash\n APP_ID=\"dcc80069-ba40-4ad9-ba8c-60001cea3497\"\n SP_ID=$(az ad sp list --filter \"appId eq '$APP_ID'\" --query \"[0].id\" -o tsv)\n [ -z \"$SP_ID\" ] && SP_ID=$(az ad sp create --id \"$APP_ID\" --query id -o tsv)\n echo \"Principal ID: $SP_ID\"\n ```\n1. Copy the value shown after `Principal ID:`.\n#### Azure CLI<#tab/cli>\nThis option requires that Azure CLI is installed on your computer. Run the following commands in PowerShell, and replace `<TenantIdOrDomain>` with your tenant ID or domain:\n```powershell\naz login --tenant <TenantIdOrDomain> --allow-no-subscriptions\n\n$appId = 'dcc80069-ba40-4ad9-ba8c-60001cea3497'\n$spId = az ad sp list --filter \"appId eq '$appId'\" --query \"[0].id\" -o tsv\n\nif (-not $spId) {\n    $spId = az ad sp create --id $appId --query id -o tsv\n}\n\n\"Principal ID: $spId\"\n```\nCopy the value shown after `Principal ID:`.\n#### Microsoft Graph PowerShell<#tab/graphps>\nThis option requires the Microsoft Graph Applications module is installed on your computer.\n1. To install the module if you don't already have it, start Windows PowerShell and then run the following command:\n ```powershell\n Install-Module Microsoft.Graph.Applications -Scope CurrentUser\n ```\n1. Run the following commands, replacing `<TenantIdOrDomain>` with your tenant ID or domain:\n ```powershell\n Connect-MgGraph -TenantId <TenantIdOrDomain> -Scopes 'Application.ReadWrite.All'\n\n $appId = 'dcc80069-ba40-4ad9-ba8c-60001cea3497'\n $sp = Get-MgServicePrincipal -Filter \"appId eq '$appId'\"\n\n if (-not $sp) {\n    $sp = New-MgServicePrincipal -AppId $appId\n }\n\n \"Principal ID: $($sp.Id)\"\n ```\n> NOTE\n> The first time you run `Connect-MgGraph`, you're asked to consent to Microsoft Graph Command Line Tools. This prompt is expected.\n1. Copy the value shown after `Principal ID:`.\n#### Graph Explorer<#tab/graphexplorer>\nUse this option if you want to use only a web browser.\n1. Open https://developer.microsoft.com/graph/graph-explorer, and sign in as an admin of the tenant.\n1. Select Modify permissions, and consent to Application.ReadWrite.All.\n1. Send the following request:\n ```http\n POST https://graph.microsoft.com/v1.0/servicePrincipals\n ```\n Use this request body:\n ```json\n {\n   \"appId\": \"dcc80069-ba40-4ad9-ba8c-60001cea3497\"\n }\n ```\n1. Copy the id value from the response.\nIf you get an error saying that the service principal already exists, send this request instead:\n```http\nGET https://graph.microsoft.com/v1.0/servicePrincipals(appId='dcc80069-ba40-4ad9-ba8c-60001cea3497')?$select=id\n```\nCopy the id value from the response.\nAfter you create or find the service principal, continue to #connect-the-business-central-environment-to-fabric.\n### Find the Object ID later\nIf the service principal already exists, you can find its Object ID in the Microsoft Entra admin center:\n1. Go to Microsoft Entra admin center > Enterprise applications.\n1. Clear the Application type filter.\n1. Search for Dynamics 365 Business Central Fabric Export or `dcc80069-ba40-4ad9-ba8c-60001cea3497`.\n1. Open the application, and copy its Object ID.\n### Grant workspace access directly in Fabric (optional)\nUse this procedure only if you want to grant workspace access in Fabric instead of using Add to workspace in Business Central. If the service principal already has Contributor, Member, or Admin access to the workspace, you don't need to grant access again.\nTo grant workspace access, you must have at least the Member role in the workspace:\n1. In Microsoft Fabric, open the destination workspace.\n1. Select Manage access, and then select Add people or groups.\n1. Find and select Dynamics 365 Business Central Fabric Export.\n1. Select the Contributor role, and then select Add.\nIf you grant access in Fabric, you can leave Principal ID blank and skip Add to workspace in Business Central.\nSee Give users access to workspaces<https://learn.microsoft.com/fabric/fundamentals/give-access-workspaces>.\n> NOTE\n> If Add to workspace in Business Central isn't available or doesn't succeed, use this procedure to grant access directly in Fabric.\n## Connect the Business Central environment to Fabric\nAfter you prepare the Microsoft-provided application's service principal and open mirrored database, configure the connection in Business Central. Use either the assisted setup guide or the setup page. Both methods use the following fields.\nField|What to enter or select\nPrincipal ID|Enter the service principal's Object ID from #set-up-authentication only if you'll use Add to workspace in Business Central. If workspace access is already granted, leave the field blank.\nFabric Workspace Name|Use the lookup to select the destination workspace. Business Central saves its ID automatically.\nFabric Open Mirroring Name|Use the lookup to select the database that you prepared in the workspace. Business Central saves its ID automatically.\n### Connect with the assisted setup guide\n1. Sign in to Business Central<https://businesscentral.dynamics.com>.\n1. Select Search (Alt+Q) in the upper-right corner, enter Assisted Setup, and then select the related link.\n1. Select Connect to Microsoft Fabric (Preview), and then select Next on the welcome step.\n1. On the Authentication step, enter the service principal's Object ID in Principal ID only if you'll use Add to workspace. If workspace access is already granted, leave the field blank. Select Next.\n1. On the Fabric Workspace step, use the lookup to select the destination workspace. Select Next.\n1. On the Grant Workspace Access step, select Add to workspace unless the service principal already has Contributor, Member, or Admin access. Select Next.\n1. On the Fabric Open Mirroring Database step, use the lookup to select the database that you prepared. Select Next.\n1. On the Synchronization Options step, select Connect to Fabric to start the background connection setup. Approve the privacy notice if prompted. Select Next.\n1. Choose Select companies, and add at least one company to synchronize. Ensure the company is enabled. Return to the guide, and select Next.\n1. Choose Select tables, and add at least one table to synchronize. Return to the guide, and select Next.\n1. Select Finish to close the guide.\nFinish doesn't start synchronization. Continue to #confirm-setup-and-start-synchronization.\n### Connect from the setup page\n1. Select Search (Alt+Q) in the upper-right corner, enter Microsoft Fabric Mirroring Setup (Preview), and then select the related link.\n1. Enter the service principal's Object ID in Principal ID only if you'll use Add to workspace. If workspace access is already granted, leave the field blank.\n> IMPORTANT\n> Enter the service principal's Object ID, not the application (client) ID. Fabric rejects the application (client) ID. You get the Object ID when you create the service principal. If workspace access is already granted, leave this field blank.\n1. Use the lookup in Fabric Workspace Name to select the destination workspace.\n1. Select Add to workspace unless the service principal already has Contributor, Member, or Admin access.\n1. Use the lookup in Fabric Open Mirroring Name to select the database that you prepared.\n1. Select Connect to Fabric to start the background connection setup. Approve the privacy notice if prompted.\n1. Select Configuration > Companies, and add at least one company to synchronize. Ensure the company is enabled.\n1. Return to the setup page. Select Configuration > Tables, and add at least one table to synchronize.\nContinue to #confirm-setup-and-start-synchronization.\n## Confirm setup and start synchronization\nConnect to Fabric prepares Business Central to export data to the selected destination. The connection setup runs in the background. You can select companies and tables while setup is in progress.\n1. Open the Microsoft Fabric Mirroring Setup (Preview) page.\n1. Select Refresh page to check the latest status. Wait until Setup Complete is selected. If setup doesn't complete, check Fabric Synchronization Overview for progress and errors.\n1. Select Start synchronization to request continuous exports of the selected companies and tables.\n1. Open Fabric Synchronization Overview to check the first export run and its result.\n> NOTE\n> If you skipped Connect to Fabric in the guide, select it on the setup page and wait for setup to complete before you start synchronization.\n### Understand the setup and export status\nAlthough Export Enabled looks like a switch, it's a read-only status. You don't turn it on manually or enter a value during setup. Business Central updates the status as background export operations run.\nField|What it tells you\nSetup Complete|Whether the background connection setup completed successfully. Use this field to confirm that the connection is ready before you start synchronization.\nExport Enabled|Whether continuous export is enabled. This status doesn't confirm that connection setup succeeded or that a particular export run completed.\nConnection setup and synchronization requests run asynchronously. A status might not change immediately after you select an action. Select Refresh page to read the latest values. Use Fabric Synchronization Overview to confirm the progress and result of each operation.\nSee Monitor and troubleshoot Fabric synchronization<admin-monitor-fabric-export>.\n## Modify the mirroring setup\nUse the Microsoft Fabric Mirroring Setup (Preview) page to review the connection and change synchronization options. Use the field tooltips for descriptions of optional settings, such as Minutes Between Exports.\nThe default data namespace is BusinessCentral. The default logging namespace is BusinessCentral_log. You can change the namespaces only before the connection setup completes.\nSelect Test connection to check whether Business Central can access the Fabric API. This action doesn't replace checking Setup Complete or verifying an export run.\nSee admin-manage-fabric-export#configure-synchronization-behavior.\n## Secure the Fabric connection\nBusiness Central shows a privacy notice before it accesses Microsoft Fabric. An administrator must approve the notice before the connection or synchronization can start.\n## Troubleshoot setup\n### Business Central can't get an access token for Fabric\nSymptom: Business Central can't get an access token when it connects to Fabric. In the Microsoft Entra admin center, the Dynamics 365 Business Central Fabric Export enterprise application shows no permissions that you can grant.\nResolution: Update the Microsoft Fabric Mirroring (Preview) extension to the latest version, and then run the setup again. Get the latest version from Microsoft Marketplace<https://go.microsoft.com/fwlink/?LinkId=2384210>.\nIf you already started a synchronization, follow the steps in #reset-the-connection-after-an-update-or-failed-setup.\n### Setup doesn't complete, or synchronization doesn't behave as expected\nSymptoms: You might see one or more of these problems, often after you update the extension or after an earlier setup attempt failed:\n Setup Complete doesn't get selected, even after you select Refresh page.\n Every export run is a full export instead of an incremental one.\n Columns for option fields contain the option value but no text. For example, the Account Type column for G/L accounts has a value, but the column next to it that should show the account type text is empty.\nResolution: Reset the connection as described in the next section.\n### Reset the connection after an update or failed setup\n1. Open the Microsoft Fabric Mirroring Setup (Preview) page.\n1. If a synchronization is running, select Stop synchronization.\n1. Select Connect to Fabric again. Point it to the same open mirrored database you used before.\n1. After you select Connect to Fabric, it might take up to 10 minutes for Setup Complete to change to True. Select Refresh page until Setup Complete is selected.\n1. Select Start synchronization.\n1. Open Fabric Synchronization Overview to check the first export run and its result.\n> NOTE\n> Resetting the connection doesn't change authentication. You don't have to create the service principal again or grant workspace access again.\n> For tables whose schema changed, the first synchronization run after the reset is a snapshot. For other tables, incremental export continues from where it stopped.\n## Related information\nData mirroring to Microsoft Fabric from Business Central<admin-fabric>\nManage Business Central data synchronization with Fabric<admin-manage-fabric-export>\nMonitor and troubleshoot Fabric synchronization<admin-monitor-fabric-export>\nOpen mirroring in Microsoft Fabric<https://learn.microsoft.com/fabric/mirroring/open-mirroring>\nFind free e-learning modules for Business Central here<https://learn.microsoft.com/training/dynamics365/business-central>"}