Se connecter à l’API Azure Cosmos DB pour SQL dans Microsoft Purview

Importante

Les fonctionnalités de gouvernance des données de catalogue unifié Microsoft Purview et Microsoft Purview classique (anciennement Azure Purview) sont mises hors service. Microsoft consolide ses fonctionnalités de gouvernance des données dans Microsoft Fabric. Vous ne pouvez plus créer de comptes et les fonctionnalités existantes resteront en mode maintenance jusqu’au 12 novembre 2027. Pour connaître les délais de mise hors service, les conseils de transition et les prochaines étapes recommandées, consultez l’annonce de mise hors service de la gouvernance des données Microsoft Purview.

Cet article décrit le processus d’inscription et d’analyse d’une instance d’API Azure Cosmos DB pour SQL dans Microsoft Purview, notamment les instructions d’authentification et d’interaction avec la source de base de données Azure Cosmos DB

Fonctionnalités prises en charge

Capacités d’analyse

Extraction de métadonnées Analyse complète Analyse incrémentielle Analyse étendue
Oui Oui Non Oui

Autres fonctionnalités

Pour les classifications, les étiquettes de confidentialité, les stratégies, la traçabilité des données et l’affichage en direct, consultez la liste des fonctionnalités prises en charge.

Configuration requise

Inscrire

Cette section vous permettra d’enregistrer l’instance d’API Azure Cosmos DB pour SQL et de mettre en place un mécanisme d’authentification approprié pour garantir la réussite de l’analyse de la source de données.

Procédure d’inscription

Il est important d’inscrire la source de données dans Microsoft Purview avant de configurer une analyse de la source de données.

  1. Ouvrez le portail de gouvernance Microsoft Purview en :

  2. Accédez au mappage de données --> Collections

    Capture d’écran qui accède au lien Sources dans le mappage de données

  3. Créez la hiérarchie des collections à l’aide du menu Collections et attribuez des autorisations à des sous-collections individuelles, selon les besoins

    Capture d’écran montrant le menu de collection permettant de créer une hiérarchie de collection

  4. Naviguez vers la collection appropriée sous le menu Sources, puis sélectionnez l’icône Inscrire pour inscrire une nouvelle base de données Azure Cosmos DB

    Capture d’écran montrant la collection utilisée pour inscrire la source de données

  5. Sélectionnez la source de données de l’API Azure Cosmos DB pour SQL, puis sélectionnez Continuer

    Capture d’écran qui permet la sélection de la source de données

  6. Fournissez un nom approprié pour la source de données, sélectionnez l’abonnement Azure approprié, le nom du compte Cosmos DB et la collection, puis sélectionnez Appliquer

    Capture d’écran montrant les détails à saisir pour inscrire la source de données

  7. Le compte de stockage de base de données Azure Cosmos DB s’affiche sous la collection sélectionnée

    Capture d’écran montrant la source de données mappée à la collection pour lancer l’analyse

Analyser

Authentification d’une analyse

Pour pouvoir analyser la source de données, vous devez configurer une méthode d’authentification dans le compte de stockage de la base de données Azure Cosmos DB.

Il n’existe qu’une seule façon de configurer l’authentification pour la base de données Azure Cosmos DB :

Clé de compte – Les secrets peuvent être créés dans un Azure Key Vault pour stocker les informations d’identification afin de permettre à Microsoft Purview d’analyser les sources de données en toute sécurité à l’aide des secrets. Un secret peut être une clé de compte de stockage, un mot de passe de connexion SQL ou un mot de passe.

Remarque

Vous devez déployer une ressource de coffre de clés Azure dans votre abonnement et affecter au MSI du compte Microsoft Purview avec l’autorisation d’accès requise aux secrets dans le coffre de clés Azure.

Utilisation de la clé de compte pour l’analyse

