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

Neste início rápido, você usará o SDK do .NET para criar uma conta do Microsoft Purview (anteriormente Azure Purview).

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, multinuvem e 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.

Visual Studio

O passo a passo neste artigo usa o Visual Studio 2019. Os procedimentos para o Visual Studio 2013, 2015 ou 2017 podem ser ligeiramente diferentes.

SDK do .NET do Azure

Baixe e instale Azure SDK do .NET em seu computador.

Criar um aplicativo no Microsoft Entra ID

1. Em Criar um aplicativo do Microsoft Entra, crie um aplicativo que represente o aplicativo .NET que você está criando neste tutorial. Para a URL de logon, você pode fornecer uma URL fictícia, conforme mostrado no artigo (https://contoso.org/exampleapp).
2. Em Obter valores para entrar, obtenha a ID do aplicativo e a ID do locatário e anote esses valores que você usará posteriormente neste tutorial.
3. Em Certificados e segredos, obtenha a chave de autenticação e anote esse valor que você usará posteriormente neste tutorial.
4. Em Atribuir o aplicativo a uma função, atribua o aplicativo à função Colaborador no nível da assinatura para que o aplicativo possa criar data factories na assinatura.

Criar um projeto do Visual Studio

Em seguida, crie um aplicativo de console C# .NET no Visual Studio:

1. Inicie o Visual Studio.
2. Na janela Iniciar, selecione Criar um novo projeto>Aplicativo de Console (.NET Framework). O .NET versão 4.5.2 ou superior é necessário.
3. Em Nome do projeto, insira PurviewQuickStart.
4. Selecione Criar para criar o projeto.

Instalar pacotes NuGet

1. Selecione Ferramentas> Gerenciador >de Pacotes NuGetConsole do Gerenciador de Pacotes.

2. No painel Console do Gerenciador de Pacotes , execute os seguintes comandos para instalar pacotes. Para obter mais informações, consulte Microsoft.Azure. Pacote NuGet Management.Purview.

   Install-Package Microsoft.Azure.Management.Purview
   Install-Package Microsoft.Azure.Management.ResourceManager -IncludePrerelease
   Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory
   

Criar um cliente do Microsoft Purview

1. Abra Program.cs, inclua as instruções a seguir para adicionar referências a namespaces.

   using System;
   using System.Collections.Generic;
   using System.Linq;
   using Microsoft.Rest;
   using Microsoft.Rest.Serialization;
      using Microsoft.Azure.Management.ResourceManager;
   using Microsoft.Azure.Management.Purview;
      using Microsoft.Azure.Management.Purview.Models;
      using Microsoft.IdentityModel.Clients.ActiveDirectory;
   

2. Adicione o código a seguir ao método Main que define as variáveis. Substitua os espaços reservados por seus próprios valores. Para obter uma lista de regiões do Azure nas quais o Microsoft Purview está disponível no momento, pesquise no Microsoft Purview e selecione as regiões que lhe interessam na seguinte página: Produtos disponíveis por região.

   // Set variables
   string tenantID = "<your tenant ID>";
   string applicationId = "<your application ID>";
   string authenticationKey = "<your authentication key for the application>";
   string subscriptionId = "<your subscription ID where the data factory resides>";
   string resourceGroup = "<your resource group where the data factory resides>";
   string region = "<the location of your resource group>";
   string purviewAccountName = 
       "<specify the name of purview account to create. It must be globally unique.>";
   

3. Adicione o código a seguir ao método Main que cria uma instância da classe PurviewManagementClient . Use este objeto para criar uma conta do Microsoft Purview.

   // Authenticate and create a purview management client
   var context = new AuthenticationContext("https://login.windows.net/" + tenantID);
   ClientCredential cc = new ClientCredential(applicationId, authenticationKey);
   AuthenticationResult result = context.AcquireTokenAsync(
   "https://management.azure.com/", cc).Result;
   ServiceClientCredentials cred = new TokenCredentials(result.AccessToken);
   var client = new PurviewManagementClient(cred)
   {
      SubscriptionId = subscriptionId           
   };
   

Criar uma conta

Adicione o código a seguir ao método Main que criará a Conta do Microsoft Purview.

// Create a purview Account
Console.WriteLine("Creating Microsoft Purview Account " + purviewAccountName + "...");
Account account = new Account()
{
Location = region,
Identity = new Identity(type: "SystemAssigned"),
Sku = new AccountSku(name: "Standard", capacity: 4)
};            
try
{
  client.Accounts.CreateOrUpdate(resourceGroup, purviewAccountName, account);
  Console.WriteLine(client.Accounts.Get(resourceGroup, purviewAccountName).ProvisioningState);                
}
catch (ErrorResponseModelException purviewException)
{
Console.WriteLine(purviewException.StackTrace);
  }
  Console.WriteLine(
    SafeJsonConvert.SerializeObject(account, client.SerializationSettings));
  while (client.Accounts.Get(resourceGroup, purviewAccountName).ProvisioningState ==
         "PendingCreation")
  {
    System.Threading.Thread.Sleep(1000);
  }
Console.WriteLine("\nPress any key to exit...");
Console.ReadKey();

Executar o código

Compile e inicie o aplicativo e, em seguida, verifique a execução.

O console imprime o progresso da criação da Conta do Microsoft Purview.

Saída de exemplo

Creating Microsoft Purview Account testpurview...
Succeeded
{
  "sku": {
    "capacity": 4,
    "name": "Standard"
  },
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "southcentralus"
}

Press any key to exit...

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 programaticamente uma conta do Microsoft Purview, adicione as seguintes linhas de código ao programa:

Console.WriteLine("Deleting the Microsoft Purview Account");
client.Accounts.Delete(resourceGroup, purviewAccountName);

Verifique se o nome da conta do Microsoft Purview está disponível

Para marcar a disponibilidade de uma conta do Purview, use o seguinte código:

CheckNameAvailabilityRequest checkNameAvailabilityRequest = newCheckNameAvailabilityRequest()
{
    Name = purviewAccountName,
    Type =  "Microsoft.Purview/accounts"
};
Console.WriteLine("Check Microsoft Purview account name");
Console.WriteLine(client.Accounts.CheckNameAvailability(checkNameAvailabilityRequest).NameAvailable);

O código acima imprimirá 'True' se o nome estiver disponível e 'False' se o nome não estiver disponível.

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 .NET e saber mais sobre outras ações de provedor de recursos que você pode executar para 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