Partager via

Extension Azure AI dans Azure Database pour PostgreSQL

L’extension Azure Database pour PostgreSQL pour Azure AI vous permet d’utiliser des modèles de langage volumineux (LLMS) et de créer des applications IA génératives enrichies au sein de la base de données.  L’extension Azure AI permet à la base de données d’appeler différents services Azure AI, notamment Azure OpenAI et Azure Cognitive Services, ce qui simplifie le processus de développement et permet une intégration transparente dans ces services.

Activer l’extension azure_ai

Avant de pouvoir activer azure_ai sur votre instance de serveur flexible Azure Database pour PostgreSQL, vous devez l’ajouter à votre liste d’autorisation comme décrit dans le Guide pratique pour utiliser des extensions PostgreSQL, et vérifier qu’elle est correctement ajoutée en exécutant SHOW azure.extensions;.

Conseil

Vous pouvez également activer l’extension pgvector, car elle est couramment utilisée avec azure_ai.

Vous pouvez ensuite installer l’extension en vous connectant à votre base de données cible et en exécutant la commande CREATE EXTENSION. Vous devez répéter la commande séparément pour chaque base de données dans laquelle vous souhaitez que l’extension soit disponible.

CREATE EXTENSION IF NOT EXISTS azure_ai;

Remarque

Pour supprimer l’extension de la base de données actuellement connectée, utilisez DROP EXTENSION azure_ai;.

L’installation de l’extension azure_ai crée les trois schémas suivants :

  • azure_ai : schéma principal où réside la table de configuration et les fonctions pour interagir avec elle.
  • azure_openai : fonctions et types composites liés à OpenAI.
  • azure_cognitive : fonctions et types composites liés à Cognitive Services.

L’extension permet également d’appeler Azure OpenAI et Azure Cognitive Services.

Configurer l’extension azure_ai

La configuration de l’extension vous oblige à fournir les points de terminaison pour vous connecter aux services Azure AI et aux clés API requises pour l’authentification. Les paramètres de service sont stockés à l’aide des fonctions suivantes :

Autorisations

Vos clés d’accès Azure AI sont similaires au mot de passe racine de votre compte. Veillez toujours à protéger vos clés d’accès. Utilisez Azure Key Vault pour gérer et effectuer la rotation de vos clés en toute sécurité. Pour gérer les clés de service utilisées par l’extension, les utilisateurs doivent disposer du rôle azure_ai_settings_manager. Les fonctions suivantes nécessitent le rôle :

  • azure_ai.set_setting
  • azure_ai.get_setting

Le rôle azure_ai_settings_manager est accordé par défaut au rôle azure_pg_admin.

azure_ai.set_setting

Utilisé pour définir les options de configuration.

azure_ai.set_setting(key TEXT, value TEXT)

Les arguments

key

Nom d’une option de configuration. Les valeurs valides pour key sont les suivantes :

  • azure_openai.endpoint : point de terminaison OpenAI pris en charge (par exemple, https://example.openai.azure.com).
  • azure_openai.subscription_key : une clé d’abonnement pour une ressource OpenAI.
  • azure_cognitive.endpoint : point de terminaison Cognitive Services pris en charge (par exemple, https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key : une clé d’abonnement pour une ressource Cognitive Services.
value

TEXT représentant la valeur souhaitée du paramètre sélectionné.

azure_ai.get_setting

Permet d’obtenir les valeurs actuelles des options de configuration.

azure_ai.get_setting(key TEXT)

Les arguments

Clé

Nom d’une option de configuration. Les valeurs valides pour key sont les suivantes :

  • azure_openai.endpoint : point de terminaison OpenAI pris en charge (par exemple, https://example.openai.azure.com).
  • azure_openai.subscription_key : une clé d’abonnement pour une ressource OpenAI.
  • azure_cognitive.endpoint : point de terminaison Cognitive Services pris en charge (par exemple, https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key : une clé d’abonnement pour une ressource Cognitive Services.

Type de retour

TEXT représentant la valeur actuelle du paramètre sélectionné.

azure_ai.version

azure_ai.version()

Type de retour

TEXT représentant la version actuelle de l’extension Azure AI.

Exemples

Définir le point de terminaison et une clé API pour 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>');

Obtenir le point de terminaison et la clé API pour Azure OpenAI

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

Vérifier la version de l’extension Azure AI

select azure_ai.version();

Autorisations

L’extension azure_ai définit un rôle appelé azure_ai_settings_manager, qui permet de lire et d’écrire les paramètres liés à l’extension. Seuls les superutilisateurs et les membres du rôle azure_ai_settings_manager peuvent appeler les fonctions azure_ai.get_settings et azure_ai.set_settings. Dans les instances de serveur flexible Azure Database pour PostgreSQL, tous les utilisateurs administrateurs ont le azure_ai_settings_manager rôle attribué.

Mise à niveau de l’extension Azure AI

Les versions plus récentes de l’extension peuvent introduire de nouvelles fonctionnalités et des mises à niveau sur place de l’extension sont autorisées. Vous pouvez comparer la version actuellement installée à la plus récente version autorisée à l’aide de la commande SQL :

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Pour mettre à jour une extension installée vers la dernière version disponible prise en charge par Azure, utilisez la commande SQL suivante :

ALTER EXTENSION azure_ai UPDATE;

Contenu connexe

  • Last updated on