Udostępnij za pomocą

Rozszerzenie azure AI w usłudze Azure Database for PostgreSQL

Rozszerzenie usługi Azure Database for PostgreSQL dla usługi Azure AI umożliwia korzystanie z dużych modeli językowych (LLMS) i tworzenie zaawansowanych aplikacji generacyjnych sztucznej inteligencji w bazie danych.  Rozszerzenie azure AI umożliwia bazie danych wywoływanie różnych usług sztucznej inteligencji platformy Azure, w tym usług Azure OpenAI i Azure Cognitive Services , upraszczając proces programowania umożliwiający bezproblemową integrację z tymi usługami.

Włączanie rozszerzenia azure_ai

Przed włączeniem azure_ai w wystąpieniu serwera elastycznego usługi Azure Database for PostgreSQL, należy dodać go do listy dozwolonych zgodnie z opisem w temacie jak używać rozszerzeń PostgreSQL i sprawdzić, czy dodano je poprawnie, uruchamiając SHOW azure.extensions;.

Wskazówka

Możesz również włączyć pgvector rozszerzenie, ponieważ jest ono często używane z azure_ai.

Następnie możesz zainstalować rozszerzenie, łącząc się z docelową bazą danych i uruchamiając polecenie CREATE EXTENSION . Należy powtórzyć polecenie oddzielnie dla każdej bazy danych, w której ma być dostępne rozszerzenie.

CREATE EXTENSION IF NOT EXISTS azure_ai;

Uwaga / Notatka

Aby usunąć rozszerzenie z aktualnie połączonej bazy danych, użyj polecenia DROP EXTENSION azure_ai;.

Zainstalowanie rozszerzenia azure_ai powoduje utworzenie następujących trzech schematów:

  • azure_ai: główny schemat, w którym znajduje się tabela konfiguracji i funkcje do interakcji z nią.
  • azure_openai: funkcje i typy złożone związane z OpenAI.
  • azure_cognitive: funkcje i typy złożone związane z usługami Cognitive Services.

Rozszerzenie umożliwia również wywoływanie usług Azure OpenAI i Azure Cognitive Services.

Konfigurowanie rozszerzenia azure_ai

Skonfigurowanie rozszerzenia wymaga podania punktów końcowych w celu nawiązania połączenia z usługami azure AI i kluczami interfejsu API wymaganymi do uwierzytelniania. Ustawienia usługi są przechowywane przy użyciu następujących funkcji:

Uprawnienia

Klucze dostępu do sztucznej inteligencji platformy Azure są podobne do hasła głównego dla twojego konta. Zawsze należy zachować ostrożność, aby chronić klucze dostępu. Usługa Azure Key Vault umożliwia bezpieczne zarządzanie kluczami i obracanie ich. Aby zarządzać kluczami usług używanymi przez rozszerzenie, użytkownicy muszą mieć przypisaną rolę azure_ai_settings_manager. Następujące funkcje wymagają roli:

  • azure_ai.set_setting
  • azure_ai.get_setting

Rola azure_ai_settings_manager jest domyślnie przyznawana azure_pg_admin roli.

azure_ai.set_setting

Służy do ustawiania opcji konfiguracji.

azure_ai.set_setting(key TEXT, value TEXT)

Argumenty (w programowaniu)

key

Nazwa opcji konfiguracji. Prawidłowe wartości dla elementu key to:

  • azure_openai.endpoint: Obsługiwany punkt końcowy OpenAI (na przykład https://example.openai.azure.com).
  • 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.subscription_key: klucz subskrypcji zasobu usług Cognitive Services.
value

TEXT reprezentująca żądaną wartość wybranego ustawienia.

azure_ai.get_setting

Służy do uzyskiwania bieżących wartości opcji konfiguracji.

azure_ai.get_setting(key TEXT)

Argumenty (w programowaniu)

Klawisz

Nazwa opcji konfiguracji. Prawidłowe wartości dla elementu key to:

  • azure_openai.endpoint: Obsługiwany punkt końcowy OpenAI (na przykład https://example.openai.azure.com).
  • 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.subscription_key: klucz subskrypcji zasobu usług Cognitive Services.

Typ zwracany

TEXT reprezentująca bieżącą wartość wybranego ustawienia.

azure_ai.version

azure_ai.version()

Typ zwracany

TEXT reprezentująca bieżącą wersję rozszerzenia usługi Azure AI.

Przykłady

Ustawianie punktu końcowego i klucza interfejsu API dla usługi 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>');

Uzyskiwanie klucza punktu końcowego i interfejsu API dla usługi Azure OpenAI

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

Sprawdzanie wersji rozszerzenia azure AI

select azure_ai.version();

Uprawnienia

azure_ai Rozszerzenie definiuje rolę o nazwie azure_ai_settings_manager, która umożliwia odczytywanie i zapisywanie ustawień związanych z rozszerzeniem. Tylko superużytkownicy i członkowie roli azure_ai_settings_manager mogą wywoływać funkcje azure_ai.get_settings i azure_ai.set_settings. W przypadku instancji serwera elastycznego usługi Azure Database for PostgreSQL wszyscy użytkownicy administracyjni mają przypisaną azure_ai_settings_manager rolę.

Uaktualnianie rozszerzenia azure AI

Nowsze wersje rozszerzenia mogą wprowadzać nowe funkcje, a bezpośrednie aktualizacje rozszerzenia są dozwolone. Obecnie zainstalowaną wersję można porównać z najnowszą dozwoloną wersją za pomocą polecenia SQL:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Aby zaktualizować zainstalowane rozszerzenie do najnowszej dostępnej wersji obsługiwanej przez platformę Azure, użyj następującego polecenia SQL:

ALTER EXTENSION azure_ai UPDATE;

Treści powiązane

  • Last updated on