Een cluster Azure Data Explorer database maken met behulp van PowerShell

  • Artikel
  • 4 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 PowerShell. U kunt PowerShell-cmdlets en -scripts uitvoeren op Windows, Linux of in Azure Cloud Shell met Az.Kusto om clusters en databases Azure Data Explorer maken en configureren.

Vereisten

Notitie

Dit artikel is bijgewerkt voor het gebruik van de nieuwe Azure PowerShell Az-module. De AzureRM-module kan nog worden gebruikt en krijgt bugoplossingen tot ten minste december 2020. Zie voor meer informatie over de nieuwe Az-module en compatibiliteit met AzureRM Introductie van de nieuwe Az-module van Azure PowerShell. Raadpleeg Azure PowerShell installeren voor instructies over de installatie van de Az-module.

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 het 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. Zie Azure CLI installeren als u CLI wilt installeren of upgraden.

  • Zie Beveiligingsrollen toewijzen voor de toewijzing van de rol databaselezer of databasebeheerder.

Parameters configureren

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

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

    Connect-AzAccount

  2. Stel het abonnement in waarin u het cluster wilt maken:

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

  3. Wanneer u Azure CLI lokaal of in Azure Cloud Shell, moet u de Az.Kusto-module op uw apparaat installeren:

     Install-Module -Name Az.Kusto

Het Azure Data Explorer-cluster maken

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

     New-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster -Location westus2 -SkuTier Standard -SkuCapacity 2 -SkuName 'Standard_D11_v2'
    Instelling Voorgestelde waarde Beschrijving van veld
    Naam mycluster De gewenste naam van uw cluster.
    Sku D13_v2 De SKU die wordt gebruikt voor uw cluster.
    ResourceGroupName testrg Naam van de resourcegroep 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:

    Get-AzKustoCluster -Name mykustocluster -ResourceGroupName 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:

    New-AzKustoDatabase -ResourceGroupName testrg -ClusterName mykustocluster -Name mykustodatabase -SoftDeletePeriod 3650:00:00:00 -HotCachePeriod 3650:00:00:00
    Instelling Voorgestelde waarde Beschrijving van veld
    Clusternaam mycluster De naam van het cluster waar de database wordt gemaakt.
    Name myplanedatabase De naam van uw database.
    ResourceGroupName testrg Naam van de resourcegroep waar het cluster wordt gemaakt.
    SoftDeletePeriod 3650:00:00:00 Hoe lang gegevens worden opgeslagen om query's erop te kunnen uitvoeren.
    HotCachePeriod 3650:00:00:00 Hoe lang gegevens worden opgeslagen in de cache.

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

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

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:

    Remove-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster

Volgende stappen