volumes 命令群組

volumes 內的命令群組包含管理 Unity 目錄中磁碟區的命令。 磁碟區提供存取、儲存、控管、組織和處理檔案的功能。 請參閱什麼是 Unity Catalog 磁碟區？。

建立 databricks 磁碟區

建立新的磁碟區。

用戶可以建立外部磁碟區或受控磁碟區。 外部磁碟區將會建立在指定的外部位置，而 Managed 磁碟區會位於父架構或父目錄或中繼存放區所指定的預設位置。

若要讓磁碟區建立成功，用戶必須滿足下列條件：

• 呼叫端必須是中繼存放區管理員，或是父目錄和架構的擁有者，或具有 USE_CATALOG 父目錄的許可權和 USE_SCHEMA 父架構的許可權。
• 呼叫端必須具有 CREATE VOLUME 父架構的許可權。

針對外部磁碟區，也需要滿足下列條件：

• 呼叫端必須具有 CREATE EXTERNAL VOLUME 外部位置的權限。
• 沒有其他數據表，也沒有存在於指定儲存位置中的磁碟區。 - 指定的儲存位置不在其他資料表的位置、磁碟區、目錄或是架構之下。

databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]

Arguments

CATALOG_NAME

    架構和卷所在的目錄名稱

SCHEMA_NAME

    磁碟區所在的架構名稱

NAME

    卷冊的名稱

VOLUME_TYPE

    磁碟區的型別。 外部磁碟區存放於指定的外部位置。 受控磁碟區位於父架構或父目錄或中繼存放區所指定的預設位置。 請參閱 受管理磁碟區與外部磁碟區。 支援的值：EXTERNAL、MANAGED

選項

--comment string

    附加至磁碟區的批注。

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

--storage-location string

    雲端上的儲存位置。

全域旗標

Examples

下列範例會建立受控磁碟區：

databricks volumes create my_catalog my_schema my_volume MANAGED

下列範例會建立具有註解的外部磁碟區：

databricks volumes create my_catalog my_schema my_external_volume EXTERNAL --storage-location s3://my-bucket/my-volume --comment "External volume for data processing"

刪除 databricks 磁碟區

從指定的父目錄和架構中刪除磁碟區。

呼叫端必須是中繼存放區管理員或磁碟區的擁有者。 在後者的情況下，呼叫者也必須是擁有者，或擁有父目錄的USE_CATALOG權限和父架構的USE_SCHEMA權限。

databricks volumes delete NAME [flags]

Arguments

NAME

    磁碟區的三層（完整）名稱

選項

全域旗標

Examples

下列範例會刪除磁碟區：

databricks volumes delete my_catalog.my_schema.my_volume

databricks 磁碟區清單

列出父目錄和架構下目前中繼存放區的磁碟區。

傳回的磁碟區會根據呼叫使用者的許可權進行篩選。 例如，中繼存放區管理員能夠列出所有磁碟區。 一般使用者必須是擁有者，或具有 READ VOLUME 權限才能在回應中獲取磁碟區。 在後者的情況下，呼叫者也必須是擁有者，或擁有父目錄的USE_CATALOG權限和父架構的USE_SCHEMA權限。

不保證陣列中的元素有特定的順序。

databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    目錄的識別碼

SCHEMA_NAME

    架構的識別碼

選項

--include-browse

    是否要在主體只能存取選擇性元數據的回應中包含磁碟區。

--max-results int

    要傳回的磁碟區數目上限（頁面長度）。

--page-token string

    先前要求傳回的不透明令牌。

全域旗標

Examples

下列範例會列出目錄和架構中的所有磁碟區：

databricks volumes list my_catalog my_schema

databricks 資料卷讀取

從中繼存放區取得特定目錄和架構的磁碟區。

呼叫者必須是中繼存放區的管理員或該磁碟區的擁有者（或者對該磁碟區具有READ VOLUME許可權）。 在後者的情況下，呼叫者也必須是擁有者，或擁有父目錄的USE_CATALOG權限和父架構的USE_SCHEMA權限。

databricks volumes read NAME [flags]

Arguments

NAME

    磁碟區的三層（完整）名稱

選項

--include-browse

    是否要在主體只能存取選擇性元數據的回應中包含磁碟區。

全域旗標

Examples

下列範例說明如何獲取磁碟區的資訊：

databricks volumes read my_catalog.my_schema.my_volume

下列範例會取得磁碟區資訊，包括瀏覽元數據：

databricks volumes read my_catalog.my_schema.my_volume --include-browse

databricks 磁碟區更新

在指定的父目錄和架構下更新指定的磁碟區。

呼叫端必須是中繼存放區管理員或磁碟區的擁有者。 在後者的情況下，呼叫者也必須是擁有者，或擁有父目錄的USE_CATALOG權限和父架構的USE_SCHEMA權限。

目前只能更新磁碟區的名稱、擁有者或批注。

databricks volumes update NAME [flags]

Arguments

NAME

    磁碟區的三層（完整）名稱

選項

--comment string

    附加至磁碟區的批注。

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

--new-name string

    磁碟區的新名稱。

--owner string

    擁有磁碟區之用戶的標識碼。

全域旗標

Examples

下列範例會更新磁碟區的註解：

databricks volumes update my_catalog.my_schema.my_volume --comment "Updated comment for my volume"

下列範例會變更磁碟區的擁有者：

databricks volumes update my_catalog.my_schema.my_volume --owner someone@example.com

下列範例會重新命名磁碟區：

databricks volumes update my_catalog.my_schema.my_volume --new-name my_new_volume_name

全域旗標

--debug

  是否要啟用偵錯記錄。

-h 或 --help

    顯示 Databricks CLI、相關命令群組或相關命令的幫助說明。

--log-file 字串

    字串，表示要寫入輸出記錄檔的檔案。 若未指定此旗標，則預設值是將輸出記錄寫入 stderr。

--log-format 格式

    記錄格式類型，text 或 json。 預設值是 text。

--log-level 字串

    表示日誌格式層級的字串。 若未指定，則日誌的格式層級功能將被停用。

-o, --output 類型

    指令輸出類型，text 或 json。 預設值是 text。

-p, --profile 字串

    用於執行命令的~/.databrickscfg檔案中的配置檔名稱。 如果未指定此旗標，則如果存在，則會使用名為 DEFAULT 的配置檔。

--progress-format 格式

    顯示進度記錄的格式：default、、appendinplace、 或json

-t, --target 字串

    如果適用，要使用的套件組合目標