Skip to main content

TABLE_PRIVILEGES

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

INFORMATION_SCHEMA.TABLE_PRIVILEGES lists principals that have privileges on a table in a catalog 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 TABLE_PRIVILEGES relation contains the following columns:

NameData typeNullableStandardDescription
GRANTORSTRINGNoYesPrincipal that granted the privilege.
GRANTEESTRINGNoYesPrincipal to which the privilege is granted.
TABLE_CATALOGSTRINGNoYesCatalog of relation on which the privilege is granted.
TABLE_SCHEMASTRINGNoYesSchema of relation on which the privilege is granted.
TABLE_NAMESTRINGNoYesRelation on which the privilege is granted.
PRIVILEGE_TYPESTRINGNoYesPrivilege being granted.
IS_GRANTABLESTRINGNoYesAlways NO. Reserved for future use.
INHERITED_FROMSTRINGNoNoThe ancestor relation that the privilege is inherited from.

Constraints

The following constraints apply to the TABLE_PRIVILEGES relation:

ClassNameColumn ListDescription
Primary keyTABLEPRIVS_PKGRANTOR, GRANTEE, TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME, PRIVILEGE_TYPEUnique identifier for the granted privilege.
Foreign keyTABLEPRIVS_TABLES_FKTABLE_CATALOG, TABLE_SCHEMA, TABLE_NAMEReferences TABLES

Examples

SQL
> SELECT table_catalog, table_schema, table_name, grantee
FROM information_schema.table_privileges;