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

Artigo
11/20/2024

Importante

Só pode criar uma conta do Microsoft Purview por inquilino. Se a sua organização já tiver uma conta do Microsoft Purview, não poderá criar uma nova conta do Microsoft Purview, a menos que a sua organização já tenha várias contas e ainda esteja abaixo da quota pré-existente. Para obter mais informações, veja as FAQ.

Neste início rápido, irá criar uma conta do Microsoft Purview (anteriormente Azure Purview) programaticamente com Python. A referência do Python para o Microsoft Purview está disponível, mas este artigo irá guiá-lo através de todos os passos necessários para criar uma conta com Python.

O portal de governação do Microsoft Purview apresenta ferramentas como o Mapa de Dados do Microsoft Purview e Catálogo de Dados do Microsoft Purview que o ajudam a gerir e a governar o seu panorama de dados. Ao ligar a dados nas origens saaS (software como serviço), multi cloud e no local, o Mapa de Dados do Microsoft Purview cria um mapa atualizado das suas informações. Identifica e classifica dados confidenciais e fornece linage ponto a ponto. Os consumidores de dados são capazes de detetar dados em toda a sua organização e os administradores de dados são capazes de auditar, proteger e garantir a utilização correta dos seus dados.

Para obter mais informações sobre as capacidades de governação clássicas do Microsoft Purview, veja a nossa página de descrição geral das soluções de governação.

Pré-requisitos

Se não tiver uma subscrição do Azure, crie uma subscrição gratuita antes de começar.
Um inquilino Microsoft Entra associado à sua subscrição.
A conta de utilizador que utiliza para iniciar sessão no Azure tem de ser membro da função de proprietárioou contribuidor ou administrador da subscrição do Azure. Para ver as permissões que tem na subscrição, siga estes passos:
1. Aceda à portal do Azure
2. Selecione o seu nome de utilizador no canto superior direito.
3. Selecione o botão de reticências ("...") para obter mais opções.
4. Em seguida, selecione As minhas permissões.
5. Se tiver acesso a várias subscrições, selecione a subscrição adequada.

Inicie sessão no portal do Azure com a sua conta do Azure.

Instalar o pacote Python

Abra um terminal ou linha de comandos com privilégios de administrador.
Primeiro, instale o pacote Python para os recursos de gestão do Azure:
```
pip install azure-mgmt-resource
```
Para instalar o pacote Python para o Microsoft Purview, execute o seguinte comando:
```
pip install azure-mgmt-purview
```
O SDK Python para Microsoft Purview suporta Python 2.7, 3.3, 3.4, 3.5, 3.6 e 3.7.
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 encontrar algum problema de autenticação, remova "azure-cli" e as respetivas dependências ou utilize uma máquina limpo sem instalar o pacote "azure-cli".

Criar um cliente purview

Crie um ficheiro com o nome purview.py. Adicione as seguintes instruções para adicionar referências a espaços de nomes.

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

Adicione o seguinte código ao método Main que cria uma instância da classe PurviewManagementClient. Irá utilizar este objeto para criar uma conta do Purview, eliminar contas do Purview, marcar disponibilidade de nomes e outras operações do fornecedor 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

Adicione o seguinte código ao método Main que cria uma conta 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)

Agora, adicione a seguinte instrução para invocar o método main quando o programa é executado:
```
# Start the main method
main()
```

Script completo

Eis 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

Crie e inicie a aplicação. A consola imprime o progresso da criação da conta do Microsoft Purview. Aguarde até que esteja concluído. Eis o resultado do exemplo:

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

Aceda à página contas do Microsoft Purview na portal do Azure e verifique a conta criada com o código acima.

Eliminar conta do Microsoft Purview

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

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

Próximas etapas

Neste início rápido, aprendeu a criar uma conta do Microsoft Purview (anteriormente Azure Purview), eliminar a conta e marcar para disponibilidade de nomes. Agora pode transferir o SDK do Python e saber mais sobre outras ações do fornecedor de recursos que pode realizar para uma conta do Microsoft Purview.

Siga estes artigos seguintes para saber como navegar no portal de governação do Microsoft Purview, criar uma coleção e conceder acesso ao portal de governação do Microsoft Purview.

Partilhar via

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

Pré-requisitos

Instalar o pacote Python

Criar um cliente purview

Criar uma conta do Purview

Script completo

Executar o código

Verificar a saída

Eliminar conta do Microsoft Purview

Próximas etapas

Comentários

Recursos adicionais

Partilhar via

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

Pré-requisitos

Iniciar sessão no Azure

Instalar o pacote Python

Criar um cliente purview

Criar uma conta do Purview

Script completo

Executar o código

Verificar a saída

Eliminar conta do Microsoft Purview

Próximas etapas

Comentários

Recursos adicionais