Condividi tramite

DESCRIBE VOLUME

  • Articolo

Si applica a:segno di spunta sì Solo databricks SQL segno di spunta sì Databricks Runtime 13.3 LTS e versioni successive segno di spunta sì al catalogo Unity

Restituisce i metadati di un volume esistente. Le informazioni sui metadati includono il nome del volume, lo schema, il catalogo, il tipo, il commento e il proprietario. Se viene specificata l'opzione facoltativa EXTENDED , restituisce le informazioni di base sui metadati insieme alle altre proprietà del catalogo.

Sintassi

DESCRIBE VOLUME volume_name

Parametri

  • volume_name: nome di un volume esistente nel catalogo unity. Se il nome non esiste, viene generata un'eccezione.

Valori restituiti

Set di risultati a riga singola con le colonne seguenti:

  • name STRING NOT NULL: nome del volume; identifica l'oggetto volume.
  • catalog STRING NOT NULL: nome del catalogo contenente il volume.
  • database STRING NOT NULL: nome dello schema contenente il volume.
  • owner STRING NOT NULL: entità proprietaria del volume.
  • storageLocation STRING: percorso della posizione esterna in cui risiede il volume esterno. NULL per i volumi gestiti.
  • volumeType STRING NOT NULL: tipo di volume, valori possibili: EXTERNAL, MANAGED.
  • comment STRING: commento associato al volume.

Esempi

- 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