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

Artigo
06/13/2024

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

O Bicep é uma linguagem específica do domínio que utiliza sintaxe declarativa para implementar recursos do Azure. Fornece sintaxe concisa, segurança de tipos fiá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 ter uma assinatura do Azure. Crie um gratuitamente.

Revise o arquivo Bicep

O arquivo Bicep usado neste início rápido é de 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 arquivo Bicep é Microsoft.StreamAnalytics/StreamingJobs: create an Azure Stream Analytics job.

Implantar o arquivo Bicep

Salve o arquivo Bicep como main.bicep em seu computador local.
Implante o arquivo Bicep usando 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ífenes, e deve ter pelo menos 3-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.
Nota

Quando a implantação terminar, você verá uma mensagem indicando que a implantação foi bem-sucedida.

Rever os recursos implementados

Você pode usar o portal do Azure para verificar o trabalho do Azure Stream Analytics ou usar o seguinte script da CLI do Azure ou do Azure PowerShell 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

Clean up resources (Limpar recursos)

Se você planeja continuar com os tutoriais subsequentes, talvez queira deixar esses recursos no lugar. Quando não for mais necessário, exclua o grupo de recursos, que exclui 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óximos passos

Neste 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 para o seguinte artigo:

Guia de início rápido: criar arquivos Bicep com o Visual Studio Code

Partilhar via