Share via


Inicio rápido: Creación de un trabajo de Azure Stream Analytics mediante Bicep

En este inicio rápido, usará Bicep para crear un trabajo de Azure Stream Analytics. Una vez creado el trabajo, se valida la implementación.

Bicep es un lenguaje específico de dominio (DSL) que usa una sintaxis declarativa para implementar recursos de Azure. Brinda sintaxis concisa, seguridad de tipos confiable y compatibilidad con la reutilización de código. Bicep ofrece la mejor experiencia de creación para sus soluciones de infraestructura como código en Azure.

Requisitos previos

Para completar este artículo, se necesita una suscripción de Azure. cree una de forma gratuita.

Revisión del archivo de Bicep

El archivo de Bicep usado en este inicio rápido forma parte de las plantillas de inicio rápido de Azure.

@description('Location for the resources.')
param location string = resourceGroup().location

@description('Stream Analytics Job Name, can contain alphanumeric characters and hypen and must be 3-63 characters long')
@minLength(3)
@maxLength(63)
param streamAnalyticsJobName string

@description('You can choose the number of Streaming Units, ranging from 3, 7, 10, 20, 30, in multiples of 10, and continuing up to 660.')
@minValue(3)
@maxValue(660)

param numberOfStreamingUnits int

resource streamingJob 'Microsoft.StreamAnalytics/streamingjobs@2021-10-01-preview' = {
  name: streamAnalyticsJobName
  location: location
  properties: {
    sku: {
      name: 'StandardV2'
    }
    outputErrorPolicy: 'Stop'
    eventsOutOfOrderPolicy: 'Adjust'
    eventsOutOfOrderMaxDelayInSeconds: 0
    eventsLateArrivalMaxDelayInSeconds: 5
    dataLocale: 'en-US'
    transformation: {
      name: 'Transformation'
      properties: {
        streamingUnits: numberOfStreamingUnits
        query: 'SELECT\r\n    *\r\nINTO\r\n    [YourOutputAlias]\r\nFROM\r\n    [YourInputAlias]'
      }
    }
  }
}

output location string = location
output name string = streamingJob.name
output resourceGroupName string = resourceGroup().name
output resourceId string = streamingJob.id

El recurso de Azure definido en el archivo de Bicep es Microsoft.StreamAnalytics/StreamingJobs: cree un trabajo de Azure Stream Analytics.

Implementación del archivo de Bicep

  1. Guarde el archivo de Bicep como main.bicep en el equipo local.

  2. Implemente el archivo de Bicep mediante la CLI de Azure o Azure PowerShell.

    az group create --name exampleRG --location eastus
    az deployment group create --resource-group exampleRG --template-file main.bicep --parameters streamAnalyticsJobName =<job-name> numberOfStreamingUnits=<int>
    

    Debe proporcionar valores para los siguientes parámetros:

    • streamAnalyticsJobName: reemplace <job-name> por el nombre del trabajo de Stream Analytics. El nombre puede contener caracteres alfanuméricos y guiones, y debe tener al menos entre 3 y 63 caracteres de longitud.
    • numberOfStreamingUnits: reemplace <int> por el número de unidades de streaming. Los valores permitidos son: 1, 3, 6, 12, 18, 24, 30, 36, 42 y 48.

    Nota

    Una vez finalizada la implementación, debería mostrarse un mensaje indicando que la implementación se realizó correctamente.

Revisión de los recursos implementados

Puede usar Azure Portal para comprobar el trabajo de Azure Stream Analytics o utilizar el siguiente script de la CLI de Azure o Azure PowerShell para enumerar el recurso.

Azure CLI

Use los Azure Portal, CLI de Azure o Azure PowerShell para enumerar los recursos implementados en el grupo de recursos.

az resource list --resource-group exampleRG

Limpieza de recursos

Si tiene pensado seguir trabajando con los otros tutoriales, considere la posibilidad de dejar estos recursos activos. Cuando ya no lo necesite, elimine el grupo de recursos, que elimina el trabajo de Azure Stream Analytics. Para eliminar el grupo de recursos mediante la CLI de Azure o Azure PowerShell:

az group delete --name exampleRG

Pasos siguientes

En este inicio rápido, ha creado un trabajo de Azure Stream Analytics mediante Bicep y ha validado la implementación. Para obtener información sobre cómo crear sus propios archivos de Bicep mediante Visual Studio Code, continúe con el siguiente artículo: