快速入門：使用 Bicep 來建立 Azure 串流分析工作

發行項
03/11/2024

在本快速入門中，您使用 Bicep 來建立 Azure 串流分析工作。建立作業之後，即可驗證該部署。

Bicep 是使用宣告式語法來部署 Azure 資源的特定領域語言 (DSL)。其提供簡潔的語法、可靠的類型安全，並支援程式碼重複使用。 Bicep 能夠為您在 Azure 中的基礎結構即程式碼解決方案，提供最佳的製作體驗。

必要條件

若要完成本文，您需要有 Azure 訂用帳戶。免費建立一個。

檢閱 Bicep 檔案

此快速入門中使用的 Bicep 檔案是來自 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

Bicep 檔案中所定義的 Azure 資源是 Microsoft.StreamAnalytics/StreamingJobs：建立 Azure 串流分析工作。

部署 Bicep 檔案

將 Bicep 檔案以 main.bicep 儲存至本機電腦。
使用 Azure CLI 或 Azure PowerShell 部署 Bicep 檔案。
- 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>
```
您需要提供下列參數的值：
- streamAnalyticsJobName：將 <job-name> 取代為串流分析工作名稱。名稱可以包含英數字元和連字號，而且其長度至少必須為 3-63 個字元。
- numberOfStreamingUnits：將 <int> 取代為串流單位數目。允許的值包括：1、3、6、12、18、24、30、36、42 和 48。
注意

當部署完成時，您應該會看到指出部署成功的訊息。

檢閱已部署的資源

您可以使用 Azure 入口網站來檢查 Azure 串流分析作業，或使用下列 Azure CLI 或 Azure PowerShell 指令碼來列出資源。

Azure CLI

使用 Azure 入口網站、Azure CLI 或 Azure PowerShell 來列出資源群組中已部署的資源。

CLI
PowerShell

az resource list --resource-group exampleRG

Get-AzResource -ResourceGroupName exampleRG

清除資源

如果您預計繼續進行後續的教學課程，可以讓這些資源留在原處。當不再需要時，請刪除資源群組，這會刪除 Azure 串流分析作業。若要使用 Azure CLI 或 Azure PowerShell 刪除資源群組：

CLI
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

下一步

在本快速入門中，您已使用 Bicep 來建立 Azure 串流分析工作，並已驗證該部署。若要了解如何使用 Visual Studio Code 來建立您自己的 Bicep 檔案，請繼續閱讀下列文章：

快速入門：使用 Visual Studio Code 建立 Bicep 檔案

共用方式為