СОЗДАНИЕ ТОМА

  • Статья

Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 13.3 LTS и более поздней проверка помечены да версии каталога Unity

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

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

Синтаксис

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

Параметры

  • EXTERNAL

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

  • IF NOT EXISTS

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

  • volume_name

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

  • LOCATION location_path

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

  • Это предложение не применяется для управляемых томов.

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

    Необязательное 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