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

Notes

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.

Important

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 possédait déjà plusieurs comptes et se trouve toujours sous le quota 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 :

   Python

   pip install azure-mgmt-resource
   

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

   Python

   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 :

   Python

   pip install azure-identity
   

   Notes

   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.

   Python

   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.

   Python

   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.

   Python

    # 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 :

   Python

   # Start the main method
   main()
   

Script complet

Voici le code Python complet :

Python

	
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 :

Console

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 :

Python

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.

• Comment utiliser le portail de gouvernance Microsoft Purview
• Accorder aux utilisateurs des autorisations sur le portail de gouvernance
• Créer un regroupement