Share via

VOLUME BESCHRIJVEN

  • Artikel

Van toepassing op:vinkje als ja aan Alleen Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger vinkje als ja aan dan 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 resultatenset met één 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 met het volume.
  • 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. NULL voor 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