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, Bicep, 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:

Templat ARM

• Langganan Azure. Membuat akun Azure gratis.

Bisep

• Langganan Azure. Membuat akun Azure gratis.

PowerShell

• Siapkan lingkungan Anda menggunakan instruksi dalam Menggunakan cmdlet Kusto di Azure PowerShell.

C#

• 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 prinsipal layanan yang dapat mengakses sumber daya. Simpan ID Direktori (tenant), ID Aplikasi, dan Rahasia Klien.

Python

• Langganan Azure. Membuat akun Azure gratis.
• Python 3.4+.
• Instal paket azure-common dan azure-mgmt-kusto.
• Aplikasi Microsoft Entra dan perwakilan layanan yang dapat mengakses sumber daya. Simpan ID Direktori (penyewa), ID Aplikasi, dan Rahasia Klien.

Go

• Langganan Azure. Membuat akun Azure gratis.
• Pasang Git.
• Instal versi Go yang sesuai. Untuk versi yang didukung, lihat Modul Azure Kusto untuk Go.
• Aplikasi Microsoft Entra dan perwakilan layanan yang dapat mengakses sumber daya. Simpan ID Direktori (penyewa), ID Aplikasi, dan Rahasia Klien.

Azure CLI

Important

Ekstensi Kusto untuk Azure CLI kedaluarsa dan tidak dipertahankan. Sebaiknya gunakan templat PowerShell atau ARM/Bicep untuk pembuatan kluster dan database. Jika Anda memilih untuk menggunakan Azure CLI, pastikan untuk menginstal ekstensi Kusto untuk memastikan Anda memiliki perintah CLI terbaru untuk Azure Data Explorer.

• Langganan Azure. Membuat akun Azure gratis.
• Anda dapat menggunakan Azure Cloud Shell untuk menjalankan kode dalam artikel ini tanpa harus menginstal apa pun di lingkungan lokal Anda.
• Jika Anda memilih untuk menginstal dan menggunakan Azure CLI secara lokal, ikuti langkah-langkah dalam Mengonfigurasi parameter. Artikel ini memerlukan Azure CLI versi 2.0.4 atau yang lebih baru. Jalankan az --version untuk memeriksa versi Anda. Jika Anda perlu memasang atau meningkatkan, Pasang Azure CLI.

Konfigurasikan parameter CLI

Langkah-langkah berikut ini tidak diperlukan jika Anda menjalankan perintah di Azure Cloud Shell. Jika Anda menjalankan CLI secara lokal, ikuti langkah-langkah berikut untuk menyiapkan lingkungan:

1. Instal ekstensi untuk menggunakan versi CLI Kusto terbaru:

   az extension add -n kusto
   

2. Jalankan perintah berikut untuk masuk ke Azure:

   az login
   

3. Atur langganan tempat Anda ingin kluster Anda dibuat. Ganti MyAzureSub dengan nama langganan Azure yang ingin Anda gunakan:

   az account set --subscription MyAzureSub
   

4. Atur grup sumber daya tempat Anda ingin kluster Anda dibuat. Ganti testrg dengan nama grup sumber daya yang ingin Anda gunakan:

   az group create --name testrg --location westus
   

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.

Templat ARM

Templat ARM

