Troubleshooting

Alation Cloud Service Applies to Alation Cloud Service instances of Alation

For general information about connector logs, refer to Troubleshoot OCF Connectors.

Refer to the following sections for help in troubleshooting common issues with the Microsoft Fabric OCF connector.

Authentication Issues

Problem

Cause

Solution

Service principal cannot access Fabric APIs.

Invalid credentials, missing permissions, or disabled tenant setting.

Verify the following:

  1. The Fabric.Read.All permission has been granted in Azure AD.

  2. Admin consent has been granted.

  3. “Service principals can use Fabric APIs” is enabled in Admin Portal > Tenant Settings > Developer settings.

  4. The service principal is in the correct security group.

Test connection fails with authentication error.

Incorrect tenant ID, client ID, or client secret.

Verify the Azure AD application registration values. Ensure the client secret has not expired.

Test connection fails with timeout.

Network firewall or proxy blocking outbound traffic.

Ensure outbound HTTPS access to login.microsoftonline.com and api.fabric.microsoft.com on port 443.

Metadata Extraction Issues

Problem

Cause

Solution

No workspaces found during preflight check.

The service principal does not have access to any Fabric workspaces.

Add the service principal as a workspace member or admin in the Microsoft Fabric portal.

MDE completes but no workspaces are extracted.

The service principal does not have access to the selected workspaces.

Grant the service principal member or admin access to the workspaces in the Fabric portal.

Lakehouses or warehouses are missing from extraction results.

Items are in staging, hidden, or have the HiddenInWorkspace relation type.

These items are intentionally filtered out. No action is needed.