Início Rápido: criar uma conta do Microsoft Purview (anteriormente Azure Purview) usando o Python

Neste início rápido, você criará uma conta do Microsoft Purview (anteriormente Azure Purview) programaticamente usando Python. A referência do Python para o Microsoft Purview está disponível, mas este artigo o orientará por todas as etapas necessárias para criar uma conta com o Python.

O portal de governança do Microsoft Purview apresenta ferramentas como o Mapa de Dados do Microsoft Purview e o Catálogo de Dados do Microsoft Purview que ajudam você a gerenciar e controlar seu cenário de dados. Conectando-se a dados em suas fontes locais, de várias nuvens e de software como serviço (SaaS), o Mapa de Dados do Microsoft Purview cria um mapa atualizado de suas informações. Ele identifica e classifica dados confidenciais e fornece linhagem de ponta a ponta. Os consumidores de dados são capazes de descobrir dados em toda a sua organização, e os administradores de dados são capazes de auditar, proteger e garantir o uso correto de seus dados.

Para obter mais informações sobre os recursos clássicos de governança do Microsoft Purview, consulte nossa página de visão geral de soluções de governança.

Pré-requisitos

• Se você não tiver uma assinatura do Azure, crie uma assinatura gratuita antes de começar.

• Um locatário do Microsoft Entra associado à sua assinatura.

• A conta de usuário que você usa para entrar no Azure deve ser um membro da função de contribuidor ou proprietário ou um administrador da assinatura do Azure. Para exibir as permissões que você tem na assinatura, siga estas etapas:

  1. Acesse o portal do Azure
  2. Selecione seu nome de usuário no canto superior direito.
  3. Selecione o botão de reticências ("...") para obter mais opções.
  4. Em seguida, selecione Minhas permissões.
  5. Se você tiver acesso a várias assinaturas, selecione a assinatura apropriada.

Entrar no Azure

Entre no portal do Azure com sua conta do Azure.

Instalar o pacote Python

1. Abra um terminal ou prompt de comando com privilégios de administrador.

2. Primeiro, instale o pacote Python para recursos de gerenciamento do Azure:

   pip install azure-mgmt-resource
   

3. Para instalar o pacote Python para Microsoft Purview, execute o seguinte comando:

   pip install azure-mgmt-purview
   

   O SDK do Python para Microsoft Purview dá suporte ao Python 2.7, 3.3, 3.4, 3.5, 3.6 e 3.7.

4. Para instalar o pacote Python para autenticação de Identidade do Azure, execute o seguinte comando:

   pip install azure-identity
   

   Observação

   O pacote "azure-identity" pode ter conflitos com "azure-cli" em algumas dependências comuns. Se você encontrar algum problema de autenticação, remova "azure-cli" e suas dependências ou use uma máquina limpa sem instalar o pacote "azure-cli".

Criar um cliente do Purview

1. Crie um arquivo chamado purview.py. Adicione as instruções a seguir para adicionar referências a namespaces.

   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. Adicione o código a seguir ao método Main que cria uma instância da classe PurviewManagementClient. Você usará esse objeto para criar uma conta do Purview, excluir contas do Purview, marcar a disponibilidade de nomes e outras operações do provedor 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)
   

Criar uma conta do Purview

1. Adicione o código a seguir ao método Main que cria uma conta do Purview. Se o grupo de recursos já existir, comente a primeira create_or_update instrução.

    # 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. Agora, adicione a seguinte instrução para invocar o método main quando o programa for executado:

   # Start the main method
   main()
   

Script completo

Aqui está o código 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()

Executar o código

Compile e inicie o aplicativo. O console imprime o progresso da criação da conta do Microsoft Purview. Aguarde até que seja concluído. Aqui está o exemplo de resultado:

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

Verificar a saída

Acesse a página Contas do Microsoft Purview no portal do Azure e verifique a conta criada usando o código acima.

Excluir conta do Microsoft Purview

Para excluir a conta do Purview, adicione o seguinte código ao programa e execute:

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

Próximas etapas

Neste guia de início rápido, você aprendeu a criar uma conta do Microsoft Purview (anteriormente Azure Purview), excluir a conta e marcar a disponibilidade de nomes. Agora você pode baixar o SDK do Python e saber mais sobre outras ações de provedor de recursos que você pode executar em uma conta do Microsoft Purview.

Siga os próximos artigos para saber como navegar no portal de governança do Microsoft Purview, criar uma coleção e conceder acesso ao portal de governança do Microsoft Purview.

• Como usar o portal de governança do Microsoft Purview
• Conceder permissões de usuários para o portal de governança
• Criar um conjunto