빠른 시작: .NET SDK를 사용하여 Microsoft Purview(이전의 Azure Purview) 계정 만들기

  • 아티클

중요

테넌트당 하나의 Microsoft Purview 계정만 만들 수 있습니다. 자세한 내용은 FAQ를 참조하세요.

이 빠른 시작에서는 .NET SDK 를 사용하여 Microsoft Purview(이전의 Azure Purview) 계정을 만듭니다.

Microsoft Purview 거버넌스 포털은 데이터 환경을 관리하고 관리하는 데 도움이 되는 Microsoft Purview 데이터 맵 및 Microsoft Purview 데이터 카탈로그 같은 도구를 제공합니다. 온-프레미스, 다중 클라우드 및 SaaS(Software as a Service) 원본의 데이터에 연결하면 Microsoft Purview 데이터 맵 정보의 최신 맵을 만듭니다. 중요한 데이터를 식별하고 분류하며 엔드 투 엔드 Linage를 제공합니다. 데이터 소비자는 organization 전체에서 데이터를 검색할 수 있으며, 데이터 관리자는 데이터의 올바른 사용을 감사, 보안 및 보장할 수 있습니다.

Microsoft Purview의 거버넌스 기능에 대한 자세한 내용은 거버넌스 솔루션 개요 페이지를 참조하세요. organization Microsoft Purview 배포에 대한 자세한 내용은 배포 모범 사례를 참조하세요.

필수 조건

  • Azure 구독이 없는 경우 시작하기 전에 무료 구독 을 만듭니다.

  • 구독과 연결된 Azure Active Directory 테넌트 입니다.

  • Azure에 로그인하는 데 사용하는 사용자 계정은 기여자 또는 소유자 역할의 구성원이거나 Azure 구독의 관리자여야 합니다. 구독에 있는 권한을 보려면 다음 단계를 수행합니다.

    1. Azure Portal
    2. 오른쪽 위 모서리에서 사용자 이름을 선택합니다.
    3. 더 많은 옵션을 보려면 줄임표 단추("...")를 선택합니다.
    4. 그런 다음 , 내 권한을 선택합니다.
    5. 여러 구독에 액세스할 수 있는 경우 적절한 구독을 선택합니다.

  • 스토리지 계정을 만들거나 업데이트하는 것을 방지하는 Azure 정책이 없습니다. Microsoft Purview는 관리되는 Storage 계정을 만들 때 배포합니다. 차단 정책이 존재하고 그대로 유지해야 하는 경우 Microsoft Purview 예외 태그 가이드에 따라 Microsoft Purview 계정에 대한 예외를 만드는 단계를 수행하세요.

Azure에 로그인

Azure 계정으로 Azure Portal 로그인합니다.

Visual Studio

이 문서의 연습에서는 Visual Studio 2019를 사용합니다. Visual Studio 2013, 2015 또는 2017에 대한 절차는 약간 다를 수 있습니다.

Azure .NET SDK

컴퓨터에 Azure .NET SDK 를 다운로드하여 설치합니다.

Azure Active Directory에서 애플리케이션 만들기

  1. Azure Active Directory 애플리케이션 만들기에서 이 자습서에서 만드는 .NET 애플리케이션을 나타내는 애플리케이션을 만듭니다. 로그온 URL의 경우 문서(https://contoso.org/exampleapp)에 표시된 것처럼 더미 URL을 제공할 수 있습니다.
  2. 로그인할 값 가져오기에서애플리케이션 ID 및 테넌트 ID를 가져오고 이 자습서의 뒷부분에서 사용하는 이러한 값을 적어둡니다.
  3. 인증서 및 비밀에서 인증 키를 가져와서 이 자습서의 뒷부분에서 사용하는 이 값을 적어둡니다.
  4. 애플리케이션을 역할에 할당에서 애플리케이션이 구독에 데이터 팩터리를 만들 수 있도록 구독 수준에서 기여자 역할에 애플리케이션을 할당합니다.

Visual Studio 프로젝트 만들기

다음으로 Visual Studio에서 C# .NET 콘솔 애플리케이션을 만듭니다.

  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

팁

다음 기본 원본에서 패키지 <패키지 이름을> 찾을 수 없으며 로컬 폴더를 나열하는 경우 Nuget 사이트를 온라인 원본으로 포함하도록 Visual Studio에서 패키지 원본을 업데이트해야 합니다.

  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. PurviewManagementClient 클래스의 instance 만드는 Main 메서드에 다음 코드를 추가합니다. 이 개체를 사용하여 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...

출력 확인

Azure PortalMicrosoft 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 거버넌스 포털에 대한 액세스 권한을 부여하는 방법을 알아봅니다.