ALTER EXTERNAL MODEL (Transact-SQL)

2025-05-19

Se aplica a: VERSIÓN PRELIMINAR de SQL Server 2025 (17.x)

Modifica un objeto de modelo externo.

Sintaxis

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" } ' ]
  );

Argumentos

external_model_object_name

Especifica el nombre definido por el usuario para el modelo externo. El nombre debe ser único en la base de datos.

UBICACIÓN

Proporciona el protocolo de conectividad y la ruta de acceso al punto de conexión de inferencia del modelo de IA.

API_FORMAT

Formato de mensaje de API para el proveedor de puntos de conexión de inferencia del modelo de IA. Los valores aceptados son Azure OpenAI, OpenAIy Ollama.

TIPO_DE_MODELO

Tipo de modelo al que se accede desde la ubicación del punto de conexión de inferencia del modelo de IA. El valor aceptado es EMBEDDINGS.

MODELO

Modelo específico hospedado por el proveedor de IA. Por ejemplo, text-embedding-ada-002, text-embedding-3-large o o3-mini.

CREDENCIAL

Indique qué objeto DATABASE SCOPED CREDENTIAL se usa con el punto de conexión de inferencia del modelo de IA.

PARÁMETROS

Cadena JSON válida que contiene parámetros que se van a anexar al mensaje de solicitud del punto de conexión de inferencia del modelo de IA. Por ejemplo:

'{"Dimensions" : 1536}'

Observaciones

Solo se puede modificar un solo objeto de modelo externo a la vez. Las solicitudes simultáneas para modificar el mismo objeto de modelo externo provocan que una instrucción espere. Sin embargo, se pueden modificar diferentes objetos de modelo externo al mismo tiempo. Esta instrucción se puede ejecutar simultáneamente con otras instrucciones.

Ejemplos

Modificar EXTERNAL MODEL y cambiar el parámetro MODEL

En este ejemplo se modifica el MODELO EXTERNO denominado dbo.myAImodel y se cambia el parámetro MODEL.

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