Partage via

Démarrage rapide : Créer un compte Microsoft Purview (anciennement Azure Purview) à l’aide de Python

  • Article

Remarque

Catalogue de données Microsoft Purview (classique) et Data Health Insights (classique) n’acceptent plus de nouveaux clients et ces services, précédemment Azure Purview, sont désormais en mode de support client.

Importante

Vous ne pouvez créer qu’un seul compte Microsoft Purview par locataire. Si votre organization dispose déjà d’un compte Microsoft Purview, vous ne pourrez pas créer de compte Microsoft Purview, sauf si votre organization déjà plusieurs comptes et est toujours sous le quota préexistant. Pour plus d’informations, consultez la FAQ.

Dans ce guide de démarrage rapide, vous allez créer un compte Microsoft Purview (anciennement Azure Purview) par programmation à l’aide de Python. La référence Python pour Microsoft Purview est disponible, mais cet article vous guidera tout au long des étapes nécessaires pour créer un compte avec Python.

Le portail de gouvernance Microsoft Purview présente des outils tels que les Mappage de données Microsoft Purview et les Catalogue de données Microsoft Purview qui vous aident à gérer et à gouverner votre paysage de données. En vous connectant à des données sur vos sources locales, multiclouds et SaaS (Software-as-a-Service), le Mappage de données Microsoft Purview crée une carte à jour de vos informations. Il identifie et classifie les données sensibles et fournit un linage de bout en bout. Les consommateurs de données sont en mesure de découvrir des données dans votre organization, et les administrateurs de données sont en mesure d’auditer, de sécuriser et de garantir une utilisation appropriée de vos données.

Pour plus d’informations sur les fonctionnalités de gouvernance classiques de Microsoft Purview, consultez la page vue d’ensemble de nos solutions de gouvernance.

Configuration requise

  • Si vous n’avez pas d’abonnement Azure, créez un abonnement gratuit avant de commencer.

  • Un locataire Microsoft Entra associé à votre abonnement.

  • Le compte d’utilisateur que vous utilisez pour vous connecter à Azure doit être membre du rôle contributeur ou propriétaire, ou administrateur de l’abonnement Azure. Pour afficher les autorisations dont vous disposez dans l’abonnement, procédez comme suit :

    1. Accéder à la Portail Azure
    2. Sélectionnez votre nom d’utilisateur dans le coin supérieur droit.
    3. Sélectionnez le bouton de sélection (« ... ») pour plus d’options.
    4. Sélectionnez ensuite Mes autorisations.
    5. Si vous avez accès à plusieurs abonnements, sélectionnez l’abonnement approprié.

Se connecter à Azure

Connectez-vous au Portail Azure avec votre compte Azure.

Installer le package Python

  1. Ouvrez un terminal ou une invite de commandes avec des privilèges d’administrateur.

  2. Tout d’abord, installez le package Python pour les ressources de gestion Azure :

    pip install azure-mgmt-resource

  3. Pour installer le package Python pour Microsoft Purview, exécutez la commande suivante :

    pip install azure-mgmt-purview

    Le SDK Python pour Microsoft Purview prend en charge Python 2.7, 3.3, 3.4, 3.5, 3.6 et 3.7.

  4. Pour installer le package Python pour l’authentification d’identité Azure, exécutez la commande suivante :

    pip install azure-identity

    Remarque

    Le package « azure-identity » peut avoir des conflits avec « azure-cli » sur certaines dépendances courantes. Si vous rencontrez un problème d’authentification, supprimez « azure-cli » et ses dépendances, ou utilisez une machine propre sans installer le package « azure-cli ».

Créer un client Purview

  1. Créez un fichier nommé purview.py. Ajoutez les instructions suivantes pour ajouter des références à des espaces de noms.

    from azure.identity import ClientSecretCredential 
 from azure.mgmt.resource import ResourceManagementClient
 from azure.mgmt.purview import PurviewManagementClient
 from azure.mgmt.purview.models import *
 from datetime import datetime, timedelta
 import time

  2. Ajoutez le code suivant à la méthode Main qui crée un instance de la classe PurviewManagementClient. Vous allez utiliser cet objet pour créer un compte Purview, supprimer des comptes Purview, case activée disponibilité des noms et d’autres opérations de fournisseur de ressources.

    def main():

# Azure subscription ID
subscription_id = '<subscription ID>'

 # This program creates this resource group. If it's an existing resource group, comment out the code that creates the resource group
rg_name = '<resource group>'

# The purview name. It must be globally unique.
purview_name = '<purview account name>'

# Location name, where Microsoft Purview account must be created.
location = '<location name>'    

# Specify your Active Directory client ID, client secret, and tenant ID
credentials = ClientSecretCredential(client_id='<service principal ID>', client_secret='<service principal key>', tenant_id='<tenant ID>') 
# resource_client = ResourceManagementClient(credentials, subscription_id)
purview_client = PurviewManagementClient(credentials, subscription_id)

