共用方式為

CREATE VOLUME

  • 發行項

適用於：核取記號為「是」Databricks SQL 核取記號為「是」 Databricks Runtime 13.3 LTS 和更新版本 核取記號為「是」 僅限 Unity Catalog

建立具有指定名稱的磁碟區。 如果在架構中已存在相同名稱的磁碟區，則會引發錯誤 VOLUME_ALREADY_EXISTS。

如需使用磁碟區的詳細資訊，請參閱磁碟區。

語法

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

參數

  • EXTERNAL

    建立外部磁碟區。 如果未 EXTERNAL 指定 ，語句會 建立受控磁碟區。

  • IF NOT EXISTS

    如果磁碟區不存在，則建立具有指定名稱的磁碟區。 如果具有相同名稱的磁碟區已經存在，則不會發生任何動作。

  • volume_name

    要建立的磁碟區名稱。 磁碟區只能在 Unity 目錄架構中建立。

  • 位置 location_path

    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