Skip to content

Fixing a broken or unreachable shortcut

OneLake shortcuts are virtual references that point to data stored in another location, either within OneLake or in external sources like ADLS Gen2, S3, or Dataverse. When a shortcut breaks or misbehaves, it's usually due to permission changes, deleted source data, expired credentials, or network/firewall configuration issues, and troubleshooting starts with the shortcut's status and target path validation.

Must-know

  • A shortcut error often surfaces as a failure to browse, query, or list files under the shortcut node in the Lakehouse explorer, so first confirm the target path still exists at the source.
  • For shortcuts to external sources (ADLS Gen2, S3-compatible storage, on-premises via gateway), the connection credentials or SAS token/key stored in the shortcut's connection must remain valid; expired or rotated credentials are a common cause of failures.
  • Internal OneLake-to-OneLake shortcuts fail if the caller lacks read permissions on the source item (Lakehouse/Warehouse) or if the source item, workspace, or capacity has been deleted or moved.
  • Shortcuts to external storage require correct network access; if the source storage account enforces firewall rules or private endpoints, OneLake's outbound IPs or the required trusted service/managed private endpoint must be allowed.
  • Deleting a shortcut only removes the reference in OneLake and never deletes the underlying source data, so a broken shortcut can typically be safely removed and recreated once the underlying access issue is fixed.
  • Renaming, moving, or deleting the source folder/table after a shortcut is created will break the shortcut, since shortcuts bind to a specific path and do not automatically follow renames.
Check this objectiveFree · always available

A data engineer creates a shortcut in a Fabric lakehouse that points to a folder in an Azure Data Lake Storage Gen2 account. The connection was configured to authenticate using the organizational account of whoever queries the shortcut. A colleague with Viewer access to the workspace opens the shortcut and receives an access-denied error, even though the engineer can query the same shortcut without issue. What is the most likely cause?

Your objective map0 tried · 0 right · 54 untouched

What you have tried across DP-700's objectives, not a readiness score.

Coverage checked against the published exam guide on Aug 12, 2026.

These are independent practice questions, written against this certification's published exam guide. They are not the certification vendor's own questions, and not the real exam.