Partager via

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

  • Article

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 Lignée 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 2.6 à 5.1.

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

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 ou créez-en une (facultatif).

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

    options d’inscription des sources

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 ici 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 la chaîne de connexion MongoDB utilisée pour se connecter à votre mongoDB, à l’exclusion du nom d’utilisateur et du mot de passe. Par exemple : mongodb://mongodb0.example.com:27017,mongodb1.example.com:27017/?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 utilisant la syntaxe d’expressions SQL LIKE incluent l’utilisation de %. 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.

      analyser MongoDB

  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 de gouvernance 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 de gouvernance 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.
  • La ressource ne sera plus mise à jour avec des modifications de schéma si votre table source a changé et que vous réexécuterez la table source après avoir modifié la description sous l’onglet Schéma de Microsoft Purview.

Prochaines étapes

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