Condividi tramite

Guida introduttiva: Creare un account Microsoft Purview (in precedenza Azure Purview) con Python

  • Articolo

Nota

Microsoft Purview Data Catalog (versione classica) e Data Health Insights (versione classica) non accettano più nuovi clienti e questi servizi, in precedenza Azure Purview, sono ora in modalità di supporto clienti.

Importante

È possibile creare un solo account Microsoft Purview per ogni tenant. Se l'organizzazione ha già un account Microsoft Purview, non sarà possibile creare un nuovo account Microsoft Purview a meno che l'organizzazione non abbia già più account e non sia ancora inclusa nella quota preesistente. Per altre informazioni, vedere domande frequenti.

In questa guida introduttiva si creerà un account Microsoft Purview (in precedenza Azure Purview) a livello di programmazione usando Python. Il riferimento python per Microsoft Purview è disponibile, ma questo articolo illustra tutti i passaggi necessari per creare un account con Python.

Il portale di governance di Microsoft Purview presenta strumenti come Microsoft Purview Data Map e Microsoft Purview Data Catalog che consentono di gestire e gestire il panorama dei dati. Connettendosi ai dati nelle origini SaaS (Software as a Service) locali, multi-cloud e software-as-a-service, il Microsoft Purview Data Map crea una mappa aggiornata delle informazioni. Identifica e classifica i dati sensibili e fornisce linage end-to-end. I consumer di dati sono in grado di individuare i dati nell'organizzazione e gli amministratori dei dati sono in grado di controllare, proteggere e garantire il corretto uso dei dati.

Per altre informazioni sulle funzionalità di governance classiche di Microsoft Purview, vedere la pagina di panoramica delle soluzioni di governance.

Prerequisiti

  • Se non si ha una sottoscrizione di Azure, creare una sottoscrizione gratuita prima di iniziare.

  • Un tenant Microsoft Entra associato alla sottoscrizione.

  • L'account utente usato per accedere ad Azure deve essere un membro del ruolo di collaboratore o proprietario o un amministratore della sottoscrizione di Azure. Per visualizzare le autorizzazioni disponibili nella sottoscrizione, seguire questa procedura:

    1. Passare alla portale di Azure
    2. Selezionare il nome utente nell'angolo in alto a destra.
    3. Selezionare il pulsante con i puntini di sospensione ("...") per altre opzioni.
    4. Selezionare quindi Autorizzazioni personali.
    5. Se si ha accesso a più sottoscrizioni, selezionare la sottoscrizione appropriata.

Accedere ad Azure

Accedere al portale di Azure con l'account Azure.

Installare il pacchetto Python

  1. Aprire un terminale o un prompt dei comandi con privilegi di amministratore.

  2. Installare prima di tutto il pacchetto Python per le risorse di gestione di Azure:

    pip install azure-mgmt-resource

  3. Per installare il pacchetto Python per Microsoft Purview, eseguire il comando seguente:

    pip install azure-mgmt-purview

    Python SDK per Microsoft Purview supporta Python 2.7, 3.3, 3.4, 3.5, 3.6 e 3.7.

  4. Per installare il pacchetto Python per l'autenticazione di Identità di Azure, eseguire il comando seguente:

    pip install azure-identity

    Nota

    Il pacchetto "azure-identity" potrebbe avere conflitti con "azure-cli" in alcune dipendenze comuni. Se si verifica un problema di autenticazione, rimuovere "azure-cli" e le relative dipendenze oppure usare un computer pulito senza installare il pacchetto "azure-cli".

Creare un client purview

  1. Creare un file denominato purview.py. Aggiungere le istruzioni seguenti per aggiungere riferimenti agli spazi dei nomi.

    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. Aggiungere il codice seguente al metodo Main che crea un'istanza della classe PurviewManagementClient. Questo oggetto verrà usato per creare un account purview, eliminare account purview, controllare la disponibilità dei nomi e altre operazioni del provider di risorse.

    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)

Creare un account purview

  1. Aggiungere il codice seguente al metodo Main che crea un account purview. Se il gruppo di risorse esiste già, impostare come commento la prima create_or_update istruzione.

     # 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. Aggiungere ora l'istruzione seguente per richiamare il metodo main quando viene eseguito il programma:

    # Start the main method
main()

Script completo

Ecco il codice Python completo:

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

Eseguire il codice

Compilare e avviare l'applicazione. La console visualizza lo stato di avanzamento della creazione dell'account Microsoft Purview. Attendere il completamento. Ecco l'output di esempio:

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

Verificare l'output

Passare alla pagina account Microsoft Purview nel portale di Azure e verificare l'account creato usando il codice precedente.

Eliminare l'account Microsoft Purview

Per eliminare l'account purview, aggiungere il codice seguente al programma, quindi eseguire:

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

Passaggi successivi

In questa guida introduttiva si è appreso come creare un account Microsoft Purview (in precedenza Azure Purview), eliminare l'account e verificare la disponibilità dei nomi. È ora possibile scaricare Python SDK e ottenere informazioni su altre azioni del provider di risorse che è possibile eseguire per un account Microsoft Purview.

Seguire questi articoli successivi per informazioni su come esplorare il portale di governance di Microsoft Purview, creare una raccolta e concedere l'accesso al portale di governance di Microsoft Purview.