Azure Data Explorer-fürt és -adatbázis létrehozása

Az Azure Data Explorer egy gyors, teljes mértékben felügyelt adatelemző szolgáltatás, amellyel valós idejű elemzést végezhet többek között alkalmazások, webhelyek és IoT-eszközök nagy mennyiségű adatfolyamain. Az Azure Data Explorer használatához először egy fürtöt hozunk létre, majd egy vagy több adatbázist a fürtben. Ezután betöltheti (betöltheti) az adatokat egy adatbázisba, és lekérdezéseket futtathat rajta.

Ebből a cikkből megtudhatja, hogyan hozhat létre fürtöt és adatbázist C#, Python, Go, Azure CLI, PowerShell vagy Azure Resource Manager (ARM) sablon használatával. Ha meg szeretné tudni, hogyan hozhat létre fürtöt és adatbázist a Azure Portal használatával, tekintse meg az Azure Data Explorer-fürt és -adatbázis létrehozása című rövid útmutatót.

A korábbi SDK-verziókon alapuló kódmintákért tekintse meg az archivált cikket.

Előfeltételek

Előfeltételek fürt- és adatbázis-létrehozási módszer szerint:

Azure Data Explorer-fürt létrehozása

Ez a szakasz végigvezeti egy Azure Data Explorer-fürt létrehozásának folyamatán. Válassza ki az előnyben részesített metódus megfelelő lapját a fürt létrehozásához.

  1. Hozza létre a fürtöt a következő kóddal:

    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);
    
    Beállítás Ajánlott érték Mező leírása
    clusterName mykustocluster A fürt kívánt neve.
    skuName Standard_E8ads_v5 A fürthöz használni kívánt termékváltozat.
    tier Standard A termékváltozat szintje.
    capacity Szám A fürt példányainak száma.
    resourceGroupName testrg Az erőforráscsoport neve, ahol a fürt létrejön.

    Megjegyzés

    A fürt létrehozása hosszú ideig futó művelet, ezért erősen ajánlott a CreateOrUpdateAsync használata a CreateOrUpdate helyett.

  2. Futtassa a következő parancsot annak ellenőrzéséhez, hogy a fürt sikeresen létrejött-e:

    clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
    
  3. Ellenőrizze a fürt sikeres létrehozását, és ellenőrizze, hogy az eredmény tartalmazza-e provisioningState a következőt: Succeeded.

Azure Data Explorer-adatbázis létrehozása

Ebben a szakaszban egy adatbázist fog létrehozni az előző szakaszban létrehozott fürtben.

  1. Hozza létre az adatbázist a következő kóddal:

    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);
    

    Megjegyzés

    Ha a C# 2.0.0-s vagy újabb verzióját használja, a ReadWriteDatabase helyett használja az Adatbázist.

    Beállítás Ajánlott érték Mező leírása
    clusterName mykustocluster Annak a fürtnek a neve, ahol az adatbázis létre lesz hozva.
    databaseName mykustodatabase Az adatbázis neve.
    resourceGroupName testrg Az erőforráscsoport neve, ahol a fürt létrejön.
    softDeletePeriod 3650:00:00:00 Az adatok lekérdezésre való rendelkezésre állásának időtartama.
    hotCachePeriod 3650:00:00:00 Az adatok gyorsítótárban való őrzésének időtartama.
  2. Futtassa a következő parancsot a létrehozott adatbázis megtekintéséhez:

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

Következő lépés