Mulai cepat: Membuat akun Microsoft Purview (sebelumnya Azure Purview) menggunakan .NET SDK

Artikel
06/19/2022
5 menit untuk membaca

Dalam mulai cepat ini, Anda akan menggunakan .NET SDK untuk membuat akun Microsoft Purview (sebelumnya Azure Purview).

Portal tata kelola Microsoft Purview menampilkan alat seperti Peta Data Microsoft Purview dan Katalog Data Microsoft Purview yang membantu Anda mengelola dan mengatur lanskap data Anda. Dengan menyambungkan ke data di seluruh sumber lokal, multi-cloud, dan software-as-a-service (SaaS), Peta Data Microsoft Purview membuat peta terbaru informasi Anda. Ini mengidentifikasi dan mengklasifikasikan data sensitif, dan menyediakan linage end-to-end. Konsumen data dapat menemukan data di seluruh organisasi Anda, dan administrator data dapat mengaudit, mengamankan, dan memastikan penggunaan data Anda dengan benar.

Untuk informasi selengkapnya tentang kemampuan tata kelola Microsoft Purview, sebelumnya Azure Purview, lihat halaman gambaran umum kami. Untuk informasi selengkapnya tentang menyebarkan Microsoft Purview di seluruh organisasi Anda, lihat praktik terbaik penyebaran kami

Prasyarat

Jika Anda tidak memiliki langganan Azure, buat langganan gratis sebelum memulai.
Penyewa Azure Active Directory yang terkait dengan langganan Anda.
Akun pengguna yang Anda gunakan untuk masuk ke Azure harus menjadi anggota peran kontributor atau pemilik , atau administrator langganan Azure. Untuk melihat izin yang Anda miliki dalam langganan, ikuti langkah-langkah berikut:
1. Masuk ke portal Microsoft Azure
2. Pilih nama pengguna Anda di sudut kanan atas.
3. Pilih tombol elipsis ("...") untuk opsi lainnya.
4. Lalu pilih Izin saya.
5. Jika Anda memiliki akses ke beberapa langganan, pilih langganan yang sesuai.
Tidak ada Kebijakan Azure yang mencegah pembuatan Akun penyimpanan atau namespace layanan Event Hub. Microsoft Purview akan menyebarkan akun Storage terkelola dan Azure Event Hubs saat dibuat. Jika ada kebijakan pemblokiran dan perlu tetap diberlakukan, ikuti panduan tag pengecualian Microsoft Purview kami dan ikuti langkah-langkah untuk membuat pengecualian untuk akun Microsoft Purview.

Masuk ke portal Microsoft Azure dengan akun Azure Anda.

Visual Studio

Panduan dalam artikel ini menggunakan Visual Studio 2019. Prosedur untuk Visual Studio 2013, 2015, atau 2017 mungkin sedikit berbeda.

Azure .NET SDK

Unduh dan pasang Azure .NET SDK di komputer Anda.

Membuat aplikasi di Azure Active Directory

Di Buat aplikasi Azure Active Directory, buat aplikasi yang mewakili aplikasi .NET yang Anda buat dalam tutorial ini. Untuk URL masuk, Anda dapat memberikan URL dummy seperti yang ditunjukkan dalam artikel (https://contoso.org/exampleapp).
Di Dapatkan nilai untuk masuk, dapatkan ID aplikasi dan ID penyewa, dan catat nilai-nilai ini yang Anda gunakan nanti dalam tutorial ini.
Dalam Sertifikat dan rahasia, dapatkan kunci autentikasi, dan catat nilai ini yang Anda gunakan nanti dalam tutorial ini.
Di Tetapkan aplikasi ke peran, tetapkan aplikasi ke peran Kontributor pada tingkat langganan sehingga aplikasi dapat membuat pabrik data dalam langganan.

Membuat proyek Visual Studio

Selanjutnya, buat aplikasi konsol C# .NET di Visual Studio:

Luncurkan Visual Studio.
Di jendela Mulai, pilih Buat Aplikasi Konsol proyek baru>(.NET Framework) . Diperlukan .NET versi 4.5.2 atau lebih tinggi.
Di Nama proyek, masukkan PurviewQuickStart.
Pilih Buat untuk membuat proyek.

Pasang paket NuGet

Pilih Alat>Manajer Paket NuGet>Konsol Manajer Paket.

Di panel Konsol Manajer Paket, jalankan perintah berikut untuk memasang paket. Untuk informasi selengkapnya, lihat paket NuGet Microsoft.Azure.Management.Purview.

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

Membuat klien Microsoft Purview

Buka Program.cs, termasuk pernyataan berikut untuk menambahkan referensi ke kumpulan nama XML.

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;

Tambahkan kode berikut ke metode Utama yang mengatur variabel. Ganti tempat penampung dengan nilai Anda. Untuk daftar wilayah Azure tempat Microsoft Purview saat ini tersedia, cari di Microsoft Purview dan pilih wilayah yang Anda minati di halaman berikut: Produk yang tersedia menurut wilayah.

// 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.>";

Tambahkan kode berikut ke metode Utama yang membuat instans kelas PurviewManagementClient. Anda menggunakan objek ini untuk membuat Akun 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           
};

Buat akun

Tambahkan kode berikut ke metode Utama yang akan membuat Akun 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();

Menjalankan kode

Bangun dan mulai aplikasi, lalu verifikasi eksekusi.

Konsol mencetak kemajuan pembuatan Akun Microsoft Purview.

Sampel output

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

Press any key to exit...

Verifikasi output

Buka halaman akun Microsoft Purview di portal Azure dan verifikasi akun yang dibuat menggunakan kode di atas.

Menghapus akun Microsoft Purview

Untuk menghapus akun Microsoft Purview secara terprogram, tambahkan baris kode berikut ke program:

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

Periksa apakah nama akun Microsoft Purview tersedia

Untuk memeriksa ketersediaan akun Purview, gunakan kode berikut:

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

Kode di atas dengan cetak 'True' jika nama tersedia dan 'False' jika nama tidak tersedia.

Langkah berikutnya

Dalam mulai cepat ini, Anda mempelajari cara membuat akun Microsoft Purview (sebelumnya Azure Purview), menghapus akun, dan memeriksa ketersediaan nama. Sekarang Anda dapat mengunduh .NET SDK dan mempelajari tentang tindakan penyedia sumber daya lain yang dapat Anda lakukan untuk akun Microsoft Purview.

Ikuti artikel berikutnya ini untuk mempelajari cara menavigasi portal tata kelola Microsoft Purview, membuat koleksi, dan memberikan akses ke portal tata kelola Microsoft Purview.