Databricksにおける機械学習モデルの管理

[Manage models \| Databricks on AWS](https://docs.databricks.com/applications/machine-learning/manage-model-lifecycle/index.html) [2021/10/14時点]の翻訳です。

DatabricksはMLflowモデルの完全なライフサイクル管理を支援するために、ホストされたMLflowモデルレジストリを提供します。モデルレジストリは、時系列のモデルリネージュ(ある時点でどのMLflowエクスペリメントとランがモデルを生成したいのか)、モデルのバージョン管理、ステージ遷移(例えば、ステージングからプロダクション、アーカイブへ)、モデルのイベント発生時のメール通知といった機能を提供します。モデルに対する説明文やコメントを追加することもできます。

本書では、機械学習ワークフローの一部としてのモデルレジストリの使い方と、モデルレジストリUIとモデルレジストリAPI両方の使用法を説明します。

モデルレジストリのコンセプト概要については、[MLflow guide](https://docs.databricks.com/applications/mlflow/index.html)をご覧ください。

# 要件

モデルレジストリのUIを使用するには以下のランタイムが必要です。

- Databricks Runtime 6.4以降、かつ mlflow>=1.7.0 がインストールされている
- Databricks Runtime 6.4 ML、かつ mlflow>=1.7.0 がインストールされている
- Databricks Runtime 6.5 ML以降

モデルレジストリのAPIを使用するには以下のランタイムが必要です。

- Databricks Runtime 6.5以降
- Databricks Runtime 6.5 ML以降
- Databricks Runtime 6.4以前、かつ mlflow>=1.7.0 がインストールされている
- Databricks Runtime 6.4 ML以前、かつ mlflow>=1.7.0 がインストールされている

# モデルの作成、登録

## UIを用いたモデルの作成、登録

モデルレジストリにモデルを登録するには2つの方法があります。MLflowで記録された既存モデルを登録するか、新規の空のモデルを作成、登録し、事前に記録されたモデルを割り当てることができます。

### ノートブックから記録済みの既存モデルを登録する

1. ワークスペースにおいて、登録したいモデルを含むMLflowランを特定します。
    1. ノートブックツールバーの**Experiment**アイコン![](https://docs.databricks.com/_images/experiment.png)をクリックします。
    ![](https://docs.databricks.com/_images/notebook-toolbar.png)
    1. Experiment Runsサイドバーで、ランの日付の隣にある![](https://docs.databricks.com/_images/external-link.png)アイコンをクリックします。MLflowランページが表示されます。このページでは、パラメーター、メトリクス、タグ、アーティファクトのリストを含むランの詳細が表示されます。
1. Artifactセクションで、**xxx-model**という名前のディレクトリをクリックします。
　　　　![](https://docs.databricks.com/_images/register-model.png) 
1. 一番右にある**Register Model**をクリックします。
1. ダイアログで、**Model**ボックスをクリックし、以下のいずれかを実行します。
    - ドロップダウンメニューから**Create New Model**をクリックします。**Model Name**フィールドが表示されるので、`scikit-learn-power-forecasting`と言ったモデルの名前を入力します。
    - ドロップダウンメニューから既存のモデルを選択します。
    ![](https://docs.databricks.com/_images/create-model.png)
1. **Register**をクリックします。
    - **Create New Model**を選択した際には、`scikit-learn-power-forecasting`というモデルが登録され、MLflowモデルレジストリによって管理されるセキュアな場所にモデルがコピーされ、新規バージョンのモデルが作成されます。
    - 既存のモデルを選択した場合には、選択されたモデルの新規バージョンを作成します。

    しばらくすると、**Register Model**ボタンは、新規モデルバージョンへのリンクに変化します。
![](https://docs.databricks.com/_images/registered-model-version.png)
1. モデルレジストリUIで新規モデルバージョンを開くにはリンクをクリックします。あるいは、サイドバーの![](https://docs.databricks.com/_images/models-icon.png)**Models**をクリックすることでモデルレジストリにあるモデルを検索することができます。

### 新規登録モデルを作成し、記録済みモデルを割り当てる

空の新規モデルを作成するために、Registered modelsページのCreate Modelボタンを使用し、記録されたモデルを割り当てることもできます。以下の手順を踏んでください。

1. Registered modelsページで、**Create Model**をクリックします。モデルの名前を入力し、**Create**をクリックします。
1. [ノートブックから記録済みの既存モデルを登録する](#ノートブックから記録済みの既存モデルを登録する)のステップ1からステップ3を実行します。
1. Register Modelダイアログで、ステップ1で作成したモデルの名前を選択し、**Register**をクリックします。これによって、指定された名前のモデルが作成され、MLflowモデルレジストリによって管理されるセキュアな場所にモデルがコピーされ、モデルバージョン`Version 1`が作成されます。

    しばらくすると、MLflow Run UIはRegister Modelボタンを新たに登録されたモデルバージョンのリンクで置き換えます。これにより、**Experiment Runs**ページのRegister Modelダイアログの**Model**ドロップダウンリストからモデルを選択できるようになります。また、[Create ModelVersion](https://mlflow.org/docs/latest/rest-api.html#create-modelversion)のようなAPIコマンドでモデル名を指定することで新規バージョンを登録することもできます。

## APIを用いたモデルの登録

プログラムからモデルレジストリにモデルを登録する方法は3つあります。全ての方法において、MLflowが管理するセキュアな場所にモデルがコピーされます。

- MLflowエクスペリメントにおいて、指定された名前でモデルを記録、登録するには、`mlflow.<model-flavor>.log_model(...)`メソッドを使用します。指定された登録モデルが存在しない場合には、このメソッドは新規モデルを登録し、バージョン1を作成し、`ModelVersion` MLflowオブジェクトを返却します。指定された名前の登録モデルが存在しる場合には、このメソッドは新規バージョンを作成し、バージョンオブジェクトを返却します。

```py:Python
with mlflow.start_run(run_name=<run-name>) as run:
  ...
  mlflow.<model-flavor>.log_model(<model-flavor>=<model>,
    artifact_path="<model-path>",
    registered_model_name="<model-name>"
  )
```

- エクスペリメントの全てのランが完了し、どのモデルをレジストリに登録するのが最も適しているのかを決断した後で、特定の名前でモデルを登録するには、`mlflow.register_model()`メソッドを使用します。このメソッドにおいては、`mlruns:URI`引数に対してランのIDが必要となります。指定された登録モデルが存在しない場合には、このメソッドは新規モデルを登録し、バージョン1を作成し、`ModelVersion` MLflowオブジェクトを返却します。指定された名前の登録モデルが存在しる場合には、このメソッドは新規バージョンを作成し、バージョンオブジェクトを返却します。

```py:Python
result=mlflow.register_model("runs:<model-path>", "<model-name>")
```

- 特定の名前で新たに登録済みモデルを作成するには、MLflow Client APIの`create_registered_model()`メソッドを使用します。指定されたモデルが存在する際には、このメソッドは`MLflowException`をスローします。

```py:Python
client = MlflowClient()
result = client.create_registered_model("<model-name>")
```

# モデルのアクセス権管理

モデルレジストリに登録されているモデルへのアクセスコントロールについて学ぶには、[MLflowモデルのアクセス権](https://qiita.com/taka_yayoi/items/2dd6711b7b254505e4a3#mlflow%E3%83%A2%E3%83%87%E3%83%AB%E3%81%AE%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E6%A8%A9)を参照ください。

# モデルのステージ遷移

モデルのバージョンには以下のステージがあります: **None**、**Staging**、**Production**、**Archived**です。**Staging**のステージは、モデルのテスト、検証段階を意味し、**Production**のステージは、モデルのテストやレビュープロセスが完了し、ライブのスコアリングのためのアプリケーションとしてデプロイされたことを意味します。Archivedされたモデルバージョンはアクティブではない状態と考えられ、[当該モデルの削除](https://docs.databricks.com/applications/machine-learning/manage-model-lifecycle/index.html#delete-a-model-or-model-version)を検討することになります。異なるバージョンのモデルは異なるステージになることが可能です。

適切な[アクセス権](https://qiita.com/taka_yayoi/items/2dd6711b7b254505e4a3#mlflow%E3%83%A2%E3%83%87%E3%83%AB%E3%81%AE%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E6%A8%A9)を持つユーザーが、モデルバージョンのステージを遷移させることができます。特定のステージにモデルを遷移できるアクセス権を持っているのであれば、直接遷移を行うことができます。アクセス権がない場合には、モデルバージョンを遷移できる権限を持つユーザーに、ステージ遷移をリクエストすることができ、権限を持つユーザーが[承認、リジェクト、キャンセル](#モデルバージョンのステージ遷移リクエストの承認リジェクトキャンセル)を行うことができます。

## UIを用いたモデルステージの遷移

モデルのステージを遷移するには以下の手順を踏んでください。

1. モデルバージョンページにおいて利用可能なモデルステージとオプションの一覧を表示するには、**Stage: &lt;Stage&gt;**ボタンをクリックし、別のステージへの遷移をリクエストします。
    ![](https://docs.databricks.com/_images/stage-options.png)
1. オプションでコメントを入力し**OK**をクリックします。

### モデルバージョンをプロダクションステージに遷移

テスト、検証の後で、Productionステージに遷移、あるいは遷移をリクエストすることができます。

モデルレジストリでは、それぞれのステージに1つ以上のバージョンのモデルを割り当てることができます。1つのバージョンのみをProductionに割り当てたい場合には、**Transition existing Production model versions to Archived**をチェックすることで、現状Productionステージにある全てのバージョンのモデルをアーカイブにすることできます。

### モデルバージョンのステージ遷移リクエストの承認、リジェクト、キャンセル

ステージ遷移権限を持たないユーザーは、ステージ遷移をリクエストすることができます。モデルバージョンページの**Pending Requests**にリクエストが表示されます。
![](https://docs.databricks.com/_images/handle-transition-request.png)

ステージ遷移リクエストを承認、リジェクト、キャンセルするには**Approve**、**Reject**、**Cancel**リンクをクリックします。

遷移リクエストを申請した本人は、申請をキャンセルすることができます。

### モデルバージョンのアクティビティの参照

モデルバージョンに対するステージ遷移のリクエスト、承認、ペンディング状態を見るには、Activitiesセクションに移動します。監査、検査目的でモデルのライフサイクルのリネージュを提供するアクティビティのレコードが表示されます。

## APIを用いたモデルステージの遷移

適切な[アクセス権](https://qiita.com/taka_yayoi/items/2dd6711b7b254505e4a3#mlflow%E3%83%A2%E3%83%87%E3%83%AB%E3%81%AE%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E6%A8%A9)を持つユーザーは、モデルバージョンを新たなステージに遷移することができます。

モデルバージョンのステージを新たなステージに更新するには、MLflow Client APIの`transition_model_version_stage()`メソッドを使用します。

```py:Python
  client = MlflowClient()
  client.transition_model_version_stage(
    name="<model-name>",
    version=<model-version>,
    stage="<stage>",
    description="<description>"
  )
```

`<stage>`に指定できる値は、`"Staging"|"staging"`、`"Archived"|"archived"`、"Production"|"production"`、`"None"|"none"`です。

# モデルを用いた推論

> **プレビュー**
本機能は[パブリックプレビュー](https://docs.databricks.com/release-notes/release-types.html)です。

モデルをモデルレジストリに登録した後で、モデルをバッチ推論で使用するノートブックを自動で生成したり、リアルタイムサービングで使用するエンドポイントを作成することができます。

[登録モデルページ](https://qiita.com/taka_yayoi/items/e7a4bec6420eb7069995#%E7%99%BB%E9%8C%B2%E3%83%A2%E3%83%87%E3%83%AB%E3%83%9A%E3%83%BC%E3%82%B8)、あるいは[モデルバージョンページ](https://qiita.com/taka_yayoi/items/e7a4bec6420eb7069995#%E3%83%A2%E3%83%87%E3%83%AB%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E3%83%9A%E3%83%BC%E3%82%B8)のの右上にある![](https://docs.databricks.com/_images/use-model-for-inference.png)ボタンをクリックします。バッチ推論、リアルタイム推論のためのモデル推論の設定ダイアログが表示されます。
![](https://docs.databricks.com/_images/configure-model-inference.png)

## バッチ推論の設定

以下の手順に従ってバッチ推論ノートブックを作成した際、あなたのユーザーフォルダーの`Batch-Inference`フォルダー配下にモデル名称でノートブックが保存されます。必要に応じてノートブックを編集することができます。

1. **Batch inference**タブをクリックします。
1. **Model version**ドロップダウンから、使用するモデルバージョンを選択します。ドロップダウンの最初の2つのアイテムは、(存在する場合には)モデルの現行のProductionとStagingバージョンのものとなります。これらのオプションの1つを選択すると、ノートブックは自動で実行時にProduction、Stagingのバージョンを使用します。モデルを開発する過程でノートブックを更新する必要はありません。
1. **Input table**の隣の**Browse**ボタンをクリックします。入力データを選択するダイアログが表示されます。必要に応じて、**Compute**ドロップダウンでクラスターを変更します。
1. モデルの入力データを格納するデータベースとテーブルを選択し、**Select**をクリックします。生成されるノートブックは自動でこのデータをインポートし、モデルに送信します。モデルに入力する前にデータ変換が必要がある場合には、生成されたノートブックを編集することができます。
1. 予測結果は`dbfs:/FileStore/batch-inference`ディレクトリ内のフォルダーに保存されます。デフォルトでは、モデル名と同じフォルダーに予測結果が保存されます。生成されたノートブックのそれぞれのランは、このディレクトリにモデル名にタイムスタンプを追加した形で予測結果を新規ファイルに保存します。後続のノートブックのランの結果でファイルを上書きするように、タイムスタンプを含めないように選択することができます。手順は生成されるノートブックに記載されています。

    **Output table location**フィールドに新規フォルダー名を入力するか、フォルダーアイコンをクリックしてディレクトリをブラウズしてフォルダーを選択することで、予測結果を保存する場所を変更することができます。

## リアルタイム推論の設定

1. モデル推論設定ダイアログで**Real-time**タブをクリックします。
1. モデルに対するサービングが有効化されていない場合には、**Enable serving**をクリックします。[登録モデルページ](https://qiita.com/taka_yayoi/items/e7a4bec6420eb7069995#%E7%99%BB%E9%8C%B2%E3%83%A2%E3%83%87%E3%83%AB%E3%83%9A%E3%83%BC%E3%82%B8)が表示され、**Status**にはPendingが表示されます。数分後に**Status**はReadyになります。

    サービングがすでに有効化されている場合には、[Servingタブ](https://docs.databricks.com/applications/mlflow/model-serving.html)を表示するために**View existing real-time inference**をクリックします。

## フィードバックの提供

この機能はプレビューであり、皆様からのフィードバックは大歓迎です。フィードバックを送信するには、Configure model inferenceダイアログの`Provide Feedback`をクリックします。

# 通知設定

指定した登録モデル、モデルバージョンのアクティビティに関してメールによる通知を受け取れるように、モデルレジストリを設定することができます。

Registered Modelページにおいて、**Notify me about**メニューに3つのオプションが表示されます。
![](https://docs.databricks.com/_images/email-notifications-menu.png)

- **All new activity:** 当該モデルの全てのバージョンのモデルに関する全てのアクティビティに関してメールによる通知を行います。登録モデルを作成した際、この設定がデフォルトとなります。
- **Activity on versions I follow:** フォローしているバージョンのモデルに対してのみ通知が行われます。この選択により、フォローするモデルバージョン全てに関する通知を受け取ることができます。特定のモデルバージョンの通知をオフにすることはできません。
- **Mute notifications:** この登録モデルに関するアクティビティの通知を受け取りません。

以下のイベントによってメール通知が行われます。

- 新規モデルバージョンの作成
- ステージ遷移のリクエスト
- ステージ遷移
- 新規コメント

以下のいずれかを実行した際に、自動でモデル通知にサブスクライブすることになります。

- モデルバージョンに対するコメント
- モデルバージョンのステージ遷移
- モデルステージ遷移のリクエスト

モデルバージョンをフォローしているかどうかを確認するには、[モデルバージョンページ](https://qiita.com/taka_yayoi/items/e7a4bec6420eb7069995#%E3%83%A2%E3%83%87%E3%83%AB%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E3%83%9A%E3%83%BC%E3%82%B8)のFollow Statusフィールドを参照するか、[登録モデルページ](https://qiita.com/taka_yayoi/items/e7a4bec6420eb7069995#%E7%99%BB%E9%8C%B2%E3%83%A2%E3%83%87%E3%83%AB%E3%83%9A%E3%83%BC%E3%82%B8)のモデルバージョンテーブルを参照します。

## 全てのメール通知をオフに

User SettingメニューのモデルレジストリのSettingタブで全てのメール通知をオフにすることができます。

1. Databricksワークスペースの左下にある![](https://docs.databricks.com/_images/user-settings-icon.png)**Setting**をクリック。
1. **User Settings**をクリック。
1. **Model Registry Settings**タブに移動。
1. **Turn on model registry email notifications**の選択を解除。

管理者は[Admin Console](https://docs.databricks.com/administration-guide/admin-console.html)で組織全体のメール通知をオフにすることができます。

## メール送信の最大数

モデルレジストリがそれぞれのユーザーに対してアクティビティごとに1日当たり送信するメールの数には制限があります。例えば、登録モデルに対して新規モデルバージョンが作成されたことを告げるメールを20通受け取った場合、モデルレジストリは1日の送信上限に到達したことを知らせるメールを送信し、次の日までそのイベントを知らせるメールを送信しません。

メール送信数の上限を引き上げるには、Databricks担当にお問い合わせください。

# モデル、モデルバージョンに対する注釈

モデルやモデルバージョンに注釈をつけることで情報を提供することができます。例えば、問題の概要、使用した方法論、アルゴリズムに関する説明を追加することができます。

## UIを用いたモデル、モデルバージョンへの注釈

2つの方法でモデルに注釈を追加することができます。説明文、あるいはコメントです。説明文はモデルとモデルバージョンで利用できます。コメントはモデルバージョンでのみ利用できます。説明文はモデルに関する情報を提供するためのものです。コメントはモデルバージョンのアクティビティに対する議論を保存する手段です。

### モデル、モデルバージョンへの説明の追加、更新

1. [登録モデル](https://qiita.com/taka_yayoi/items/e7a4bec6420eb7069995#%E7%99%BB%E9%8C%B2%E3%83%A2%E3%83%87%E3%83%AB%E3%83%9A%E3%83%BC%E3%82%B8)ページや[モデルバージョン](https://qiita.com/taka_yayoi/items/e7a4bec6420eb7069995#%E3%83%A2%E3%83%87%E3%83%AB%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E3%83%9A%E3%83%BC%E3%82%B8)ページで、**Description**![](https://docs.databricks.com/_images/edit-icon.png)アイコンをクリックします。編集ウィンドウが表示されます。
1. 編集ウィンドウで説明文を入力、編集します。
1. **Save**をクリックします。

    モデルバージョンの説明文を入力した際、説明文は[登録モデルページ](https://qiita.com/taka_yayoi/items/e7a4bec6420eb7069995#%E7%99%BB%E9%8C%B2%E3%83%A2%E3%83%87%E3%83%AB%E3%83%9A%E3%83%BC%E3%82%B8)のテーブルの**Description**カラムに表示されます。カラムには最大32文字のテキスト、あるいは1行のテキストの短い方が表示されます。

### モデルバージョンへのコメント

1. [モデルバージョン](https://qiita.com/taka_yayoi/items/e7a4bec6420eb7069995#%E3%83%A2%E3%83%87%E3%83%AB%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E3%83%9A%E3%83%BC%E3%82%B8)ページをスクロールダウンし、**Activities**の隣の下向き矢印をクリックします。
1. 編集ウィンドウにコメントを入力し、**Add Comment**をクリックします。

## APIを用いたモデルの注釈

モデルバージョンの説明文を更新するには、MLflow Client APIの`update_model_version()`メソッドを使用します。

```py:Python
client = MlflowClient()
client.update_model_version(
  name="<model-name>",
  version=<model-version>,
  description="<description>"
)
```

# モデルの名称変更(APIのみ)

登録モデルの名前を変更するには、MLflow Client APIの`rename_registered_model()`メソッドを使用します。

```py:Python
client=MlflowClient()
client.rename_registered_model("<model-name>", "<new-model-name>")
```

> **注意**
バージョンが存在しない場合、あるいは全てのバージョンがNone、Archivedステージの場合にのみ登録モデルの名前を変更できます。

# モデルの検索

全ての登録モデルは、MLflowモデルレジストリに存在します。UIあるいはAPIでモデルを検索することができます。

## UIによるモデルの検索

サイドバーの![](https://docs.databricks.com/_images/models-icon.png)**Models**アイコンをクリックして、全ての登録モデルを表示します。

特定のモデルを検索するには、検索ボックスにモデルの名前を入力します。
![](https://docs.databricks.com/_images/registered-models-search.png)

タグを用いてモデルをフィルタリングすることができます。**Filter**をクリックし、`tags.<key>=<value>`の書式でタグを入力します。複数タグでフィルタリングするには`AND`オペレーターを使用します。
![](https://docs.databricks.com/_images/search-with-tags.png)

## APIによるモデルの検索

全ての登録モデルのリストを取得するには、MLflow Client APIの`list_model_versions()`メソッドを使用します。

```py:Python
from pprint import pprint

client = MlflowClient()
for rm in client.list_registered_models():
  pprint(dict(rm), indent=4)
```

出力は以下のようになります。

```
{   'creation_timestamp': 1582671933216,
    'description': None,
    'last_updated_timestamp': 1582671960712,
    'latest_versions': [<ModelVersion: creation_timestamp=1582671933246, current_stage='Production', description='A random forest model containing 100 decision trees trained in scikit-learn', last_updated_timestamp=1582671960712, name='sk-learn-random-forest-reg-model', run_id='ae2cc01346de45f79a44a320aab1797b', source='./mlruns/0/ae2cc01346de45f79a44a320aab1797b/artifacts/sklearn-model', status='READY', status_message=None, user_id=None, version=1>,
    <ModelVersion: creation_timestamp=1582671960628, current_stage='None', description=None, last_updated_timestamp=1582671960628, name='sk-learn-random-forest-reg-model', run_id='d994f18d09c64c148e62a785052e6723', source='./mlruns/0/d994f18d09c64c148e62a785052e6723/artifacts/sklearn-model', status='READY', status_message=None, user_id=None, version=2>],
    'name': 'sk-learn-random-forest-reg-model'}
```

MLflow Client APIの`search_model_versions()`を用いることで、特定のモデル名で検索を行い、バージョンの詳細一覧を取得することができます。

```py:Python
from pprint import pprint

client=MlflowClient()
[pprint(mv) for mv in client.search_model_versions("name=<model-name>")]
```

出力は以下のようになります。

```
{   'creation_timestamp': 1582671933246,
    'current_stage': 'Production',
    'description': 'A random forest model containing 100 decision trees '
                   'trained in scikit-learn',
    'last_updated_timestamp': 1582671960712,
    'name': 'sk-learn-random-forest-reg-model',
    'run_id': 'ae2cc01346de45f79a44a320aab1797b',
    'source': './mlruns/0/ae2cc01346de45f79a44a320aab1797b/artifacts/sklearn-model',
    'status': 'READY',
    'status_message': None,
    'user_id': None,
    'version': 1 }

{   'creation_timestamp': 1582671960628,
    'current_stage': 'None',
    'description': None,
    'last_updated_timestamp': 1582671960628,
    'name': 'sk-learn-random-forest-reg-model',
    'run_id': 'd994f18d09c64c148e62a785052e6723',
    'source': './mlruns/0/d994f18d09c64c148e62a785052e6723/artifacts/sklearn-model',
    'status': 'READY',
    'status_message': None,
    'user_id': None,
    'version': 2 }
```

# モデル、モデルバージョンの削除

UIあるいはAPIからモデルを削除することができます。

## UIによるモデルバージョン、モデルの削除

> **警告!**
この操作を取り消すことはできません。レジストリからモデルバージョンを削除するのではなく、モデルバージョンをArchivedステージに遷移させることができます。モデルを削除した際、モデルレジストリに格納されている全てのモデルのアーティファクト、登録モデルに関係する全てのメタデータが削除されます。

> **注意**
None、Archivedステージのモデル、モデルバージョンのみを削除できます。登録モデルにStaging、Productionステージのモデルバージョンがある場合には、モデルを削除する前にNone、Archivedステージに遷移させる必要があります。

モデルバージョンを削除するには、以下の手順を踏みます。

1. サイドバーの![](https://docs.databricks.com/_images/models-icon.png)**Models**をクリック
1. モデル名をクリック
1. モデルバージョンをクリック
1. 画面の右上にある![](https://docs.databricks.com/_images/delete-model-version.png)をクリックし、ドロップダウンメニューから**Delete**を選択

モデルを削除するには、以下の手順を踏みます。

1. サイドバーの![](https://docs.databricks.com/_images/models-icon.png)**Models**をクリック
1. モデル名をクリック
1. 画面の右上にある![](https://docs.databricks.com/_images/delete-model-version.png)をクリックし、ドロップダウンメニューから**Delete**を選択

## APIによるモデルバージョン、モデルの削除

> **警告!**
この操作を取り消すことはできません。レジストリからモデルバージョンを削除するのではなく、モデルバージョンをArchivedステージに遷移させることができます。モデルを削除した際、モデルレジストリに格納されている全てのモデルのアーティファクト、登録モデルに関係する全てのメタデータが削除されます。

> **注意**
None、Archivedステージのモデル、モデルバージョンのみを削除できます。登録モデルにStaging、Productionステージのモデルバージョンがある場合には、モデルを削除する前にNone、Archivedステージに遷移させる必要があります。

### モデルバージョンの削除

モデルバージョンを削除するには、MLflow Client APIの`delete_model_version()`メソッドを使用します。

```py:Python
# Delete versions 1,2, and 3 of the model
client = MlflowClient()
versions=[1, 2, 3]
for version in versions:
  client.delete_model_version(name="<model-name>", version=version)
```

### モデルの削除

モデルを削除するには、MLflow Client APIの`delete_registered_model()`メソッドを使用します。

```py:Python
client = MlflowClient()
client.delete_registered_model(name="<model-name>")
```

# ワークスペースをまたがるモデル共有

Databricksでは、複数のワークスペースでのモデル共有をサポートしています。例えば、ご自身のワークスペースでモデルを開発、記録し、集中管理されたモデルレジストリにモデルを登録することができます。これは、複数のチームがモデルにアクセスする際に有用です。複数のワークスペースを作成し、環境にまたがってモデルを管理することができます。

- [Databricksワークスペース間における機械学習モデルの共有](https://qiita.com/taka_yayoi/items/ddddbf9637fe03607b4f)

# サンプル

このサンプルでは、機械学習アプリケーションを構築する際にどのようにモデルレジストリを活用するのかを説明しています。。

- [MLflow Model Registry example](https://docs.databricks.com/applications/mlflow/model-registry-example.html)

### Databricks 無料トライアル

[Databricks 無料トライアル](https://databricks.com/jp/try-databricks)