Sdílet prostřednictvím

Rozšíření Azure AI na flexibilním serveru Azure Database for PostgreSQL

  • Článek

PLATÍ PRO: Flexibilní server Azure Database for PostgreSQL

Rozšíření flexibilního serveru 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 povolit azure_ai instanci flexibilního serveru Azure Database for PostgreSQL, musíte ji přidat do seznamu povolených, jak je popsáno v tom, jak používat rozšíření PostgreSQL, a zkontrolovat, jestli je správně přidaná spuštěním SHOW azure.extensions;.

Tip

Rozšíření můžete také povolitpgvector, protože se běžně používá .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 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: Schéma objektu zabezpečení, ve kterém se nachází konfigurační tabulka, a funkce 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. Ke správě klíčů služeb používaných rozšířením uživatelé vyžadují azure_ai_settings_manager , aby jim byla udělena role. 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í udělena azure_pg_admin této roli.

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 následující key hodnoty:

  • 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ředek služeb Cognitive Services.
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 následující key hodnoty:

  • 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ředek služeb Cognitive Services.

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. Tyto funkce azure_ai.set_settings můžou vyvolat azure_ai.get_settings pouze superuživatelé a členové azure_ai_settings_manager role. Na flexibilním serveru Azure Database for PostgreSQL mají přiřazenou azure_ai_settings_manager roli všichni uživatelé správce.

Upgrade 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