Поделиться через

Краткое руководство. Создание учетной записи Microsoft Purview (ранее Azure Purview) с помощью пакета SDK для .NET

  • Статья

Примечание.

Каталог данных Microsoft Purview (классическая) и Аналитика работоспособности данных (классическая) больше не берут на себя новых клиентов, и эти службы, ранее Azure Purview, теперь находятся в режиме поддержки клиентов.

Важно!

Для каждого клиента можно создать только одну учетную запись Microsoft Purview. Если в вашей организации уже есть учетная запись Microsoft Purview, вы не сможете создать новую учетную запись Microsoft Purview, если в вашей организации уже есть несколько учетных записей и она по-прежнему находится под уже существующей квотой. Дополнительные сведения см . в разделе Вопросы и ответы.

В этом кратком руководстве вы будете использовать пакет SDK для .NET для создания учетной записи Microsoft Purview (прежнее название — Azure Purview).

Портал управления Microsoft Purview предоставляет такие инструменты, как Схема данных Microsoft Purview и Каталог данных Microsoft Purview, которые помогают управлять ландшафтом данных и управлять ими. При подключении к данным в локальных, многооблачных источниках и saaS (программное обеспечение как услуга) Схема данных Microsoft Purview создает актуальную карту вашей информации. Он идентифицирует и классифицирует конфиденциальные данные, а также предоставляет сквозную структуру. Потребители данных могут обнаруживать данные в организации, а администраторы данных могут проводить аудит, защищать и обеспечивать правильное использование данных.

Дополнительные сведения о возможностях классического управления Microsoft Purview см. на странице обзоров решений для управления.

Предварительные условия

  • Если у вас нет подписки Azure, создайте бесплатную подписку перед началом работы.

  • Клиент Microsoft Entra, связанный с вашей подпиской.

  • Учетная запись пользователя, используемая для входа в Azure, должна быть членом участник роли владельца или администратора подписки Azure. Чтобы просмотреть разрешения, которые у вас есть в подписке, выполните следующие действия:

    1. Перейдите к портал Azure
    2. Выберите имя пользователя в правом верхнем углу.
    3. Нажмите кнопку с многоточием ("...") для получения дополнительных параметров.
    4. Затем выберите Мои разрешения.
    5. Если у вас есть доступ к нескольким подпискам, выберите соответствующую подписку.

Вход в Azure

Войдите в портал Azure с помощью учетной записи Azure.

Visual Studio

В этом пошаговом руководстве используется Visual Studio 2019. Процедуры для Visual Studio 2013, 2015 или 2017 годах могут немного отличаться.

Azure .NET SDK

Скачайте и установите пакет SDK для Azure .NET на компьютере.

Создание приложения в Microsoft Entra ID

  1. В разделе Создание приложения Microsoft Entra создайте приложение, представляющее приложение .NET, которое вы создаете в этом руководстве. Для URL-адреса входа можно указать фиктивный URL-адрес, как показано в статье (https://contoso.org/exampleapp).
  2. В разделе Получение значений для входа получите идентификатор приложения и идентификатор клиента и запишите эти значения, которые будут использоваться далее в этом руководстве.
  3. В разделе Сертификаты и секреты получите ключ проверки подлинности и запишите это значение, которое будет использоваться далее в этом руководстве.
  4. В разделе Назначение приложения роли назначьте приложению роль Участник на уровне подписки, чтобы приложение о 20000 000 в подписке создавало фабрики данных.

Создание проекта Visual Studio

Затем создайте консольное приложение C# .NET в Visual Studio:

  1. Запустите Visual Studio.
  2. В окне Пуск выберите Создать консольное приложение проекта>(платформа .NET Framework). Требуется .NET версии 4.5.2 или более поздней.
  3. В поле Имя проекта введите PurviewQuickStart.
  4. Выберите Создать , чтобы создать проект.

Установка пакетов Nuget

  1. Выберите Инструменты>Консоль диспетчера>пакетов NuGet.

  2. В области консоли диспетчера пакетов выполните следующие команды, чтобы установить пакеты. Дополнительные сведения см . в пакете NuGet Microsoft.Azure.Management.Purview.

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

Совет

Если появляется сообщение об ошибке: Имя> пакета пакета <не найдено в следующих первичных источниках и отображает локальную папку, необходимо обновить источники пакетов в Visual Studio, чтобы включить сайт Nuget в качестве источника в сети.

  1. Перейдите к разделу "Инструменты"
  2. Выбор диспетчера пакетов NuGet
  3. Выбор параметров управления пакетами
  4. Выбор источников пакетов
  5. Добавьте https://nuget.org/api/v2/ в качестве источника.

Создание клиента Microsoft Purview

  1. Откройте Program.cs, добавьте следующие инструкции для добавления ссылок на пространства имен.

    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. Добавьте следующий код в метод Main , который задает переменные. Замените заполнители собственными значениями. Список регионов Azure, в которых в настоящее время доступен Microsoft Purview, выполните поиск в Microsoft Purview и выберите интересующие вас регионы на следующей странице : Продукты, доступные по регионам.

    // 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. Добавьте следующий код в метод Main , который создает экземпляр класса PurviewManagementClient . Этот объект используется для создания учетной записи 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           
};

Создание учетной записи

Добавьте следующий код в метод Main , который создаст учетную запись 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();

Выполнение кода

Выполните сборку и запуск приложения, а затем проверьте выполнение.

Консоль выводит ход создания учетной записи Microsoft Purview.

Пример выходных данных

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

Press any key to exit...

Проверка выходных данных

Перейдите на страницу учетных записей Microsoft Purview в портал Azure и проверьте учетную запись, созданную с помощью приведенного выше кода.

Удаление учетной записи Microsoft Purview

Чтобы программно удалить учетную запись Microsoft Purview, добавьте в программу следующие строки кода:

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

Проверка доступности имени учетной записи Microsoft Purview

Чтобы проверка доступность учетной записи purview, используйте следующий код:

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

Приведенный выше код с печатью "True", если имя доступно, и "False", если имя недоступно.

Дальнейшие действия

Из этого краткого руководства вы узнали, как создать учетную запись Microsoft Purview (ранее — Azure Purview), удалить учетную запись и проверка для доступности имен. Теперь вы можете скачать пакет SDK для .NET и узнать о других действиях поставщика ресурсов, которые можно выполнить для учетной записи Microsoft Purview.

В следующих статьях вы узнаете, как перейти на портал управления Microsoft Purview, создать коллекцию и предоставить доступ к порталу управления Microsoft Purview.