Dela via

Azure AI-tillägg i Azure Database for PostgreSQL – flexibel server

  • Artikel

GÄLLER FÖR: Azure Database for PostgreSQL – flexibel server

Med Azure Database for PostgreSQL–tillägget för flexibel server för Azure AI kan du använda stora språkmodeller (LLMS) och skapa omfattande generativa AI-program i databasen.  Azure AI-tillägget gör det möjligt för databasen att anropa olika Azure AI-tjänster, inklusive Azure OpenAI och Azure Cognitive Services , vilket förenklar utvecklingsprocessen och möjliggör sömlös integrering i dessa tjänster.

azure_ai Aktivera tillägget

Innan du kan aktivera azure_ai på din flexibla Azure Database for PostgreSQL-serverinstans måste du lägga till den i listan med tillåtna värden enligt beskrivningen i hur du använder PostgreSQL-tillägg och kontrollera om det har lagts till korrekt genom att köra SHOW azure.extensions;.

Dricks

Du kanske också vill aktivera pgvector tillägget eftersom det ofta används med azure_ai.

Sedan kan du installera tillägget genom att ansluta till måldatabasen och köra kommandot CREATE EXTENSION . Du måste upprepa kommandot separat för varje databas som du vill att tillägget ska vara tillgängligt i.

CREATE EXTENSION azure_ai;

Kommentar

Om du vill ta bort tillägget från den anslutna databasen använder du DROP EXTENSION azure_ai;.

När du installerar tillägget azure_ai skapas följande tre scheman:

  • azure_ai: huvudschema där konfigurationstabellen finns och funktioner för att interagera med den.
  • azure_openai: funktioner och sammansatta typer relaterade till OpenAI.
  • azure_cognitive: funktioner och sammansatta typer relaterade till Cognitive Services.

Tillägget gör det också möjligt att anropa Azure OpenAI och Azure Cognitive Services.

azure_ai Konfigurera tillägget

När du konfigurerar tillägget måste du ange slutpunkterna för att ansluta till Azure AI-tjänsterna och de API-nycklar som krävs för autentisering. Tjänstinställningarna lagras med hjälp av följande funktioner:

Behörigheter

Dina Azure AI-åtkomstnycklar liknar ett rotlösenord för ditt konto. Var alltid noga med att skydda dina åtkomstnycklar. Använd Azure Key Vault för att hantera och rotera dina nycklar på ett säkert sätt. För att hantera tjänstnycklar som används av tillägget behöver användarna den roll som azure_ai_settings_manager de har tilldelats. Följande funktioner kräver rollen:

  • azure_ai.set_setting
  • azure_ai.get_setting

Rollen azure_ai_settings_manager beviljas som standard rollen azure_pg_admin .

azure_ai.set_setting

Används för att ange konfigurationsalternativ.

azure_ai.set_setting(key TEXT, value TEXT)

Argument

key

Namn på ett konfigurationsalternativ. Giltiga värden för key är:

  • azure_openai.endpoint: OpenAI-slutpunkt som stöds (till exempel https://example.openai.azure.com).
  • azure_openai.subscription_key: En prenumerationsnyckel för en OpenAI-resurs.
  • azure_cognitive.endpoint: Cognitive Services-slutpunkt som stöds (till exempel https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: En prenumerationsnyckel för en Cognitive Services-resurs.
value

TEXT representerar det önskade värdet för den valda inställningen.

azure_ai.get_setting

Används för att hämta aktuella värden för konfigurationsalternativ.

azure_ai.get_setting(key TEXT)

Argument

Nyckel

Namn på ett konfigurationsalternativ. Giltiga värden för key är:

  • azure_openai.endpoint: OpenAI-slutpunkt som stöds (till exempel https://example.openai.azure.com).
  • azure_openai.subscription_key: En prenumerationsnyckel för en OpenAI-resurs.
  • azure_cognitive.endpoint: Cognitive Services-slutpunkt som stöds (till exempel https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: En prenumerationsnyckel för en Cognitive Services-resurs.

Returtyp

TEXT representerar det aktuella värdet för den valda inställningen.

azure_ai.version

azure_ai.version()

Returtyp

TEXT representerar den aktuella versionen av Azure AI-tillägget.

Exempel

Ange slutpunkten och en API-nyckel för 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>');

Hämta slutpunkten och API-nyckeln för Azure OpenAI

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

Kontrollera versionen av Azure AI-tillägget

select azure_ai.version();

Behörigheter

Tillägget azure_ai definierar en roll med namnet azure_ai_settings_manager, som möjliggör läsning och skrivning av inställningar relaterade till tillägget. Endast superanvändare och medlemmar i azure_ai_settings_manager rollen kan anropa azure_ai.get_settings funktionerna och azure_ai.set_settings . I Azure Database for PostgreSQL – flexibel server har alla administratörsanvändare rollen azure_ai_settings_manager tilldelad.

Uppgradera Azure AI-tillägget

Nyare versioner av tillägget kan introducera nya funktioner och uppgraderingar på plats av tillägget tillåts. Du kan jämföra den installerade versionen med den senaste versionen som tillåts med hjälp av SQL-kommandot:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Om du vill uppdatera ett installerat tillägg till den senaste tillgängliga versionen som stöds av Azure använder du följande SQL-kommando:

ALTER EXTENSION azure_ai UPDATE;

Nästa steg

Generera vektorinbäddningar med Azure OpenAI