Inicio rápido: Creación de una cuenta de Microsoft Purview (anteriormente Azure Purview) con Python

En este inicio rápido, creará una cuenta de Microsoft Purview (anteriormente Azure Purview) mediante programación con Python. La referencia de Python para Microsoft Purview está disponible, pero este artículo le guiará a través de todos los pasos necesarios para crear una cuenta con Python.

El portal de gobierno de Microsoft Purview presenta herramientas como el Mapa de datos de Microsoft Purview y el Catálogo de datos de Microsoft Purview que le ayudan a administrar y gobernar el panorama de datos. Al conectarse a los datos a través de orígenes locales, multinube y de software como servicio (SaaS), el Mapa de datos de Microsoft Purview crea un mapa actualizado de la información. Identifica y clasifica los datos confidenciales y proporciona linaje de un extremo a otro. Los consumidores de datos pueden detectar datos en toda la organización y los administradores de datos pueden auditar, proteger y garantizar el uso correcto de los datos.

Para obtener más información sobre las funcionalidades de gobernanza clásicas de Microsoft Purview, consulte nuestra página de introducción a las soluciones de gobernanza.

Requisitos previos

• Si no tiene una suscripción a Azure, cree una suscripción gratuita antes de empezar.

• Un inquilino de Microsoft Entra asociado a su suscripción.

• La cuenta de usuario que use para iniciar sesión en Azure debe ser miembro del colaborador o propietario, o administrador de la suscripción de Azure. Para ver los permisos que tiene en la suscripción, siga estos pasos:

  1. Vaya a Azure Portal
  2. Seleccione su nombre de usuario en la esquina superior derecha.
  3. Selecciona el botón de puntos suspensivos ("...") para ver más opciones.
  4. A continuación, seleccione Mis permisos.
  5. Si tienes acceso a varias suscripciones, selecciona la suscripción adecuada.

Iniciar sesión en Azure

Inicie sesión en Azure Portal con su cuenta de Azure.

Instalar el paquete de Python

1. Abra un terminal o un símbolo del sistema con privilegios de administrador.

2. En primer lugar, instale el paquete de Python para los recursos de administración de Azure:

   pip install azure-mgmt-resource
   

3. Para instalar el paquete de Python para Microsoft Purview, ejecute el siguiente comando:

   pip install azure-mgmt-purview
   

   El SDK de Python para Microsoft Purview admite Python 2.7, 3.3, 3.4, 3.5, 3.6 y 3.7.

4. Para instalar el paquete de Python para la autenticación de identidad de Azure, ejecute el siguiente comando:

   pip install azure-identity
   

   Nota:

   El paquete "azure-identity" puede tener conflictos con "azure-cli" en algunas dependencias comunes. Si se produce algún problema de autenticación, quite "azure-cli" y sus dependencias, o utilice una máquina limpia sin instalar el paquete "azure-cli".

Crear un cliente de Purview

1. Cree un archivo llamado purview.py. Agregue las instrucciones siguientes para agregar referencias a espacios de nombres.

   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. Agregue el código siguiente al método Main que crea una instancia de la clase PurviewManagementClient. Usará este objeto para crear una cuenta de Purview, eliminar cuentas de Purview, comprobar la disponibilidad del nombre y otras operaciones del proveedor de recursos.

   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)
   

Crear una cuenta de Purview

1. Agregue el código siguiente al método Main que crea una cuenta de Purview. Si su grupo de recursos ya existe, comente la primera create_or_update instrucción.

    # 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. Ahora, agregue la siguiente instrucción para invocar el método principal cuando se ejecute el programa:

   # Start the main method
   main()
   

Script completo

Aquí está el código completo de 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()

Ejecutar el código

Genere e inicie la aplicación. La consola imprime el progreso de la creación de la cuenta de Microsoft Purview. Espere hasta que se complete. Este es el resultado de ejemplo:

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

Comprobar la salida

Vaya a la página de cuentas de Microsoft Purview en Azure Portal y compruebe la cuenta creada con el código anterior.

Eliminar una cuenta de Microsoft Purview

Para eliminar la cuenta de Purview, agregue el siguiente código al programa y, a continuación, ejecútelo:

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

Pasos siguientes

En este inicio rápido, aprendió a crear una cuenta de Microsoft Purview (anteriormente Azure Purview), eliminarla y comprobar la disponibilidad del nombre. Ahora puede descargar el SDK de Python y obtener información sobre otras acciones del proveedor de recursos que puede realizar con una cuenta de Microsoft Purview.

Sigue los siguientes artículos para aprender a navegar por el portal de gobierno de Microsoft Purview, crear una colección y conceder acceso al portal de gobierno de Microsoft Purview.

• Cómo usar el portal de gobierno de Microsoft Purview
• Conceder permisos de usuario al portal de gobierno
• Creación de una colección