共用方式為


clean-rooms 命令群組

Note

此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態

Databricks CLI 的使用受限於 Databricks 授權Databricks 隱私權聲明,包括任何使用數據條款。

clean-rooms Databricks CLI 中的指令群組允許你管理無塵室。 乾淨的會議室會使用 Delta Sharing 和無伺服器計算來提供安全且隱私權保護的環境,讓多方可以共同處理敏感數據,而不需要直接存取彼此的數據。 請參閱什麼是 Azure Databricks Clean Rooms?

databricks 清理空間建立

使用指定的共同作業者建立新的乾淨空間。 這個方法是非同步的;在 clean_room 欄位中傳回的 name 欄位可用來使用 get 方法查詢 clean room 狀態。 當此方法傳回時,潔淨室會處於 PROVISIONING 狀態,且只會填入名稱、擁有者、備註、建立時間和狀態。 無塵室將在進入ACTIVE狀態後可以使用。

呼叫端必須是中繼存放區管理員,或具有 CREATE_CLEAN_ROOM 中繼存放區的許可權。

databricks clean-rooms create [flags]

Arguments

None

選項

--comment string

    乾淨房間的批注。

--json JSON

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

--name string

    無塵室的名稱。

--owner string

    這是本機潔淨室可保護物管理者的 Databricks 用戶名稱,用於權限管理。

全域旗標

Examples

下列範例會建立具有名稱和擁有者的乾淨房間:

databricks clean-rooms create --name "my-clean-room" --owner "someone@example.com"

下列範例會建立具有註解的無塵室:

databricks clean-rooms create --name "analytics-clean-room" --owner "someone@example.com" --comment "Clean room for analytics collaboration"

Databricks 潔淨室創建輸出目錄

建立無塵室的輸出目錄。

databricks clean-rooms create-output-catalog CLEAN_ROOM_NAME [flags]

Arguments

CLEAN_ROOM_NAME

    無塵室名稱。

選項

--catalog-name string

    Unity Catalog 中輸出目錄之名稱。

--json JSON

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

全域旗標

Examples

下列範例會為乾淨的房間建立輸出目錄:

databricks clean-rooms create-output-catalog my-clean-room --catalog-name "my_output_catalog"

databricks 清潔室刪除

刪除無塵室。 刪除之後,無塵室將會從中繼資料庫中移除。 如果其他共同作業者尚未刪除清理室,它們仍會在中繼存放區中擁有乾淨的空間,但它會處於 DELETED 狀態,而且無法對其執行刪除以外的任何作業。

databricks clean-rooms delete NAME [flags]

Arguments

NAME

    無塵室名稱。

選項

全域旗標

Examples

下列範例會刪除無塵室:

databricks clean-rooms delete my-clean-room

databricks clean-rooms 查詢

取得無塵室的詳細資料,根據其名稱。

databricks clean-rooms get NAME [flags]

Arguments

NAME

    無塵室名稱。

選項

全域旗標

Examples

下列範例會取得乾淨的房間詳細數據:

databricks clean-rooms get my-clean-room

下列範例會使用特定設定檔取得乾淨的房間詳細資料:

databricks clean-rooms get analytics-clean-room --profile production

databricks 無塵室清單

列出元存儲庫的所有潔淨室。 只會傳回呼叫端可存取的乾淨房間。

databricks clean-rooms list [flags]

Arguments

None

選項

--page-size int

    要傳回的乾淨房間數目上限(也就是頁面長度)。

--page-token string

    不透明分頁令牌會根據上一個查詢移至下一頁。

全域旗標

Examples

下列範例會列出所有可存取的乾淨的會議室:

databricks clean-rooms list

下列範例會列出具有特定頁面大小的無塵室:

databricks clean-rooms list --page-size 10

databricks 無塵室更新

更新乾淨的房間。 呼叫端必須是潔淨室的擁有者、具有 MODIFY_CLEAN_ROOM 許可權或 Metastore 管理員。

當呼叫端是 Metastore 管理員時,只有 owner 欄位可以更新。

databricks clean-rooms update NAME [flags]

Arguments

NAME

    無塵室名稱。

選項

--json JSON

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

全域旗標

Examples

下列範例會使用 JSON 設定來更新無塵室:

databricks clean-rooms update my-clean-room --json '{"comment": "Updated clean room description"}'

下列範例會更新無塵室的擁有者(僅限中繼存放區管理員):

databricks clean-rooms update my-clean-room --json '{"owner": "new-someone@example.com"}'

下列範例會使用JSON檔案更新無塵室:

databricks clean-rooms update my-clean-room --json @update-config.json

全域旗標

--debug

  是否要啟用偵錯記錄。

-h--help

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

--log-file 字串

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

--log-format 格式

    記錄格式類型,textjson。 預設值是 text

--log-level 字串

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

-o, --output 類型

    指令輸出類型,textjson。 預設值是 text

-p, --profile 字串

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

--progress-format 格式

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

-t, --target 字串

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