Guia de início rápido: Criar um trabalho do Azure Stream Analytics usando o Bicep

Artigo
06/01/2023

Neste guia de início rápido, você usará o Bicep para criar um trabalho do Azure Stream Analytics. Depois que o trabalho for criado, você validará a implantação.

O Bicep é um DSL (linguagem específica de domínio) que usa sintaxe declarativa para implantar recursos do Azure. Ele fornece sintaxe concisa, segurança de tipos confiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para suas soluções de infraestrutura como código no Azure.

Pré-requisitos

Para concluir este artigo, você precisa de uma assinatura do Azure. Crie um gratuitamente.

Examinar o arquivo Bicep

O arquivo Bicep usado neste guia de início rápido vem dos Modelos de início rápido do 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

O recurso do Azure definido no Bicep é Microsoft.StreamAnalytics/StreamingJobs: criar um trabalho do Azure Stream Analytics.

Implante o arquivo Bicep

Salve o arquivo Bicep como main.bicep em seu computador local.
Para implantar o arquivo Bicep, use a CLI do Azure ou o Azure PowerShell.
- CLI
- 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>
```
```
New-AzResourceGroup -Name exampleRG -Location eastus
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -streamAnalyticsJobName "<job-name>" -numberOfStreamingUnits <int>
```
Você precisa fornecer valores para os seguintes parâmetros:
- streamAnalyticsJobName: substitua <job-name> pelo nome do trabalho do Stream Analytics. O nome pode conter caracteres alfanuméricos e hífens e precisa ter no mínimo de 3 a 63 caracteres.
- numberOfStreamingUnits: substitua <int> pelo número de unidades de streaming. Os valores permitidos incluem: 1, 3, 6, 12, 18, 24, 30, 36, 42 e 48.
Observação

Quando a implantação for concluída, você deverá ver uma mensagem indicando que ela foi bem-sucedida.

Examinar os recursos implantados

Use o portal do Azure para verificar o trabalho do Azure Stream Analytics ou use o script da CLI do Azure ou do Azure PowerShell a seguir para listar o recurso.

CLI do Azure

Use o portal do Azure, a CLI do Azure ou o Azure PowerShell para listar os recursos implantados no grupo de recursos.

CLI
PowerShell

az resource list --resource-group exampleRG

Get-AzResource -ResourceGroupName exampleRG

Limpar os recursos

Se você pretende prosseguir com os tutoriais seguintes, mantenha esses recursos em vigor. Quando você não precisar mais do grupo de recursos, exclua-o, o que excluirá o trabalho do Azure Stream Analytics. Para excluir o grupo de recursos usando a CLI do Azure ou o Azure PowerShell:

CLI
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Próximas etapas

Neste guia de início rápido, você criou um trabalho do Azure Stream Analytics usando o Bicep e validou a implantação. Para saber como criar seus próprios arquivos Bicep usando o Visual Studio Code, continue no seguinte artigo:

Início Rápido: criar arquivos Bicep com o Visual Studio Code

Compartilhar via