Udostępnij za pośrednictwem

Rozszerzenie azure AI w usłudze Azure Database for PostgreSQL — serwer elastyczny

  • Artykuł

DOTYCZY: Azure Database for PostgreSQL — serwer elastyczny

Elastyczne rozszerzenie serwera 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 generujących sztuczną inteligencję 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.

azure_ai Włączanie rozszerzenia

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 how to use PostgreSQL extensions (Jak używać rozszerzeń PostgreSQL) i sprawdzić, czy dodano je poprawnie, uruchamiając polecenie SHOW azure.extensions;.

Napiwek

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

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

Uwaga

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: schemat podmiotu zabezpieczeń, w którym znajduje się tabela konfiguracji i funkcje do interakcji z nią.
  • azure_openai: funkcje i typy złożone związane z interfejsem 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.

azure_ai Konfigurowanie rozszerzenia

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 wymagają azure_ai_settings_manager nadane im roli. 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

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

Klucz

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 azure_ai_settings_manager roli mogą wywoływać azure_ai.get_settings funkcje i azure_ai.set_settings . Na serwerze elastycznym 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 i uaktualnienia w miejscu 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;

Następne kroki

Generowanie osadzania wektorów za pomocą usługi Azure OpenAI