rozszerzenie azure_ai w programie Azure Database for PostgreSQL

Rozszerzenie azure_ai w Azure Database for PostgreSQL umożliwia korzystanie z dużych modeli językowych (LLMs) w bazie danych w celu tworzenia aplikacji generacyjnych sztucznej inteligencji. Pozwala bazie danych na wywoływanie Azure OpenAI w modelach Microsoft Foundry, Azure OpenAI Service, Azure Cognitive Services (Azure Language in Foundry Tools) i Azure Machine Learning Services, upraszczając programowanie dzięki bezproblemowej integracji z tymi usługami.

Włączanie rozszerzenia azure_ai

Aby można było użyć rozszerzenia azure_ai, należy dodać je do listy dozwolonych, a następnie zainstalować w wystąpieniu Azure Database for PostgreSQL. Wykonaj poniższe kroki, aby rozpocząć pracę.

Dodać rozszerzenie do listy dozwolonych

Dodaj azure_ai do listy dozwolonych serwera elastycznego Azure Database for PostgreSQL zgodnie z opisem w jak używać rozszerzeń PostgreSQL. Sprawdź, czy zostało ono poprawnie dodane, uruchamiając SHOW azure.extensions; zapytanie.

Instalowanie rozszerzenia

Połącz się z bazą CREATE EXTENSION danych i uruchom polecenie:

CREATE EXTENSION IF NOT EXISTS azure_ai;

Powtórz to polecenie dla każdej bazy danych, w której wymagane jest rozszerzenie.

Podczas instalacji azure_aiprogram tworzy następujące schematy:

  • azure_ai: główny schemat konfiguracji i powiązanych funkcji
  • azure_openai: funkcje i typy dla Azure OpenAI w modelach Foundry oraz w modelach OpenAI w Microsoft Foundry
  • azure_cognitive: funkcje i typy dla Azure Cognitive Services (Azure Language in Foundry Tools)
  • azure_ml: funkcje i typy dla usług Azure Machine Learning

Wskazówka

Możesz również włączyć Enable i użyć pgvector w Azure Database for PostgreSQL ponieważ jest często używany z azure_ai.

Uwaga / Notatka

Aby usunąć rozszerzenie z bieżącej bazy danych, uruchom polecenie DROP EXTENSION azure_ai;.

Konfigurowanie rozszerzenia azure_ai

Aby skonfigurować rozszerzenie, podaj punkty końcowe i szczegóły uwierzytelniania (klucz interfejsu API lub tożsamość zarządzana) dla usług Azure sztucznej inteligencji i uczenia maszynowego, których chcesz użyć. azure_ai.set_setting Użyj funkcji konfiguracji z różnymi kluczami konfiguracji, aby przechowywać te wartości.

Permissions

Rozszerzenie definiuje rolę azure_ai_settings_manager , która udziela uprawnień do odczytu i zapisu ustawień konfiguracji przy użyciu funkcji azure_ai.set_getting i azure_ai.set_setting. Tylko superużytkownicy i członkowie tej roli mogą wywoływać te funkcje. W Azure Database for PostgreSQL serwera elastycznego rola azure_pg_admin domyślnie przyznaje tę rolę.

Funkcje konfiguracji

azure_ai_set_setting

Ustawia konfigurację sztucznej inteligencji i uczenia maszynowego.

Usage:

-- 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 obsługiwanych kluczy konfiguracji i wartości:

key value
azure_openai.endpoint Obsługiwany interfejs API OpenAI (na przykład https://example.openai.azure.com).
azure_openai.auth_type subscription-key lub managed-identity
azure_openai.subscription_key Klucz subskrypcji dla zasobu OpenAI.
azure_cognitive.endpoint Obsługiwany punkt końcowy usług Cognitive Services (na przykład https://example.cognitiveservices.azure.com)
azure_cognitive.auth_type subscription-key lub managed-identity
azure_cognitive.subscription_key Klucz subskrypcji dla zasobu usług Cognitive Services.
azure_ml.scoring_endpoint Obsługiwany Machine Learning identyfikator URI punktu końcowego online.
azure_ml.auth_type subscription-key lub managed-identity
azure_ml.endpoint_key Klucz punktu końcowego dla punktu końcowego usługi Azure ML.

azure_ai.get_setting

Pobiera bieżące wartości konfiguracji dla danego key elementu (zobacz obsługiwane klucze na powyższej liście). Zwraca TEXT wartość reprezentującą bieżącą wartość wybranego ustawienia.

Usage:

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

Zwraca TEXT wartość reprezentującą bieżącą wersję azure_ai rozszerzenia.

Usage:

SELECT azure_ai.version()

Włącz uwierzytelnianie tożsamości zarządzanej

Rozszerzenie azure_ai dla Azure Database for PostgreSQL obsługuje tożsamość zarządzaną przypisaną przez system (SAMI), która oferuje zwiększone korzyści zabezpieczeń. Korzystając z Microsoft Entra ID, można uwierzytelniać się bez kluczy dostępu, zmniejszając ryzyko nieautoryzowanego dostępu i upraszczając zarządzanie poświadczeniami.

Aby włączyć uwierzytelnianie tożsamości zarządzanej, zobacz ten przewodnik z instrukcjami.

azure_ai Możliwości rozszerzenia

Funkcje sztucznej inteligencji

Rozszerzenie azure_ai umożliwia w bazie danych wywołania modeli hostowanych w Foundry i Azure OpenAI poprzez następujące funkcje AI (wersja zapoznawcza):

Dodatkowe możliwości

Rozszerzenie obsługuje również wywoływanie

Uaktualnianie rozszerzenia sztucznej inteligencji i uczenia maszynowego

Aby sprawdzić zainstalowaną wersję i dostępne uaktualnienia, uruchom polecenie:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Aby zaktualizować rozszerzenie do najnowszej obsługiwanej wersji, uruchom polecenie:

ALTER EXTENSION azure_ai UPDATE;

Treści powiązane

  • Last updated on