対象者:
SQL Server 2025 (17.x) Azure SQL DatabaseSQL database in Microsoft Fabric
外部モデル オブジェクトを変更します。
構文
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 パラメーターを変更する
次の使用例は、EXTERNAL MODELという名前のmyAImodelを変更し、MODEL パラメーターを変更します。
-- Alter an external model
ALTER EXTERNAL MODEL myAImodel
SET
(
MODEL = 'text-embedding-3-large'
);