azure_ai-Erweiterung in Azure Database for PostgreSQL

Die erweiterung azure_ai in Azure Database for PostgreSQL ermöglicht die In-Datenbank-Verwendung großer Sprachmodelle (LLMs) zum Erstellen von generativen KI-Anwendungen. Es ermöglicht der Datenbank, Azure OpenAI in Microsoft Foundry-Modellen, Azure OpenAI Service, Azure Cognitive Services (Azure Language in Foundry Tools) und Azure Machine Learning Services. Zudem, vereinfacht es die Entwicklung durch nahtlose Integration mit diesen Diensten.

Aktivieren Sie die Erweiterung azure_ai

Bevor Sie die azure_ai-Erweiterung verwenden können, müssen Sie sie zulassen und dann in Ihrer Azure Database for PostgreSQL Instanz installieren. Führen Sie die folgenden Schritte aus, um zu beginnen.

Die Erweiterung auf die Positivliste setzen.

Fügen Sie azure_ai zur Allowlist Ihres Azure Database for PostgreSQL flexiblen Servers hinzu, wie in wie PostgreSQL-Erweiterungen verwendet werden beschrieben. Stellen Sie sicher, dass sie ordnungsgemäß hinzugefügt wird, indem Sie die SHOW azure.extensions; Abfrage ausführen.

Installieren der Erweiterung

Stellen Sie eine Verbindung mit Ihrer Datenbank her, und führen Sie den CREATE EXTENSION Folgenden Befehl aus:

CREATE EXTENSION IF NOT EXISTS azure_ai;

Wiederholen Sie diesen Befehl für jede Datenbank, in der die Erweiterung erforderlich ist.

Bei der Installation azure_aiwerden die folgenden Schemas erstellt:

• azure_ai: Prinzipalschema für Konfigurations- und verwandte Funktionen
• azure_openai: Funktionen und Typen für Azure OpenAI in Foundry Models und OpenAI-Modellen in Microsoft Foundry-Modellen
• azure_cognitive: Funktionen und Typen für Azure Cognitive Services (Azure Sprache in Foundry Tools)
• azure_ml: Funktionen und Typen für Azure Machine Learning Services

Konfigurieren Sie die azure_ai Erweiterung

Um die Erweiterung zu konfigurieren, stellen Sie Endpunkte und Authentifizierungsdetails (API-Schlüssel oder verwaltete Identität) für die Azure AI + Machine Learning-Dienste bereit, die Sie verwenden möchten. Verwenden Sie die azure_ai.set_setting Konfigurationsfunktion mit verschiedenen Konfigurationsschlüsseln, um diese Werte zu speichern.

Erlaubnisse

Die Erweiterung definiert eine Rolle azure_ai_settings_manager, die Berechtigung zum Lesen und Schreiben von Konfigurationseinstellungen mithilfe der Funktionen azure_ai.set_getting und azure_ai.set_setting gewährt. Nur Superbenutzer und Mitglieder dieser Rolle können diese Funktionen aufrufen. In Azure Database for PostgreSQL Flexible Server gewährt die Rolle azure_pg_admin diese Rolle standardmäßig.

Konfigurationsfunktionen

azure_ai_set_setting

Legt die KONFIGURATION für KI + Maschinelles Lernen fest.

Syntax:

-- 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>');

Liste der unterstützten Konfigurationsschlüssel und -werte:

azure_ai.get_setting

Ruft die aktuellen Konfigurationswerte für einen bestimmten key Wert ab (siehe unterstützte Schlüssel in der obigen Liste). Gibt TEXT den aktuellen Wert der ausgewählten Einstellung zurück.

Syntax:

-- 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

Gibt die aktuelle Version der azure_ai Erweiterung als TEXT zurück.

Syntax:

SELECT azure_ai.version()

Aktivieren der verwalteten Identitätsauthentifizierung

Die erweiterung azure_ai für Azure Database for PostgreSQL unterstützt vom System zugewiesene verwaltete Identität (SAMI), die höhere Sicherheitsvorteile bietet. Mithilfe von Microsoft Entra ID können Sie sich ohne Zugriffstasten authentifizieren und das Risiko eines nicht autorisierten Zugriffs verringern und die Verwaltung von Anmeldeinformationen vereinfachen.

Informationen zum Aktivieren der verwalteten Identitätsauthentifizierung finden Sie in dieser Anleitung.

Funktionen der azure_ai Erweiterung

KI-Funktionen

Die erweiterung azure_ai ermöglicht In-Database-Aufrufe von Modellen, die in Foundry gehostet werden, und Azure OpenAI über die folgenden AI-Funktionen (Vorschau):

• Generieren Sie Vektoreinbettungen mit Azure OpenAI in Azure Database for PostgreSQL: Erstellt Vektoreinbettungen für einen bestimmten Eingabetext.
• azure_ai.generate(): Generiert Text oder strukturierte Ausgabe mit großen Sprachmodellen (LLMs).
• azure_ai.is_true(): Evaluiert die Wahrscheinlichkeit, dass eine bestimmte Aussage wahr ist.
• azure_ai.extract(): Extrahiert strukturierte Funktionen oder Entitäten aus Text.
• azure_ai.rank(): Ordnet eine Liste von Dokumenten neu, basierend auf der Relevanz für eine gegebene Anfrage.

Zusätzliche Funktionalitäten

Die Erweiterung unterstützt auch das Aufrufen von

• Azure-Datenbank für PostgreSQL mit Azure Cognitive Services integrieren: Ermöglicht es, Aufgaben wie die Durchführung von Stimmungsanalysen direkt innerhalb der Datenbank auszuführen.
• Integrieren Sie Azure Database for PostgreSQL mit Azure Machine Learning Services: Ermöglicht es Ihnen, Modelle aus dem Machine Learning Katalog oder benutzerdefinierten Bereitstellungen aufzurufen.

Upgrade der AI + Machine Learning-Erweiterung

Führen Sie Folgendes aus, um die installierte Version und die verfügbaren Upgrades zu überprüfen:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Führen Sie Folgendes aus, um die Erweiterung auf die neueste unterstützte Version zu aktualisieren:

ALTER EXTENSION azure_ai UPDATE;

Verwandte Inhalte

• KI-Funktionen in der azure_ai-Erweiterung (Vorschau)
• Generieren von Vektoreinbettungen mit Azure OpenAI in Azure Database for PostgreSQL
• Aktivieren und Verwenden von pgvector in Azure-Datenbank für PostgreSQL
• Lernprogramm: Erstellen einer semantischen Suche mit Azure Database für PostgreSQL und Azure OpenAI
• Integrieren der Azure-Datenbank für PostgreSQL in Azure Machine Learning Services