Een cluster Azure Data Explorer database maken met behulp van een Azure Resource Manager sjabloon

Azure Data Explorer is een snelle en zeer schaalbare service voor gegevensverkenning voor telemetrische gegevens en gegevens uit logboeken. 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 Azure Data Explorer cluster en database met behulp van een Azure Resource Manager sjabloon. In het artikel wordt beschreven hoe u definieert welke resources worden geïmplementeerd en hoe u parameters definieert die worden opgegeven wanneer de implementatie wordt uitgevoerd. U kunt deze sjabloon gebruiken voor uw eigen implementaties of de sjabloon aanpassen aan uw eisen. Zie voor meer informatie over het maken van sjablonen Azure Resource Manager maken. Zie Microsoft.Kusto resource types (Microsoft.Kusto-resourcetypen)voor de JSON-syntaxis en eigenschappen die u in een sjabloon kunt gebruiken.

Als u geen abonnement op Azure hebt, maakt u een gratis account voordat u begint.

Azure Resource Manager voor het maken van clusters en databases

In dit artikel gebruikt u een bestaande quickstart-sjabloon

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
      "clusters_kustocluster_name": {
          "type": "string",
          "defaultValue": "[concat('kusto', uniqueString(resourceGroup().id))]",
          "metadata": {
            "description": "Name of the cluster to create"
          }
      },
      "databases_kustodb_name": {
          "type": "string",
          "defaultValue": "kustodb",
          "metadata": {
            "description": "Name of the database to create"
          }
      },
      "location": {
        "type": "string",
        "defaultValue": "[resourceGroup().location]",
        "metadata": {
          "description": "Location for all resources."
        }
      }
  },
  "variables": {},
  "resources": [
      {
          "name": "[parameters('clusters_kustocluster_name')]",
          "type": "Microsoft.Kusto/clusters",
          "sku": {
              "name": "Standard_D13_v2",
              "tier": "Standard",
              "capacity": 2
          },
          "apiVersion": "2020-09-18",
          "location": "[parameters('location')]",
          "tags": {
            "Created By": "GitHub quickstart template"
          },
          "properties": {
              "trustedExternalTenants": [],
              "optimizedAutoscale": {
                  "version": 1,
                  "isEnabled": true,
                  "minimum": 2,
                  "maximum": 10
              },
              "enableDiskEncryption": false,
              "enableStreamingIngest": false,
              "virtualNetworkConfiguration":{
                  "subnetId": "<subnet resource id>",
                  "enginePublicIpId": "<Engine service's public IP address resource id>",
                  "dataManagementPublicIpId": "<Data management's service public IP address resource id>"
              },
              "keyVaultProperties":{
                  "keyName": "<Key name>",
                  "keyVaultUri": "<Key vault uri>"
              },
              "enablePurge": false,
              "enableDoubleEncryption": false,
              "engineType": "V3",
          }
      },
      {
          "name": "[concat(parameters('clusters_kustocluster_name'), '/', parameters('databases_kustodb_name'))]",
          "type": "Microsoft.Kusto/clusters/databases",
          "apiVersion": "2020-09-18",
          "location": "[parameters('location')]",
          "dependsOn": [
              "[resourceId('Microsoft.Kusto/clusters', parameters('clusters_kustocluster_name'))]"
          ],
          "properties": {
              "softDeletePeriodInDays": 365,
              "hotCachePeriodInDays": 31
          }
      }
  ]
}

Zie Azure-snelstartsjablonen voor meer informatie over sjabloonvoorbeelden.

De sjabloon implementeren en sjabloonimplementatie controleren

U kunt de sjabloon Azure Resource Manager implementeren met behulp van de Azure Portal of met behulp van PowerShell.

Gebruik de Azure Portal om de sjabloon te implementeren en de sjabloonimplementatie te controleren

  1. Als u een cluster en database wilt maken, gebruikt u de volgende knop om de implementatie te starten. Klik met de rechtermuisknop en selecteer In nieuw venster openen, zodat u de rest van de stappen in dit artikel kunt volgen.

    Schermopname van een blauwe knop die een foto van clouds maakt en het label Implementeren in Azure heeft.

    Als u op de knop Implementeren in Azure klikt, wordt u naar de Azure-portal geleid om een implementatieformulier in te vullen.

    Schermopname van een sjabloon op Azure Portal. Alle knoppen, selectievakjes en selectievakjes die worden gebruikt bij het bewerken zijn gemarkeerd.

    U kunt de sjabloon bewerken en implementeren in de Azure Portal met behulp van het formulier.

  2. Voltooi de sectiesBASISBEGINSELEN en INSTELLINGEN. Selecteer unieke cluster- en databasenamen. Het duurt enkele minuten om een cluster en database Azure Data Explorer maken.

  3. Als u de implementatie wilt controleren, opent u de resourcegroep in de Azure Portal om uw nieuwe cluster en database te vinden.

PowerShell gebruiken om de sjabloon te implementeren en sjabloonimplementatie te controleren

De sjabloon implementeren met behulp van PowerShell

  1. Selecteer Uitproberen in het volgende codeblok en volg de instructies om u aan te melden bij de Azure Cloud Shell.

    $projectName = Read-Host -Prompt "Enter a project name that is used for generating resource names"
    $location = Read-Host -Prompt "Enter the location (i.e. centralus)"
    $resourceGroupName = "${projectName}rg"
    $clusterName = "${projectName}cluster"
    $parameters = @{}
    $parameters.Add("clusters_kustocluster_name", $clusterName)
    $templateUri = "https://azure.microsoft.com/resources/templates/101-kusto-cluster-database/"
    New-AzResourceGroup -Name $resourceGroupName -Location $location
    New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri -TemplateParameterObject $parameters
    Write-Host "Press [ENTER] to continue ..."
    
  2. Selecteer Kopiëren om het PowerShell-script te kopiëren.

  3. Klik met de rechtermuisknop op de shell-console en selecteer Plakken. Het duurt enkele minuten om een cluster en database Azure Data Explorer maken.

De implementatie controleren met behulp van PowerShell

Gebruik het volgende script om de implementatie Azure PowerShell controleren. Als de Cloud Shell nog steeds is geopend, hoeft u de eerste regel niet te kopiëren/uit te voeren (Read-Host). Lees Az.Kustovoor meer Azure Data Explorer het beheren van uw resources in PowerShell.

$projectName = Read-Host -Prompt "Enter the same project name that you used in the last procedure"

Install-Module -Name Az.Kusto
$resourceGroupName = "${projectName}rg"
$clusterName = "${projectName}cluster"

Get-AzKustoCluster -ResourceGroupName $resourceGroupName -Name $clusterName
Write-Host "Press [ENTER] to continue ..."

Resources opschonen

Schoon de geïmplementeerd Azure-resources, wanneer u deze niet meer nodig hebt, op door de resourcegroep te verwijderen.

Resources ops schonen met behulp van Azure Portal

Verwijder de resources in de Azure Portal door de stappen in Resources ops schonen uit te voeren.

Resources opschonen met PowerShell

Als de Cloud Shell nog steeds is geopend, hoeft u de eerste regel niet te kopiëren/uit te voeren (Read-Host).

$projectName = Read-Host -Prompt "Enter the same project name that you used in the last procedure"
$resourceGroupName = "${projectName}rg"

Remove-AzResourceGroup -ResourceGroupName $resourceGroupName

Write-Host "Press [ENTER] to continue ..."

Volgende stappen

Gegevens opnemen in Azure Data Explorer cluster en database