适用于: 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
。
凭据
指示哪个 DATABASE SCOPED CREDENTIAL 对象与 AI 模型推理终结点一起使用。
参数
一个有效的 JSON 字符串,其中包含要追加到 AI 模型推理终结点请求消息的参数。 例如:
'{"Dimensions" : 1536}'
注解
一次只能修改单个外部模型对象。 并发修改同一外部模型对象的请求会导致一条语句等待。 但是,可以同时修改不同的外部模型对象。 此语句可以与其他语句同时运行。
例子
更改 EXTERNAL MODEL 并更改 MODEL 参数
此示例更改名为 dbo.myAImodel 的外部模型并更改 MODEL 参数。
-- Alter an external model
ALTER EXTERNAL MODEL dbo.myAImodel
SET
(
MODEL = 'text-embedding-3-large'
);