Een cluster Azure Data Explorer database maken met behulp van Azure CLI

  • Artikel
  • 3 minuten om te lezen

Azure Data Explorer is een snelle, volledig beheerde service voor gegevensanalyses waarmee grote hoeveelheden gegevens van toepassingen, websites, IoT-apparaten en dergelijke in real-time kunnen worden geanalyseerd. Als u Azure Data Explorer wilt gebruiken, maakt u eerst een cluster. Daarna maakt u een of meer databases in het cluster. De volgende stap is het opnemen (laden) van gegevens in een database, zodat u er query's op kunt uitvoeren. In dit artikel maakt u een cluster en een database met behulp van Azure CLI.

Vereisten

Azure Cloud Shell gebruiken

Azure host Azure Cloud Shell, een interactieve shell-omgeving die u via uw browser kunt gebruiken. U kunt Bash of PowerShell gebruiken met Cloud Shell om met Azure-services te werken. U kunt de vooraf geïnstalleerde opdrachten van Cloud Shell gebruiken om de code in dit artikel uit te voeren zonder dat u iets hoeft te installeren in uw lokale omgeving.

Om Azure Cloud Shell op te starten:

Optie Voorbeeld/koppeling
Selecteer Nu proberen in de rechterbovenhoek van een codeblok. Als u Uitproberen selecteert, wordt de code niet automatisch gekopieerd naar Cloud Shell. Voorbeeld van Probeer het voor Azure Cloud Shell.
Ga naar https://shell.azure.com, of selecteer de knop https://shell.azure.com om Cloud Shell in uw browser te openen. Start Cloud Shell in een nieuw venster.
Klik op de knop Cloud Shell in het menu in de balk rechtsboven in de Azure-portal. Cloud Shell knop in de Azure Portal.

Om de code in dit artikel in Azure Cloud Shell uit te voeren:

  1. Start Cloud Shell.

  2. Selecteer de knop Kopiëren op een codeblok om de code te kopiëren.

  3. Plak de code in de Cloud Shell door CtrlShift V op Windows en Linux te selecteren of door CmdShiftV in macOS te selecteren.

  4. Selecteer Invoeren om de code uit te voeren.

  • Als u ervoor kiest om de Azure CLI lokaal te installeren en te gebruiken, is voor dit artikel versie 2.0.4 of hoger van Azure CLI vereist. Voer az --version uit om uw versie te controleren. Als u uw CLI wilt installeren of upgraden, raadpleegt u De Azure CLI installeren.

De CLI-parameters configureren

De volgende stappen zijn niet vereist als u opdrachten in Azure Cloud Shell uitvoert. Als u de CLI lokaal uitvoert, volgt u deze stappen om u aan te melden bij Azure en uw huidige abonnement in te stellen:

  1. Voer de volgende opdracht uit om u aan te melden bij Azure:

    az login

  2. Stel het abonnement in waarin u uw cluster wilt maken. Vervang MyAzureSub door de naam van het Azure-abonnement dat u wilt gebruiken:

    az account set --subscription MyAzureSub

  3. Installeer de extensie om de nieuwste Kusto CLI-versie te gebruiken:

    az extension add -n kusto

Het Azure Data Explorer-cluster maken

  1. Maak uw cluster met behulp van de volgende opdracht:

    az kusto cluster create --cluster-name azureclitest --sku name="Standard_D13_v2" tier="Standard" --resource-group testrg --location westus
    Instelling Voorgestelde waarde Beschrijving van veld
    naam azureclitest De gewenste naam van uw cluster.
    sku Standard_D13_v2 De SKU die wordt gebruikt voor uw cluster. Parameters: naam: de naam van de SKU. laag: de SKU-laag.
    resource-group testrg Naam van de resourcegroep waar het cluster wordt gemaakt.
    location westus De locatie waar het cluster wordt gemaakt.

    Er zijn aanvullende optionele parameters die u kunt gebruiken, zoals de capaciteit van het cluster.

  2. Voer de volgende opdracht uit om te controleren of het cluster is gemaakt:

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

Als het resultaat provisioningState met waarde Succeeded bevat, is het maken van het cluster geslaagd.

De database in het Azure Data Explorer-cluster maken

  1. Maak uw database met behulp van de volgende opdracht:

    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
    Instelling Voorgestelde waarde Beschrijving van veld
    cluster-name azureclitest De naam van het cluster waar de database wordt gemaakt.
    databasenaam clidatabase De naam van uw database.
    resource-group testrg Naam van de resourcegroep waar het cluster wordt gemaakt.
    read-write-database P365DP31Dwestus Het databasetype. Parameters: soft-delete-period: hiermee geeft u aan hoe lang de gegevens beschikbaar blijven om query's uit te voeren. Zie bewaarbeleid voor meer informatie. hot-cache-period: geeft aan hoe lang de gegevens in de cache worden bewaard. Zie Cachebeleid voor meer informatie. location: de locatie waar de database wordt gemaakt.

  2. Voer de volgende opdracht uit om de database te bekijken die u hebt gemaakt:

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

U hebt nu een cluster en een database.

Resources opschonen

  • Als u van plan bent onze andere artikelen te volgen, bewaar dan de resources die u hebt gemaakt.

  • Als u resources wilt opschonen, moet u het cluster verwijderen. Wanneer u een cluster verwijdert, worden alle databases hierin ook verwijderd. Gebruik de volgende opdracht om uw cluster te verwijderen:

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

Volgende stappen