Краткое руководство. Создание учетной записи Microsoft Purview (ранее Azure Purview) с помощью пакета SDK для .NET
Важно!
Для каждого клиента можно создать только одну учетную запись Microsoft Purview. Дополнительные сведения см. в разделе Вопросы и ответы.
В этом кратком руководстве вы будете использовать пакет SDK для .NET для создания учетной записи Microsoft Purview (прежнее название — Azure Purview).
Портал управления Microsoft Purview предоставляет такие инструменты, как Схема данных Microsoft Purview и Каталог данных Microsoft Purview, которые помогают управлять ландшафтом данных и управлять ими. При подключении к данным в локальных, многооблачных источниках и saaS (программное обеспечение как услуга) Схема данных Microsoft Purview создает актуальную карту вашей информации. Он идентифицирует и классифицирует конфиденциальные данные, а также предоставляет сквозную структуру. Потребители данных могут обнаруживать данные в организации, а администраторы данных могут проводить аудит, защищать и обеспечивать правильное использование данных.
Дополнительные сведения о возможностях управления Microsoft Purview см. на странице обзоров решений для управления. Дополнительные сведения о развертывании Microsoft Purview в организации см. в наших рекомендациях по развертыванию.
Предварительные требования
Если у вас нет подписки Azure, создайте бесплатную подписку перед началом работы.
Клиент Azure Active Directory, связанный с вашей подпиской.
Учетная запись пользователя, используемая для входа в Azure, должна быть членом участник роли владельца или администратора подписки Azure. Чтобы просмотреть разрешения, которые у вас есть в подписке, выполните следующие действия:
- Перейдите к портал Azure
- Выберите имя пользователя в правом верхнем углу.
- Нажмите кнопку с многоточием ("...") для получения дополнительных параметров.
- Затем выберите Мои разрешения.
- Если у вас есть доступ к нескольким подпискам, выберите соответствующую подписку.
Нет политик Azure , препятствующих созданию или обновлению учетных записей хранения. Microsoft Purview развернет управляемую учетную запись хранения при ее создании. Если политика блокировки существует и должна оставаться в силе, следуйте инструкциям в руководстве по тегам исключений Microsoft Purview и выполните действия по созданию исключения для учетных записей Microsoft Purview.
Вход в Azure
Войдите в портал Azure с помощью учетной записи Azure.
Visual Studio
В этом пошаговом руководстве используется Visual Studio 2019. Процедуры для Visual Studio 2013, 2015 или 2017 годах могут немного отличаться.
Azure .NET SDK
Скачайте и установите пакет SDK для Azure .NET на компьютере.
Создание приложения в Azure Active Directory
- В разделе Создание приложения Azure Active Directory создайте приложение, представляющее приложение .NET, которое вы создаете в этом руководстве. Для URL-адреса входа можно указать фиктивный URL-адрес, как показано в статье (
https://contoso.org/exampleapp). - В разделе Получение значений для входа получите идентификатор приложения и идентификатор клиента и запишите эти значения, которые будут использоваться далее в этом руководстве.
- В разделе Сертификаты и секреты получите ключ проверки подлинности и запишите это значение, которое будет использоваться далее в этом руководстве.
- В разделе Назначение приложения роли назначьте приложению роль Участник на уровне подписки, чтобы приложение о 20000 000 в подписке создавало фабрики данных.
Создание проекта Visual Studio
Затем создайте консольное приложение C# .NET в Visual Studio:
- Запустите Visual Studio.
- В окне Пуск выберите Создать консольное приложение проекта>(платформа .NET Framework). Требуется .NET версии 4.5.2 или более поздней.
- В поле Имя проекта введите PurviewQuickStart.
- Выберите Создать , чтобы создать проект.
Установка пакетов Nuget
Выберите Инструменты>Консоль диспетчера>пакетов NuGet.
В области консоли диспетчера пакетов выполните следующие команды, чтобы установить пакеты. Дополнительные сведения см . в пакете 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 в качестве источника в сети.
- Перейдите к разделу "Инструменты"
- Выбор диспетчера пакетов NuGet
- Выбор параметров управления пакетами
- Выбор источников пакетов
- Добавьте https://nuget.org/api/v2/ в качестве источника.
Создание клиента Microsoft Purview
Откройте файл 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;Добавьте следующий код в метод 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.>";Добавьте следующий код в метод 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.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по