Megosztás a következőn keresztül:

Azure AI-bővítmény az Azure Database for PostgreSQL-ben

A következőkre vonatkozik: Azure Database for PostgreSQL – Rugalmas kiszolgáló

Az Azure AI rugalmas Azure Database for PostgreSQL-kiszolgálóbővítménye lehetővé teszi, hogy nagy nyelvi modelleket (LLMS) használjon, és gazdag generatív AI-alkalmazásokat építsen az adatbázisban.  Az Azure AI-bővítmény lehetővé teszi, hogy az adatbázis különböző Azure AI-szolgáltatásokba hívjon be, beleértve az Azure OpenAI-t és az Azure Cognitive Servicest is, így egyszerűbbé válik a fejlesztési folyamat, így zökkenőmentesen integrálható ezekbe a szolgáltatásokba.

A azure_ai bővítmény engedélyezése

Ahhoz, hogy engedélyezni tudja azure_ai a rugalmas Azure Database for PostgreSQL-kiszolgálópéldányán, fel kell vennie azt az engedélyezési listába a PostgreSQL-bővítmények használata útmutató szerint, és ellenőriznie kell, hogy megfelelően van-e hozzáadva a SHOW azure.extensions; parancs futtatásával.

Jótanács

Érdemes lehet engedélyezni a pgvector bővítményt is, mivel a bővítményt gyakran használják.azure_ai

Ezután telepítheti a bővítményt a céladatbázishoz való csatlakozással és a CREATE EXTENSION parancs futtatásával. A parancsot külön kell megismételnie minden olyan adatbázis esetében, amelyben elérhetővé szeretné tenni a bővítményt.

CREATE EXTENSION IF NOT EXISTS azure_ai;

Megjegyzés:

Ha el szeretné távolítani a bővítményt a jelenleg csatlakoztatott adatbázisból, használja a következőt DROP EXTENSION azure_ai;:

A bővítmény azure_ai telepítése a következő három sémát hozza létre:

  • azure_ai: egyszerű séma, ahol a konfigurációs tábla található, és a vele való interakcióhoz szükséges függvények.
  • azure_openai: az OpenAI-hoz kapcsolódó függvények és összetett típusok.
  • azure_cognitive: a Cognitive Serviceshez kapcsolódó függvények és összetett típusok.

A bővítmény lehetővé teszi az Azure OpenAI és az Azure Cognitive Services meghívását is.

A azure_ai bővítmény konfigurálása

A bővítmény konfigurálásához meg kell adnia a végpontokat az Azure AI-szolgáltatásokhoz való csatlakozáshoz, valamint a hitelesítéshez szükséges API-kulcsokat. A szolgáltatásbeállítások tárolása a következő függvényekkel történik:

Engedélyek

Az Azure AI-hozzáférési kulcsok hasonlóak a fiók legfelső szintű jelszavához. Mindig ügyeljen a hozzáférési kulcsok védelmére. Az Azure Key Vault használatával biztonságosan kezelheti és elforgathatja a kulcsokat. A bővítmény által használt szolgáltatáskulcsok kezeléséhez a felhasználóknak rendelkezniük kell a azure_ai_settings_manager szerepkörrel. A következő függvények megkövetelik a szerepkört:

  • azure_ai.set_setting
  • azúr_ai.beállítást_lekér

A azure_ai_settings_manager szerepkör alapértelmezés szerint a azure_pg_admin szerepkörhöz van adva.

azure_ai.set_setting

A konfigurációs beállítások beállítására szolgál.

azure_ai.set_setting(key TEXT, value TEXT)

Érvek

key

Konfigurációs beállítás neve. Az érvényes értékek a key következők:

  • azure_openai.endpoint: Támogatott OpenAI-végpont (például https://example.openai.azure.com).
  • azure_openai.subscription_key: Egy OpenAI-erőforrás előfizetési kulcsa.
  • azure_cognitive.endpoint: Támogatott Cognitive Services-végpont (például https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: Egy Cognitive Services-erőforrás előfizetési kulcsa.
value

TEXT a kiválasztott beállítás kívánt értékét jelöli.

azure_ai.get_setting

A konfigurációs beállítások aktuális értékeinek lekérésére szolgál.

azure_ai.get_setting(key TEXT)

Érvek

Kulcs

Konfigurációs beállítás neve. Az érvényes értékek a key következők:

  • azure_openai.endpoint: Támogatott OpenAI-végpont (például https://example.openai.azure.com).
  • azure_openai.subscription_key: Egy OpenAI-erőforrás előfizetési kulcsa.
  • azure_cognitive.endpoint: Támogatott Cognitive Services-végpont (például https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: Egy Cognitive Services-erőforrás előfizetési kulcsa.

Visszatérési típus

TEXT a kijelölt beállítás aktuális értékét jelöli.

azure_ai.version

azure_ai.version()

Visszatérési típus

TEXT az Azure AI-bővítmény aktuális verzióját jelöli.

Példák

Az Azure OpenAI végpontjának és API-kulcsának beállítása

select azure_ai.set_setting('azure_openai.endpoint','https://<endpoint>.openai.azure.com'); 
select azure_ai.set_setting('azure_openai.subscription_key', '<API Key>');

Az Azure OpenAI végpont- és API-kulcsának lekérése

select azure_ai.get_setting('azure_openai.endpoint');
select azure_ai.get_setting('azure_openai.subscription_key');

Az Azure AI-bővítmény verziójának ellenőrzése

select azure_ai.version();

Engedélyek

A azure_ai bővítmény egy úgynevezett azure_ai_settings_managerszerepkört határoz meg, amely lehetővé teszi a bővítményhez kapcsolódó beállítások olvasását és írását. Csak a felügyelők és a azure_ai_settings_manager szerepkör tagjai hívhatják meg a azure_ai.get_settings és a azure_ai.set_settings függvényeket. A rugalmas Azure Database for PostgreSQL-kiszolgálón minden rendszergazdai felhasználóhoz hozzá van rendelve a azure_ai_settings_manager szerepkör.

Az Azure AI-bővítmény frissítése

A bővítmény újabb verziói új funkciókat vezethetnek be, és a bővítmény helyszíni frissítései engedélyezettek. Az SQL-paranccsal összehasonlíthatja a jelenleg telepített verziót a legújabb verzióval:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Ha egy telepített bővítményt az Azure által támogatott legújabb elérhető verzióra szeretne frissíteni, használja a következő SQL-parancsot:

ALTER EXTENSION azure_ai UPDATE;

Kapcsolódó tartalom