Guida introduttiva: Creare un account Microsoft Purview (in precedenza Azure Purview) con .NET SDK

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 userà .NET SDK per creare un account Microsoft Purview (in precedenza Azure Purview).

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

Visual Studio

La procedura dettagliata in questo articolo usa Visual Studio 2019. Le procedure per Visual Studio 2013, 2015 o 2017 possono essere leggermente diverse.

Azure .NET SDK

Scaricare e installare Azure .NET SDK nel computer.

Creare un'applicazione in Microsoft Entra ID

1. In Creare un'applicazione Microsoft Entra creare un'applicazione che rappresenta l'applicazione .NET che si sta creando in questa esercitazione. Per l'URL di accesso, è possibile specificare un URL fittizio, come illustrato nell'articolo (https://contoso.org/exampleapp).
2. In Ottenere i valori per l'accesso ottenere l'ID applicazione e l'IDtenant e prendere nota di questi valori usati più avanti in questa esercitazione.
3. In Certificati e segreti ottenere la chiave di autenticazione e prendere nota di questo valore usato più avanti in questa esercitazione.
4. In Assegnare l'applicazione a un ruolo assegnare l'applicazione al ruolo Collaboratore a livello di sottoscrizione in modo che l'applicazione possa creare data factory nella sottoscrizione.

Creare un progetto di Visual Studio

Creare quindi un'applicazione console .NET C# in Visual Studio:

1. Avviare Visual Studio.
2. Nella finestra Start selezionare Crea una nuovaapp console di progetto> (.NET Framework). È necessaria .NET versione 4.5.2 o successiva.
3. In Nome progetto immettere PurviewQuickStart.
4. Selezionare Crea per creare il progetto.

Installare pacchetti NuGet

1. Selezionare Strumenti>Console di Gestione pacchetti Di Gestione>pacchetti NuGet.

2. Nel riquadro Console di Gestione pacchetti eseguire i comandi seguenti per installare i pacchetti. Per altre informazioni, vedere il pacchetto NuGet Microsoft.Azure.Management.Purview.

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

Consiglio

Se viene visualizzato un errore che indica <che il nome> del pacchetto non è presente nelle origini primarie seguenti: ed elenca una cartella locale, è necessario aggiornare le origini del pacchetto in Visual Studio per includere il sito nuget come origine online.

1. Passare a Strumenti
2. Selezionare Gestione pacchetti NuGet
3. Selezionare Package Manage Settings (Gestisci pacchetti)
4. Selezionare Origini pacchetto
5. Aggiungere https://nuget.org/api/v2/ come origine.

Creare un client Microsoft Purview

1. Aprire Program.cs, includere le istruzioni seguenti per aggiungere riferimenti agli spazi dei nomi.

   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. Aggiungere il codice seguente al metodo Main che imposta le variabili. Sostituire i segnaposto con i propri valori. Per un elenco delle aree di Azure in cui Microsoft Purview è attualmente disponibile, cercare in Microsoft Purview e selezionare le aree di interesse nella pagina seguente: Prodotti disponibili per area.

   // 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. Aggiungere il codice seguente al metodo Main che crea un'istanza della classe PurviewManagementClient . Questo oggetto viene usato per creare un account 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           
   };
   

Crea un account

Aggiungere il codice seguente al metodo Main che creerà l'account 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();

Eseguire il codice

Compilare e avviare l'applicazione, quindi verificare l'esecuzione.

La console visualizza lo stato di avanzamento della creazione dell'account Microsoft Purview.

Output di esempio

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

Press any key to exit...

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 a livello di codice un account Microsoft Purview, aggiungere le righe di codice seguenti al programma:

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

Verificare se il nome dell'account Microsoft Purview è disponibile

Per controllare la disponibilità di un account purview, usare il codice seguente:

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

Il codice precedente con la stampa 'True' se il nome è disponibile e 'False' se il nome non è disponibile.

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

• Come usare il portale di governance di Microsoft Purview
• Concedere agli utenti le autorizzazioni per il portale di governance
• Creare una raccolta