Поделиться через

CREATE VOLUME

  • Статья

применяется к:флажок Databricks SQL флажок Databricks Runtime 13.3 LTS и новее флажок Unity Catalog только

Создает том с указанным именем. Если том с таким же именем уже существует, выдается schemaVOLUME_ALREADY_EXISTS.

Дополнительные сведения об использовании Volumesсм. в volumes.

Синтаксис

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

Parameters

  • EXTERNAL

    Создает внешний том. Если EXTERNAL инструкция не указана, создается управляемый том.

  • IF NOT EXISTS

    Создает том с заданным именем, если он не существует. Если том с тем же именем уже существует, ничего не произойдет.

  • volume_name

    Имя создаваемого тома. Volumes можно создать только в схемах Unity Catalog.

  • LOCATION location_path

    location_path STRING— это литерал, определяющий путь файловой системы, в которой создается указанный внешний том. Если указанный путь не существует в файловой системе, создается каталог с этим путем. Выбранный путь не должен перекрываться с расположением какого-либо другого volumes или tables.

  • Данный пункт не применяется для управляемых volumes.

  • комментарий

    Необязательное STRING описание литерала для тома.

Примеры


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