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

  • 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 Azure CLI.

Förutsättningar

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. Om du behöver installera eller uppgradera kan du läsa informationen i Installera Azure CLI.

Konfigurera CLI-parametrarna

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

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

    az login

  2. Konfigurera den prenumeration där du vill att klustret ska skapas. Ersätt MyAzureSub med namnet på den Azure-prenumeration som du vill använda:

    az account set --subscription MyAzureSub

  3. Installera tillägget för att använda den senaste Kusto CLI-versionen:

    az extension add -n kusto

Skapa Azure Data Explorer-klustret

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

    az kusto cluster create --cluster-name azureclitest --sku name="Standard_D13_v2" tier="Standard" --resource-group testrg --location westus
    Inställning Föreslaget värde Fältbeskrivning
    name azureclitest Önskat namn på klustret.
    sku Standard_D13_v2 Den SKU som ska användas för klustret. Parametrar: name – SKU-namnet. nivå – SKU-nivån.
    resource-group testrg Namnet på resursgruppen där klustret kommer att skapas.
    location westus Den plats där klustret ska 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:

    az kusto cluster show --cluster-name azureclitest --resource-group 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:

    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
    Inställning Föreslaget värde Fältbeskrivning
    cluster-name azureclitest Namnet på det kluster där databasen ska skapas.
    databasnamn clidatabase Namn på databasen.
    resource-group testrg Namnet på resursgruppen där klustret kommer att skapas.
    read-write-database P365DP31Dwestus Databastypen. Parametrar: mjuk borttagningsperiod – Innebär hur lång tid data ska hållas tillgängliga för frågor. Mer information finns i Kvarhållningsprincip. hot-cache-period – Visar hur lång tid data sparas i cacheminnet. Mer information finns i Cacheprincip. plats – Den plats där databasen kommer att skapas.

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

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

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:

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

Nästa steg