適用対象:
SQL Server 2025 (17.x) プレビュー
外部モデル オブジェクトを変更します。
構文
ALTER EXTERNAL MODEL external_model_object_name
SET
( LOCATION = '<prefix>://<path> [ :<port> ] '
, API_FORMAT = '<OpenAI , Azure OpenAI , etc>'
, MODEL_TYPE = EMBEDDINGS
, MODEL = 'text-embedding-ada-002'
[ , CREDENTIAL = <credential_name> ]
[ , PARAMETERS = ' { "valid":"JSON" } ' ]
);
論争
external_model_object_name
外部モデルのユーザー定義名を指定します。 名前は、データベース内で一意である必要があります。
場所
接続プロトコルと AI モデル推論エンドポイントへのパスを提供します。
API_FORMAT
AI モデル推論エンドポイント プロバイダーの API メッセージ形式。 指定できる値は Azure OpenAI、OpenAI、Ollama です。
モデルタイプ
AI モデル推論エンドポイントの場所からアクセスされるモデルの種類。 指定できる値は EMBEDDINGS です。
モデル
AI プロバイダーによってホストされる特定のモデル。 (text-embedding-ada-002、text-embedding-3-large、または o3-mini など)。
資格 情報
AI モデル推論エンドポイントで使用される DATABASE SCOPED CREDENTIAL オブジェクトを示します。
パラメーター
AI モデル推論エンドポイント要求メッセージに追加されるパラメーターを含む有効な JSON 文字列。 例えば次が挙げられます。
'{"Dimensions" : 1536}'
注釈
一度に変更できる外部モデル オブジェクトは 1 つだけです。 同じ外部モデル オブジェクトを変更する同時要求により、1 つのステートメントが待機します。 ただし、異なる外部モデル オブジェクトを同時に変更できます。 このステートメントは、他のステートメントと同時実行できます。
例示
EXTERNAL MODEL を変更し、MODEL パラメーターを変更する
この例では、dbo.myAImodel という名前の EXTERNAL MODEL を変更し、MODEL パラメーターを変更します。
-- Alter an external model
ALTER EXTERNAL MODEL dbo.myAImodel
SET
(
MODEL = 'text-embedding-3-large'
);