Поделиться через

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

Задает определяемое пользователем имя внешней модели. В базе данных это имя должно быть уникальным.

МЕСТОПОЛОЖЕНИЕ

Предоставляет протокол подключения и путь к конечной точке вывода модели ИИ.

Формат_API

Формат сообщения API для поставщика конечной точки вывода модели ИИ. Допустимые значения: Azure OpenAI, OpenAIи Ollama.

MODEL_TYPE

Тип модели, к которой осуществляется доступ из расположения конечной точки вывода модели ИИ. Принятое значение EMBEDDINGSравно.

МОДЕЛЬ

Конкретная модель, размещенная поставщиком ИИ. Например, text-embedding-ada-002, text-embedding-3-large или o3-mini.

УЧЁТНЫЕ ДАННЫЕ

Укажите, какой объект DATABASE SCOPED CREDENTIAL используется с конечной точкой вывода модели ИИ.

ПАРАМЕТРЫ

Допустимая строка JSON, содержащая параметры, добавляемые в сообщение запроса конечной точки вывода модели ИИ. Рассмотрим пример.

'{"Dimensions" : 1536}'

Замечания

Одновременно можно изменить только один объект внешней модели. Одновременные запросы на изменение одного и того же объекта внешней модели вызывают ожидание одной инструкции. Однако различные объекты внешней модели можно изменять одновременно. Эта инструкция может выполняться параллельно с другими операторами.

Примеры

Изменение ВНЕШНЕЙ МОДЕЛИ и изменение параметра MODEL

В этом примере изменяется external MODEL с именем dbo.myAImodel и изменяется параметр MODEL.

-- Alter an external model
ALTER EXTERNAL MODEL dbo.myAImodel
SET
(
  MODEL = 'text-embedding-3-large'
);

Связанный контент