Início rápido: Criar um trabalho do Azure Stream Analytics por meio de um modelo do ARM

Azure Stream Analytics é um serviço de análise em tempo real que processa dados em streaming de fontes como dispositivos, sensores e aplicações. Neste guia de início rápido, você usará um modelo do Azure Resource Manager (modelo ARM) para criar um trabalho do Azure Stream Analytics. Depois de criar a tarefa, você valida a implantação.

Um Modelo do Azure Resource Manager é um arquivo JSON (JavaScript Object Notation) que define a infraestrutura e a configuração do seu projeto. O modelo usa a sintaxe declarativa. Você descreve a implantação pretendida sem escrever a sequência de comandos de programação para criar a implantação.

Se seu ambiente atender aos pré-requisitos e você estiver familiarizado com o uso de modelos ARM, selecione o botão Implantar no Azure. O modelo é aberto no portal do Azure.

Botão para implantar o modelo do Resource Manager no Azure.

Pré-requisitos

Para concluir este artigo, você precisará:

Examinar o modelo

Este guia de início rápido usa um modelo do Azure Quickstart Templates.

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

O modelo define o seguinte recurso:

Implantar o modelo

Nesta seção, você cria um trabalho de Azure Stream Analytics usando o template ARM.

  1. Selecione a imagem a seguir para entrar no Azure e abrir um modelo. O modelo cria um trabalho do Azure Stream Analytics.

    Botão para implantar o modelo do Resource Manager no Azure.

  2. Forneça os valores necessários para criar seu trabalho do Azure Stream Analytics.

    Captura de tela da página de implantação personalizada do portal Azure mostrando os campos de propriedades para criar um trabalho Azure Stream Analytics a partir de um template ARM.

    Forneça os seguintes valores:

    Propriedade Descrição
    Assinatura Na lista suspensa, selecione sua assinatura do Azure.
    Grupo de recursos Especifique se deseja criar um novo grupo de recursos ou usar um existente. Um grupo de recursos é um contêiner que mantém os recursos relacionados a uma solução do Azure. Para obter mais informações, consulte Visão geral do Grupo de Recursos do Azure.
    Região Selecione Leste dos EUA. Para outras regiões disponíveis, consulte serviços do Azure por região.
    Nome do Trabalho do Stream Analytics Forneça um nome para o trabalho do Stream Analytics.
    Número de unidades de streaming Escolha o número de unidades de streaming necessário. Para saber mais, confira Compreender e ajustar unidades de streaming.
  3. Selecione Examinar + Criar e Criar.

Examinar os recursos implantados

Use o portal do Azure para verificar o trabalho do Azure Stream Analytics, ou um script do CLI do Azure ou Azure PowerShell para listar o recurso.

portal do Azure

Quando a implantação terminar, selecione Ir para o recurso para acessar a página Trabalho do Stream Analytics do trabalho.

CLI do Azure

Use o comando az stream-analytics job show para obter detalhes sobre o trabalho que você criou. Substitua os marcadores de posição pela ID da sua assinatura do Azure, pelo nome do grupo de recursos e pelo nome do trabalho do Stream Analytics.

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

Azure PowerShell

Use o comando Get-AzStreamAnalyticsJob para obter detalhes sobre o trabalho que você criou. Substitua os placeholders pelo identificador da sua assinatura do Azure, pelo nome do grupo de recursos e pelo nome do trabalho do Stream Analytics.

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

Limpar os recursos

Se você pretende continuar com tutoriais futuros, talvez queira manter esses recursos. Quando você não precisar mais desses recursos, exclua o grupo de recursos. Deletar o grupo de recursos também elimina o trabalho do Azure Stream Analytics. Para excluir o grupo de recursos usando a CLI do Azure ou o Azure PowerShell:

CLI do Azure

az group delete --name RESOURCEGROUPNAME

Azure PowerShell

Remove-AzResourceGroup -Name RESOURCEGROUPNAME

Próximas etapas

Neste guia de início rápido, você criou uma tarefa do Azure Stream Analytics por meio de um modelo ARM e validou a implantação. Avance para o próximo artigo para aprender como exportar um template ARM para um trabalho existente usando VS Code.