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

  • 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 la CLI de Azure.

Prerrequisitos

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. Si necesita instalarla o actualizarla, consulte Instalación de la CLI de Azure.

Configuración de los parámetros de la CLI

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

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

    az login

  2. Establezca la suscripción donde quiere que se cree el clúster. Reemplace MyAzureSub por el nombre de la suscripción de Azure que quiere usar:

    az account set --subscription MyAzureSub

  3. Instale la extensión para usar la versión más reciente de la CLI de Kusto:

    az extension add -n kusto

Creación del clúster de Azure Data Explorer

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

    az kusto cluster create --cluster-name azureclitest --sku name="Standard_D13_v2" tier="Standard" --resource-group testrg --location westus
    Configuración Valor sugerido Descripción del campo
    name azureclitest Nombre que quiere para el clúster.
    sku Standard_D13_v2 La SKU que se usará para el clúster. Parámetros: nombre: el nombre de la SKU. tier: el nivel de SKU.
    resource-group testrg Nombre del grupo de recursos en el que se creará el clúster.
    ubicación westus La ubicación en la 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:

    az kusto cluster show --cluster-name azureclitest --resource-group 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:

    az kusto database create --cluster-name azureclitest --database-name clidatabase --resource-group testrg --read-write-database soft-delete-period=P365D hot-cache-period=P31D location=westus
    Configuración Valor sugerido Descripción del campo
    cluster-name azureclitest Nombre del clúster donde se creará la base de datos.
    database-name clidatabase Nombre de la base de datos.
    resource-group testrg Nombre del grupo de recursos en el que se creará el clúster.
    read-write-database P365DP31Dwestus El tipo de base de datos. Parámetros: soft-delete-period, indica la cantidad de tiempo que los datos estarán disponibles para consulta. Para más información, consulte Directiva de retención. hot-cache-period: cantidad de tiempo que los datos se conservarán en la caché. Para más información, consulte Directiva de caché. location: esta es la ubicación en la que se creará la base de datos.

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

    az kusto database show --database-name clidatabase --resource-group testrg --cluster-name azureclitest

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:

    az kusto cluster delete --cluster-name azureclitest --resource-group testrg

Pasos siguientes