MongoDB (préversion)

MongoDB est une plateforme de données de document à usage général, distribuée et distribuée, qui est aimée par les développeurs et utilisée par les entreprises pour exécuter diverses charges de travail. Vous pouvez maintenant explorer les différents points de terminaison et effectuer des opérations CRUD et des agrégations sur votre collection à l’aide du connecteur MongoDB.

Ce connecteur est disponible dans les produits et régions suivants :

MongoDB Connector fournit un moyen simple de se connecter à MongoDB Atlas via des API de données hébergées à l’aide de la fonction Azure dans votre locataire pour lire et écrire des données dans des collections MongoDB Atlas. Le connecteur MongoDB facilite l’exécution d’opérations cruD et d’agrégations sur vos données en quelques minutes et vous permet d’interroger MongoDB pour créer des applications et des flux de travail enrichis dans Power Apps, Power Automate et Logic Apps.

*** Notez que MongoDB a déprécié les API De données Atlas à partir de septembre 2025 et utilise donc cette approche de connecteur pour configurer une fonction Azure et utiliser ses clés URL et API au lieu de celles d’Atlas dans vos applications et flux. ***

Prerequisites

1. Configurer l’environnement Atlas

Inscrivez-vous à un nouveau compte Atlas ici. Suivez les étapes de 1 à 4 (Créer un compte Atlas, déployer un cluster gratuit, ajouter votre adresse IP à la liste d’accès IP et créer un utilisateur de base de données) pour configurer l’environnement Atlas.

2. Configurer la fonction Azure en tant qu’API Atlas Data Pour configurer la fonction Azure qui hébergera le code pour agir en tant qu’API Atlas Data, nous avons deux options : 1. Utilisation de GitHub Actions OR 2. Utilisation de Zip Deploy

   Choisissez la méthode d’actions GitHub, si vous êtes en mesure de dépliquer le dépôt actuel, pouvez activer les actions GitHub dans ce référentiel et que vous souhaitez ajouter d’autres API et préférer une configuration CI/CD ou DevOps prête à l’emploi. Toutefois, si vous recherchez un moyen rapide et simple de déploiement et que vous avez simplement besoin de la configuration de la fonction Azure pour remplacer les API Atlas Data, accédez à l’option De déploiement Zip.

   Option 1 : Configurer la fonction Azure à l’aide d’actions GitHub

   a.Fork le dépôt MongoDB. Notez la nouvelle URL du dépôt dupliqué. Si les actions GitHub ne sont pas activées par défaut, activez-les en accédant aux paramètres -> Actions -> Général dans votre référentiel dupliqué, puis sélectionnez l’une des options Autoriser les actions/flux de travail réutilisables.

   b.Cliquez sur le bouton Déployer sur Azure ci-dessous pour que la fonction Azure soit créée dans votre locataire.

   

   c. Sélectionnez ou créez votre groupe de ressources qui contiendra la fonction Azure et ses composants associés (Plan App Service, Compte de stockage et App Insights). Vous pouvez conserver le nom de la fonction et la référence SKU comme valeurs par défaut ou modifier si vous souhaitez respecter certaines normes spécifiques. Nous vous recommandons d’ajouter votre nom de cluster au nom de l’application de fonction afin qu’il soit unique et facile à identifier.

   Donnez l’URL de connexion MongoDB pour le cluster sur lequel cette fonction Azure s’exécutera. Cette chaîne de connexion est enregistrée sous la forme d’une variable Environmnet. Donnez votre URL de dépôt forked en tant que dépôt GitHub. Sélectionnez Créer et créez la fonction Azure avec les ressources associées. Notez qu’à ce stade, l’application de fonction est créée, les variables env sont remplies, mais la fonction réelle n’est pas encore déployée sur l’application de fonction.

   d. Pour exécuter des actions GitHub à partir de votre dépôt et déployer la fonction, obtenez le profil de publication à partir de votre fonction Azure créée.

   Il est téléchargé, l’ouvre dans un éditeur de texte et copie tout son contenu.

   

   e. Accédez à votre dépôt GitHub -> Paramètres -> Secrets et variables -> Actions Cliquez sur Nouveau secret de respository et copiez la valeur entière dans votre profil de publication dans un nouveau secret nommé « AZUREAPPSERVICE_PUBLISHPROFILE »

   f. Apportez une modification mineure dans README et Commit Changes pour appeler des actions GitHub qui déploieraient le code Python sur la fonction Azure dans votre application de fonction. Vous devez maintenant voir la fonction disponible dans l’application Functon et le code dans function_app.py déployé.

   g. L’onglet Actions GitHub dans le dépôt GitHub affiche les étapes du déploiement (y compris l’installation des dépendances) et le résultat de chaque étape.

   Option 2 : Configurer la fonction Azure à l’aide de ZipDeploy

   a. Cliquez sur le bouton Déployer sur Azure ci-dessous pour que la fonction Azure soit créée dans votre locataire.

   

   b. Sélectionnez ou créez votre groupe de ressources qui contiendra la fonction Azure et ses composants associés (Plan App Service, Compte de stockage et App Insights). Vous pouvez conserver le nom de la fonction et la référence SKU comme valeurs par défaut ou modifier si vous souhaitez respecter certaines normes spécifiques. Nous avons recommmenté que vous ajoutez votre nom de cluster au nom de l’application de fonction afin qu’il soit unique et facile à identifier.

   Veuillez modifier ** DONOT ** le packageUrl, car il s’agit de l’URL SAP du compte de stockage qui a le zip qui doit être déployé. Sélectionnez Créer et créez l’application de fonction Azure, déployez la fonction Azure avec les ressources associées.

