CREATE VOLUME

  • 發行項

適用於：檢查標示為是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 指定 ，語句會 建立受控磁碟區。

  • 如果不存在

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

  • 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