Di bawah ini adalah contoh templat ARM yang membuat kluster Azure Data Explorer dan database dalam kluster tersebut dengan konfigurasi minimal. Untuk detail lengkap dan properti yang didukung, lihat referensi kluster templat ARM dan referensi database templat ARM.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "clusters_kustocluster_name": {
            "type": "string",
            "defaultValue": "[concat('kusto', uniqueString(resourceGroup().id))]",
            "metadata": {
                "description": "Name of the cluster to create"
            }
        },
        "databases_kustodb_name": {
            "type": "string",
            "defaultValue": "kustodb",
            "metadata": {
                "description": "Name of the database to create"
            }
        },
        "location": {
            "type": "string",
            "defaultValue": "[resourceGroup().location]",
            "metadata": {
                "description": "Location for all resources."
            }
        }
    },
    "variables": {},
    "resources": [
        {
            "name": "[parameters('clusters_kustocluster_name')]",
            "type": "Microsoft.Kusto/clusters",
            "apiVersion": "2025-02-14",
            "location": "[parameters('location')]",
            "sku": {
                "name": "Standard_E8ads_v5",
                "tier": "Standard",
                "capacity": 2
            }
        },
        {
            "name": "[concat(parameters('clusters_kustocluster_name'), '/', parameters('databases_kustodb_name'))]",
            "type": "Microsoft.Kusto/clusters/databases",
            "apiVersion": "2025-02-14",
            "location": "[parameters('location')]",
            "dependsOn": [
                "[resourceId('Microsoft.Kusto/clusters', parameters('clusters_kustocluster_name'))]"
            ],
            "kind": "ReadWrite",
            "properties": {
                "softDeletePeriod": "P365D",
                "hotCachePeriod": "P31D"
            }
        }
    ]
}

Bisep

Di bawah ini adalah contoh templat Bicep yang membuat kluster Azure Data Explorer dan database dalam kluster tersebut dengan konfigurasi minimal. Untuk detail lengkap dan properti yang didukung, lihat referensi kluster Bicep dan referensi database Bicep.

    @description('Name of the cluster to create')
    param clusterName string = 'kusto${uniqueString(resourceGroup().id)}'
    
    @description('Name of the database to create')
    param databaseName string = 'kustodb'
    
    @description('Location for all resources.')
    param location string = resourceGroup().location
    
    resource cluster 'Microsoft.Kusto/clusters@2025-02-14' = {
      name: clusterName
      location: location
      sku: {
        name: 'Standard_E8ads_v5'
        tier: 'Standard'
        capacity: 2
      }
    }
    
    
    resource database 'Microsoft.Kusto/clusters/databases@2025-02-14' = {
      parent: cluster
      name: databaseName
      location: location
      kind: 'ReadWrite'
      properties: {
        softDeletePeriod: 'P365D'
        hotCachePeriod: 'P31D'
      }
    }

PowerShell

1. Buat kluster Anda dengan menggunakan perintah berikut:

    New-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster -Location westus2 -SkuTier Standard -SkuCapacity 2 -SkuName 'Standard_E8ads_v5'
   

   Pengaturan	Nilai yang disarankan	Deskripsi bidang
   Nama	mykustocluster	Nama kluster yang diinginkan.
   SKU	Standard_E8ads_v5	SKU yang akan digunakan untuk kluster Anda.
   ResourceGroupName	testrg	Nama grup sumber daya tempat kluster akan dibuat.

   Ada parameter opsional lain yang dapat Anda gunakan, seperti kapasitas kluster.

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

   Get-AzKustoCluster -Name mykustocluster -ResourceGroupName testrg
   

3. Konfirmasikan keberhasilan pembuatan kluster dengan memverifikasi hasilnya berisi provisioningState sebagai Succeeded.

C#

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.
   tingkat	Standard	Tingkatan SKU.
   kapasitas	nomor	Jumlah instans dalam 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.

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.

Python

