DESCRIBE VOLUME
nl-NL: Van toepassing op:
Databricks SQL Databricks Runtime 13.3 LTS en hoger Alleen Unity Catalog
Retourneert de metagegevens van een bestaand volume. De metagegevensinformatie bevat volumenaam, schema, catalogus, type, opmerking en eigenaar.
Als de optionele EXTENDED optie is opgegeven, worden de basisgegevens van metagegevens samen met de andere cataloguseigenschappen geretourneerd.
Syntaxis
DESCRIBE VOLUME volume_name
Parameters
- volume_name: de naam van een bestaand volume in de Unity Catalog. Als de naam niet bestaat, wordt er een uitzondering gegenereerd.
Retouren
Een set resultaten bestaande uit een enkele rij met de volgende kolommen:
-
name STRING NOT NULL: De naam van het volume; hiermee wordt het volumeobject geïdentificeerd. -
catalog STRING NOT NULL: de naam van de catalogus die het volume bevat. -
database STRING NOT NULL: de naam van het schema dat het volume bevat. -
owner STRING NOT NULL: de principal die eigenaar is van het volume. -
storageLocation STRING: het pad van de externe locatie waar het externe volume zich bevindt.NULLvoor beheerde volumes. -
volumeType STRING NOT NULL: het type volume, mogelijke waarden:EXTERNAL,MANAGED. -
comment STRING: Een opmerking die aan het volume is gekoppeld.
Voorbeelden
- 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