Compartilhar 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 no 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.

Formato_API

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

TIPO_DE_MODELO

O tipo de modelo que está sendo acessado 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 acrescentados à mensagem de solicitação de ponto de extremidade de inferência do modelo de IA. Por exemplo:

'{ "dimensions": 1536 }'

Observações

Somente um único objeto de modelo externo pode ser modificado por 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. Essa instrução pode ser executada simultaneamente com outras instruções.

Exemplos

Alter 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