Freigeben über

Azure KI-Erweiterungen in Azure Database for PostgreSQL – Flexible Server

  • Artikel

GILT FÜR: Azure Database for PostgreSQL – Flexibler Server

Mit der Azure Database for PostgreSQL – Flexibler Server-Erweiterung für Azure KI können Sie umfangreiche Sprachmodelle (LLMS) verwenden und umfangreiche generative KI-Anwendungen innerhalb der Datenbank erstellen.  Die Azure KI-Erweiterung ermöglicht es der Datenbank, verschiedene Azure KI Services aufzurufen, einschließlich Azure OpenAI und Azure Cognitive Services, die den Entwicklungsprozess vereinfachen, um eine nahtlose Integration in diese Dienste zu ermöglichen.

Aktivieren der azure_ai Erweiterung:

Bevor Sie azure_ai auf Ihrer flexiblen Serverinstanz von Azure Database for PostgreSQL aktivieren können, müssen Sie den Dienst, wie in der Anleitung zur Verwendung von PostgreSQL-Erweiterungen beschrieben, Ihrer Positivliste hinzufügen und überprüfen, ob er korrekt hinzugefügt wurde, indem Sie SHOW azure.extensions; ausführen.

Tipp

Möglicherweise möchten Sie auch die pgvector Erweiterung aktivieren, da sie häufig mit azure_ai verwendet wird.

Anschließend können Sie die Erweiterung installieren, indem Sie eine Verbindung mit Ihrer Zieldatenbank herstellen und den Befehl CREATE EXTENSION ausführen. Sie müssen den Befehl separat für jede Datenbank wiederholen, in der die Erweiterung verfügbar sein soll.

CREATE EXTENSION azure_ai;

Hinweis

Um die Erweiterung aus der derzeit verbundenen Datenbank zu entfernen, verwenden Sie DROP EXTENSION azure_ai;.

Durch die Installation der Erweiterung azure_ai werden die folgenden drei Schemas erstellt:

  • azure_ai: Prinzipalschema, in dem sich die Konfigurationstabelle befindet, und Funktionen für die Interaktion mit der Tabelle.
  • azure_openai: Funktionen und zusammengesetzte Typen im Zusammenhang mit OpenAI.
  • azure_cognitive: Funktionen und zusammengesetzte Typen im Zusammenhang mit Cognitive Services.

Die Erweiterung ermöglicht auch das Aufrufen von Azure OpenAI und Azure Cognitive Services.

Konfigurieren der azure_ai Erweiterung:

Zum Konfigurieren der Erweiterung müssen Sie die Endpunkte bereitstellen, um eine Verbindung mit den Azure KI Services und den für die Authentifizierung erforderlichen API-Schlüsseln herzustellen. Diensteinstellungen werden mithilfe der folgenden Funktionen gespeichert:

Berechtigungen

Ihre Azure KI-Zugriffsschlüssel ähneln einem Stammkennwort für Ihr Konto. Achten Sie darauf, die Zugriffsschlüssel immer gut zu schützen. Verwenden Sie Azure Key Vault zum sicheren Verwalten und Rotieren Ihrer Schlüssel. Um Dienstschlüssel die von der Erweiterung verwendet werden, verwalten zu können, muss Benutzer*innen die Rolle azure_ai_settings_manager zugewiesen werden. Diese Rolle ist für die folgenden Funktionen erforderlich:

  • azure_ai.set_setting
  • azure_ai.get_setting

Die Rolle azure_ai_settings_manager wird standardmäßig der Rolle azure_pg_admin zugewiesen.

azure_ai.set_setting

Für das Festlegen von Konfigurationsoptionen.

azure_ai.set_setting(key TEXT, value TEXT)

Argumente

key

Der Name einer Konfigurationsoption. Gültige Werte für key sind die folgenden Werte:

  • azure_openai.endpoint: Unterstützter OpenAI-Endpunkt (z. B https://example.openai.azure.com. ).
  • azure_openai.subscription_key: Ein Abonnementschlüssel für eine OpenAI-Ressource.
  • azure_cognitive.endpoint: Unterstützter Cognitive Services-Endpunkt (z. B https://example.cognitiveservices.azure.com. ).
  • azure_cognitive.subscription_key: Ein Abonnementschlüssel für eine Cognitive Services-Ressource.
value

TEXT stellt den gewünschten Wert der ausgewählten Einstellung dar.

azure_ai.get_setting

Wird verwendet, um aktuelle Werte von Konfigurationsoptionen abzurufen.

azure_ai.get_setting(key TEXT)

Argumente

Schlüssel

Der Name einer Konfigurationsoption. Gültige Werte für key sind die folgenden Werte:

  • azure_openai.endpoint: Unterstützter OpenAI-Endpunkt (z. B https://example.openai.azure.com. ).
  • azure_openai.subscription_key: Ein Abonnementschlüssel für eine OpenAI-Ressource.
  • azure_cognitive.endpoint: Unterstützter Cognitive Services-Endpunkt (z. B https://example.cognitiveservices.azure.com. ).
  • azure_cognitive.subscription_key: Ein Abonnementschlüssel für eine Cognitive Services-Ressource.

Rückgabetyp

TEXT stellt den aktuellen Wert der ausgewählten Einstellung dar.

azure_ai.version

azure_ai.version()

Rückgabetyp

TEXT stellt die aktuelle Version der Azure KI-Erweiterung dar.

Beispiele

Festlegen des Endpunkts und eines API-Schlüssels 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>');

Abrufen des Endpunkts und des API-Schlüssels für Azure OpenAI

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

Überprüfen der Azure KI-Erweiterungsversion

select azure_ai.version();

Berechtigungen

Die azure_ai Erweiterung definiert eine Rolle namens azure_ai_settings_manager, die das Lesen und Schreiben von Einstellungen im Zusammenhang mit der Erweiterung ermöglicht. Nur Superuser und Mitglieder der azure_ai_settings_manager Rolle können die Funktionen azure_ai.get_settings und azure_ai.set_settings aufrufen. In Azure Database for PostgreSQL – Flexibler Server wird allen Administratorbenutzer*innen die Rolle azure_ai_settings_manager zugewiesen.

Upgrade der Azure KI-Erweiterung

Neuere Versionen der Erweiterung können neue Funktionen einführen und direkte Upgrades der Erweiterung sind zulässig. Sie können die aktuell installierte Version mit der neuesten Version vergleichen, indem Sie den SQL-Befehl verwenden:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Verwenden Sie den folgenden SQL-Befehl, um eine installierte Erweiterung auf die neueste verfügbare Version zu aktualisieren, die von Azure unterstützt wird:

ALTER EXTENSION azure_ai UPDATE;

Nächste Schritte

Generieren von Vektoreinbettungen mit Azure OpenAI