CREATE VOLUME

  • Article

S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 13.3 LTS et versions ultérieures coche marquée oui Unity Catalog uniquement

Crée un volume du nom spécifié. Si un volume portant le même nom existe déjà dans le schéma, SCHEMA_NOT_FOUND est levée.

Pour plus d’informations sur l’utilisation de volumes, consultez Volumes.

Syntaxe

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

Paramètres

  • EXTERNAL

    Crée un volume externe. Si EXTERNAL n’est pas spécifié, l’instruction crée un volume managé.

  • IF NOT EXISTS

    Crée un volume du nom spécifié s’il n’en existe pas. S’il existe déjà un volume du même nom, rien ne se produit.

  • volume_name

    Nom du volume à créer. Les volumes ne peuvent être créés que dans les schémas Unity Catalog.

  • EMPLACEMENT location_path

    location_path est un littéral STRING qui définit le chemin d'accès du système de fichiers dans lequel le volume externe spécifié est créé. Si le chemin spécifié n’existe pas dans le système de fichiers sous-jacent, crée un répertoire avec le chemin. Le chemin d’accès choisi ne doit pas chevaucher l’emplacement d’autres volumes ou tables.

  • Cette clause ne s’applique pas aux volumes managés.

  • commentaire

    Description du littéral STRING facultative pour le volume.

Exemples


-- 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