Se connecter à MongoDB et le gérer dans Microsoft Purview

Cet article explique comment inscrire MongoDB et comment s’authentifier et interagir avec MongoDB dans Microsoft Purview. Pour plus d’informations sur Microsoft Purview, consultez l’article d’introduction.

Fonctionnalités prises en charge

Extraction de métadonnées	Analyse complète	Analyse incrémentielle	Analyse délimitée	Classification	Étiquetage	Stratégie d’accès	Traçabilité	Partage de données	Affichage en direct
Oui	Oui	Non	Oui	Non	Non	Non	Non	Non	Non

Les versions de MongoDB prises en charge sont 3.6 à 7.0. Vous pouvez également utiliser ce connecteur pour analyser MongoDB Atlas.

Lors de l’analyse de la source MongoDB, Microsoft Purview prend en charge l’extraction de métadonnées techniques, notamment :

• Serveur
• Bases de données
• Collections incluant le schéma
• Affichages, y compris le schéma

Pendant l’analyse, Microsoft Purview récupère et analyse des exemples de documents pour déduire le schéma de collection/vue. La taille de l’exemple est configurable.

Lors de la configuration de l’analyse, vous pouvez choisir d’analyser entièrement une ou plusieurs bases de données MongoDB, ou d’étendre l’analyse à un sous-ensemble de collections correspondant au(s) nom(s) donné(s) ou modèle(s) de nom.

Limitations connues

Lorsque l’objet est supprimé de la source de données, l’analyse suivante ne supprime pas automatiquement la ressource correspondante dans Microsoft Purview.

Configuration requise

• Un compte Azure avec un abonnement actif. Créez un compte gratuitement.

• Un compte Microsoft Purview actif.

• Vous avez besoin des autorisations Administrateur de source de données et Lecteur de données pour inscrire une source et la gérer dans le portail de gouvernance Microsoft Purview. Pour plus d’informations sur les autorisations, consultez Contrôle d’accès dans Microsoft Purview.

• Si votre source de données n’est pas accessible publiquement, configurez le dernier runtime d’intégration auto-hébergé.

  • Choisissez le runtime d’intégration approprié pour votre scénario :
    • Pour utiliser un runtime d’intégration auto-hébergé :
      • Suivez l’article pour créer et configurer un runtime d’intégration auto-hébergé.
      • Vérifiez que JDK 11 est installé sur l’ordinateur sur lequel le runtime d’intégration auto-hébergé est installé. Redémarrez la machine après avoir installé le JDK pour qu’il prenne effet.
      • Vérifiez que Visual C++ Redistributable (version Visual Studio 2012 Update 4 ou ultérieure) est installé sur l’ordinateur sur lequel le runtime d’intégration auto-hébergé est en cours d’exécution. Si cette mise à jour n’est pas installée, téléchargez-la maintenant.
    • Pour utiliser un runtime d’intégration auto-hébergé pris en charge par Kubernetes :
      • Suivez l’article pour créer et configurer un runtime d’intégration pris en charge par Kubernetes.

Inscrire

Cette section explique comment inscrire MongoDB dans Microsoft Purview à l’aide du portail de gouvernance Microsoft Purview.

Étapes d’inscription

Pour inscrire une nouvelle source MongoDB dans votre catalogue de données, procédez comme suit :

1. Accédez à votre compte Microsoft Purview dans le portail de gouvernance Microsoft Purview.
2. Sélectionnez Data Map dans le volet de navigation de gauche.
3. Sélectionnez Inscrire.
4. Dans Inscrire des sources, sélectionnez MongoDB. Cliquez sur Continuer.

Dans l’écran Inscrire des sources (MongoDB), procédez comme suit :

1. Entrez un Nom indiquant que la source de données sera répertoriée dans le catalogue.

2. Entrez le nom du serveur . Spécifiez un nom pour identifier de façon unique votre instance MongoDB dans votre entreprise. Par exemple, host pour un déploiement autonome, MyReplicaSetName pour réplica ensemble, MyClusterName pour un cluster partitionné. Cette valeur sera utilisée dans le nom qualifié de la ressource et ne peut pas être modifiée.

3. Sélectionnez une collection dans la liste.

4. Terminez l’inscription de la source de données.

   

Analyser

Suivez les étapes ci-dessous pour analyser MongoDB afin d’identifier automatiquement les ressources. Pour plus d’informations sur l’analyse en général, consultez notre présentation des analyses et de l’ingestion.

Authentification pour une analyse

Le type d’authentification pris en charge pour une source MongoDB est l’authentification de base.

Créer et exécuter une analyse

Pour créer et exécuter une nouvelle analyse, procédez comme suit :

