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:

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.

  1. 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.
    Tier Standar Tingkat SKU.
    kapasitas number Jumlah instans kluster.
    resourceGroupName testrg Nama grup sumber daya tempat kluster akan dibuat.

    Catatan

    Membuat kluster adalah operasi yang berjalan lama, jadi sangat disarankan untuk menggunakan CreateOrUpdateAsync, bukan CreateOrUpdate.

  2. Jalankan perintah berikut untuk memeriksa apakah kluster Anda berhasil dibuat:

    clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
    
  3. Konfirmasikan keberhasilan pembuatan kluster dengan memverifikasi hasilnya berisi provisioningState sebagai Succeeded.

Membuat database Azure Data Explorer

Di bagian ini, Anda akan membuat database dalam kluster yang dibuat di bagian sebelumnya.

  1. 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 tetap tersedia untuk kueri.
    hotCachePeriod 3650:00:00:00 Jumlah waktu data akan disimpan dalam cache.
  2. Jalankan perintah berikut untuk melihat database yang Anda buat:

    databaseData = (await databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;
    

Langkah selanjutnya