ALTER EXTERNAL MODEL (Transact-SQL)

适用于: 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 OpenAIOpenAIOllama

模型类型

从 AI 模型推理终结点位置访问的模型类型。 接受的值为:EMBEDDINGS

由 AI 提供程序托管的特定模型。 例如,text-embedding-ada-002text-embedding-3-largeo3-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'
);