適用於: 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
。
MODEL_TYPE
從 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'
);