Skapa ett Azure Data Explorer kluster och en databas med hjälp av PowerShell

  • Artikel
  • 3 minuter för att läsa

Azure Data Explorer är en snabb, fullständigt hanterad dataanalystjänst för realtidsanalys av stora mängder data som strömmar från program, webbplatser, IoT-enheter med mera. För att använda Azure Data Explorer skapar du först ett kluster och skapar en eller flera databaser i klustret. Sedan matar du in (läser in) data i databasen så att du kan köra frågor mot den. I den här artikeln skapar du ett kluster och en databas med hjälp av Powershell. Du kan köra PowerShell-cmdlets och skript på Windows, Linux eller i Azure Cloud Shell med Az.Kusto för att skapa och konfigurera Azure Data Explorer kluster och databaser.

Förutsättningar

Anteckning

Den här artikeln har uppdaterats till att använda den nya Azure PowerShell Az-modulen. Du kan fortfarande använda modulen AzureRM som kommer att fortsätta att ta emot felkorrigeringar fram till december 2020 eller längre. Mer information om den nya Az-modulen och AzureRM-kompatibilitet finns i Introduktion till den nya Azure PowerShell Az-modulen. Instruktioner för installation av Az-modulen finns i Installera Azure PowerShell.

Använda Azure Cloud Shell

Azure är värd för Azure Cloud Shell, en interaktiv gränssnittsmiljö som du kan använda via webbläsaren. Du kan använda antingen Bash eller PowerShell med Cloud Shell för att arbeta med Azure-tjänster. Du kan använda förinstallerade Cloud Shell-kommandon för att köra koden i den här artikeln utan att behöva installera något i din lokala miljö.

Så här startar du Azure Cloud Shell:

Alternativ Exempel/länk
Välj Prova i det övre högra hörnet av ett kodblock. Om du väljer Prova kopieras koden inte automatiskt till Cloud Shell. Exempel på Prova för Azure Cloud Shell.
Gå till https://shell.azure.com eller Välj knappen https://shell.azure.com för att öppna Cloud Shell i webbläsaren. Starta Cloud Shell i ett nytt fönster.
Välj knappen Cloud Shell på menyn längst upp till höger i Azure-portalen. Cloud Shell i Azure Portal.

Så här kör du koden i den här artikeln i Azure Cloud Shell:

  1. Starta Cloud Shell.

  2. Kopiera koden genom att klicka på knappen Kopiera på ett kodblock.

  3. Klistra in koden i Cloud Shell sessionen genom att välja CtrlSkift V i Windows och Linux eller genom att välja CmdShiftV på macOS.

  4. Välj Retur för att köra koden.

  • Om du väljer att installera och använda Azure CLI lokalt kräver den här artikeln Azure CLI version 2.0.4 eller senare. Kör az --version för att kontrollera vilken version du har. Information om hur du installerar eller uppgraderar finns i Installera Azure CLI.

  • Information om tilldelning av databasläsare eller databasadministratörsroll finns i Tilldela säkerhetsroller.

Konfigurera parametrar

Följande steg krävs inte om du kör kommandon i Azure Cloud Shell. Om du kör CLI lokalt följer du steg 1 2 för att logga in på & Azure och ange din aktuella prenumeration:

  1. Kör följande kommandon för att logga in på Azure:

    Connect-AzAccount

  2. Ange den prenumeration där du vill att klustret ska skapas:

     Set-AzContext -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

  3. När du kör Azure CLI lokalt eller i Azure Cloud Shell måste du installera Modulen Az.Kusto på enheten:

     Install-Module -Name Az.Kusto

Skapa Azure Data Explorer-klustret

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

     New-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster -Location westus2 -SkuTier Standard -SkuCapacity 2 -SkuName 'Standard_D11_v2'
    Inställning Föreslaget värde Fältbeskrivning
    Name mykustocluster Önskat namn på klustret.
    Sku D13_v2 Den SKU som ska användas för klustret.
    ResourceGroupName testrg Namnet på resursgruppen där klustret kommer att skapas.

    Det finns ytterligare parametrar som du kan använda, till exempel kapaciteten för klustret.

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

    Get-AzKustoCluster -Name mykustocluster -ResourceGroupName testrg

Om resultatet innehåller provisioningState med värdet Succeeded har klustret skapats.

Skapa databasen i Azure Data Explorer-klustret

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

    New-AzKustoDatabase -ResourceGroupName testrg -ClusterName mykustocluster -Name mykustodatabase -SoftDeletePeriod 3650:00:00:00 -HotCachePeriod 3650:00:00:00
    Inställning Föreslaget värde Fältbeskrivning
    ClusterName mykustocluster Namnet på det kluster där databasen ska skapas.
    Name mykustodatabase Namn på databasen.
    ResourceGroupName testrg Namnet på resursgruppen där klustret kommer att skapas.
    SoftDeletePeriod 3650:00:00:00 Hur lång tid data ska behållas för att vara tillgängliga för frågor.
    HotCachePeriod 3650:00:00:00 Hur lång tid data ska behållas i cache.

  2. Kör följande kommando för att se den databas som du skapade:

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

Nu har du ett kluster och en databas.

Rensa resurser

  • Om du planerar att följa våra andra artiklar behåller du de resurser som du har skapat.

  • Ta bort klustret om du vill rensa resurser. När du tar bort ett kluster, raderas också alla databaser i den. Använd följande kommando för att ta bort klustret:

    Remove-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster

Nästa steg