Troubleshoot semantic model connections in plan (preview)

This article provides troubleshooting guidance for semantic model connection issues in plan (preview) in Microsoft Fabric. For information about known limitations, see Known limitations in plan (preview).

Important

This feature is in preview.

Insufficient permissions to connect to semantic model

The error appears with the following description: The connection owner must be a workspace Member or Admin. Ask a workspace Admin to update the role in Workspace settings > Access.

Cause

The shared cloud connection owner has insufficient permissions. The connection owner, whether using OAuth or a service principal, must have a workspace Member or Admin role. Users with lower-level permissions can't generate access tokens for the semantic model.

Resolution

If you're a Contributor or Member in the workspace, ask the workspace Admin to follow these steps:

1. Go to the workspace and select Manage access.
2. Check the role assigned to the connection owner.
3. Upgrade the connection owner's role to Member or Admin.

Semantic model not found

Cause

The semantic model linked to the shared cloud connection can't be found. It might have been moved, renamed, or deleted.

Resolution

1. Verify that the semantic model exists in the required workspace in Microsoft Fabric.
2. If it got moved, locate the new workspace and connect to it.
3. Ensure the connection owner has either Member or Admin access to the correct workspace.
4. If not, ask a workspace Admin to upgrade the connection owner's role to either Member or Admin in Workspace > Manage access.

Shared cloud connection expired

Cause

The credentials for this shared cloud connection expired.

Resolution

The connection owner must reauthenticate the connection by following these steps:

1. In Microsoft Fabric Home, go to Settings > Manage connections and gateways.
2. Locate the connection, select More actions (···), then Settings.
3. Select Edit credentials, reauthenticate, and then select Save.
4. Return to the artifact and retry the connection.

When workspace is not accessible

Before troubleshooting, ensure that you have completed all the steps described in this article: Create and share a cloud connection for a semantic model.

Another possible cause

The owner of the shared cloud connection is not a Member of the workspace.

Resolution

If you're a Contributor in the workspace, ask a workspace Member or Admin to follow these steps:

1. Go to the workspace and select Manage access.
2. Add the connection owner as a Member or Admin of the workspace.
3. Retry the connection in the artifact.