Share via

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

  • [アーティクル]

このクイックスタートでは、Azure Resource Manager テンプレート (ARM テンプレート) を使用して、Azure Stream Analytics ジョブを作成します。 ジョブの作成後、デプロイを検証します。

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

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

Button to deploy the Resource Manager template to 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'))]"
    }
  }
}

テンプレートで定義されている Azure リソースは Microsoft.StreamAnalytics/StreamingJobs です。つまり Azure Stream Analytics ジョブを作成します。

テンプレートのデプロイ

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

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

    Button to deploy the Resource Manager template to Azure.

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

    Create Azure Stream Analytics job using an Azure Resource Manager template

    次の値を指定します。

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

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

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

Azure portal を使用して 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 テンプレートをエクスポートする