DESCRIBE CATALOG

  • Article

S’applique à : coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 10.4 LTS et ultérieur coche pour oui Unity Catalog uniquement

Retourne les métadonnées d’un catalogue existant. Les informations de métadonnées incluent le nom du catalogue, le commentaire et le propriétaire. Si l’option facultative EXTENDED est spécifiée, retourne les informations de métadonnées de base ainsi que les autres propriétés de catalogue.

Syntaxe

{ DESC | DESCRIBE } CATALOG [ EXTENDED ] catalog_name

Paramètres

  • catalog_name : nom d’un catalogue existant dans le metastore. Si le nom n’existe pas, une exception est levée.

Exemples

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

> 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
 Catalog Type                               Regular
   Created By
   Created At
   Updated By
   Updated At

-- A catalog from a Delta Sharing share
> DESCRIBE CATALOG vaccinedata;
 info_name     info_value
 ------------  ------------------------------------
 Catalog Name                           vaccinedata
      Comment
        Owner            alwaysworks@databricks.com
 Catalog Type                         Delta Sharing