DESCRIBE CATALOG (Databricks SQL)

Preview

Unity Catalog is in Public Preview. To participate in the preview, contact your Databricks representative.

Returns the metadata of an existing catalog. The metadata information includes catalog name, comment, and owner. If the optional EXTENDED option is specified, it returns the basic metadata information along with the other catalog properties.

Syntax

{ DESC | DESCRIBE } CATALOG [ EXTENDED ] catalog_name

Parameters

  • catalog_name: The name of an existing catalog in the metastore. If the name does not exist, an exception is thrown.

Examples

> DESCRIBE CATALOG main;
 info_name     info_value
 ------------  ------------------------------------
 Catalog Name                                  main
      Comment           Main catalog (auto-created)
        Owner                 metastore-admin-users

> DESCRIBE CATALOG EXTENDED main;
 info_name     info_value
 ------------  ------------------------------------
 Catalog Name                                  main
      Comment  This is a reserved catalog in Spark.
      Comment           Main catalog (auto-created)
        Owner                 metastore-admin-users
   Created By
   Created At
   Updated By
   Updated At