Condividi tramite

CREATE VOLUME

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 13.3 LTS e versioni successive segno di spunta sì solo al Catalogo Unity

Crea un volume con il nome specificato. Se esiste già un volume con lo stesso nome nello schema, viene sollevato VOLUME_ALREADY_EXISTS.

Per informazioni dettagliate sull'uso dei volumi, vedere Volumi .

Sintassi

CREATE [ EXTERNAL ] VOLUME [ IF NOT EXISTS ] volume_name
    [ LOCATION location_path ]
    [ COMMENT comment ]

Parametri

  • ESTERNO

    Crea un volume esterno. I volumi esterni devono essere registrati in una directory all'interno di un percorso esterno. Se EXTERNAL non viene specificato, l'istruzione crea un volume gestito.

  • SE NON ESISTE

    Crea un volume con il nome specificato, se non esiste. Se esiste già un volume con lo stesso nome, non verrà eseguita alcuna operazione.

  • volume_name

    Nome del volume da creare. I volumi possono essere creati solo negli schemi del catalogo Unity.

  • UBICAZIONE location_path

    location_pathè un STRING valore letterale che definisce il percorso del file system in cui viene creato il volume esterno specificato. Se il percorso specificato non esiste nel file system sottostante, crea una directory con il percorso. Il percorso scelto non deve sovrapporsi alla posizione di altri volumi o tabelle.

  • Questa clausola non si applica ai volumi gestiti.

  • commento

    Descrizione letterale facoltativa STRING per il volume.

Esempi


-- Create an external volume on the specified location with comment
> CREATE EXTERNAL VOLUME my_catalog.my_schema.my_external_volume
    LOCATION 's3://my-bucket/my-location/my-path'
    COMMENT 'This is my example external volume on S3'
  OK

-- Query the data from the file in the created volume
> SELECT *
    FROM csv.`/Volumes/my_catalog/my_schema/my_external_volume/foo.csv`

-- Create a managed volume with full schema name
> CREATE VOLUME my_catalog.my_schema.my_volume
  OK

-- Create a managed volume in default catalog and schema
> CREATE VOLUME my_another_volume
  OK
  • Last updated on