共用方式為


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

MODEL_TYPE

從 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'
);