クイック スタート: ARM テンプレートを使用して Azure Stream Analytics ジョブを作成する

Azure Stream Analyticsは、デバイス、センサー、アプリケーションなどのソースからのストリーミングデータをリアルタイムで処理するサービスです。 このクイックスタートでは、Azure Resource Manager テンプレート (ARM テンプレート) を使用して、Azure Stream Analytics ジョブを作成します。 ジョブを作成した後、デプロイメントの検証を行います。

Azure Resource Manager テンプレートは JavaScript Object Notation (JSON) ファイルであり、プロジェクトのインフラストラクチャと構成が定義されています。 このテンプレートでは、宣言型の構文が使用されています。 デプロイしようとしているものを、デプロイを作成する一連のプログラミング コマンドを記述しなくても記述できます。

環境が前提条件を満たしていて、ARM テンプレートの使用に慣れている場合は、 [Azure へのデプロイ] ボタンを選択します。 テンプレートが Azure portal で開きます。

Resource Manager テンプレートを Azure にデプロイするボタン。

前提条件

この記事を完了するには、以下が必要です。

テンプレートを確認する

このクイック スタートでは、クイック スタート テンプレートのテンプレートAzure使用します。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.26.54.24096",
      "templateHash": "8637009133184248358"
    }
  },
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for the resources."
      }
    },
    "streamAnalyticsJobName": {
      "type": "string",
      "minLength": 3,
      "maxLength": 63,
      "metadata": {
        "description": "Stream Analytics Job Name, can contain alphanumeric characters and hypen and must be 3-63 characters long"
      }
    },
    "numberOfStreamingUnits": {
      "type": "int",
      "minValue": 3,
      "maxValue": 660,
      "metadata": {
        "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."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.StreamAnalytics/streamingjobs",
      "apiVersion": "2021-10-01-preview",
      "name": "[parameters('streamAnalyticsJobName')]",
      "location": "[parameters('location')]",
      "properties": {
        "sku": {
          "name": "StandardV2"
        },
        "outputErrorPolicy": "Stop",
        "eventsOutOfOrderPolicy": "Adjust",
        "eventsOutOfOrderMaxDelayInSeconds": 0,
        "eventsLateArrivalMaxDelayInSeconds": 5,
        "dataLocale": "en-US",
        "transformation": {
          "name": "Transformation",
          "properties": {
            "streamingUnits": "[parameters('numberOfStreamingUnits')]",
            "query": "SELECT\r\n    *\r\nINTO\r\n    [YourOutputAlias]\r\nFROM\r\n    [YourInputAlias]"
          }
        }
      }
    }
  ],
  "outputs": {
    "location": {
      "type": "string",
      "value": "[parameters('location')]"
    },
    "name": {
      "type": "string",
      "value": "[parameters('streamAnalyticsJobName')]"
    },
    "resourceGroupName": {
      "type": "string",
      "value": "[resourceGroup().name]"
    },
    "resourceId": {
      "type": "string",
      "value": "[resourceId('Microsoft.StreamAnalytics/streamingjobs', parameters('streamAnalyticsJobName'))]"
    }
  }
}

テンプレートは以下のリソースを定義しています:

テンプレートのデプロイ

このセクションでは、ARMテンプレートを使ってAzure Stream Analyticsジョブを作成します。

  1. Azure にサインインし、テンプレートを開くには次のイメージを選択します。 テンプレートによって Azure Stream Analytics ジョブが作成されます。

    Resource Manager テンプレートを Azure にデプロイするボタン。

  2. Azure Stream Analytics ジョブを作成するために必要な値を入力します。

    Azureポータルのカスタムデプロイページで、ARMテンプレートからAzure Stream Analyticsジョブを作成するためのプロパティフィールドが示されています。

    次の値を指定します。

    プロパティ 説明
    サブスクリプション ドロップダウンから Azure サブスクリプションを選択します。
    リソース グループ 新しいリソース グループを作成するか、既存のリソース グループを使用するかを指定します。 リソース グループは、Azure ソリューションの関連するリソースを保持するコンテナーです。 詳しくは、Azure リソース グループの概要に関するページをご覧ください。
    リージョン [米国東部] を選択します。 使用可能な他のリージョンについては、「リージョン別の利用可能な製品」をご覧ください。
    Stream Analytics ジョブ名 Stream Analytics ジョブの名前を指定します。
    ストリーミング ユニットの数 必要なストリーミング ユニット数を選択します。 詳細については、「ストリーミング ユニットの理解と調整」をご覧ください。

  3. [確認および作成] 、 [作成] の順に選択します。

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

AzureポータルでAzure Stream Analyticsジョブを確認するか、Azure CLIやAzure PowerShellスクリプトでリソースをリストアップしてください。

Azure portal

展開が完了したら、「 リソースへへ行く」 を選択して、そのジョブの Stream Analyticsジョブ ページに移動します。

Azure CLI

az stream-analytics job show コマンドを使用して、作成したジョブの詳細を取得します。 プレースホルダーは、Azure サブスクリプション ID、リソース グループ名、Stream Analytics ジョブ名に置き換えます。

az stream-analytics job show -s SUBSCRIPTIONID -g RESOURCEGROUPNAME -n ASAJOBNAME

Azure PowerShell

Get-AzStreamAnalyticsJob コマンドを使用して、作成したジョブの詳細を取得します。 プレースホルダーは、Azure サブスクリプション ID、リソース グループ名、Stream Analytics ジョブ名に置き換えます。

Get-AzStreamAnalyticsJob -SubscriptionID $subscriptionID -ResourceGroupName $resourceGroupName -Name $streamAnalyticsJobName

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

もし今後のチュートリアルを続ける予定があるなら、これらの教材を残しておくと良いでしょう。 これらのリソースが不要になったら、リソースグループを削除してください。 リソースグループを削除するとAzure Stream Analyticsジョブも削除されます。 Azure CLI または Azure PowerShell を使用してリソース グループを削除するには、次を実行します。

Azure CLI

az group delete --name RESOURCEGROUPNAME

Azure PowerShell

Remove-AzResourceGroup -Name RESOURCEGROUPNAME

次のステップ

このクイックスタートでは、ARM テンプレートを使用して Azure Stream Analytics ジョブを作成し、デプロイを検証しました。 次の記事に進んで、VS Codeを使って既存ジョブ用のARMテンプレートをエクスポートする方法を学びましょう。

Azure Stream Analytics ジョブの ARM テンプレートをエクスポートする

  • Last updated on