Поделиться через

Расширение ИИ Azure в База данных Azure для PostgreSQL — гибкий сервер

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: База данных Azure для PostgreSQL — гибкий сервер

База данных Azure для PostgreSQL гибкое расширение сервера для ИИ Azure позволяет использовать большие языковые модели (LLMS) и создавать в базе данных широкие возможности создания приложений искусственного интеллекта.  Расширение ИИ Azure позволяет базе данных вызывать различные службы ИИ Azure, включая Azure OpenAI и Azure Cognitive Services , упрощая процесс разработки, позволяя легко интегрировать эти службы.

Включение расширения azure_ai

Прежде чем включить azure_ai на База данных Azure для PostgreSQL гибкий экземпляр сервера, необходимо добавить его в список разрешений, как описано в том, как использовать расширения PostgreSQL и проверить, правильно ли добавлено путем выполнения.SHOW azure.extensions;

Совет

Также может потребоваться включить pgvector расширение, так как оно обычно используется.azure_ai

Затем можно установить расширение, подключився к целевой базе данных и выполнив команду CREATE EXTENSION . Необходимо повторить команду отдельно для каждой базы данных, в которой должно быть доступно расширение.

CREATE EXTENSION azure_ai;

Примечание.

Удаление расширения из текущей подключенной базы данных DROP EXTENSION azure_ai;.

Установка расширения azure_ai создает следующие три схемы:

  • azure_ai: схема субъекта, в которой находится таблица конфигурации и функции для взаимодействия с ним.
  • azure_openai: функции и составные типы, связанные с OpenAI.
  • azure_cognitive: функции и составные типы, связанные с Cognitive Services.

Расширение также позволяет вызывать Azure OpenAI и Azure Cognitive Services.

Настройка расширения azure_ai

При настройке расширения необходимо предоставить конечные точки для подключения к службам ИИ Azure и ключам API, необходимым для проверки подлинности. Параметры службы хранятся с помощью следующих функций:

Разрешения

Ключи доступа к искусственному интеллекту Azure похожи на корневой пароль для учетной записи. Не забудьте защитить ключи доступа. Для безопасного управления ключами и их замены воспользуйтесь Azure Key Vault. Для управления ключами службы, используемыми расширением, пользователям требуется azure_ai_settings_manager роль, предоставленная им. Для следующих функций требуется роль:

  • azure_ai.set_setting
  • azure_ai.get_setting

Роль azure_ai_settings_manager по умолчанию предоставляется azure_pg_admin роли.

azure_ai.set_setting

Используется для задания параметров конфигурации.

azure_ai.set_setting(key TEXT, value TEXT)

Аргументы

key

Имя параметра конфигурации. Допустимые значения для следующих значений key :

  • azure_openai.endpoint: поддерживаемая конечная точка OpenAI (например, https://example.openai.azure.com).
  • azure_openai.subscription_key: ключ подписки для ресурса OpenAI.
  • azure_cognitive.endpoint: поддерживаемая конечная точка Cognitive Services (например, https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: ключ подписки для ресурса Cognitive Services.
value

TEXT представляет требуемое значение выбранного параметра.

azure_ai.get_setting

Используется для получения текущих значений параметров конфигурации.

azure_ai.get_setting(key TEXT)

Аргументы

Ключ

Имя параметра конфигурации. Допустимые значения для следующих значений key :

  • azure_openai.endpoint: поддерживаемая конечная точка OpenAI (например, https://example.openai.azure.com).
  • azure_openai.subscription_key: ключ подписки для ресурса OpenAI.
  • azure_cognitive.endpoint: поддерживаемая конечная точка Cognitive Services (например, https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: ключ подписки для ресурса Cognitive Services.

Возвращаемый тип

TEXT представляет текущее значение выбранного параметра.

azure_ai.version

azure_ai.version()

Возвращаемый тип

TEXT представляет текущую версию расширения ИИ Azure.

Примеры

Настройка конечной точки и ключа API для 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>');

Получение ключа конечной точки и API для Azure OpenAI

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

Проверка версии расширения ИИ Azure

select azure_ai.version();

Разрешения

Расширение azure_ai определяет роль с именем azure_ai_settings_manager, которая позволяет читать и записывать параметры, связанные с расширением. Только суперпользователи и члены azure_ai_settings_manager роли могут вызывать azure_ai.get_settings и azure_ai.set_settings функции. На гибком сервере База данных Azure для PostgreSQL всем azure_ai_settings_manager пользователям администратора назначена роль.

Обновление расширения ИИ Azure

Более новые версии расширения могут ввести новые функциональные возможности и обновления на месте расширения разрешены. Вы можете сравнить текущую установленную версию с самой новой версией, разрешенной с помощью команды SQL:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Чтобы обновить установленное расширение до последней доступной версии, поддерживаемой Azure, используйте следующую команду SQL:

ALTER EXTENSION azure_ai UPDATE;

Связанный контент