Membuat klaster dan database Azure Data Explorer
Azure Data Explorer adalah layanan analitik data yang cepat dan terkelola sepenuhnya untuk analisis real time pada aliran data dalam jumlah besar dari aplikasi, situs web, perangkat IoT, dan banyak lagi. Untuk menggunakan Azure Data Explorer, Anda terlebih dahulu membuat kluster, dan membuat satu atau beberapa database di kluster tersebut. Kemudian, Anda dapat menyerap (memuat) data ke dalam database dan menjalankan kueri terhadapnya.
Dalam artikel ini, Anda akan mempelajari cara membuat kluster dan database menggunakan templat C#, Python, Go, Azure CLI, PowerShell, atau Azure Resource Manager (ARM). Untuk mempelajari cara membuat kluster dan database menggunakan portal Azure, lihat Mulai Cepat: Membuat kluster dan database Azure Data Explorer.
Untuk sampel kode berdasarkan versi SDK sebelumnya, lihat artikel yang diarsipkan.
Prasyarat
Prasyarat berdasarkan metode pembuatan kluster dan database:
- Langganan Azure. Membuat akun Azure gratis.
- Visual Studio 2022 Community Edition. Aktifkan pengembangan Azure selama penyiapan Visual Studio.
- Instal paket Microsoft.Azure.Management.Kusto NuGet.
- Aplikasi Microsoft Entra dan perwakilan layanan yang dapat mengakses sumber daya. Simpan ID Direktori (penyewa), ID Aplikasi, dan Rahasia Klien.
Membuat kluster Azure Data Explorer
Bagian ini memandu Anda melalui proses pembuatan kluster Azure Data Explorer. Pilih tab yang relevan untuk metode pilihan Anda untuk membuat kluster.
Buat kluster Anda dengan menggunakan kode berikut:
var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Directory (tenant) ID var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Application ID var clientSecret = "PlaceholderClientSecret"; //Client Secret var subscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; var credentials = new ClientSecretCredential(tenantId, clientId, clientSecret); var resourceManagementClient = new ArmClient(credentials, subscriptionId); var resourceGroupName = "testrg"; var subscription = await resourceManagementClient.GetDefaultSubscriptionAsync(); var resourceGroup = (await subscription.GetResourceGroupAsync(resourceGroupName)).Value; var clusters = resourceGroup.GetKustoClusters(); var clusterName = "mykustocluster"; var skuName = KustoSkuName.StandardE8adsV5; var skuTier = KustoSkuTier.Standard; var capacity = 5; var clusterData = new KustoClusterData( location: AzureLocation.CentralUS, sku: new KustoSku(skuName, skuTier) { Capacity = capacity } ); await clusters.CreateOrUpdateAsync(WaitUntil.Completed, clusterName, clusterData);
Pengaturan Nilai yang disarankan Deskripsi bidang clusterName mykustocluster Nama kluster yang diinginkan. skuName Standard_E8ads_v5 SKU yang akan digunakan untuk kluster Anda. tingkat Standard Tingkat SKU. kapasitas number Jumlah instans kluster. resourceGroupName testrg Nama grup sumber daya tempat kluster akan dibuat. Catatan
Membuat kluster adalah operasi jangka panjang, jadi sangat disarankan untuk menggunakan CreateOrUpdateAsync, alih-alih CreateOrUpdate.
Jalankan perintah berikut untuk memeriksa apakah kluster Anda berhasil dibuat:
clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
Konfirmasikan keberhasilan pembuatan kluster dengan memverifikasi hasilnya berisi
provisioningState
sebagaiSucceeded
.
Membuat database Azure Data Explorer
Di bagian ini, Anda akan membuat database dalam kluster yang dibuat di bagian sebelumnya.
Buat database Anda dengan menggunakan kode berikut:
var cluster = (await clusters.GetAsync(clusterName)).Value; var databases = cluster.GetKustoDatabases(); var databaseName = "mykustodatabase"; var softDeletePeriod = TimeSpan.FromDays(3650); var hotCachePeriod = TimeSpan.FromDays(3650); var databaseData = new KustoReadWriteDatabase { Location = clusterData.Location, SoftDeletePeriod = softDeletePeriod, HotCachePeriod = hotCachePeriod }; await databases.CreateOrUpdateAsync(WaitUntil.Completed, databaseName, databaseData);
Catatan
Jika Anda menggunakan C# versi 2.0.0 atau di bawahnya, gunakan Database alih-alih ReadWriteDatabase.
Pengaturan Nilai yang disarankan Deskripsi bidang clusterName mykustocluster Nama kluster Anda tempat database akan dibuat. databaseName mykustodatabase Nama database Anda. resourceGroupName testrg Nama grup sumber daya tempat kluster akan dibuat. softDeletePeriod 3650:00:00:00 Jumlah waktu data akan disimpan tersedia untuk kueri. hotCachePeriod 3650:00:00:00 Jumlah waktu data akan disimpan dalam cache. Jalankan perintah berikut untuk melihat database yang Anda buat:
databaseData = (await databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;