快速入门:使用 .NET SDK 创建 Microsoft Purview(以前称为 Azure Purview)帐户

重要

对于每个租户,只能创建一个 Microsoft Purview 帐户。 如果你的组织已有 Microsoft Purview 帐户,则你将无法创建新的 Microsoft Purview 帐户,除非你的组织已有多个帐户,并且仍有预先存在的配额。 有关详细信息,请参阅常见问题解答

在本快速入门中,你将使用 .NET SDK 创建 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

在计算机上下载并安装 Azure .NET SDK

在 Microsoft Entra ID 中创建应用程序

  1. 创建 Microsoft Entra 应用程序中,创建一个应用程序来表示要在本教程中创建的 .NET 应用程序。 对于登录 URL,可以提供虚拟 URL,如本文中所示 (https://contoso.org/exampleapp)。
  2. 获取用于登录的值中,获取应用程序 ID 和租户 ID,并记下这些值,稍后要在本教程中使用它们 。
  3. 证书与机密中,获取身份验证密钥,并记此值,稍后要在本教程中使用它。
  4. 将应用程序分配给角色中,在订阅级别将应用程序分配到“参与者”角色,让该应用程序可以在订阅中创建数据工厂。

创建 Visual Studio 项目

接下来,在 Visual Studio 中创建 C# 控制台应用程序:

  1. 启动 Visual Studio
  2. 在“开始”窗口中,选择“创建新项目”>“控制台应用(.NET Framework)” 。 需要 .NET 4.5.2 或更高版本。
  3. 在“项目名称”中,输入“PurviewQuickStart” 。
  4. 选择“创建”来创建项目。

安装 NuGet 包

  1. 选择“工具”>“NuGet 包管理器”>“包管理器控制台”。

  2. 在“包管理器控制台”窗格中,运行以下命令来安装包。 有关详细信息,请参阅 Microsoft.Azure.Management.Purview NuGet 包

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

提示

如果你收到一个错误,其中显示:“在以下主要源中找不到包 <package name>:”,并且其中列出了一个本地文件夹,那么你需要在 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 方法以设置变量。 将占位符替换为自己的值。 若要查看目前提供 Microsoft Purview 的 Azure 区域列表,请在 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.chinacloudapi.cn/" + tenantID);
    ClientCredential cc = new ClientCredential(applicationId, authenticationKey);
    AuthenticationResult result = context.AcquireTokenAsync(
    "https://management.chinacloudapi.cn/", 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": "chinanorth3"
}

Press any key to exit...

验证输出

转到 Azure 门户的“Microsoft Purview 帐户”页,并验证使用上述代码创建的帐户。

删除 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)帐户、删除帐户以及检查名称可用性。 你现可下载 .NET SDK,并了解你可以对 Microsoft Purview 帐户执行的其他资源提供程序操作。

请按照接下来的这些文章学习如何导航 Microsoft Purview 治理门户、创建集合以及授予对 Microsoft Purview 治理门户的访问权限。