Condividi tramite


CREATE VOLUME

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

Crea un volume con il nome specificato. Se nel SCHEMA_NOT_FOUND dello schema è già presente un volume con lo stesso nome.

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

Sintassi

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

Parametri

  • EXTERNAL

    Crea un volume 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.

  • comment

    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