An Apache Spark-based analytics platform optimized for Azure.
Follow these steps to resolve Azure Databricks workspace delete issues and access-denied errors:
- Verify delete permissions on the workspace
- In the Azure portal, open the Databricks workspace resource.
- Go to Access control (IAM).
- Check the role assignments for the signed-in identity.
- Ensure a role is assigned that allows delete on the resource (for example, a role that includes
Microsoft.Databricks/workspaces/deletevia built-in roles like Owner/Contributor at the subscription, resource group, or workspace level). - If the required role is missing, have the subscription or resource group Owner grant an appropriate role and then retry deletion.
- Delete the workspace from Azure portal (Databricks UI path)
- Sign in to the Azure Databricks workspace as the account owner (the identity that originally created the workspace).
- In the top bar, select the username → Azure portal.
- In the Azure Databricks service blade that opens, select Delete and follow the prompts to delete the workspace.
- This initiates workspace deletion and cleans up most compute resources.
- Use Azure CLI if portal delete is blocked
- If the portal delete button is disabled or fails, use Azure CLI:
az databricks workspace delete \ --name <workspace-name> \ --resource-group <resource-group-name> \ --subscription <subscription-id> \ --yes - If Unity Catalog is enabled and there is a need to control catalog data retention, add
--force-deletionas needed based on the desired catalog behavior.
- If the portal delete button is disabled or fails, use Azure CLI:
- Understand retention behavior after delete
- After a successful delete, the workspace enters a 7‑day soft-delete state. During this time, some Databricks-managed metadata (notebooks, jobs, configs) may be recoverable, but Azure resources such as VMs, disks, and networking are cleaned up immediately and cannot be restored.
- Treat deletion as permanent and ensure all important data is backed up before retrying deletion.
- If deletion is still blocked by deny assignments
- If a
DenyAssignmentAuthorizationFailedor similar access-denied error persists even for a subscription Owner, it typically indicates a deny assignment at subscription or resource group scope. - A user with sufficient privileges at the tenant or management group level must remove or adjust the deny assignment that blocks
deleteon the Databricks workspace resource, then retry the delete (portal or CLI).
- If a
- If the workspace is stuck in deleting or cannot be removed
- If the workspace remains in a stuck state (for example, deleting for a long time) even after permissions and deny assignments are corrected, open an Azure support request so the backend team can force-complete the delete.
- Be aware of workspace deletion retention policy
- During the 7‑day retention period, the workspace name and metadata may still be reserved. Avoid recreating a workspace with the same name until the soft-delete period has expired or the backend has completed the hard delete.
References: