Note
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
registered-models 內的命令群組包含管理 Unity 目錄中模型登錄中模型的命令。 已註冊的模型提供跨 Databricks 工作區的 ML 模型的集中式訪問控制、稽核、譜系和探索。 請參閱在 Unity 目錄中管理模型生命週期。
databricks 註冊模型 create
在 Unity 目錄中建立新的已註冊模型。
已註冊模型中模型版本的檔案記憶體會位於父架構或父目錄或中繼存放區所指定的預設位置。
若要成功建立已註冊的模型，用戶必須符合下列條件：
- 呼叫端必須是中繼存放區管理員，或是父目錄和架構的擁有者，或具有
USE_CATALOG父目錄的許可權和USE_SCHEMA父架構的許可權。 - 呼叫端必須在父架構上具有
CREATE MODEL或CREATE FUNCTION許可權。
databricks registered-models create CATALOG_NAME SCHEMA_NAME NAME [flags]
Arguments
CATALOG_NAME
架構和已註冊模型所在的目錄名稱。
SCHEMA_NAME
已註冊模型所在的架構名稱。
NAME
已註冊模型的名稱。
選項
--comment string
附加至已註冊模型的批注。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--storage-location string
儲存模型版本數據檔的雲端儲存位置。
Examples
下列範例會在指定的目錄和架構中建立已註冊的模型：
databricks registered-models create main my_schema my_model
下列範例會建立具有批注的已註冊模型：
databricks registered-models create main my_schema my_model --comment "My model description"
databricks 注冊模型刪除
從指定的父目錄和架構中刪除已註冊的模型及其所有模型版本。
呼叫端必須是中繼存放區管理員或已註冊模型的擁有者。 在後者的情況下，呼叫者必須是擁有者或擁有父目錄的USE_CATALOG權限以及父架構的USE_SCHEMA權限。
databricks registered-models delete FULL_NAME [flags]
Arguments
FULL_NAME
已註冊模型的三級（完整限定）名稱。
選項
Examples
下列範例會刪除已註冊的模型：
databricks registered-models delete main.my_schema.my_model
databricks 註冊模型刪除別名
刪除已註冊的模型別名。
呼叫端必須是中繼存放區管理員或已註冊模型的擁有者。 在後者的情況下，呼叫者必須是擁有者或擁有父目錄的USE_CATALOG權限以及父架構的USE_SCHEMA權限。
databricks registered-models delete-alias FULL_NAME ALIAS [flags]
Arguments
FULL_NAME
已註冊模型的三級（完整限定）名稱。
ALIAS
別名的名稱。
選項
Examples
下列範例會刪除已註冊的模型別名：
databricks registered-models delete-alias main.my_schema.my_model production
databricks 註冊模型指令 get
取得已註冊的模型。
呼叫端必須是中繼存放區管理員或註冊模型的擁有者（或具有 EXECUTE 許可權）。 在後者的情況下，呼叫者必須是擁有者或擁有父目錄的USE_CATALOG權限以及父架構的USE_SCHEMA權限。
databricks registered-models get FULL_NAME [flags]
Arguments
FULL_NAME
已註冊模型的三級（完整限定）名稱。
選項
--include-aliases
是否要在回應中包含已註冊的模型別名。
--include-browse
是否要在主體只能存取特定元數據的情況下，在回應中包含已註冊的模型。
Examples
下列範例會取得已註冊模型的相關信息：
databricks registered-models get main.my_schema.my_model
下列範例會取得已註冊模型的相關信息，包括別名：
databricks registered-models get main.my_schema.my_model --include-aliases
databricks registered-models 清單
列出已註冊的模型。 您可以在特定架構下列出已註冊的模型，或列出目前中繼存放區中的所有已註冊模型。
傳回的模型會根據呼叫使用者的許可權進行篩選。 例如，中繼存放區管理員能夠列出所有已註冊的模型。 一般使用者必須是擁有者，或擁有 EXECUTE 已註冊模型的權限，才能在回應中接收已註冊模型。 在後者的情況下，呼叫者必須是擁有者或擁有父目錄的USE_CATALOG權限以及父架構的USE_SCHEMA權限。
不保證響應中元素的特定順序。
databricks registered-models list [flags]
選項
--catalog-name string
要列出已註冊模型的目錄識別碼。
--include-browse
是否要在主體只能存取特定元數據的情況下，在回應中包含已註冊的模型。
--max-results int
要傳回的已註冊模型數目上限。
--page-token string
要針對結果下一頁傳送的不透明令牌（分頁）。
--schema-name string
要用於列出已註冊模型的架構識別碼。
Examples
下列範例會列出目前中繼存放區中的所有已註冊模型：
databricks registered-models list
下列範例會列出特定目錄中已註冊的模型：
databricks registered-models list --catalog-name main
下列範例會列出特定架構中的已註冊模型：
databricks registered-models list --catalog-name main --schema-name my_schema
databricks 註冊模型 設定別名
在指定的已註冊模型上設定別名。
呼叫端必須是中繼存放區管理員或已註冊模型的擁有者。 在後者的情況下，呼叫者必須是擁有者或擁有父目錄的USE_CATALOG權限以及父架構的USE_SCHEMA權限。
databricks registered-models set-alias FULL_NAME ALIAS VERSION_NUM [flags]
Arguments
FULL_NAME
已註冊模型的完整名稱。
ALIAS
別名的名稱。
VERSION_NUM
別名所指向之模型版本的版本號碼。
選項
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
Examples
下列範例會在已註冊的模型上設定別名：
databricks registered-models set-alias main.my_schema.my_model production 1
databricks 註冊模型更新
更新指定的已註冊模型。
呼叫端必須是中繼存放區管理員或已註冊模型的擁有者。 在後者的情況下，呼叫者必須是擁有者或擁有父目錄的USE_CATALOG權限以及父架構的USE_SCHEMA權限。
目前只能更新已註冊模型的名稱、擁有者或批注。
databricks registered-models update FULL_NAME [flags]
Arguments
FULL_NAME
已註冊模型的三級（完整限定）名稱。
選項
--comment string
附加至已註冊模型的批注。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
''--新名稱字串'**
已註冊模型的新名稱。
--owner string
擁有已註冊模型之用戶的標識碼。
Examples
下列範例會更新已註冊的模型批注：
databricks registered-models update main.my_schema.my_model --comment "Updated model description"
下列範例會更新已註冊的模型名稱：
databricks registered-models update main.my_schema.my_model --new-name my_new_model
全域旗標
--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 字串
如果適用，要使用的套件組合目標