1. Buat kluster Anda dengan menggunakan perintah berikut:

   from azure.mgmt.kusto import KustoManagementClient
   from azure.mgmt.kusto.models import Cluster, AzureSku
   from azure.common.credentials import ServicePrincipalCredentials
   
   #Directory (tenant) ID
   tenant_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
   #Application ID
   client_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
   #Client Secret
   client_secret = "xxxxxxxxxxxxxx"
   subscription_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
   credentials = ServicePrincipalCredentials(
       client_id=client_id,
       secret=client_secret,
       tenant=tenant_id
   )
   
   location = 'Central US'
   sku_name = 'Standard_E8ads_v5'
   capacity = 5
   tier = "Standard"
   resource_group_name = 'testrg'
   cluster_name = 'mykustocluster'
   cluster = Cluster(location=location, sku=AzureSku(name=sku_name, capacity=capacity, tier=tier))
   
   kusto_management_client = KustoManagementClient(credentials, subscription_id)
   
   cluster_operations = kusto_management_client.clusters
   
   poller = cluster_operations.begin_create_or_update(resource_group_name, cluster_name, cluster)
   poller.wait()
   

   Pengaturan	Nilai yang disarankan	Deskripsi bidang
   nama_klaster	mykustocluster	Nama kluster yang diinginkan.
   sku_name	Standard_E8ads_v5	SKU yang akan digunakan untuk kluster Anda.
   tingkat	Standard	Tingkatan SKU.
   kapasitas	angka	Jumlah instans dalam kluster.
   resource_group_name	testrg	Nama grup sumber daya tempat kluster akan dibuat.

   Catatan

   Membuat kluster adalah operasi jangka panjang. Metode begin_create_or_update mengembalikan instans LROPoller, lihat kelas LROPoller untuk mendapatkan informasi selengkapnya.

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

   cluster_operations.get(resource_group_name = resource_group_name, cluster_name= cluster_name, custom_headers=None, raw=False)
   

3. Konfirmasikan keberhasilan pembuatan kluster dengan memverifikasi hasilnya berisi provisioningState sebagai Succeeded.

Go

Kode berikut menunjukkan cara membuat kluster.

1. Atur variabel lingkungan yang diperlukan, termasuk informasi service principal yang tercantum di prasyarat. Masukkan ID langganan, grup sumber daya, dan wilayah tempat Anda ingin membuat kluster.

   export AZURE_CLIENT_ID="<enter service principal client ID>"
   export AZURE_CLIENT_SECRET="<enter service principal client secret>"
   export AZURE_TENANT_ID="<enter tenant ID>"
   
   export SUBSCRIPTION="<enter subscription ID>"
   export RESOURCE_GROUP="<enter resource group name>"
   export LOCATION="<enter azure location e.g. Southeast Asia>"
   
   export CLUSTER_NAME_PREFIX="<enter prefix (cluster name will be [prefix]-ADXTestCluster)>"
   export DATABASE_NAME_PREFIX="<enter prefix (database name will be [prefix]-ADXTestDB)>"
   

   Kiat

   Gunakan auth.NewAuthorizerFromCLIWithResource jika Anda telah memasang dan mengonfigurasi Azure CLI untuk autentikasi. Dalam situasi tersebut, Anda tidak perlu membuat service principal.

