Compartir a través de

CREAR VOLUMEN

  • Artículo

Se aplica a: casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 13.3 LTS y versiones posteriores casilla de verificación marcada solo a Unity Catalog

Crea un volumen compartido con el nombre especificado. Si ya existe un volumen con el mismo nombre en el esquema SCHEMA_NOT_FOUND se genera.

Consulte Volúmenes para obtener más información sobre el uso de volúmenes.

Sintaxis

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

Parámetros

  • EXTERNAL

    Crea un volumen externo. Si EXTERNAL no se especifica, la instrucción crea un volumen administrado.

  • IF NOT EXISTS

    Crea un volumen compartido con el nombre especificado si no existe. Si ya existe un volumen compartido con el mismo nombre, no ocurrirá nada.

  • volume_name

    Nombre del volumen que se va a crear. Los volúmenes solo se pueden crear en esquemas de Unity Catalog.

  • UBICACIÓN location_path

    location_path es una STRINGdefinición literal del camino del sistema de filas en donde el volumen externo especificado es creado. Si la ruta de acceso especificada no existe en el sistema de archivos subyacente, crea un directorio con la ruta de acceso. La ruta de acceso elegida no debe superponerse con la ubicación de ningún otro volumen o tabla.

  • Esta cláusula no se aplica a los volúmenes administrados.

  • comentario

    Descripción literal opcional STRING del volumen.

Ejemplos


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