Расширение ИИ 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;