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

  • Artículo
  • Tiempo de lectura: 4 minutos

Azure Data Explorer es un servicio de análisis de datos rápido y totalmente administrado para analizar en tiempo real grandes volúmenes de datos de que se transmiten desde aplicaciones, sitios web, dispositivos IoT, etc. 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, se crean un clúster y una base de datos mediante PowerShell. Los scripts y cmdlets de PowerShell se pueden ejecutar en Windows, Linux, o en Azure Cloud Shell con Az.Kusto para crear y configurar clústeres y bases de datos de Azure Data Explorer.

Requisitos previos

Nota:

Este artículo se ha actualizado para usar el nuevo módulo Az de Azure PowerShell. Aún puede usar el módulo de AzureRM que continuará recibiendo correcciones de errores hasta diciembre de 2020 como mínimo. Para más información acerca del nuevo módulo Az y la compatibilidad con AzureRM, consulte Introducing the new Azure PowerShell Az module (Presentación del nuevo módulo Az de Azure PowerShell). Para obtener instrucciones sobre la instalación del módulo Az, consulte Instalación de Azure PowerShell.

Uso de Azure Cloud Shell

En Azure se hospeda Azure Cloud Shell, un entorno de shell interactivo que puede utilizar mediante el explorador. Puede usar Bash o PowerShell con Cloud Shell para trabajar con los servicios de Azure. Puede usar los comandos preinstalados de Cloud Shell para ejecutar el código de este artículo sin tener que instalar nada en su entorno local.

Para iniciar Azure Cloud Shell:

Opción Ejemplo o vínculo
Seleccione Pruébelo en la esquina superior derecha de un bloque de código. Solo con seleccionar Pruébelo no se copia automáticamente el código en Cloud Shell. Ejemplo de Pruébalo para Azure Cloud Shell.
Vaya a https://shell.azure.com o seleccione el botón https://shell.azure.com para abrir Cloud Shell en el explorador. Inicie Cloud Shell en una nueva ventana.
Seleccione el botón Cloud Shell en la barra de menús de la esquina superior derecha de Azure Portal. Cloud Shell de la Azure Portal.

Para ejecutar el código de este artículo en Azure Cloud Shell:

  1. Inicie Cloud Shell.

  2. Seleccione el botón Copiar de un bloque de código para copiar el código.

  3. Pegue el código en la sesión Cloud Shell seleccionando CtrlMayús V en Windows y Linux o seleccionando CmdMayúsV en macOS.

  4. Seleccione Entrar para ejecutar el código.

  • Si decide instalar y usar la CLI de Azure localmente, para este artículo es preciso la CLI de Azure versión 2.0.4 o posterior. Ejecute az --version para comprobar la versión. Para la instalación o la actualización, consulte Instalación de la CLI de Azure.

  • Para la asignación del rol de lector de base de datos o administrador de base de datos, consulte Asignación de roles de seguridad.

Configuración de parámetros

Los pasos siguientes no son necesarios si ejecuta comandos en Azure Cloud Shell. Si ejecuta la CLI localmente, siga los pasos 1 2 para iniciar sesión en Azure y & establecer la suscripción actual:

  1. Ejecute el siguiente comandos para iniciar sesión en Azure:

    Connect-AzAccount

  2. Establezca la suscripción en el lugar en que desee que se cree el clúster:

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

  3. Si ejecuta la CLI de Azure localmente o en Azure Cloud Shell, es preciso que instale el módulo Az.Kusto en el dispositivo:

     Install-Module -Name Az.Kusto

Creación del clúster de Azure Data Explorer

  1. Cree el clúster mediante el siguiente comando:

     New-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster -Location westus2 -SkuTier Standard -SkuCapacity 2 -SkuName 'Standard_D11_v2'
    Configuración Valor sugerido Descripción del campo
    Nombre mykustocluster Nombre que quiere para el clúster.
    SKU D13_v2 La SKU que se usará para el clúster.
    ResourceGroupName testrg Nombre del grupo de recursos en el que se creará el clúster.

    Hay varios parámetros opcionales que puede usar, como la capacidad del clúster, etcétera.

  2. Ejecute el siguiente comando para comprobar si el clúster se creó correctamente:

    Get-AzKustoCluster -Name mykustocluster -ResourceGroupName testrg

Si el resultado contiene provisioningState con el valor Succeeded, significa que el clúster se ha creado correctamente.

Creación de la base de datos en el clúster de Azure Data Explorer

  1. Cree la base de datos con el siguiente comando:

    New-AzKustoDatabase -ResourceGroupName testrg -ClusterName mykustocluster -Name mykustodatabase -SoftDeletePeriod 3650:00:00:00 -HotCachePeriod 3650:00:00:00
    Configuración Valor sugerido Descripción del campo
    ClusterName mykustocluster Nombre del clúster donde se creará la base de datos.
    Nombre mykustodatabase Nombre de la base de datos.
    ResourceGroupName testrg Nombre del grupo de recursos en el que se creará el clúster.
    SoftDeletePeriod 3650:00:00:00 Cantidad de tiempo que los datos estarán disponibles para consulta.
    HotCachePeriod 3650:00:00:00 Cantidad de tiempo que los datos se conservarán en la caché.

  2. Ejecute el siguiente comando para ver la base de datos que ha creado:

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

Ahora cuenta con un clúster y una base de datos.

Limpieza de recursos

  • Si tiene previsto seguir nuestros otros artículos, conserve los recursos que creó.

  • Para limpiar los recursos, elimine el clúster. Cuando se elimina un clúster, también se eliminan todas las bases de datos en él. Use el siguiente comando para eliminar el clúster:

    Remove-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster

Pasos siguientes