2. Jalankan kode berikut untuk membuat kluster:

   import (
    "context"
    "log"
    "os"
    "strconv"
   
    "github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
    "github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/kusto/armkusto"
    "github.com/olekukonko/tablewriter"
   )
   
   const (
    subscriptionEnvVar      = "AZURE_SUBSCRIPTION_ID"
    resourceGroupEnvVar     = "AZURE_RESOURCE_GROUP"
    locationEnvVar          = "AZURE_LOCATION"
    clusterNamePrefixEnvVar = "CLUSTER_NAME_PREFIX"
    dbNamePrefixEnvVar      = "DATABASE_NAME_PREFIX"
   
    clusterName  = "ADXTestCluster"
    databaseName = "ADXTestDB"
   )
   
   func init() {
    subscription = os.Getenv(subscriptionEnvVar)
    if subscription == "" {
     log.Fatalf("missing environment variable %s", subscriptionEnvVar)
    }
   
    rgName = os.Getenv(resourceGroupEnvVar)
    if rgName == "" {
     log.Fatalf("missing environment variable %s", resourceGroupEnvVar)
    }
   
    location = os.Getenv(locationEnvVar)
    if location == "" {
     log.Fatalf("missing environment variable %s", locationEnvVar)
    }
   
    clusterNamePrefix = os.Getenv(clusterNamePrefixEnvVar)
    if clusterNamePrefix == "" {
     log.Fatalf("missing environment variable %s", clusterNamePrefixEnvVar)
    }
   
    dbNamePrefix = os.Getenv(dbNamePrefixEnvVar)
    if dbNamePrefix == "" {
     log.Fatalf("missing environment variable %s", dbNamePrefixEnvVar)
    }
   }
   
   func getClustersClient(subscription string) *armkusto.ClustersClient {
    cred, err := azidentity.NewDefaultAzureCredential(nil)
    if err != nil {
     log.Fatal(err)
    }
   
    client, err := armkusto.NewClustersClient(subscription, cred, nil)
    if err != nil {
     log.Fatal(err)
    }
   
    return client
   }
   
   // 1 instance, Basic tier with compute type Dev(No SLA)_Standard_D11_v2
   func createCluster(sub, name, location, rgName string) {
    ctx := context.Background()
   
    numInstances := int32(1)
    client := getClustersClient(sub)
    result, err := client.BeginCreateOrUpdate(
     ctx,
     rgName,
     name,
     armkusto.Cluster{
      Location: &location,
      SKU: &armkusto.AzureSKU{
       Name:     to.Ptr(armkusto.AzureSKUNameDevNoSLAStandardD11V2),
       Capacity: &numInstances,
       Tier:     to.Ptr(armkusto.AzureSKUTierBasic),
      },
     },
     nil,
    )
    if err != nil {
     log.Fatal("failed to start cluster creation ", err)
    }
   
    log.Printf("waiting for cluster creation to complete - %s\n", name)
    r, err := result.PollUntilDone(ctx, nil)
    if err != nil {
     log.Fatal(err)
    }
   
    log.Printf("created cluster %s\n", *r.Name)
   }
   
   createCluster(subscription, clusterNamePrefix+clusterName, location, rgName)
   

3. Cantumkan kluster untuk memastikan keberhasilan pembuatan:

   func listClusters(sub, rgName string) {
    log.Printf("listing clusters in resource group %s\n", rgName)
    ctx := context.Background()
   
    result := getClustersClient(sub).NewListByResourceGroupPager(rgName, nil)
   
    data := [][]string{}
   
    for result.More() {
     temp, err := result.NextPage(ctx)
     if err != nil {
      log.Fatal(err)
     }
     for _, c := range temp.Value {
      data = append(data, []string{*c.Name, string(*c.Properties.State), *c.Location, strconv.Itoa(int(*c.SKU.Capacity)), *c.Properties.URI})
     }
    }
   
    table := tablewriter.NewWriter(os.Stdout)
    table.SetHeader([]string{"Name", "State", "Location", "Instances", "URI"})
   
    for _, v := range data {
     table.Append(v)
    }
    table.Render()
   }
   
   listClusters(subscription, rgName)
   

Azure CLI

Important

Ekstensi Kusto untuk Azure CLI kedaluarsa dan tidak dipertahankan. Sebaiknya gunakan templat PowerShell atau ARM/Bicep untuk pembuatan kluster dan database. Jika Anda memilih untuk menggunakan Azure CLI, pastikan untuk menginstal ekstensi Kusto untuk memastikan Anda memiliki perintah CLI terbaru untuk Azure Data Explorer.

1. Buat kluster Anda dengan menggunakan perintah berikut:

   az kusto cluster create --cluster-name azureclitest --sku name="Standard_E8ads_v5" tier="Standard" --resource-group testrg --location westus
   

   Pengaturan	Nilai yang disarankan	Deskripsi bidang
   nama	azureclitest	Nama kluster yang diinginkan.
   sku	Standard_E8ads_v5	SKU yang akan digunakan untuk kluster Anda. Parameter: nama - Nama SKU. tingkatan - Tingkatan SKU.
   grup sumber daya	testrg	Nama grup sumber daya tempat kluster akan dibuat.
   lokasi	westus	Lokasi tempat kluster akan dibuat.

   Ada parameter opsional lain yang dapat Anda gunakan, seperti kapasitas kluster.

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

   az kusto cluster show --cluster-name azureclitest --resource-group testrg
   

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.

