Sdílet prostřednictvím

Rozšíření Azure AI ve službě Azure Database for PostgreSQL

Rozšíření Azure Database for PostgreSQL pro Azure AI umožňuje používat velké jazykové modely (LLMS) a vytvářet v databázi bohaté aplikace generující AI.  Rozšíření Azure AI umožňuje databázi volat do různých služeb Azure AI, včetně Služeb Azure OpenAI a Azure Cognitive Services , což zjednodušuje proces vývoje, což umožňuje bezproblémovou integraci do těchto služeb.

Povolení rozšíření azure_ai

Než budete moct na flexibilní instanci serveru Azure Database for PostgreSQL povolit azure_ai, musíte ji přidat do seznamu povolených podle pokynů v jak používat rozšíření PostgreSQL, a zkontrolovat, zda byla správně přidána, spuštěním SHOW azure.extensions;.

Návod

Rozšíření můžete také povolitpgvector, protože se běžně používá s azure_ai.

Rozšíření pak můžete nainstalovat tak, že se připojíte k cílové databázi a spustíte příkaz CREATE EXTENSION . Tento příkaz je potřeba opakovat zvlášť pro každou databázi, ve které má být rozšíření dostupné.

CREATE EXTENSION IF NOT EXISTS azure_ai;

Poznámka:

Chcete-li odebrat rozšíření z aktuálně připojené databáze, použijte DROP EXTENSION azure_ai;.

Instalace rozšíření azure_ai vytvoří následující tři schémata:

  • azure_ai: Hlavní schéma, kde se nachází konfigurační tabulka a funguje pro interakci s ní.
  • azure_openai: funkce a složené typy související s OpenAI.
  • azure_cognitive: funkce a složené typy související se službami Cognitive Services.

Rozšíření také umožňuje volat Azure OpenAI a Azure Cognitive Services.

Konfigurace rozšíření azure_ai

Konfigurace rozšíření vyžaduje, abyste zadali koncové body pro připojení ke službám Azure AI a klíčům rozhraní API potřebným k ověřování. Nastavení služby se ukládají pomocí následujících funkcí:

Oprávnění

Přístupové klíče Azure AI se podobají kořenovému heslu pro váš účet. Vždy buďte opatrní při ochraně přístupových klíčů. Pomocí služby Azure Key Vault můžete klíče bezpečně spravovat a otáčet. Uživatelé vyžadují, aby jim byla udělena role azure_ai_settings_manager ke správě klíčů služeb používaných rozšířením. Následující funkce vyžadují roli:

  • azure_ai.set_setting
  • azure_ai.get_setting

Role azure_ai_settings_manager je ve výchozím nastavení přidělena roli azure_pg_admin.

azure_ai.set_setting

Slouží k nastavení možností konfigurace.

azure_ai.set_setting(key TEXT, value TEXT)

Argumenty

key

Název možnosti konfigurace Platné hodnoty pro key jsou:

  • azure_openai.endpoint: Podporovaný koncový bod OpenAI (například https://example.openai.azure.com).
  • azure_openai.subscription_key: Klíč předplatného pro prostředek OpenAI.
  • azure_cognitive.endpoint: Podporovaný koncový bod služeb Cognitive Services (například https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: Klíč předplatného pro prostředky kognitivních služeb.
value

TEXT představuje požadovanou hodnotu vybraného nastavení.

azure_ai.get_setting

Slouží k získání aktuálních hodnot možností konfigurace.

azure_ai.get_setting(key TEXT)

Argumenty

Klíč

Název možnosti konfigurace Platné hodnoty pro key jsou:

  • azure_openai.endpoint: Podporovaný koncový bod OpenAI (například https://example.openai.azure.com).
  • azure_openai.subscription_key: Klíč předplatného pro prostředek OpenAI.
  • azure_cognitive.endpoint: Podporovaný koncový bod služeb Cognitive Services (například https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: Klíč předplatného pro prostředky kognitivních služeb.

Návratový typ

TEXT představuje aktuální hodnotu vybraného nastavení.

azure_ai.version

azure_ai.version()

Návratový typ

TEXT představuje aktuální verzi rozšíření Azure AI.

Příklady

Nastavení koncového bodu a klíče rozhraní API pro Azure OpenAI

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

Získání koncového bodu a klíče rozhraní API pro Azure OpenAI

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

Kontrola verze rozšíření Azure AI

select azure_ai.version();

Oprávnění

Rozšíření azure_ai definuje roli nazvanou azure_ai_settings_manager, která umožňuje čtení a zápis nastavení souvisejících s rozšířením. Pouze superuživatelé a členové role azure_ai_settings_manager mohou vyvolat funkce azure_ai.get_settings a azure_ai.set_settings. Ve flexibilních instancích serveru Azure Database for PostgreSQL mají všichni administrátoři přiřazenou roli azure_ai_settings_manager.

Aktualizujte rozšíření Azure AI

Novější verze rozšíření mohou zavést nové funkce a místní upgrady rozšíření jsou povolené. Aktuálně nainstalovanou verzi můžete porovnat s nejnovější povolenou verzí pomocí příkazu SQL:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Pokud chcete aktualizovat nainstalované rozšíření na nejnovější dostupnou verzi podporovanou v Azure, použijte následující příkaz SQL:

ALTER EXTENSION azure_ai UPDATE;

Související obsah

  • Last updated on