Vytvoření Azure Data Explorer clusteru a databáze pomocí Azure Resource Manager šablony

Průzkumník dat Azure je rychlá a vysoce škálovatelná služba pro zkoumání dat protokolů a telemetrie. Pokud chcete použít Azure Data Explorer, musíte nejdříve vytvořit cluster a v něm vytvořit jednu nebo více databází. Do databáze potom ingestujete (načtete) data, abyste se na ně mohli dotazovat spouštěním dotazů.

V tomto článku vytvoříte cluster Azure Data Explorer databáze pomocí šablony Azure Resource Manager . Tento článek popisuje, jak definovat, které prostředky se nasadí a jak definovat parametry, které jsou zadány při spuštění nasazení. Tuto šablonu můžete použít pro vlastní nasazení nebo ji upravit, aby splňovala vaše požadavky. Informace o vytváření šablon najdete v tématu vytváření Azure Resource Manager šablonách. Informace o syntaxi a vlastnostech JSON, které se mají použít v šabloně, najdete v tématu Typy prostředků Microsoft.Kusto.

Pokud předplatné Azure ještě nemáte, napřed si vytvořte bezplatný účet.

Azure Resource Manager šablony pro vytvoření clusteru a databáze

V tomto článku použijete existující šablonu pro rychlý start.

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

Další ukázky šablon najdete v tématu Šablony Azure pro rychlý start.

Nasazení šablony a ověření nasazení šablony

Šablonu šablony Azure Resource Manager nasadit pomocí rutiny Azure Portalnebo powershellu.

K nasazení Azure Portal a ověření nasazení šablony použijte následující kód.

  1. Pokud chcete vytvořit cluster a databázi, spusťte nasazení pomocí následujícího tlačítka. Klikněte pravým tlačítkem a vyberte Otevřít v novém okně,abyste mohli postupovat podle zbývajících kroků v tomto článku.

    Snímek obrazovky s modrým tlačítkem, které vyfotuje cloudy a je označené jako Nasadit do Azure

    Výběrem tlačítka Deploy to Azure (Nasadit do Azure) přejdete na web Azure Portal, kde vyplníte formulář nasazení.

    Snímek obrazovky se šablonou na Azure Portal Všechna tlačítka, pole a zaškrtávací políčka použitá při úpravách jsou zvýrazněná.

    Šablonu můžete upravit a nasadit v Azure Portal pomocí formuláře.

  2. Dokončete oddílY ZÁKLADY a NASTAVENÍ. Vyberte jedinečné názvy clusteru a databáze. Vytvoření clusteru a databáze Azure Data Explorer několik minut.

  3. Pokud chcete nasazení ověřit, otevřete skupinu prostředků v Azure Portal a vyhledejte nový cluster a databázi.

Nasazení šablony pomocí PowerShellu a ověření nasazení šablony

Nasazení šablony pomocí PowerShellu

  1. V následujícím bloku kódu vyberte Vyzkoušet a pak se podle pokynů přihlaste k Azure Cloud Shellu.

    $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. Vyberte Kopírovat a zkopírujte skript PowerShellu.

  3. Klikněte pravým tlačítkem na konzolu prostředí a pak vyberte Vložit. Vytvoření clusteru a databáze Azure Data Explorer několik minut.

Ověření nasazení pomocí PowerShellu

K ověření nasazení použijte následující Azure PowerShell skriptu. Pokud Cloud Shell otevřený, nemusíte kopírovat/spouštět první řádek (Read-Host). Další informace o správě prostředků Azure Data Explorer v PowerShellu najdete v tématu 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 ..."

Vyčištění prostředků

Pokud už nasazené prostředky Azure nepotřebujete, vyčistěte je odstraněním skupiny prostředků.

Vyčištění prostředků pomocí Azure Portal

Odstraňte prostředky v Azure Portal podle postupu v části Vyčištění prostředků.

Vyčištění prostředků pomocí PowerShell

Pokud Cloud Shell otevřený, nemusíte kopírovat/spouštět první řádek (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 ..."

Další kroky

Ingestování dat do Azure Data Explorer clusteru a databáze