Templat ARM

Kluster dan database dibuat bersama dengan templat ARM di bagian sebelumnya.

Bisep

Kluster dan database dibuat bersama dengan templat Bicep di bagian sebelumnya.

PowerShell

1. Buat database Anda dengan menggunakan perintah berikut:

   New-AzKustoDatabase -ResourceGroupName testrg -ClusterName mykustocluster -Name mykustodatabase -SoftDeletePeriod 3650:00:00:00 -HotCachePeriod 3650:00:00:00
   

   Pengaturan	Nilai yang disarankan	Deskripsi bidang
   ClusterName	mykustocluster	Nama kluster Anda tempat database akan dibuat.
   Nama	mykustodatabase	Nama database Anda.
   ResourceGroupName	testrg	Nama grup sumber daya tempat kluster akan dibuat.
   SoftDeletePeriod	3650:00:00:00	Lama waktu data akan tetap tersedia untuk diakses melalui kueri.
   HotCachePeriod	3650:00:00:00	Jumlah waktu data akan disimpan dalam cache.

2. Jalankan perintah berikut untuk melihat database yang Anda buat:

   Get-AzKustoDatabase -ClusterName mykustocluster -ResourceGroupName testrg -Name mykustodatabase
   

C#

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	Lama waktu data akan tetap tersedia untuk dikueri.
   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;
   

Python

1. Buat database Anda dengan menggunakan perintah berikut:

   from azure.mgmt.kusto import KustoManagementClient
   from azure.common.credentials import ServicePrincipalCredentials
   from azure.mgmt.kusto.models import ReadWriteDatabase
   from datetime import timedelta
   
   #Directory (tenant) ID
   tenant_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
   #Application ID
   client_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
   #Client Secret
   client_secret = "xxxxxxxxxxxxxx"
   subscription_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
   credentials = ServicePrincipalCredentials(
       client_id=client_id,
       secret=client_secret,
       tenant=tenant_id
   )
   
   location = 'Central US'
   resource_group_name = 'testrg'
   cluster_name = 'mykustocluster'
   soft_delete_period = timedelta(days=3650)
   hot_cache_period = timedelta(days=3650)
   database_name = "mykustodatabase"
   
   kusto_management_client = KustoManagementClient(credentials, subscription_id)
   
   database_operations = kusto_management_client.databases
   database = ReadWriteDatabase(location=location,
         soft_delete_period=soft_delete_period,
         hot_cache_period=hot_cache_period)
   
   poller = database_operations.begin_create_or_update(resource_group_name = resource_group_name, cluster_name = cluster_name, database_name = database_name, parameters = database)
   poller.wait()
   

   Catatan

   Jika Anda menggunakan Python versi 0.4.0 atau di bawahnya, gunakan Database alih-alih ReadWriteDatabase.

   Pengaturan	Nilai yang disarankan	Deskripsi bidang
   cluster_name	mykustocluster	Nama kluster Anda tempat database akan dibuat.
   database_name	mykustodatabase	Nama database Anda.
   resource_group_name	testrg	Nama grup sumber daya tempat kluster akan dibuat.
   soft_delete_period	3650 hari, 0:00:00	Jangka waktu data akan tetap tersedia untuk dikueri.
   hot_cache_period	3650 hari, 0:00:00	Jumlah waktu data akan disimpan dalam cache.

2. Jalankan perintah berikut untuk melihat database yang Anda buat:

   database_operations.get(resource_group_name = resource_group_name, cluster_name = cluster_name, database_name = database_name)
   

