Quickstart: Een Azure Stream Analytics-taak maken met behulp van een ARM-sjabloon

Azure Stream Analytics is een realtime analysedienst die streamingdata verwerkt van bronnen zoals apparaten, sensoren en applicaties. In deze quickstart gebruikt u een ARM-sjabloon (Azure Resource Manager-sjabloon) om een Azure Stream Analytics-taak te maken. Nadat je de taak hebt aangemaakt, valideer je de implementatie.

Een Azure Resource Manager-sjabloon is een JSON-bestand (JavaScript Object Notation) dat de infrastructuur en configuratie voor uw project definieert. Voor de sjabloon is declaratieve syntaxis vereist. U beschrijft de beoogde implementatie zonder de reeks programmeeropdrachten te schrijven om de implementatie te maken.

Als uw omgeving voldoet aan de vereisten en u benkend bent met het gebruik van ARM-sjablonen, selecteert u de knop Implementeren naar Azure. De sjabloon wordt in Azure Portal geopend.

Knop voor het implementeren van de Resource Manager-sjabloon in Azure.

Vereisten

U hebt het volgende nodig om dit artikel te voltooien:

De sjabloon controleren

In deze quickstart wordt een sjabloon uit Azure QuickStart-sjablonen gebruikt.

{
  "$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'))]"
    }
  }
}

Het sjabloon definieert de volgende bron:

De sjabloon implementeren

In deze sectie maak je een Azure Stream Analytics-taak aan door gebruik te maken van de ARM-template.

  1. Selecteer de volgende afbeelding om u aan te melden bij Azure en een sjabloon te openen. Met de sjabloon wordt een Azure Stream Analytics-taak gemaakt.

    Knop voor het implementeren van de Resource Manager-sjabloon in Azure.

  2. Geef de vereiste waarden op om de Azure Stream Analytics-taak te maken.

    Screenshot van de Azure portal custom deployment-pagina waarop de property-velden worden getoond voor het aanmaken van een Azure Stream Analytics-taak vanuit een ARM-template.

    Geef de volgende waarden op:

    Eigenschap Beschrijving
    Abonnement Selecteer uw Azure-abonnement in de vervolgkeuzelijst.
    Resourcegroep Geef aan of u een nieuwe resourcegroep wilt maken of een bestaande groep wilt gebruiken. Een resourcegroep is een container met gerelateerde resources voor een Azure-oplossing. Zie Overzicht van Azure Resource Manager voor meer informatie.
    Regio Selecteer East US. Voor andere beschikbare regio's, zie Azure-services beschikbaar per regio.
    Naam van Stream Analytics-taak Geef de Stream Analytics-taak een naam.
    Aantal streaming-eenheden Kies het aantal streaming-eenheden dat u nodig hebt. Zie Streaming-eenheden begrijpen en aanpassen.
  3. Selecteer Beoordelen + maken en vervolgens Maken.

Uitgerolde resources bekijken

Gebruik ofwel het Azure-portaal om de Azure Stream Analytics-taak te controleren, of een Azure CLI- of Azure PowerShell-script om de bron te vermelden.

Azure Portal

Wanneer de implementatie is voltooid, selecteer Ga naar resource om naar de Stream Analytics Job-pagina van de taak te gaan.

Azure-CLI

Gebruik de opdracht az stream-analytics job show voor meer informatie over de taak die u hebt gemaakt. Vervang tijdelijke aanduidingen door de id van uw Azure-abonnement, de naam van de resourcegroep en de naam van de Stream Analytics-taak.

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

Azure PowerShell

Gebruik de opdracht Get-AzStreamAnalyticsJob voor meer informatie over de taak die u hebt gemaakt. Vervang tijdelijke aanduidingen door de id van uw Azure-abonnement, de naam van de resourcegroep en de naam van de Stream Analytics-taak.

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

Hulpbronnen opschonen

Als je van plan bent door te gaan met volgende tutorials, wil je deze bronnen misschien behouden. Als je deze bronnen niet meer nodig hebt, verwijder dan de resourcegroep. Het verwijderen van de resourcegroep verwijdert ook de Azure Stream Analytics-taak. Zo verwijdert u de resourcegroep met behulp van Azure CLI of Azure PowerShell:

Azure-CLI

az group delete --name RESOURCEGROUPNAME

Azure PowerShell

Remove-AzResourceGroup -Name RESOURCEGROUPNAME

Volgende stappen

In deze quickstart hebt u een Azure Stream Analytics-taak gemaakt met behulp van een ARM-sjabloon en de implementatie gevalideerd. Ga verder naar het volgende artikel om te leren hoe je een ARM-template voor een bestaande taak kunt exporteren met VS Code.