クイック スタート: Bicep を使用して Azure Stream Analytics ジョブを作成する

このクイックスタートでは、Bicep を使って Azure Stream Analytics ジョブを作成します。 ジョブの作成後、デプロイを検証します。

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 Stream Analytics ジョブを作成します。

Bicep ファイルをデプロイする

1. Bicep ファイルを main.bicep としてローカル コンピューターに保存します。

2. 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>
   

   次のパラメーターの値を指定する必要があります。

   • streamAnalyticsJobName: <job-name> を Stream Analytics ジョブの名前に置き換えます。 名前は、英数字とハイフンのみを含み、3 文字から 63 文字の長さにする必要があります。
   • numberOfStreamingUnits: <int> をストリーミング ユニットの数に置き換えます。 指定できる値は、1、3、6、12、18、24、30、36、42、48 です。

   注意

   デプロイが完了すると、デプロイが成功したことを示すメッセージが表示されます。

デプロイされているリソースを確認する

Azure portal を使用して Azure Stream Analytics ジョブを確認するか、次の Azure CLI または Azure PowerShell スクリプトを使用してリソースを一覧表示できます。

Azure CLI

Azure portal、Azure CLI、または Azure PowerShell を使用して、リソースグループ内のデプロイ済みリソースをリスト表示します。

az resource list --resource-group exampleRG

Get-AzResource -ResourceGroupName exampleRG

リソースをクリーンアップする

引き続き後続のチュートリアルに進む場合は、これらのリソースをそのまま残しておくことをお勧めします。 不要になったら、リソース グループを削除してください。リソース グループを削除すれば、Azure Stream Analytics ジョブが削除されます。 Azure CLI または Azure PowerShell を使用してリソース グループを削除するには、次を実行します。

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

次の手順

このクイックスタートでは、Bicep を使って Azure Stream Analytics ジョブを作成し、デプロイを検証しました。 Visual Studio Code を使って独自の Bicep ファイルを作成する方法については、次の記事をご覧ください。