Mulai Cepat: Membuat pekerjaan Azure Stream Analytics menggunakan Bicep

Artikel
06/01/2023

Dalam mulai cepat ini, Anda menggunakan Bicep untuk membuat pekerjaan Azure Stream Analytics. Setelah pekerjaan dibuat, Anda akan memvalidasi penyebaran.

Bicep adalah bahasa pemrogram khusus domain (DSL) yang menggunakan sintaks deklaratif untuk menyebarkan sumber daya Azure. Bicep menyediakan sintaks ringkas, keamanan jenis yang andal, dan dukungan untuk penggunaan kembali kode. Bicep menawarkan pengalaman penulisan terbaik untuk solusi infrastructure-as-code di Azure.

Prasyarat

Untuk menyelesaikan artikel ini, Anda harus memiliki langganan Azure. Membuat satu akun gratis.

Tinjau file Bicep

File Bicep yang digunakan dalam mulai cepat berasal dari Templat Mulai Cepat 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

Sumber daya Azure yang ditentukan dalam file Bicep adalah Microsoft.StreamAnalytics/StreamingJobs: buat tugas Azure Stream Analytics.

Menerapkan file Bicep

Simpan file Bicep sebagai main.bicep ke komputer lokal Anda.
Sebarkan file Bicep menggunakan Azure CLI atau 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>
```
Anda perlu memberikan nilai untuk parameter berikut:
- streamAnalyticsJobName: Ganti <nama pekerjaan> dengan nama pekerjaan Azure Stream Analytics. Nama dapat berisi karakter alfanumerik dan tanda hubung, dan panjangnya harus minimal 3-63 karakter.
- numberOfStreamingUnits: Ganti <int> dengan jumlah Unit Streaming. Nilai yang diizinkan meliputi: 1, 3, 6, 12, 18, 24, 30, 36, 42, dan 48.
Catatan

Setelah penyebaran selesai, Anda akan melihat pesan yang menunjukkan penyebaran berhasil.

Meninjau sumber daya yang disebarkan

Anda dapat menggunakan portal Microsoft Azure untuk memeriksa pekerjaan Azure Stream Analytics atau menggunakan Azure CLI atau skrip Azure PowerShell berikut untuk mencantumkan sumber daya.

Azure CLI

Gunakan portal Microsoft Azure, Azure CLI, atau Azure PowerShell untuk mencantumkan sumber daya yang disebarkan dalam grup sumber daya.

CLI
PowerShell

az resource list --resource-group exampleRG

Get-AzResource -ResourceGroupName exampleRG

Membersihkan sumber daya

Jika Anda berencana untuk melanjutkan ke tutorial berikutnya, sebaiknya tinggalkan sumber daya ini. Jika sudah tidak diperlukan, hapus grup sumber daya, yang juga akan menghapus pekerjaan Azure Stream Analytics. Untuk menghapus grup sumber daya menggunakan Azure CLI atau Azure PowerShell:

CLI
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Langkah berikutnya

Dalam panduan memulai ini, Anda membuat tugas Azure Stream Analytics menggunakan Bicep dan memvalidasi penyebaran. Untuk mempelajari cara membuat file Bicep Anda sendiri menggunakan Visual Studio Code, lanjutkan ke artikel berikut:

Mulai cepat: Membuat file Bicep dengan Visual Studio Code

Share via