Sdílet prostřednictvím

DESCRIBE VOLUME

  • Článek

platí pro:zaškrtněte políčko ano Databricks SQL zaškrtněte políčko ano Databricks Runtime 13.3 LTS a vyšší zaškrtněte políčko ano pouze Unity Catalog

Vrátí metadata existujícího svazku. Informace o metadatech zahrnují název svazku, schema, catalog, typ, komentář a vlastníka. Pokud je zadaná volitelná možnost EXTENDED, vrátí základní informace metadat spolu s dalšími vlastnostmi catalog.

Syntaxe

DESCRIBE VOLUME volume_name

Parameters

  • volume_name: Název existujícího svazku v CatalogUnity. Pokud název neexistuje, vyvolá se výjimka.

Návraty

Jednořádkový výsledek set s následujícími údaji columns:

  • name STRING NOT NULL: Název svazku; identifikuje objekt svazku.
  • catalog STRING NOT NULL: Název svazku v rámci catalog.
  • database STRING NOT NULL: Název schema, který obsahuje svazek.
  • owner STRING NOT NULL: Objekt zabezpečení , který vlastní svazek.
  • storageLocation STRING: Cesta externího umístění, kde se nachází externí svazek where. NULL pro spravované volumes.
  • volumeType STRING NOT NULL: Typ svazku, možný values: EXTERNAL, MANAGED.
  • comment STRING: Komentář připojený ke svazku.

Příklady

- Describe an external volume
> DESCRIBE VOLUME my_external_volume
  name               catalog         database       owner storageLocation                    volumeType comment
  ------------------ --------------- -------------- ----- ---------------------------------- ---------- ---------------
  my_external_volume default_catalog default_schema Alice s3://my-bucket/my-location/my-path EXTERNAL   My first volume

- Describe a managed volume
> DESCRIBE VOLUME managed_volume
  name           catalog         database       owner storageLocation                      volumeType comment
  -------------- --------------- -------------- ----- ------------------------------------ ---------- -----------------------
  managed_volume default_catalog default_schema Alice s3://<metastore-root>/volumes/<uuid> MANAGED    My first managed volume