Comment obtenir des informations d’identification

Obtenir la clé API et BaseUrl

a. Dans l’application de fonction, sélectionnez votre fonction, puis cliquez sur Obtenir l’URL de la fonction . Copiez l’URL de la fonction depuis le début jusqu’à l’avant « /action », comme illustré dans la capture d’écran ci-dessous. Il s’agit de l’URL de base que vous allez utiliser pour appeler l’une des API CRUD/Aggregate MongoDB.

b. Accédez à votre application de fonction -> Sous Fonctions -> Clés d’application , récupérez la clé API _master ou la clé API par défaut pour votre fonction Azure. Il s’agit de la clé API que vous utiliserez avec l’URL de base pour créer une connexion MongoDB pour appeler l’une des API CRUD/Aggregate MongoDB.

Bien démarrer avec votre connecteur

1. Une fois les prérequis terminés, accédez à PowerAutomate -> Connexions. Cliquez sur « Nouvelle connexion » et recherchez MongoDB dans la barre de recherche en haut à droite, comme indiqué ci-dessous dans la capture d’écran.

2. Cliquez sur la connexion MongoDB et vous verrez la fenêtre contextuelle ci-dessous qui vous demande d’entrer la clé API et l’URL de base.

3. Pour les champs « URL de base » et « Clé API », entrez les valeurs récupérées dans la section Comment obtenir les informations d’identification ci-dessus

Utilisez l’une des 8 API de données pour toutes les opérations CRUD sur votre cluster Atlas MongoDB. Pour les requêtes complexes, utilisez l’API « Exécuter un pipeline d’agrégation » pour utiliser des étapes d’agrégation pour masser la sortie d’une étape à une autre. La flexibilité et le dynamisme de MongoDB vous permettent de créer des applications enrichies et d’automatiser les processus fastidieux. Vous continuez à améliorer les applications en ajoutant d’autres fonctionnalités et champs au même regroupement.

Problèmes connus et limitations

Comme MongoDB n’applique pas de schéma, le connecteur actuel peut être utilisé uniquement avec Power Automate et Logic Apps, qui prend en charge le schéma dynamique pour la réponse de l’API, qui peut ensuite être analysé à l’aide des constructions « Parse JSON ». Il peut être utilisé dans Power Apps en appelant un flux Power Automate pour chaque interaction MongoDB. Vous pouvez également continuer à utiliser le connecteur MongoDB certifié à partir du référentiel Microsoft Github en tant que connecteur personnalisé pour l’utiliser directement dans Power Apps pour personnaliser le schéma Response en fonction de votre schéma de collection MongoDB.

Les restrictions applicables aux opérations de données MongoDB s’appliquent également au connecteur MongoDB. Reportez-vous à ce lien pour en savoir plus sur les étapes d’agrégation qui ne sont pas prises en charge dans le contexte utilisateur des API de données.

Suivez ce lien pour connaître les limitations connues avec les fonctions Azure, telles que les délais d’attente et d’autres limites de service pour chaque plan de ressources.

Erreurs courantes et solutions

Les codes de réponse d’API classiques s’appliquent également ici. Toutes les erreurs 4XX indiquent un problème avec la requête du client. Assurez-vous que dataSource, base de données, collection sont fournies dans un format JSON valide. Reportez-vous à cette collection Postman pour obtenir des exemples. Pour les erreurs 5XX, vérifiez que la fonction Azure est opérationnelle et vérifiez sa trace pour approfondir l’examen.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Limitations

Actions

Exécuter le pipeline d’agrégation

Insérer plusieurs documents

Insérer un document

Mettre à jour le document

Mettre à jour plusieurs documents

Rechercher plusieurs documents

Rechercher un document

Supprimer de nombreux documents

Supprimer un document