Skapa ett Azure Data Explorer kluster och en databas med hjälp av Azure Resource Manager mall

Azure Data Explorer är en snabb och mycket skalbar datautforskningstjänst för logg- och telemetridata. 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 Azure Data Explorer kluster och en databas med hjälp av Azure Resource Manager mall. Artikeln visar hur du definierar vilka resurser som distribueras och hur du definierar parametrar som anges när distributionen körs. Du kan använda den här mallen för dina egna distributioner eller anpassa den så att den uppfyller dina krav. Information om hur du skapar mallar finns i redigera Azure Resource Manager mallar. JSON-syntaxen och JSON-egenskaperna som ska användas i en mall finns i Resurstyper för Microsoft.Kusto.

Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

Azure Resource Manager mall för att skapa kluster och databaser

I den här artikeln använder du en befintlig snabbstartsmall

{
  "$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
          }
      }
  ]
}

Fler mallexempel finns i Azure-snabbstartsmallar.

Distribuera mallen och verifiera malldistributionen

Du kan distribuera Azure Resource Manager med hjälp av Azure Portal eller med powershell.

Använd Azure Portal för att distribuera mallen och verifiera malldistributionen

  1. Om du vill skapa ett kluster och en databas använder du följande knapp för att starta distributionen. Högerklicka och välj Öppna i nytt fönster så att du kan följa resten av stegen i den här artikeln.

    Skärmbild av en blå knapp som föreställer moln och är märkt Distribuera till Azure.

    Knappen Distribuera till Azure tar dig till Azure-portalen där du kan fylla i ett distributionsformulär.

    Skärmbild av en mall på Azure Portal. Alla knappar, rutor och kryssrutor som används vid redigering är markerade.

    Du kan redigera och distribuera mallen i Azure Portal med hjälp av formuläret.

  2. Slutför avsnitten GRUNDLÄGGANDE INSTÄLLNINGAR och INSTÄLLNINGAR. Välj unika kluster- och databasnamn. Det tar några minuter att skapa ett Azure Data Explorer kluster och databas.

  3. Du verifierar distributionen genom att öppna resursgruppen i Azure Portal för att hitta det nya klustret och databasen.

Använda PowerShell för att distribuera mallen och verifiera malldistributionen

Distribuera mallen med powershell

  1. Välj Prova från följande kodblock och följ sedan anvisningarna för att logga in på 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. Välj Kopiera för att kopiera PowerShell-skriptet.

  3. Högerklicka på gränssnittskonsolen och välj klistra in. Det tar några minuter att skapa ett Azure Data Explorer kluster och databas.

Verifiera distributionen med PowerShell

Verifiera distributionen med hjälp av följande Azure PowerShell skript. Om Cloud Shell fortfarande är öppen behöver du inte kopiera/köra den första raden (Read-Host). Mer information om hur du hanterar Azure Data Explorer i PowerShell finns i Az.Kusto.

$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 ..."

Rensa resurser

När Azure-resurserna inte längre behövs rensar du de resurser som du har distribuerat genom att ta bort resursgruppen.

Rensa resurser med hjälp av Azure Portal

Ta bort resurserna i Azure Portal genom att följa stegen i rensa resurser.

Rensa resurser med hjälp av PowerShell

Om Cloud Shell fortfarande är öppen behöver du inte kopiera/köra den första raden (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 ..."

Nästa steg

Mata in data i Azure Data Explorer kluster och databas