Go

Kode berikut menunjukkan cara membuat database. Impor paket dan inisiasi variabel lingkungan sama seperti di bagian sebelumnya.

1. Jalankan kode berikut untuk membuat database:

   func createDatabase(sub, rgName, clusterName, location, dbName string) {
    ctx := context.Background()
   
    client := getDBClient(sub)
    future, err := client.BeginCreateOrUpdate(ctx, rgName, clusterName, dbName, &armkusto.ReadWriteDatabase{Kind: to.Ptr(armkusto.KindReadWrite), Location: &location}, nil)
   
    if err != nil {
     log.Fatal("failed to start database creation ", err)
    }
   
    log.Printf("waiting for database creation to complete - %s\n", dbName)
    resp, err := future.PollUntilDone(ctx, nil)
    if err != nil {
     log.Fatal(err)
    }
   
    kdb := resp.GetDatabase()
    log.Printf("created DB %s with ID %s and type %s\n", *kdb.Name, *kdb.ID, *kdb.Type)
   }
   
   createDatabase(subscription, rgName, clusterNamePrefix+clusterName, location, dbNamePrefix+databaseName)
   

2. Cantumkan database untuk memastikan keberhasilan pembuatan:

   func listDatabases(sub, rgName, clusterName string) {
    log.Printf("listing databases in cluster %s\n", clusterName)
   
    ctx := context.Background()
    result := getDBClient(sub).NewListByClusterPager(rgName, clusterName, nil)
   
    data := [][]string{}
   
    for result.More() {
     temp, err := result.NextPage(ctx)
     if err != nil {
      log.Fatal(err)
     }
     for _, db := range temp.Value {
      if *db.GetDatabase().Kind == armkusto.KindReadWrite {
       data = append(data, []string{*db.GetDatabase().Name, string(*db.GetDatabase().Kind), *db.GetDatabase().Location, *db.GetDatabase().Type})
      }
     }
    }
   
    table := tablewriter.NewWriter(os.Stdout)
    table.SetHeader([]string{"Name", "State", "Location", "Type"})
   
    for _, v := range data {
     table.Append(v)
    }
    table.Render()
   }
   
   listDatabases(subscription, rgName, clusterNamePrefix+clusterName)
   

Azure CLI

Important

Ekstensi Kusto untuk Azure CLI kedaluarsa dan tidak dipertahankan. Sebaiknya gunakan templat PowerShell atau ARM/Bicep untuk pembuatan kluster dan database. Jika Anda memilih untuk menggunakan Azure CLI, pastikan untuk menginstal ekstensi Kusto untuk memastikan Anda memiliki perintah CLI terbaru untuk Azure Data Explorer.

1. Buat database Anda dengan menggunakan perintah berikut:

   az kusto database create --cluster-name azureclitest --database-name clidatabase --resource-group testrg --read-write-database soft-delete-period=P365D hot-cache-period=P31D location=westus
   

   Pengaturan	Nilai yang disarankan	Deskripsi bidang
   nama kluster	azureclitest	Nama kluster Anda tempat database akan dibuat.
   database-name	clidatabase	Nama database Anda.
   grup sumber daya	testrg	Nama grup sumber daya tempat kluster akan dibuat.
   database baca-tulis	P365DP31Dwestus	Jenis database. Parameter: soft-delete-period - Menandakan jumlah waktu data akan tetap tersedia untuk kueri. Lihat kebijakan penyimpanan untuk informasi selengkapnya. hot-cache-period - Menandakan jumlah waktu data akan disimpan dalam cache. Lihat kebijakan cache untuk informasi selengkapnya. location -Lokasi tempat database akan dibuat.

2. Jalankan perintah berikut untuk melihat database yang Anda buat:

   az kusto database show --database-name clidatabase --resource-group testrg --cluster-name azureclitest
   

Langkah selanjutnya

Buat tabel