モデルAPIとプロバイダーのリネージを追跡する
Unity Catalogは、Unity AI Gateway を通じて管理されるモデルAPIs （モデルサービス）および外部モデルプロバイダー （モデルプロバイダーサービス）のリネージをキャプチャします。各サービスが提供する基盤モデル、そのプライマリまたはfallbackのルーティング、およびペイロードデータを消費する下流のアセットを追跡できます。リネージを使用すると、次のことが可能になります：
- 基盤モデルまたはサービスを非推奨にする前に影響範囲を確認 ：制限された基盤モデルを非推奨にする、またはモデルプロバイダーをスワップする前に、影響を受けるダウンストリームのサービスやワークロードを特定します。
- データおよび AI アセット間の依存関係を追跡 ：サービスが提供する基盤モデルから、ペイロードをLogsする推論テーブル、そしてそのペイロードデータを消費するダウンストリームのワークロードまでを追跡します。
要件
- モデルサービスまたはモデルプロバイダーサービスは、Unity Catalog メタストアに登録されている必要があります。See Govern model APIs (model サービス) and Govern external model providers (model provider サービス).
- サービスのリネージを表示するには、サービスの親カタログに対する
BROWSE権限が少なくとも必要であり、そのカタログはワークスペースからアクセスできる必要があります。ワークスペース-カタログ バインディングを参照してください。 - リネージはUnity Catalogの権限を尊重します。閲覧権限のないオブジェクトは、マスクされたノードとして表示されます。詳細については、パーミッションを参照してください。
Unity AI Gateway は、AWS GovCloud または Azure Government ではサポートされていません。
キャプチャされるリネージの内容
Unity Catalogは、サービスの 定義 からその依存関係をキャプチャします。これは、サービスを作成または更新するときに参照されるオブジェクトです。リネージは、テーブルリネージと一貫して、2つの方向を区別します：
- アップストリーム 依存関係とは、提供されている基盤モデルなど、サービスが依存するオブジェクトのことです。
- 下流 の依存関係とは、推論テーブルのように、サービスに依存するオブジェクトのことです。
次の表に、各サービスタイプでキャプチャされるリネージの依存関係を示します。
サービス | 上流 | 下流 |
|---|---|---|
Model API（モデルサービス） | PRIMARY （プライマリ）または FALLBACK （フォールバック）として注釈が付けられた、提供される基盤モデル。提供される外部モデルは、その外部モデルプロバイダーとして表示されます。 | リクエストペイロードを記録するように構成された推論テーブル。 |
外部モデルプロバイダー (モデルプロバイダーサービス) | なし。ガードレールポリシーに基づくジャッジモデルサービスについては、ここでは説明しません。 | プロバイダーへのルーティング用に構成された各モデルサービス、およびリクエストペイロードをログに記録するように構成された推論テーブル。 |
リネージは相互的なものです。提供される基盤モデルは、その基盤モデル自身の Lineage tabでモデルサービスを下流のコンシューマーとして表示し、推論テーブルはそのサービスをアップストリームのプロデューサーとして表示します。
Catalog Explorer でサービスリネージを表示する
モデルサービスまたはモデルプロバイダーサービスのリネージを表示するには：
-
Databricks ワークスペースで、
カタログ をクリックします。 -
サービスを検索または参照し、その名前をクリックします。
-
リネージ tabを選択します。このtabには、サービスのアップストリームおよびダウンストリームのリネージが、以下の列とともに一覧表示されます：
- 名前 : 関連オブジェクトの名前です。
- 方向 : オブジェクトがサービスの アップストリーム にあるか、 ダウンストリーム にあるかを示します。
- Type ：関連オブジェクトのタイプ（ Model 、 Model provider service 、 Table など）。
- 最終アクティビティ : リネージ関係が最後にキャプチャされた日時。
-
リストを絞り込むには、 [リネージのフィルタリング] に名前を入力するか、方向、オブジェクトタイプ、ワークスペース、時間範囲でフィルタリングします。
次の例は、main.ai_lineage_demo.customer_support_endpoint モデルサービスの リネージ タブを示しています。アップストリームアセットには、databricks-claude-opus-4-8 および databricks-kimi-k3-neo 基盤モデルと、それが提供する anthropic モデルプロバイダーサービスが含まれます。ダウンストリームアセットは、リクエストペイロードをLogsする customer_support_endpoint_payload 推論テーブルです。
リネージグラフを表示する
リネージグラフは、サービスとその関連オブジェクトを接続されたノードとしてレンダリングするため、マルチホップの依存関係を視覚的に探索できます。
- サービスの リネージ tabで、 リネージグラフを表示 をクリックします。
- ノード上の
アイコンをクリックすると、接続が展開されます。 - モデルサービスの場合、それが提供する基盤モデルまたはモデルプロバイダーサービスへのエッジには、 PRIMARY または FALLBACK というラベルが付けられます。ノードをクリックしてオブジェクトに移動するか、そのリネージを探索します。
defaultでは、グラフにはメタストアにアタッチされているすべてのワークスペース全体のリネージが表示されます。グラフツールバーの時間範囲フィルターを使用して、アクティブな依存関係と古い依存関係を区別します。結果を現在のワークスペースに制限するには、ノードを選択してから、 Lineage details パネルで Only this workspace を選択してください。
次の例は、main.ai_lineage_demo.customer_support_endpoint モデルサービスからアクセスされるグラフを示しています。anthropic モデルプロバイダーサービスは3つのモデルサービスに展開されるため、1つのビューでそのプロバイダーへの変更が影響を与えるすべてのサービスを確認できます。基盤モデルを非推奨にする、またはサービスへのアクセスを制限する前に、リネージグラフを使用して以下を行います：
- 影響を受けるすべてのサービスを1つのビューで検索 ：各サービスを個別に確認する代わりに、特定のモデルまたはプロバイダーを提供するすべてのモデルサービスを表示します。
- どのサービスが停止し、どのサービスが低下するかを特定する : PRIMARY および FALLBACK エッジラベルは、モデルを削除した場合にどのサービスが失敗し、どれが別のサービスに fallback するかを示しているため、移行の優先順位を付けることができます。
- 適切なオーナーに連絡する ：各ノードにはそのオーナーが表示されるため、誰に通知すべきかがわかります。ノードをクリックして、カタログエクスプローラーでオブジェクトを開きます。
サービスの推論テーブルは独自のリネージを持つため、それを下流に展開して、ログに記録されたリクエストと応答のペイロードがどこに流れるかを追跡できます。次の例では、customer_support_endpoint_payload テーブルが payload_analysis ビューとその下流のコンシューマーにデータを提供します。テーブルリネージを参照してください。
制限事項
サービスリネージは、サービスの定義における依存関係のみをキャプチャします。Unity Catalogは、ランタイム時にサービスを呼び出すワークロードやエージェント、またはそれらを通じてアクセスされるデータをキャプチャしません。すべてのUnity Catalogリネージに適用される制限も適用されます。