Vytvoření clusteru a databáze Azure Data Exploreru

Azure Data Explorer je rychlá, plně spravovaná služba analýzy dat pro analýzy velkých objemů dat v reálném čase, která se streamují z aplikací, webů, zařízení IoT a dalších. Pokud chcete použít Azure Data Explorer, musíte nejdříve vytvořit cluster a v něm vytvořit jednu nebo více databází. Pak můžete ingestovat (načíst) data do databáze a spouštět na ni dotazy.

V tomto článku se dozvíte, jak vytvořit cluster a databázi pomocí C#, Pythonu, Go, Azure CLI, PowerShellu nebo šablony Azure Resource Manager (ARM). Informace o vytvoření clusteru a databáze pomocí Azure Portal najdete v tématu Rychlý start: Vytvoření clusteru a databáze Azure Data Explorer.

Ukázky kódu založené na předchozích verzích sady SDK najdete v archivovaného článku.

Požadavky

Požadavky metodou vytváření clusteru a databáze:

Vytvoření clusteru Azure Data Explorer

Tato část vás provede procesem vytvoření clusteru Azure Data Explorer. Zvolte příslušnou kartu pro preferovanou metodu vytvoření clusteru.

  1. Vytvořte cluster pomocí následujícího kódu:

    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);
    
    Nastavení Navrhovaná hodnota Popis pole
    clusterName mykustocluster Požadovaný název clusteru.
    skuName Standard_E8ads_v5 Skladová položka, která se použije pro váš cluster.
    tier Standard Úroveň skladové položky.
    capacity Číslo Počet instancí clusteru.
    resourceGroupName testrg Název skupiny prostředků, ve které se cluster vytvoří.

    Poznámka

    Vytvoření clusteru je dlouhotrvající operace, proto se důrazně doporučuje místo CreateOrUpdateAsync použít CreateOrUpdateAsync.

  2. Spuštěním následujícího příkazu zkontrolujte, jestli se cluster úspěšně vytvořil:

    clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
    
  3. Ověřte úspěšné vytvoření clusteru tím, že ověříte, že výsledek obsahuje provisioningState hodnotu Succeeded.

Vytvoření databáze Azure Data Explorer

V této části vytvoříte databázi v clusteru vytvořeném v předchozí části.

  1. Vytvořte databázi pomocí následujícího kódu:

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

    Poznámka

    Pokud používáte C# verze 2.0.0 nebo nižší, použijte databázi místo ReadWriteDatabase.

    Nastavení Navrhovaná hodnota Popis pole
    clusterName mykustocluster Název vašeho clusteru, ve kterém se databáze vytvoří.
    databaseName databáze mykustodatabase Název databáze.
    resourceGroupName testrg Název skupiny prostředků, ve které se cluster vytvoří.
    softDeletePeriod 3650:00:00:00 Doba, po kterou budou data k dispozici pro dotazování.
    hotCachePeriod 3650:00:00:00 Doba, po kterou se budou data uchovávat v mezipaměti.
  2. Spuštěním následujícího příkazu zobrazte databázi, kterou jste vytvořili:

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

Další krok