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.

Disabled tenant setting or service principal not in the allowed security group.

Verify the following:

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

  2. The service principal (or its security group) is included in the allowed list for the above tenant setting.

  3. The service principal is added as a Member to at least one Fabric workspace.

  4. Wait up to 15 minutes after enabling tenant settings for changes to take effect.

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.