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

Observação

Mapa de Dados do Microsoft Purview (clássico), Catálogo de Dados (clássico), o Data Health Insights (clássico) já não assume novos clientes e estes serviços, anteriormente Azure Purview, estão agora no modo de suporte ao cliente.

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á utilizar o SDK .NET para criar uma conta do Microsoft Purview (anteriormente Azure Purview).

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), multicloud 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.

Iniciar sessão no Azure

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

Visual Studio

As instruções neste artigo utilizam o Visual Studio 2019. Os procedimentos para Visual Studio 2013, 2015 ou 2017 podem diferir ligeiramente.

Azure .NET SDK

Transfira e instale o SDK .NET do Azure no seu computador.

Criar uma aplicação no Microsoft Entra ID

1. Em Criar uma aplicação Microsoft Entra, crie uma aplicação que represente a aplicação .NET que está a criar neste tutorial. Para o URL de início de sessão, pode fornecer um URL fictício, conforme mostrado no artigo (https://contoso.org/exampleapp).
2. Em Obter valores para iniciar sessão, obtenha o ID da aplicação e o ID do inquilino e anote estes valores que irá utilizar mais à frente neste tutorial.
3. Em Certificados e segredos, obtenha a chave de autenticação e anote este valor que irá utilizar mais à frente neste tutorial.
4. Em Atribuir a aplicação a uma função, atribua a aplicação à função Contribuidor ao nível da subscrição para que a aplicação possa criar fábricas de dados na subscrição.

Criar um projeto do Visual Studio

Em seguida, crie uma aplicação de consola .NET C# no Visual Studio:

1. Inicie o Visual Studio.
2. Na janela Iniciar, selecione Criar um novo projeto>Aplicação de Consola (.NET Framework). É necessária a versão 4.5.2 ou superior do .NET.
3. Em Nome do projeto, introduza PurviewQuickStart.
4. Selecione Criar para criar o projeto.

Instalar pacotes NuGet

1. Selecione Ferramentas>Consola do Gestor de Pacotes do Gestor > dePacotes NuGet.

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

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

Dica

Se estiver a receber um erro que diz: O <nome> do pacote não é encontrado nas seguintes origens primárias: e está a listar uma pasta local, tem de atualizar as origens do pacote no Visual Studio para incluir o site nuget como uma origem online.

1. Aceda a Ferramentas
2. Selecione Gestor de Pacotes NuGet
3. Selecionar Definições de Gestão de Pacotes
4. Selecionar Origens do Pacote
5. Adicionar https://nuget.org/api/v2/ como origem.

Criar um cliente do Microsoft Purview

1. Abra Program.cs, inclua as seguintes instruções para adicionar referências a espaços de nomes.

   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 seguinte código ao método Main que define as variáveis. Substitua os marcadores de posição pelos seus próprios valores. Para obter uma lista das regiões do Azure nas quais o Microsoft Purview está atualmente disponível, procure no Microsoft Purview e selecione as regiões que lhe interessam na página seguinte: 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 seguinte código ao método Main que cria uma instância da classe PurviewManagementClient . Utilize 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 seguinte código ao método Main que irá 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

Crie e inicie a aplicação e, em seguida, verifique a execução.

A consola 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

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

Eliminar conta do Microsoft Purview

Para eliminar 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);

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

Para marcar disponibilidade de uma conta do Purview, utilize 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 com a impressão "Verdadeiro" se o nome estiver disponível e "Falso" se o nome não estiver disponível.

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 .NET 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.

• Como utilizar o portal de governação do Microsoft Purview
• Conceder permissões aos utilizadores para o portal de governação
• Criar um conjunto