Note
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
model-versions 的命令群組包含一些命令，用於管理 Unity 編目中的模型註冊表中的模型版本。 Unity 目錄中的模型提供跨 Databricks 工作區的 ML 模型的集中式訪問控制、稽核、譜系和探索。 請參閱在 Unity 目錄中管理模型生命週期。
databricks 模型版本刪除
從指定的已註冊模型中刪除模型版本。 指派給模型版本的任何別名也會被刪除。
呼叫端必須是中繼存放區管理員或父註冊模型的擁有者。 在後者的情況下，呼叫者必須是擁有者或擁有父目錄的USE_CATALOG權限以及父架構的USE_SCHEMA權限。
databricks model-versions delete FULL_NAME VERSION [flags]
Arguments
FULL_NAME
模型版本的三級完整限定名稱
VERSION
模型版本的整數版本號碼
選項
Examples
下列範例會刪除第 1 版的模型：
databricks model-versions delete main.my_schema.my_model 1
databricks 模型版本取得
取得模型版本。
呼叫端必須是中繼存放區管理員或父註冊模型的擁有者，或具備 EXECUTE 權限。 在後者的情況下，呼叫者必須是擁有者或擁有父目錄的USE_CATALOG權限以及父架構的USE_SCHEMA權限。
databricks model-versions get FULL_NAME VERSION [flags]
Arguments
FULL_NAME
模型版本的三級完整限定名稱
VERSION
模型版本的整數版本號碼
選項
--include-aliases
是否要在回應中包含與模型版本相關聯的別名。
--include-browse
是否應在主體僅能存取選擇性元數據的情況下，在回應中包含模型版本。
Examples
下列範例會取得第 1 版的模型：
databricks model-versions get main.my_schema.my_model 1
下列範例會取得包含別名的模型第 1 版：
databricks model-versions get main.my_schema.my_model 1 --include-aliases
Databricks 模型版本 `get-by-alias`
依別名取得模型版本。
呼叫端必須是中繼存放區管理員或註冊模型的擁有者（或具有 EXECUTE 許可權）。 在後者的情況下，呼叫者必須是擁有者或擁有父目錄的USE_CATALOG權限以及父架構的USE_SCHEMA權限。
databricks model-versions get-by-alias FULL_NAME ALIAS [flags]
Arguments
FULL_NAME
已註冊模型的三層（完整）名稱
ALIAS
別名的名稱
選項
--include-aliases
是否要在回應中包含與模型版本相關聯的別名。
Examples
下列範例會依暱稱取得模型版本：
databricks model-versions get-by-alias main.my_schema.my_model production
下列範例會依別名取得包含別名的模型版本：
databricks model-versions get-by-alias main.my_schema.my_model production --include-aliases
databricks 模型版本清單
列出模型版本。 您可以在特定架構下列出模型版本，或列出目前中繼存放區中的所有模型版本。
傳回的模型會根據呼叫使用者的許可權進行篩選。 例如，中繼存放區管理員能夠列出所有模型版本。 一般使用者必須是父註冊模型的擁有者，或擁有 EXECUTE 權限，才能在回應中接收到模型版本。 在後者的情況下，呼叫者必須是擁有者或擁有父目錄的USE_CATALOG權限以及父架構的USE_SCHEMA權限。
不保證響應中元素的特定順序。 回應中的元素不會包含任何別名或標記。
databricks model-versions list FULL_NAME [flags]
Arguments
FULL_NAME
註冊模型的完整三層名稱，用於列出模型版本
選項
--include-browse
是否應在主體僅能存取選擇性元數據的情況下，在回應中包含模型版本。
--max-results int
要傳回的模型版本數目上限。
--page-token string
不透明分頁令牌會根據上一個查詢移至下一頁。
Examples
下列範例會列出已註冊模型的所有模型版本：
databricks model-versions list main.my_schema.my_model
下列範例列出具有分頁的模型版本：
databricks model-versions list main.my_schema.my_model --max-results 10 --page-token abc123token
databricks 模型版本更新
更新指定的模型版本。
呼叫端必須是中繼存放區管理員或父註冊模型的擁有者。 在後者的情況下，呼叫者必須是擁有者或擁有父目錄的USE_CATALOG權限以及父架構的USE_SCHEMA權限。
目前只能更新模型版本的批注。
databricks model-versions update FULL_NAME VERSION [flags]
Arguments
FULL_NAME
模型版本的三級完整限定名稱
VERSION
模型版本的整數版本號碼
選項
--comment string
附在模型版本上的批注。
--json JSON
內嵌 JSON 字串或 @path 指向 JSON 檔案的要求本文
Examples
下列範例會更新模型版本的註釋：
databricks model-versions update main.my_schema.my_model 1 --comment "Updated model with improved accuracy"
下列範例會使用 JSON 檔案更新模型版本：
databricks model-versions update main.my_schema.my_model 1 --json @model-version-update.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 字串
如果適用，要使用的套件組合目標