Partager via

Configurer l’extension Stockage Azure dans Azure Database pour PostgreSQL

Vous devez suivre ces étapes pour pouvoir utiliser l’extension Stockage Azure :

  1. Identifier les comptes de stockage Azure
  2. Choisir le type d’autorisation
  3. Charger la bibliothèque de l’extension
  4. Liste verte de l’extension
  5. Créer l’extension
  6. Utiliser l’extension pour importer et exporter des données

Identifier les comptes de stockage Azure

Identifiez les comptes de stockage Azure vers lesquels vous souhaitez que les utilisateurs de l’extension interagissent, importent des données à partir ou exportent des données.

Choisir le type d’autorisation

Déterminez le type d’autorisation que vous souhaitez utiliser pour les demandes effectuées sur le service blob de chacun de ces comptes de stockage Azure. azure_storage l’extension prend en charge l’autorisation avec la clé partagée et l’autorisation avec l’ID Microsoft Entra.

Parmi ces deux types d’autorisation, Microsoft Entra ID offre une sécurité et une facilité d’utilisation supérieures sur la clé partagée, et est celui que Microsoft recommande.

Pour répondre aux conditions préalables requises dans chaque cas, suivez les instructions des sections correspondantes :

Pour utiliser l’autorisation avec l’ID Microsoft Entra

  1. Activez l’identité managée affectée par le système sur votre instance de serveur flexible Azure Database pour PostgreSQL.
  2. Redémarrez l’instance du serveur flexible Azure Database pour PostgreSQL, après avoir activé une identité managée affectée par le système.
  3. Attribuez des autorisations de contrôle d’accès en fonction du rôle (RBAC) pour l’accès aux données blob, sur le compte stockage Azure, à l’identité managée affectée par le système de votre instance de serveur flexible Azure Database pour PostgreSQL.

Activer l’identité managée affectée par le système

Capture d’écran de l’activation de l’identité managée affectée par le système.

Pour utiliser l’autorisation avec la clé partagée

  1. Vérifiez que le compte de stockage autorise l’accès à sa clé
  2. Récupérer l’une des deux clés d’accès du compte de stockage

Vérifiez que le compte de stockage autorise l’accès à sa clé

Votre compte stockage Azure doit avoir activé l’accès à la clé du compte de stockage (autrement dit, sa propriété AllowSharedKeyAccess n’est pas définie sur false).

Capture d’écran montrant que l’autorisation d’accès à la clé de compte de stockage est activée.

Récupérer l’une des deux clés d’accès du compte de stockage

Pour le transmettre à la fonction azure_storage.account_add , récupérez l’une des deux clés d’accès du compte stockage Azure.

Capture d’écran de la copie de la clé d’accès du compte de stockage.

Charger la bibliothèque de l’extension

Configurez votre serveur pour qu’il charge le azure_storage module binaire au démarrage.

Capture d’écran de la sélection de azure_storage dans shared_preload_libraries dans les paramètres du serveur. Étant donné que le shared_preload_libraries serveur est statique, le serveur doit être redémarré pour qu’une modification prenne effet : capture d’écran de la boîte de dialogue qui s’affiche lors de la modification de shared_preload_libraries, pour enregistrer et redémarrer.

Liste verte de l’extension

Vous devez autoriser l’extension afin que les utilisateurs puissent exécuter CREATE EXTENSION, DROP EXTENSION, ALTER EXTENSION, COMMENT ON EXTENSION.

Capture d’écran de la sélection de azure_storage dans azure.extensions dans les paramètres du serveur.

Créer l’extension

Utilisez le client de votre préférence, comme PostgreSQL pour Visual Studio Code (préversion),psql ou PgAdmin, pour vous connecter à la base de données dans laquelle vous souhaitez utiliser l’extension Stockage Azure.

Pour créer tous les objets SQL (tables, types, fonctions, vues, etc.) avec lesquels vous pouvez utiliser l’extension azure_storage pour interagir avec des instances de comptes de stockage Azure, exécutez l’instruction suivante :

CREATE EXTENSION azure_storage;

Utiliser l’extension pour importer et exporter des données

Vous êtes maintenant prêt à ajouter les comptes de stockage avec lesquels vous souhaitez interagir (à l’aide de la azure_storage.account_add fonction). Vous pouvez ensuite importer des données stockées dans des fichiers dans des comptes de stockage Azure, à l’aide de la azure_storage.blob_get fonction ou de l’instruction COPY FROM , ou vous pouvez exporter des données de PostgreSQL dans des fichiers dans un compte de stockage Azure, à l’aide de la azure_storage.blob_put fonction ou de l’instruction COPY TO .

Consultez la liste des exemples de démarrage rapide :

Si vous devez passer en revue toutes les fonctions proposées par l’extension et tous les détails relatifs à chacun d’eux, passez en revue la référence complète :

Et, si vous devez effectuer une résolution des problèmes, passez en revue la liste des erreurs que l’extension peut produire et le contexte dans lequel ils peuvent être déclenchés.

Important

Pour les types d’authentification pour lesquels vous devez fournir une clé d’accès de compte de stockage Azure, notez que vos clés d’accès stockage Azure sont similaires à un mot de passe racine pour votre compte de stockage. Veillez toujours à les protéger. Utilisez Azure Key Vault pour gérer et effectuer la rotation de vos clés en toute sécurité. azure_storage l’extension stocke ces clés dans une table azure_storage.accounts, qui est lisible par les membres du pg_read_all_data rôle.

Contenu connexe

  • Last updated on