1. Dans le Centre de gestion, sélectionnez Runtimes d’intégration. Vérifiez qu’un runtime d’intégration auto-hébergé est configuré. S’il n’est pas configuré, suivez les étapes mentionnées dans Prérequis pour créer un runtime d’intégration auto-hébergé.

2. Accédez à Sources.

3. Sélectionnez la source MongoDB inscrite.

4. Sélectionnez + Nouvelle analyse.

5. Fournissez les détails ci-dessous :

   1. Nom : nom de l’analyse

   2. Se connecter via le runtime d’intégration : sélectionnez le runtime d’intégration auto-hébergé utilisé pour effectuer l’analyse.

   3. Informations d’identification : sélectionnez les informations d’identification pour vous connecter à votre source de données. Veillez à :

      • Sélectionnez Authentification de base lors de la création d’informations d’identification.
      • Indiquez le nom d’utilisateur utilisé pour se connecter à MongoDB dans le champ d’entrée Nom d’utilisateur.
      • Stockez le mot de passe utilisateur utilisé pour se connecter à MongoDB dans la clé secrète.

   4. Chaîne de connexion : spécifiez le chaîne de connexion MongoDB utilisé pour vous connecter à votre base de données MongoDB, à l’exception du nom d’utilisateur et du mot de passe. Par exemple, mongodb://mongodb0.example.com:27017,mongodb1.example.com:27017/?replicaSet=myRepl, mongodb+srv://mongodb0.example.com/?authSource=admin&replicaSet=myRepl.

   5. Bases de données : spécifiez la liste des bases de données MongoDB à importer. La liste peut avoir un ou plusieurs noms de base de données séparés par des points-virgules (;), par exemple database1; database2.

   6. Collections : sous-ensemble de collections à importer exprimée sous la forme d’une liste de collections séparées par des points-virgules, par exemple collection1;collection2. Toutes les collections sont importées si la liste est vide.

      Les modèles de nom de collection acceptables peuvent être des noms statiques ou contenir des caractères génériques . Par exemple : A%;%B;%C%;D:

      • Commencer par A ou
      • Terminer par B ou
      • Contenir C ou
      • Égal à D

      L’utilisation de NOT et de caractères spéciaux n’est pas acceptable.

   7. Nombre d’exemples de documents : nombre d’exemples de documents à analyser pour l’extraction de schéma. La valeur par défaut est 10.

   8. Mémoire maximale disponible (applicable lors de l’utilisation du runtime d’intégration auto-hébergé) : mémoire maximale (en Go) disponible sur la machine virtuelle du client à utiliser par les processus d’analyse. Cela dépend de la taille de la source MongoDB à analyser.

      

6. Sélectionnez Tester la connexion pour valider les configurations.

7. Cliquez sur Continuer.

8. Choisissez votre déclencheur d’analyse. Vous pouvez configurer une planification ou exécuter l’analyse une seule fois.

9. Passez en revue votre analyse et sélectionnez Enregistrer et exécuter.

Afficher vos analyses et exécutions d’analyse

Pour afficher les analyses existantes :

1. Accédez au portail Microsoft Purview. Dans le volet gauche, sélectionnez Mappage de données.
2. Sélectionnez la source de données. Vous pouvez afficher une liste des analyses existantes sur cette source de données sous Analyses récentes, ou vous pouvez afficher toutes les analyses sous l’onglet Analyses .
3. Sélectionnez l’analyse qui contient les résultats que vous souhaitez afficher. Le volet affiche toutes les exécutions d’analyse précédentes, ainsi que les status et les métriques pour chaque exécution d’analyse.
4. Sélectionnez l’ID d’exécution pour case activée les détails de l’exécution de l’analyse.

Gérer vos analyses

Pour modifier, annuler ou supprimer une analyse :

1. Accédez au portail Microsoft Purview. Dans le volet gauche, sélectionnez Mappage de données.

2. Sélectionnez la source de données. Vous pouvez afficher une liste des analyses existantes sur cette source de données sous Analyses récentes, ou vous pouvez afficher toutes les analyses sous l’onglet Analyses .

3. Sélectionnez l’analyse que vous souhaitez gérer. Vous pouvez ensuite :

   • Modifiez l’analyse en sélectionnant Modifier l’analyse.
   • Annulez une analyse en cours en sélectionnant Annuler l’exécution de l’analyse.
   • Supprimez votre analyse en sélectionnant Supprimer l’analyse.

Remarque

• La suppression de votre analyse ne supprime pas les ressources de catalogue créées à partir d’analyses précédentes.

Étapes suivantes

Maintenant que vous avez inscrit votre source, suivez les guides ci-dessous pour en savoir plus sur Microsoft Purview et vos données.

• Data Estate Insights dans Microsoft Purview
• Recherche dans le catalogue de données