Delen via

ALTER EXTERNAL MODEL (Transact-SQL)

Van toepassing op: SQL Server 2025 (17.x) Preview

Wijzigt een extern modelobject.

Syntaxis

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

Argumenten

external_model_object_name

Hiermee geeft u de door de gebruiker gedefinieerde naam voor het externe model. De naam moet uniek zijn binnen de database.

LOCATIE

Biedt het connectiviteitsprotocol en het pad naar het eindpunt van deductie van het AI-model.

API_FORMAT

De API-berichtindeling voor de eindpuntprovider voor deductie van het AI-model. Geaccepteerde waarden zijn Azure OpenAI, OpenAIen Ollama.

MODEL_TYPE

Het type model dat wordt geopend vanaf de eindpuntlocatie van het AI-modeldeductie. Geaccepteerde waarde is EMBEDDINGS.

MODEL

Het specifieke model dat wordt gehost door de AI-provider. Bijvoorbeeld text-embedding-ada-002, text-embedding-3-large of o3-mini.

REFERENTIE

Geef aan welk DATABASE SCOPED CREDENTIAL object wordt gebruikt met het eindpunt voor deductie van het AI-model.

PARAMETERS

Een geldige JSON-tekenreeks die parameters bevat die moeten worden toegevoegd aan het eindpuntaanvraagbericht voor deductie van het AI-model. Voorbeeld:

'{ "dimensions": 1536 }'

Opmerkingen

Er kan slechts één extern modelobject tegelijk worden gewijzigd. Gelijktijdige aanvragen om hetzelfde externe modelobject te wijzigen, zorgt ervoor dat één instructie wacht. Verschillende externe modelobjecten kunnen echter tegelijkertijd worden gewijzigd. Deze instructie kan gelijktijdig worden uitgevoerd met andere instructies.

Voorbeelden

EXTERN MODEL wijzigen en de parameter MODEL wijzigen

In dit voorbeeld wordt de EXTERNAL MODEL benoemde dbo.myAImodelnaam gewijzigd en wordt de MODEL parameter gewijzigd.

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

Verwante inhoud