Compartir a través de

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

  • Artículo

Importante

Solo puede crear una cuenta de Microsoft Purview por inquilino. Si su organización ya tiene una cuenta de Microsoft Purview, no podrá crear una nueva cuenta de Microsoft Purview a menos que la organización ya tenga varias cuentas y siga estando bajo la cuota preexistente. Para obtener más información, consulte las preguntas más frecuentes.

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

El portal de gobernanza de Microsoft Purview muestra herramientas como la Mapa de datos de Microsoft Purview y Catálogo de datos de Microsoft Purview que le ayudan a administrar y controlar el panorama de los datos. Al conectarse a datos a través de los orígenes locales, de nube múltiple 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 linage 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 información general sobre soluciones de gobernanza.

Requisitos previos

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

  • Un inquilino Microsoft Entra asociado a la suscripción.

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

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

Inicio de sesión en Azure

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

Instalación del paquete de Python

  1. Abra un terminal o 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" podría 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 use una máquina limpia sin instalar el paquete "azure-cli".

Creación de un cliente de Purview

  1. Cree un archivo denominado purview.py. Agregue las siguientes instrucciones 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 de nombres 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)

Creación de una cuenta de Purview

  1. Agregue el código siguiente al método Main que crea una cuenta de Purview. Si el 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 main cuando se ejecute el programa:

    # Start the main method
main()

Script completo

Este es 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()

Ejecución del código

Compile 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. Esta es la salida 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

Comprobación de la salida

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

Eliminación de una cuenta de Microsoft Purview

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

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

Pasos siguientes

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

Siga estos artículos siguientes para obtener información sobre cómo navegar por el portal de gobernanza de Microsoft Purview, crear una colección y conceder acceso al portal de gobernanza de Microsoft Purview.