Creación de un clúster y una base de datos de Azure Data Explorer mediante una plantilla de Azure Resource Manager

  • Artículo
  • Tiempo de lectura: 4 minutos

El Explorador de datos de Azure es un servicio de exploración de datos altamente escalable y rápido para datos de telemetría y registro. Para usar Azure Data Explorer, cree primero un clúster y una o varias bases de datos en ese clúster. A continuación, ingerirá (cargará) los datos en una base de datos para que pueda ejecutar consultas en ella.

En este artículo, crea un clúster y una base de datos de Azure Data Explorer mediante una plantilla de Azure Resource Manager. El artículo muestra cómo definir los recursos que se implementan y los parámetros que se especifican cuando se ejecuta la implementación. Puede usar esta plantilla para sus propias implementaciones o personalizarla para satisfacer sus necesidades. Para información sobre la creación de plantillas, consulte Creación de plantillas de Azure Resource Manager. Para la sintaxis y las propiedades de JSON que se usan en una plantilla, consulte Tipos de recursos de Microsoft.Kusto.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Plantilla de Azure Resource Manager para la creación de un clúster y una base de datos

En este inicio rápido se usa una plantilla de inicio rápido existente

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

Para buscar más ejemplos de plantillas, consulte Plantillas de inicio rápido de Azure.

Implementación de la plantilla y comprobación de esta

Puede implementar la plantilla de Azure Resource Manager mediante Azure Portal o mediante PowerShell.

Uso de Azure Portal para implementar la plantilla y comprobación de esta

  1. Con el fin de crear un clúster y una base de datos, use el botón siguiente para iniciar la implementación. Haga clic con el botón derecho y seleccione Abrir en una ventana nueva para seguir el resto de los pasos de este artículo.

    Captura de pantalla de un botón azul que representa las nubes y cuya etiqueta es Implementar en Azure.

    El botón Deploy to Azure (Implementar en Azure) le lleva a Azure Portal para rellenar un formulario de implementación.

    Captura de pantalla de una plantilla en Azure Portal. Están resaltados todos los botones, cuadros y casillas que se usan en la edición.

    Puede editar e implementar la plantilla en Azure Portal mediante el formulario.

  2. Complete las secciones ASPECTOS BÁSICOS y CONFIGURACIÓN. Seleccione nombres de base de datos y clúster únicos. La creación de un clúster y una base de datos de Azure Data Explorer tarda unos minutos.

  3. Para comprobar la implementación, abra el grupo de recursos en Azure Portal para encontrar sus nuevos clúster y base de datos.

Uso de PowerShell para implementar la plantilla y comprobación de esta

Implementación de la plantilla mediante PowerShell

  1. Seleccione Probar en el bloque de código siguiente y luego siga las instrucciones para iniciar sesión en 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. Seleccione Copiar para copiar el script de PowerShell.

  3. Haga clic con el botón derecho en la consola del shell y seleccione Pegar. La creación de un clúster y una base de datos de Azure Data Explorer tarda unos minutos.

Comprobación de la implementación mediante PowerShell

Para comprobar la implementación, use el siguiente script de Azure PowerShell. Si Cloud Shell sigue abierto, no es necesario copiar ni ejecutar la primera línea (Read-Host). Para obtener más información sobre la administración de recursos de Azure Data Explorer en PowerShell, lea 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 ..."

Limpieza de recursos

Cuando los recursos de Azure ya no sean necesarios, limpie los recursos que implementó eliminando el grupo de recursos.

Limpieza de recursos mediante Azure Portal

Elimine los recursos en Azure Portal siguiendo los pasos en Limpieza de recursos.

Limpieza de recursos mediante PowerShell

Si Cloud Shell sigue abierto, no es necesario copiar ni ejecutar la primera línea (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 ..."

Pasos siguientes

Ingest data into Azure Data Explorer cluster and database (Ingesta de datos en el clúster y la base de datos de Azure Data Explorer)