What causes VOLUME_NOT_FOUND?

The volume was dropped and the pipeline was not updated to reference the replacement. The three-part name (catalog.schema.volume) has a typo or uses the wrong catalog for the environment. The job is running in a workspace attached to a different metastore that does not contain the volume. The volume was created in a personal or dev schema that does not exist in production

How do I fix VOLUME_NOT_FOUND?

Step 1: Run SHOW VOLUMES IN catalog.schema to list existing volumes and verify the name.. Step 2: If the volume was recently dropped, determine whether it needs to be recreated or if the pipeline reference needs to be updated.. Step 3: Check that the job is running in the correct workspace and against the correct catalog (dev vs. prod catalog).. Step 4: Update the pipeline code or job configuration to use the correct three-part volume name.. Step 5: Test by running a SELECT or LIST DIRECTORY on the volume path before re-enabling the scheduled job.

High severityconfiguration

Power BI Refresh Error:
VOLUME_NOT_FOUND

What does this error mean?

A SQL statement or job task referenced a Unity Catalog volume using a three-part name that does not exist, has been dropped, or is in a different catalog or schema than expected.

Common causes

1The volume was dropped and the pipeline was not updated to reference the replacement
2The three-part name (catalog.schema.volume) has a typo or uses the wrong catalog for the environment
3The job is running in a workspace attached to a different metastore that does not contain the volume
4The volume was created in a personal or dev schema that does not exist in production

How to fix it

1Step 1: Run SHOW VOLUMES IN catalog.schema to list existing volumes and verify the name.
2Step 2: If the volume was recently dropped, determine whether it needs to be recreated or if the pipeline reference needs to be updated.
3Step 3: Check that the job is running in the correct workspace and against the correct catalog (dev vs. prod catalog).
4Step 4: Update the pipeline code or job configuration to use the correct three-part volume name.
5Step 5: Test by running a SELECT or LIST DIRECTORY on the volume path before re-enabling the scheduled job.

Frequently asked questions

What is the difference between a Unity Catalog volume and an external location?

An external location maps to a cloud storage path and provides raw file access. A volume is a Unity Catalog governed object that sits on top of an external or managed location and exposes it through a /Volumes path with fine-grained access control.

Can a volume be accessed from multiple workspaces?

Yes, provided all workspaces are assigned to the same Unity Catalog metastore and the caller has the required privilege on the volume's catalog and schema.