Dela via


Skapa ett Azure Data Explorer-kluster och en databas

Azure Data Explorer är en snabb, fullständigt hanterad dataanalystjänst för realtidsanalys på stora mängder dataströmning från program, webbplatser, IoT-enheter med mera. Om du vill använda Azure Data Explorer skapar du först ett kluster och skapar en eller flera databaser i klustret. Sedan kan du mata in (läsa in) data i en databas och köra frågor mot den.

I den här artikeln får du lära dig hur du skapar ett kluster och en databas med hjälp av antingen C#, Python, Go, Azure CLI, PowerShell eller en ARM-mall (Azure Resource Manager). Information om hur du skapar ett kluster och en databas med hjälp av Azure-portalen finns i Snabbstart: Skapa ett Azure Data Explorer-kluster och en databas.

Kodexempel baserade på tidigare SDK-versioner finns i den arkiverade artikeln.

Förutsättningar

Förutsättningar efter metod för att skapa kluster och databaser:

Skapa ett Azure Data Explorer-kluster

Det här avsnittet vägleder dig genom processen att skapa ett Azure Data Explorer-kluster. Välj relevant flik för den metod du föredrar för att skapa klustret.

  1. Skapa klustret med hjälp av följande kod:

    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);
    
    Setting Föreslaget värde Fältbeskrivning
    klusternamn mykustocluster Det önskade namnet på klustret.
    skuName Standard_E8ads_v5 Den SKU som ska användas för klustret.
    tier Standard SKU-nivån.
    capacity number Antalet instanser av klustret.
    resourceGroupName testrg Resursgruppens namn där klustret ska skapas.

    Anmärkning

    Att skapa ett kluster är en tidskrävande åtgärd, så vi rekommenderar starkt att du använder CreateOrUpdateAsync i stället för CreateOrUpdate.

  2. Kör följande kommando för att kontrollera om klustret har skapats:

    clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
    
  3. Bekräfta att klustret har skapats genom att verifiera att resultatet innehåller provisioningState som Succeeded.

Skapa en Azure Data Explorer-databas

I det här avsnittet skapar du en databas i klustret som skapades i föregående avsnitt.

  1. Skapa databasen med hjälp av följande kod:

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

    Anmärkning

    Om du använder C# version 2.0.0 eller senare använder du Database i stället för ReadWriteDatabase.

    Setting Föreslaget värde Fältbeskrivning
    klusternamn mykustocluster Namnet på klustret där databasen ska skapas.
    databaseName mykustodatabase Namnet på databasen.
    resourceGroupName testrg Resursgruppens namn där klustret ska skapas.
    softDeletePeriod 3650:00:00:00 Hur lång tid data ska hållas tillgängliga för frågor.
    hotCachePeriod 3650:00:00:00 Hur lång tid data ska lagras i cacheminnet.
  2. Kör följande kommando för att se databasen som du skapade:

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

Nästa steg