Créer un compte Purview

  1. Ajoutez le code suivant à la méthode Main qui crée un compte Purview. Si votre groupe de ressources existe déjà, commentez la première create_or_update instruction.

     # create the resource group
 # comment out if the resource group already exits
 resource_client.resource_groups.create_or_update(rg_name, rg_params)

 #Create a purview
 identity = Identity(type= "SystemAssigned")
 sku = AccountSku(name= 'Standard', capacity= 4)
 purview_resource = Account(identity=identity,sku=sku,location =location )

 try:
     pa = (purview_client.accounts.begin_create_or_update(rg_name, purview_name, purview_resource)).result()
     print("location:", pa.location, " Microsoft Purview Account Name: ", pa.name, " Id: " , pa.id ," tags: " , pa.tags)  
 except:
     print("Error")
     print_item(pa)

 while (getattr(pa,'provisioning_state')) != "Succeeded" :
     pa = (purview_client.accounts.get(rg_name, purview_name))  
     print(getattr(pa,'provisioning_state'))
     if getattr(pa,'provisioning_state') == "Failed" :
         print("Error in creating Microsoft Purview account")
         break
     time.sleep(30)

  2. À présent, ajoutez l’instruction suivante pour appeler la méthode main lors de l’exécution du programme :

    # Start the main method
main()

Script complet

Voici le code Python complet :

	
from azure.identity import ClientSecretCredential 
from azure.mgmt.resource import ResourceManagementClient
from azure.mgmt.purview import PurviewManagementClient
from azure.mgmt.purview.models import *
from datetime import datetime, timedelta
import time

def main():

    # Azure subscription ID
    subscription_id = '<subscription ID>'
	
    # This program creates this resource group. If it's an existing resource group, comment out the code that creates the resource group
    rg_name = '<resource group>'

    # The purview name. It must be globally unique.
    purview_name = '<purview account name>'

    # Location for your resource group and your Microsoft Purview account.
    location ="<location>" 

    # Specify your Active Directory client ID, client secret, and tenant ID
    credentials = ClientSecretCredential(client_id='<service principal ID>', client_secret='<service principal key>', tenant_id='<tenant ID>') 
    resource_client = ResourceManagementClient(credentials, subscription_id)
    purview_client = PurviewManagementClient(credentials, subscription_id)
	
    # create the resource group
    # comment out if the resource group already exits
    resource_client.resource_groups.create_or_update(rg_name, {"location": location})

    #Create a purview
    identity = Identity(type= "SystemAssigned")
    sku = AccountSku(name= 'Standard', capacity= 4)
    purview_resource = Account(identity=identity,sku=sku,location =location)
       
    try:
        pa = (purview_client.accounts.begin_create_or_update(rg_name, purview_name, purview_resource)).result()
        print("location:", pa.location, " Microsoft Purview Account Name: ", purview_name, " Id: " , pa.id ," tags: " , pa.tags) 
    except:
        print("Error in submitting job to create account")
        print_item(pa)
 
    while (getattr(pa,'provisioning_state')) != "Succeeded" :
        pa = (purview_client.accounts.get(rg_name, purview_name))  
        print(getattr(pa,'provisioning_state'))
        if getattr(pa,'provisioning_state') == "Failed" :
            print("Error in creating Microsoft Purview account")
            break
        time.sleep(30)    

# Start the main method
main()

Exécuter le code

Générez et démarrez l’application. La console affiche la progression de la création du compte Microsoft Purview. Attendez qu’il soit terminé. Voici l’exemple de sortie :

location: southcentralus  Microsoft Purview Account Name:  purviewpython7  Id:  /subscriptions/8c2c7b23-848d-40fe-b817-690d79ad9dfd/resourceGroups/Demo_Catalog/providers/Microsoft.Purview/accounts/purviewpython7  tags:  None
Creating
Creating
Succeeded

Vérifier la sortie

Accédez à la page Comptes Microsoft Purview dans le Portail Azure et vérifiez le compte créé à l’aide du code ci-dessus.

Supprimer un compte Microsoft Purview

Pour supprimer le compte purview, ajoutez le code suivant au programme, puis exécutez :

pa = purview_client.accounts.begin_delete(rg_name, purview_name).result()

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez appris à créer un compte Microsoft Purview (anciennement Azure Purview), à supprimer le compte et à case activée pour la disponibilité des noms. Vous pouvez maintenant télécharger le Kit de développement logiciel (SDK) Python et en savoir plus sur les autres actions de fournisseur de ressources que vous pouvez effectuer pour un compte Microsoft Purview.

Suivez les articles suivants pour découvrir comment naviguer dans le portail de gouvernance Microsoft Purview, créer une collection et accorder l’accès au portail de gouvernance Microsoft Purview.