外部モデルプロバイダー（モデルプロバイダーサービス）の作成と管理
外部モデルプロバイダーをモデルプロバイダーサービスとして登録し、アクセス権を付与し、Unity AI Gateway機能を構成し、削除します。
要件
CREATE SERVICEモデルプロバイダーサービスを作成するスキーマ上、そのカタログとスキーマに対するUSE CATALOGとUSE SCHEMAの権限。- 登録する外部プロバイダーの認証情報（例：OpenAI API キーまたはAWSアクセスキーペア）。
モデルプロバイダーサービスを作成
モデルプロバイダーサービスとモデルサービスは、Unity Catalog スキーマ内で単一の名前空間を共有します。スキーマ内のモデルサービスがすでに使用している名前をモデルプロバイダーサービスに使用することはできません。その逆も同様です。
UIを使用してください
-
以下のいずれかを実行します。
- ワークスペースのサイドバーで [ AI Gateway ] をクリックし、[ Providers tab] を開いて [ Provider ] をクリックします。
- カタログエクスプローラーで、モデルプロバイダーサービスを作成したいスキーマに移動し、 作成 > サービス をクリックしてから、 サービスの作成 ダイアログで モデルプロバイダーサービス を選択します。
-
モデルプロバイダーサービスの名前を入力し、作成するカタログとスキーマを選択します。Catalog Explorerから起動すると、Catalog Explorerがカタログとスキーマを事前に設定します。
-
プロバイダータイプを選択し、プロバイダーの接続の詳細と資格情報を入力します。
-
作成 をクリックします。Databricksは資格情報を暗号化して保存します。この時点以降はUIに表示しません。
プロバイダーの全リストとその認証方法については、外部モデルプロバイダー（モデルプロバイダーサービス）のガバナンスを参照してください。
カスタムプロバイダーの API キーをヘッダーで送信する
カスタムプロバイダーは、default で API キーをベアラートークンとして送信します。Endpoint が特定のヘッダーでキーを要求する場合は、API キーヘッダー認証を使用し、ヘッダー名を指定してください。その後、Databricks は各送信リクエストでキーを <header name>: <header value> として送信します。
モデルプロバイダーサービスを作成するで説明されているように、モデルプロバイダーサービスを作成します。プロバイダータイプとして Custom を選択し、 Auth method を API key header に設定して、Endpoint が期待する Header name (X-API-Key や Ocp-Apim-Subscription-Key など) と Header value を指定します。
これら2つのメソッドは相互に排他的です。カスタムプロバイダーは、ベアラートークンまたは名前付きヘッダーのいずれかを使用し、両方を使用することはできません。ヘッダー認証には、ヘッダーが1つ必要です。
ヘッダー名は有効なHTTPヘッダー名である必要があります（英数字および!#$%&'*+-.^_`|~の文字、最大255文字）。スペース、コロン、スラッシュ、改行など、その他の文字はすべて拒否されます。
アクセス権を付与
他のユーザーがモデルプロバイダーサービスをクエリーできるようにするには、モデルプロバイダーサービスに対してEXECUTEを付与し、そのカタログとスキーマに対してUSE CATALOGとUSE SCHEMAを付与します。モデルプロバイダーサービスが推論テーブルにLogsを記録する場合は、テーブルに対してSELECTを付与して、Logsに記録されたリクエストとレスポンスを読み取れるようにします。
カタログエクスプローラーでアクセス権を付与するには
- カタログエクスプローラーで、モデルプロバイダーサービスを開きます。
- アクセス許可 タブで、 許可 をクリックします。
- アクセスを付与するユーザーまたはグループを選択し、
EXECUTE権限を選択して、 付与 をクリックします。
同じプリンシパルが、モデルプロバイダーサービスのカタログとスキーマに対してUSE CATALOGとUSE SCHEMAも保持していることを確認してください。ログに記録されたリクエストと応答を読み取れるようにするには、推論テーブルのSELECT **[権限]**tabから を付与します。
アクセス権の付与と検出の詳細については、外部モデルプロバイダー（モデルプロバイダーサービス）へのアクセスの検出と管理を参照してください。
機能の構成
モデルプロバイダーサービスは Unity AI Gateway を介してルーティングされるため、他の Unity AI Gateway トラフィックで利用するものと同じガバナンスと可観測性機能をご利用ください。
- 推論ロギング。 リクエストと応答をUnity CatalogテーブルにLogs。推論テーブルへのリクエストと応答のLogsを参照してください。
- レート制限。 1分あたりのクエリー数を制限して、容量とコストを管理します。モデルおよび MCP サービスのレート制限の適用 を参照してください。
- サービスポリシー。 サービスポリシーをアタッチすることで、安全でないコンテンツのブロックや機密データの伏せ字化など、各インタラクションのコンテンツを管理します。「AI保護対象のサービスポリシー」および「サービスポリシーの作成とアタッチ」を参照してください。
モデルプロバイダーサービスの削除
モデルプロバイダーサービスを削除するには、そのサービスに対する少なくともMANAGE権限が必要です。所有者はMANAGEのスーパーセットを持っています。
モデルプロバイダーサービスを削除するには、Catalog Explorerで開き、ケバブメニューから「 削除 」を選択します。モデルプロバイダーサービスを削除すると、保存されている資格情報が削除されます。