Skip to main content

CATALOGS

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.CATALOGS describes catalogs.

Information is displayed only for catalogs bound to the current workspace that the user has permission to interact with.

This is an extension to the SQL Standard Information Schema.

Definition

The CATALOGS relation contains the following columns:

NameData typeNullableDescription
CATALOG_NAMESTRINGNoName of the catalog.
CATALOG_OWNERSTRINGNoOwner of the catalog.
COMMENTSTRINGYesAn optional comment that describes the catalog.
CREATEDTIMESTAMPNoTimestamp when the catalog was created.
CREATED_BYSTRINGNoPrincipal who created the catalog.
LAST_ALTEREDTIMESTAMPNoTimestamp when the catalog was last altered in any way.
LAST_ALTERED_BYSTRINGNoPrincipal who last altered the catalog.

Constraints

The following constraints apply to the CATALOGS relation:

ClassNameColumn ListDescription
Primary keyCATALOGS_PKCATALOG_NAMEUnique identifier for the catalog.

Examples

SQL
> SELECT catalog_owner
FROM information_schema.catalogs