Vous devez récupérer votre clé d’accès et la stocker dans le coffre de clés :

  1. Accédez à votre compte de stockage de base de données Azure Cosmos DB

  2. Sélectionner les clés de paramètres >

    Capture d’écran montrant les clés d’accès dans le compte de stockage

  3. Copiez votre clé et enregistrez-la séparément pour les étapes suivantes

    Capture d’écran montrant les touches d’accès à copier

  4. Accédez à votre coffre de clés

    Capture d’écran montrant le coffre de clés

  5. Sélectionnez Paramètres > Secrets , puis + Générer/Importer

    Capture dʼécran montrant lʼoption de génération dʼun secret par le coffre de clés

  6. Entrez le nom et la valeur comme clé de votre compte de stockage et sélectionnez Créer pour terminer

    Capture dʼécran montrant lʼoption du coffre de clés permettant dʼentrer les valeurs secrètes

  7. Si votre coffre de clés n’est pas encore connecté à Microsoft Purview, vous devez créer une connexion de coffre de clés

  8. Enfin, créez de nouvelles informations d’identification à l’aide de la clé pour configurer votre analyse.

Création de l’analyse

  1. Ouvrez votre compte Microsoft Purview , puis sélectionnez le portail de gouvernance Ouvrir Microsoft Purview

  2. Accédez au mappage de données -->Sources pour afficher la hiérarchie de la collection

  3. Sélectionnez l’icône Nouvelle analyse sous la base de données Azure Cosmos précédemment enregistrée

    Capture d’écran montrant l’écran permettant de créer une nouvelle analyse

  4. Donnez un nom à l’analyse.

  5. Choisissez le runtime d’intégration Azure si votre source est accessible publiquement, un runtime d’intégration de réseau virtuel managé si vous utilisez un réseau virtuel managé, ou un runtime d’intégration auto-hébergé si votre source se trouve dans un réseau virtuel privé. Pour plus d’informations sur le runtime d’intégration à utiliser, consultez l’article Choisir la configuration du runtime d’intégration appropriée.

  6. Choisissez le regroupement approprié pour l’analyse et sélectionnez + Nouveau sous Informations d’identification

    Capture dʼécran montrant lʼoption Clé de compte pour lʼanalyse

  7. Sélectionnez la connexion au coffre de clés appropriée et le nom de secret utilisé lors de la création de la clé de compte. Choisir la méthode d’authentification comme clé de compte

    Capture dʼécran montrant les options de clé de compte

  8. Sélectionnez Tester la connexion. Lorsque la connexion est établie, sélectionnez Continuer

    Capture d’écran montrant la réussite du test de connexion

Étendue et exécution de l’analyse

  1. Vous pouvez limiter votre analyse à des dossiers et sous-dossiers spécifiques en choisissant les éléments appropriés dans la liste.

    Étendre votre analyse

  2. Sélectionnez ensuite un ensemble de règles d’analyse. Vous pouvez choisir entre le système par défaut, les ensembles de règles personnalisés existants ou créer un nouvel ensemble de règles en ligne.

    Ensemble de règles d’analyse

    Nouvelle règle d’analyse

  3. Vous pouvez sélectionner les règles de classification à inclure dans la règle de balayage

    Règles de classification d’ensemble de règles d’analyse

    Sélection de l’ensemble de règles d’analyse

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

    Déclencheur d’analyse

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

    Examiner l’analyse

Affichage de l’analyse

  1. Accédez à la source de données dans la collection et sélectionnez Afficher les détails pour vérifier le statut de l’analyse en cas de case activée

    Afficher Numériser

  2. Les détails de l’analyse indiquent la progression de l’analyse dans le dernier status d’exécution et le nombre de ressources analysées et classifiées

    Afficher les détails de l’analyse

  3. Le status de la dernière exécution sera mis à jour vers En cours, puis Terminé une fois que l’ensemble de l’analyse aura été exécuté avec succès

    Afficher l’analyse en cours

    Afficher l’analyse terminée

Gestion de l’analyse

Les analyses peuvent être gérées ou réexécutées une fois terminées.

  1. Sélectionnez le nom de l’analyse pour gérer l’analyse

    Gérer l’analyse

  2. Vous pouvez réexécuter l’analyse , modifier l’analyse et supprimer l’analyse

    Gérer les options d’analyse

  3. Vous pouvez à nouveau exécuter une analyse complète

    Analyse complète

Étapes suivantes

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