Note
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI の使用には、Databricks ライセンスおよび使用状況データのプロビジョニングを含むDatabricks のプライバシーに関する通知が適用されます。
model-versions 内の コマンド グループには、Unity カタログのモデル レジストリでモデル バージョンを管理するためのコマンドが含まれています。 Unity カタログのモデルは、Databricks ワークスペース全体で ML モデルの一元的なアクセス制御、監査、系列、検出を提供します。 「Unity Catalog 内でモデル ライフサイクルを管理する」をご覧ください。
databricks モデルバージョンの削除
指定した登録済みモデルからモデル バージョンを削除します。 モデル バージョンに割り当てられているエイリアスも削除されます。
呼び出し元は、メタストア管理者または親登録済みモデルの所有者である必要があります。 後者の場合、呼び出し元も所有者であるか、親カタログに対する USE_CATALOG 特権と親スキーマに対する USE_SCHEMA 特権を持っている必要があります。
databricks model-versions delete FULL_NAME VERSION [flags]
Arguments
FULL_NAME
モデル バージョンの 3 つのレベル (完全修飾) からなる名称
VERSION
モデル バージョンの整数バージョン番号
オプション
Examples
次の例では、モデルのバージョン 1 を削除します。
databricks model-versions delete main.my_schema.my_model 1
databricks model-versions get（Databricksコマンド）
モデル バージョンを取得します。
呼び出し元は、親登録済みモデルのメタストア管理者または所有者である (または EXECUTE 特権を持っている) 必要があります。 後者の場合、呼び出し元も所有者であるか、親カタログに対する USE_CATALOG 特権と親スキーマに対する USE_SCHEMA 特権を持っている必要があります。
databricks model-versions get FULL_NAME VERSION [flags]
Arguments
FULL_NAME
モデル バージョンの 3 つのレベル (完全修飾) からなる名称
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
登録済みモデルの 3 つのレベル (完全修飾) からなる名称
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
モデルのバージョンを一覧表示する登録済みモデルの、完全な 3 つのレベルからなる名前
オプション
--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
モデル バージョンの 3 つのレベル (完全修飾) からなる名称
VERSION
モデル バージョンの整数バージョン番号
オプション
--comment string
モデル バージョンに添付されているコメント。
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path
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 形式
ログ形式の種類、 text 、または json。 既定値は text です。
--log-level 文字列
ログ形式レベルを表す文字列。 指定しない場合、ログ形式レベルは無効になります。
-o, --output 型
コマンド出力の種類( text または json)。 既定値は text です。
-p, --profile 文字列
コマンドの実行に使用する ~/.databrickscfg ファイル内のプロファイルの名前。 このフラグが指定されていない場合は、存在する場合は、 DEFAULT という名前のプロファイルが使用されます。
--progress-format 形式
進行状況ログを表示する形式: default、 append、 inplace、または json
-t, --target 文字列
該当する場合は、使用するバンドル ターゲット