databricks-unity-gateway

Unity Gateway

CLI 認証とプロファイルの選択には、親の databricks-core スキルを使用してください。

Unity Gateway は、AI サービスへの統制されたアクセスを提供する Unity Catalog のセキュリティ保護可能なオブジェクトを提供します。CLI のコマンドグループでは、以前の製品名が引き続き使用されます：databricks ai-gateway --help。

適切な Gateway を選択する

リクエスト	使用するもの
Unity Gateway のモデルサービス、MCP サービス、またはモデルプロバイダーサービス	このスキルと databricks ai-gateway
put-ai-gateway を含む、Model Serving エンドポイントの AI Gateway 設定	databricks-model-serving と databricks serving-endpoints
Lakeflow Connect の取り込みゲートウェイ	databricks-lakeflow-connect

リソースが Unity Catalog のセキュリティ保護可能なオブジェクトである場合、Unity AI Gateway は Unity Gateway の以前の名称として扱ってください。ユーザーから明示的に移行を依頼されない限り、従来の Model Serving AI Gateway リソースを Unity Gateway リソースに変換しないでください。

CLI ワークフロー

リソースのライフサイクル管理と権限管理には Databricks CLI を使用してください。これらの操作に直接 REST 呼び出しや Databricks SDK を代用しないでください。モデルサービスとモデルプロバイダーサービスのクエリには Python クライアントを使用できます。サービスへのクエリを参照してください。

Unity Gateway、Unity AI Gateway、または databricks ai-gateway の明示的なリクエストは、このスキルの対象です。リクエストにモデルサービスやワークスペースが関係するという理由だけで、databricks-model-serving に切り替えないでください。そのスキルを使用するのは、従来のエンドポイント単位の AI Gateway 操作の場合、またはプロビジョニング済みスループットの宛先に Model Serving エンドポイントの詳細が必要な場合に限ります。

1. CLI が最小バージョンを満たしていることを確認します。

   databricks --version
   

2. ペイロードを作成する前に、コマンドと関連する操作を確認します。

   databricks ai-gateway --help
   databricks ai-gateway <operation> --help
   

3. 作成と更新の設定は --json を通じて渡します。プロファイルベースの認証が必要な場合は、明示的なプロファイルを使用します。

   databricks ai-gateway <operation> --json @payload.json --profile <PROFILE>
   

類似した名前の従来の API を参考にして、JSON フィールドを推測しないでください。インストール済み CLI のヘルプと、選択したサービスタイプの Unity Gateway ドキュメントに基づいてペイロードを作成してください。

サービスタイプ

サービスタイプ	CLI 操作
モデルサービス	create-model-service、get-model-service、list-model-services、update-model-service、delete-model-service。モデルサービスを参照してください。
MCP サービス	create-mcp-service、get-mcp-service、list-mcp-services、update-mcp-service、delete-mcp-service。MCP サービスを参照してください。
モデルプロバイダーサービス	create-model-provider-service、get-model-provider-service、list-model-provider-services、update-model-provider-service、delete-model-provider-service。モデルプロバイダーサービスを参照してください。

クエリと権限

• モデルまたはモデルプロバイダーサービスを呼び出す Python を記述する前に、references/querying.md を読んでください。
• Unity Gateway のアクセスを確認、付与、または取り消す前に、references/permissions.md を読んでください。
• モデルサービスに関する操作を行う前に、references/model-services.md を読んでください。現在のリソース名の規則、JSON ペイロードのフィールド、必須入力の確認条件、ライフサイクルコマンドが記載されています。
• MCP サービスに関する操作を行う前に、MCP 固有の同等の仕様が記載されている references/mcp-services.md を読んでください。
• モデルプロバイダーサービスに関する操作を行う前に、references/model-provider-services.md を読んでください。
• Unity Gateway の利用に関する支出予算または支出アラートを設定する前に、references/budgets.md を読んでください。
• アカウントスコープの操作（付与主体としてのアカウントグループ、アカウント予算）を行う前に、references/account-access.md を読んでください。

これらのリファレンスですでに説明されているフィールドについて、公開ドキュメントを取得しないでください。必須フィールドがリファレンスに記載されていない場合、またはユーザーが最新のドキュメントを明示的に求めている場合に限り、正式なドキュメントを参照してください。インストール済みの CLI ヘルプまたは最新のドキュメントで明示されていない限り、ベータ版またはプレビュー版であると判断しないでください。

Model Serving から Unity Gateway への移行

ワークスペーススコープの Model Serving エンドポイントから Unity Catalog スコープの Unity Gateway サービスに移行する場合は、references/model-serving-migration.md を読んでください。

正式なドキュメント

• Unity Gateway の概要
• Unity Gateway のリリースノート
• Unity Gateway 開発者向けドキュメント
• モデルサービス API リファレンス
• MCP サービス API リファレンス
• モデルプロバイダーサービス API リファレンス
• モデルサービスへのクエリ
• Open Responses 仕様
• Databricks における Open Responses のプロバイダー動作
• モデルプロバイダーサービスへのクエリ
• モデルサービスの要件と付与
• モデルプロバイダーサービスのガバナンス
• ルーティングとフォールバック
• レート制限
• 外部 MCP サーバーの登録