CREATE VOLUME

适用于:勾选“是” Databricks SQL 勾选“是” Databricks Runtime 13.3 LTS 及更高版本 勾选“是” 仅 Unity Catalog

创建具有指定名称的卷。 如果架构中已存在同名卷,则会引发 SCHEMA_NOT_FOUND 错误。

有关如何使用卷的详细信息,请参阅

语法

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

parameters

  • EXTERNAL

    创建外部卷。 如果未指定 EXTERNAL,则该语句会创建一个托管卷

  • IF NOT EXISTS

    创建具有给定名称的卷(如果不存在)。 如果已存在同名卷,则不会执行任何操作。

  • volume_name

    要创建的卷的名称。 只能在 Unity Catalog 架构中创建卷。

  • 位置

    location_path 是一个 STRING 文本,定义在其中创建指定外部卷的文件系统的路径。 如果基础文件系统中不存在指定的路径,则使用该路径创建一个目录。 所选路径不应与任何其他卷或表的位置重叠。

  • 此子句不适用于托管卷

  • comment

    卷的可选 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