Partilhar via

ALTERAR MODELO EXTERNO (Transact-SQL)

Aplica-se a: SQL Server 2025 (17.x) Azure SQL Database SQLdatabase in Microsoft Fabric

Altera um objeto de modelo externo.

Sintaxe

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 o nome definido pelo usuário para o modelo externo. O nome deve ser exclusivo dentro do banco de dados.

LOCALIZAÇÃO

Fornece o protocolo de conectividade e o caminho para o ponto de extremidade de inferência do modelo de IA.

API_FORMAT

O formato de mensagem da API para o provedor de ponto de extremidade de inferência de modelo de IA. Os valores aceites são Azure OpenAI, OpenAI, e Ollama.

Modelo_Tipo

O tipo de modelo que está sendo acessado a partir do local do ponto de extremidade de inferência do modelo de IA. O valor aceito é EMBEDDINGS.

MODELO

O modelo específico hospedado pelo provedor de IA. Por exemplo, text-embedding-ada-002, text-embedding-3-large, ou o3-mini.

CREDENCIAL

Indique qual DATABASE SCOPED CREDENTIAL objeto é usado com o ponto de extremidade de inferência do modelo de IA.

PARÂMETROS

Uma cadeia de caracteres JSON válida que contém parâmetros a serem anexados à mensagem de solicitação de ponto de extremidade de inferência do modelo AI. Por exemplo:

'{ "dimensions": 1536 }'

Observações

Apenas um único objeto de modelo externo pode ser modificado de cada vez. Solicitações simultâneas para modificar o mesmo objeto de modelo externo fazem com que uma instrução aguarde. No entanto, diferentes objetos de modelo externos podem ser modificados ao mesmo tempo. Esta instrução pode ser executada simultaneamente com outras instruções.

Exemplos

Altere EXTERNAL MODEL e altere o parâmetro MODEL

Este exemplo altera o EXTERNAL MODEL nome myAImodele altera o MODEL parâmetro.

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

Conteúdo relacionado

  • Last updated on