model-versions コマンド グループ
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。Databricks CLI は パブリック プレビュー段階です。
Databricks CLI 使用には、使用状況データを含む Databricks ライセンス および Databricks プライバシー通知が適用されます。
Databricks CLI内のmodel-versionsコマンドグループには、Unity Catalogのモデルレジストリでモデルバージョンを管理するコマンドが含まれています。Unity Catalog のモデルは、一元化されたアクセス制御、監査、 リネージ、およびDatabricksワークスペース全体でMLモデルの検出を提供します。「 Unity Catalog でのモデル ライフサイクルの管理」を参照してください。
databricks model-versions delete
指定した登録モデルからモデルバージョンを削除します。モデルバージョンに割り当てられたエイリアスも削除されます。
呼び出し元は、メタストア管理者または親登録モデルの所有者である必要があります。後者の場合、呼び出し元も所有者であるか、親カタログに対する USE_CATALOG 特権と親スキーマに対する USE_SCHEMA 特権を持っている必要があります。
databricks model-versions delete FULL_NAME VERSION [flags]
引数
FULL_NAME
モデル・バージョンの 3 レベル (完全修飾) の名前
VERSION
モデルバージョンの整数バージョン番号
オプション
例
次の例では、モデルのバージョン 1 を削除します。
databricks model-versions delete main.my_schema.my_model 1
databricks model-versions get
モデルバージョンを入手します。
呼び出し元は、メタストア管理者、または親登録モデルの所有者 (または EXECUTE 特権を持っている) である必要があります。後者の場合、呼び出し元も所有者であるか、親カタログに対する USE_CATALOG 特権と親スキーマに対する USE_SCHEMA 特権を持っている必要があります。
databricks model-versions get FULL_NAME VERSION [flags]
引数
FULL_NAME
モデル・バージョンの 3 レベル (完全修飾) の名前
VERSION
モデルバージョンの整数バージョン番号
オプション
--include-aliases
モデルバージョンに関連付けられたエイリアスを応答に含めるかどうか。
--include-browse
プリンシパルが選択的なメタデータにのみアクセスできるモデルバージョンを応答に含めるかどうか。
例
次の例では、モデルのバージョン 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 model-versions get-by-alias
エイリアスでモデルバージョンを取得します。
呼び出し元は、メタストア管理者、または登録済みモデルの所有者 (または EXECUTE 特権を持っている) である必要があります。後者の場合、呼び出し元も所有者であるか、親カタログに対する USE_CATALOG 特権と親スキーマに対する USE_SCHEMA 特権を持っている必要があります。
databricks model-versions get-by-alias FULL_NAME ALIAS [flags]
引数
FULL_NAME
登録済みモデルの 3 レベル (完全修飾) 名
ALIAS
エイリアスの名前
オプション
--include-aliases
モデルバージョンに関連付けられたエイリアスを応答に含めるかどうか。
例
次の例では、エイリアスでモデルバージョンを取得します。
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 model-versions list
モデルのバージョンを一覧表示します。特定のスキーマの下にモデル バージョンを一覧表示することも、現在のメタストア内のすべてのモデル バージョンを一覧表示することもできます。
返されるモデルは、呼び出し元ユーザーの権限に基づいてフィルター処理されます。たとえば、メタストア管理者は、すべてのモデル バージョンを一覧表示できます。通常のユーザーは、応答でモデルバージョンを受け取るために、所有者であるか、親登録モデルに対する EXECUTE 権限を持っている必要があります。後者の場合、呼び出し元も所有者であるか、親カタログに対する USE_CATALOG 特権と親スキーマに対する USE_SCHEMA 特権を持っている必要があります。
応答内の要素の特定の順序を保証するものではありません。応答の要素には、エイリアスやタグは含まれません。
databricks model-versions list FULL_NAME [flags]
引数
FULL_NAME
モデルバージョンを一覧表示する登録済みモデルの完全な 3 レベル名
オプション
--include-browse
プリンシパルが選択的なメタデータにのみアクセスできるモデルバージョンを応答に含めるかどうか。
--max-results int
返すモデルバージョンの最大数。
--page-token string
前のクエリに基づいて次のページに移動するための不透明なページネーショントークン。
例
次の例は、登録済みモデルのすべてのモデル バージョンを一覧表示します。
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 model-versions update
指定したモデルバージョンを更新します。
呼び出し元は、メタストア管理者または親登録モデルの所有者である必要があります。後者の場合、呼び出し元も所有者であるか、親カタログに対する USE_CATALOG 特権と親スキーマに対する USE_SCHEMA 特権を持っている必要があります。
現在、更新できるのはモデルバージョンのコメントのみです。
databricks model-versions update FULL_NAME VERSION [flags]
引数
FULL_NAME
モデル・バージョンの 3 レベル (完全修飾) の名前
VERSION
モデルバージョンの整数バージョン番号
オプション
--comment string
モデルバージョンに添付されたコメント。
--json JSON
インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path
例
次の例では、モデルバージョンのコメントを更新します。
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 string
出力ログの書き込み先となるファイルを表す文字列。このフラグが指定されていない場合、デフォルトでは出力ログが stderr に書き込まれます。
--log-format format
ログ・フォーマット・タイプ ( text または json) 。デフォルト値は textです。
--log-level string
ログ形式レベルを表す文字列。指定しない場合、ログ・フォーマット・レベルは使用不可になります。
-o, --output タイプ
コマンド出力タイプ text または json。デフォルト値は textです。
-p, --profile string
コマンドの実行に使用する ~/.databrickscfg ファイル内のプロファイルの名前。このフラグが指定されていない場合、存在する場合は、 DEFAULT という名前のプロファイルが使用されます。
--progress-format format
進行状況ログを表示する形式: default、 append、 inplace、 json
-t, --target string
該当する場合は、使用するバンドル・ターゲット