azure_ai tillägg i Azure Database for PostgreSQL

Tillägget azure_ai i Azure Database for PostgreSQL möjliggör användning i databasen av stora språkmodeller (LLM) för att skapa generativa AI-program. Det gör att databasen kan anropa Azure OpenAI i Microsoft Foundry-modeller, Azure OpenAI Service, Azure Cognitive Services (Azure Language in Foundry Tools) och Azure Machine Learning Tjänster, vilket förenklar utvecklingen genom sömlös integrering med dessa tjänster.

Aktivera azure_ai-tillägget

Innan du kan använda tillägget azure_ai måste du tillåta listan och sedan installera det i din Azure Database for PostgreSQL-instans. Följ stegen nedan för att komma igång.

Lägg till tillägget i godkänd lista

Lägg till azure_ai i tillåtna listan för din flexibla Azure Database för PostgreSQL-server enligt beskrivningen i hur du använder PostgreSQL-tillägg. Kontrollera att den har lagts till korrekt genom att köra frågan SHOW azure.extensions; .

Installera tillägget

Anslut till databasen och kör CREATE EXTENSION kommandot:

CREATE EXTENSION IF NOT EXISTS azure_ai;

Upprepa det här kommandot för varje databas där tillägget krävs.

När du installerar azure_aiskapar den följande scheman:

• azure_ai: huvudschema för konfiguration och relaterade funktioner
• azure_openai: funktioner och typer för Azure OpenAI i Foundry Models och OpenAI-modeller i Microsoft Foundry
• azure_cognitive: funktioner och typer för Azure Cognitive Services (Azure Language i Foundry Tools)
• azure_ml: funktioner och typer för Azure Machine Learning Services

Konfigurera azure_ai-tillägget

För att konfigurera tillägget anger du slutpunkter och autentiseringsinformation (API-nyckel eller hanterad identitet) för de Azure AI + maskininlärningstjänster som du vill använda. Använd konfigurationsfunktionen azure_ai.set_setting med olika konfigurationsnycklar för att lagra dessa värden.

Permissions

Tillägget definierar en roll azure_ai_settings_manager som ger behörighet att läsa och skriva konfigurationsinställningar genom att använda funktionerna azure_ai.set_getting och azure_ai.set_setting. Endast superanvändare och medlemmar i den här rollen kan anropa dessa funktioner. I Azure Database for PostgreSQL Flexibel Server beviljar rollen azure_pg_admin befogenheter som standard.

Konfigurationsfunktioner

azure_ai_set_setting

Ställer in konfigurationen för AI + maskininlärning.

Användning:

-- Syntax
azure_ai.set_setting(key TEXT, value TEXT)

-- Usage example: Set the Endpoint and an API Key for 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>');

Lista över konfigurationsnycklar och värden som stöds:

azure_ai.get_setting

Hämtar aktuella konfigurationsvärden för en viss key (se nycklar som stöds i listan ovan). Returnerar TEXT det aktuella värdet för den valda inställningen.

Användning:

-- Syntax
azure_ai.get_setting(key TEXT)

-- Usage example: Get the Endpoint and API Key for Azure OpenAI
select azure_ai.get_setting('azure_openai.endpoint');
select azure_ai.get_setting('azure_openai.subscription_key');

azure_ai.version

Returnerar TEXT den aktuella versionen av azure_ai tillägget.

Användning:

SELECT azure_ai.version()

Aktivera hanterad identitetsautentisering

tillägget azure_ai för Azure Database for PostgreSQL stöder systemtilldelad hanterad identitet (SAMI), vilket ger förbättrade säkerhetsfördelar. Med hjälp av Microsoft Entra ID kan du autentisera utan åtkomstnycklar, vilket minskar risken för obehörig åtkomst och förenklar autentiseringshanteringen.

Information om hur du aktiverar hanterad identitetsautentisering finns i den här guiden.

Funktioner i azure_ai tillägget

AI-funktioner

Tillägget azure_ai möjliggör databasanrop till modeller som finns i Foundry och Azure OpenAI via följande AI-funktioner (förhandsversion):

• Generera vektorinbäddningar med Azure OpenAI i Azure Database for PostgreSQL: Skapar vektorinbäddningar för en viss indatatext.
• azure_ai.generate(): Genererar text eller strukturerade utdata med hjälp av stora språkmodeller (LLM).
• azure_ai.is_true(): Utvärderar sannolikheten för att ett givet påstående är sant.
• azure_ai.extract(): Extraherar strukturerade funktioner eller entiteter från text.
• azure_ai.rank(): Rankar en lista över dokument baserat på relevans för en viss fråga.

Ytterligare funktioner

Tillägget har också stöd för att anropa

• Integrera Azure Database for PostgreSQL med Azure Cognitive Services: Aktiverar uppgifter som attitydanalys direkt i databasen.
• Integrera Azure Database for PostgreSQL med Azure Machine Learning Services: Gör att du kan anropa modeller från strojové učenie-katalogen eller anpassade distributioner.

Uppgradera AI- och maskininlärningstillägget

Om du vill kontrollera den installerade versionen och tillgängliga uppgraderingar kör du:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Om du vill uppdatera tillägget till den senaste versionen som stöds kör du:

ALTER EXTENSION azure_ai UPDATE;

Relaterat innehåll

• AI-funktioner i azure_ai-tillägget (förhandsversion)
• Generera vektorinbäddningar med Azure OpenAI i Azure Database for PostgreSQL
• Aktivera och använda pgvector i Azure Database for PostgreSQL
• Självstudie: Skapa en semantisk sökning med Azure Database for PostgreSQL och Azure OpenAI
• Integrera Azure Database for PostgreSQL med Azure Machine Learning Services