Skip to main content

VOLUME_PRIVILEGES

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime 13.3 LTS and above check marked yes Unity Catalog only

INFORMATION_SCHEMA.VOLUME_PRIVILEGES lists principals that have privileges on a volume in a catalog schema.

This is an extension to the SQL Standard Information Schema.

note

Currently, users with the MANAGE privilege on an object cannot view all grants for that object in the INFORMATION_SCHEMA. Instead, the INFORMATION_SCHEMA only shows grants their own grants on the object. This behavior will be corrected in the future.

Users with MANAGE privilege can view all grants on an object using SQL commands or Catalog Explorer. See Manage privileges in Unity Catalog.

Definition

The VOLUME_PRIVILEGES relation contains the following columns:

NameData typeNullableDescription
GRANTORSTRINGNoPrincipal that granted the privilege.
GRANTEESTRINGNoPrincipal to which the privilege is granted.
VOLUME_CATALOGSTRINGNoCatalog of relation on which the privilege is granted.
VOLUME_SCHEMASTRINGNoSchema of relation on which the privilege is granted.
VOLUME_NAMESTRINGNoVolume on which the privilege is granted.
PRIVILEGE_TYPESTRINGNoPrivilege being granted.
IS_GRANTABLESTRINGNoAlways NO. Reserved for future use.
INHERITED_FROMSTRINGYesThe ancestor relation that the privilege is inherited from.

Constraints

The following constraints apply to the VOLUME_PRIVILEGES relation:

ClassNameColumn ListDescription
Primary keyVOLUMEPRIVS_PKGRANTOR, GRANTEE, VOLUME_CATALOG, VOLUME_SCHEMA, VOLUME_NAME, PRIVILEGE_TYPEUnique identifier for the granted privilege.
Foreign keyVOLUMEPRIVS_VOLUMES_FKVOLUME_CATALOG, VOLUME_SCHEMA, VOLUME_NAMEReferences VOLUMES

Examples

SQL
> SELECT volume_catalog, volume_schema, volume_name, grantee
FROM information_schema.volume_privileges;