Condividi tramite


ALTERARE IL MODELLO ESTERNO (Transact-SQL)

Si applica a: SQL Server 2025 (17.x) Azure SQL DatabaseSQL database in Microsoft Fabric

Modifica un oggetto modello esterno.

Sintassi

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

Argomenti

external_model_object_name

Specifica il nome definito dall'utente per il modello esterno. Il nome deve essere univoco all'interno del database.

UBICAZIONE

Fornisce il protocollo di connettività e il percorso dell'endpoint di inferenza del modello di intelligenza artificiale.

API_FORMAT

Formato del messaggio API per il provider di endpoint di inferenza del modello di intelligenza artificiale. I valori accettati sono Azure OpenAI, OpenAIe Ollama.

TIPO_DI_MODULO

Tipo di modello a cui si accede dalla posizione dell'endpoint di inferenza del modello di intelligenza artificiale. Il valore accettato è EMBEDDINGS.

MODELLO

Modello specifico ospitato dal provider di intelligenza artificiale. Ad esempio, text-embedding-ada-002, text-embedding-3-large o o3-mini.

CREDENZIALE

Indicare quale DATABASE SCOPED CREDENTIAL oggetto viene usato con l'endpoint di inferenza del modello di intelligenza artificiale.

PARAMETRI

Stringa JSON valida che contiene parametri da aggiungere al messaggio di richiesta dell'endpoint di inferenza del modello di intelligenza artificiale. Per esempio:

'{ "dimensions": 1536 }'

Osservazioni:

È possibile modificare un solo oggetto modello esterno alla volta. Le richieste simultanee per modificare lo stesso oggetto modello esterno causano l'attesa di un'istruzione. Tuttavia, è possibile modificare contemporaneamente oggetti modello esterni diversi. Questa istruzione può essere eseguita simultaneamente con altre istruzioni.

Esempi

Modificare EXTERNAL MODEL e modificare il parametro MODEL

In questo esempio viene modificato il EXTERNAL MODEL parametro denominato myAImodele viene modificato il MODEL parametro .

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