Bagikan melalui


UBAH MODEL EKSTERNAL (Transact-SQL)

Berlaku untuk: SQL Server 2025 (17.x) Database SQL Azure SQL databasedi Microsoft Fabric

Mengubah objek model eksternal.

Sintaksis

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

Argumen

external_model_object_name

Menentukan nama yang ditentukan pengguna untuk model eksternal. Nama dalam database harus unik.

TEMPAT

Menyediakan protokol konektivitas dan jalur ke titik akhir inferensi model AI.

API_FORMAT

Format pesan API untuk penyedia titik akhir inferensi model AI. Nilai yang diterima adalah Azure OpenAI, OpenAI, dan Ollama.

Jenis Model

Jenis model yang diakses dari lokasi titik akhir inferensi model AI. Nilai yang diterima adalah EMBEDDINGS.

POLA

Model tertentu yang dihosting oleh penyedia AI. Misalnya, text-embedding-ada-002, text-embedding-3-large, atau o3-mini.

bukti sah

Menunjukkan objek mana yang DATABASE SCOPED CREDENTIAL digunakan dengan titik akhir inferensi model AI.

PARAMETER

String JSON valid yang berisi parameter yang akan ditambahkan ke pesan permintaan titik akhir inferensi model AI. Contohnya:

'{ "dimensions": 1536 }'

Komentar

Hanya satu objek model eksternal yang dapat dimodifikasi pada satu waktu. Permintaan bersamaan untuk memodifikasi objek model eksternal yang sama menyebabkan satu pernyataan menunggu. Namun, objek model eksternal yang berbeda dapat dimodifikasi secara bersamaan. Pernyataan ini dapat berjalan bersamaan dengan pernyataan lain.

Contoh

Mengubah MODEL EKSTERNAL dan mengubah parameter MODEL

Contoh ini mengubah EXTERNAL MODEL parameter bernama myAImodel, dan mengubah MODEL .

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