Guia de início rápido: criar um trabalho do Azure Stream Analytics usando um modelo 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 início rápido, você usa um modelo do Azure Resource Manager (modelo ARM) para criar um trabalho do Azure Stream Analytics. Depois de criares o trabalho, validas a implementaçã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 utiliza sintaxe declarativa. Você descreve a implantação pretendida sem escrever a sequência de comandos de programação para criar a implantação.

Se o seu ambiente cumpre os pré-requisitos e se está familiarizado com a utilização de modelos ARM, selecione o botão Implementar no Azure. O modelo é aberto no portal do Azure.

Botão para implantar o modelo do Gerenciador de Recursos no Azure.

Pré-requisitos

Para concluir este artigo, você precisa:

Rever o modelo

Este quickstart utiliza 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:

Implementar o modelo

Nesta secção, cria um trabalho de Azure Stream Analytics utilizando o modelo ARM.

  1. Selecione a imagem seguinte para iniciar sessão no Azure e abrir um modelo. O modelo cria uma tarefa do Azure Stream Analytics.

    Botão para implantar o modelo do Gerenciador de Recursos no Azure.

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

    Captura de ecrã da página de implementaçã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
    Subscrição Na lista pendente, selecione a sua subscrição do Azure.
    Grupo de recursos Especifique se quer criar um novo grupo de recursos ou utilizar um existente. Um grupo de recursos é um contentor que mantém recursos relacionados para uma solução do Azure. Para obter mais informações, veja Descrição geral do Grupo de Recursos do Azure.
    Região Selecione E.U.A. Leste. Para outras regiões disponíveis, veja Serviços do Azure disponíveis por região.
    Nome do trabalho do Stream Analytics Forneça um nome para seu trabalho do Stream Analytics.
    Número de unidades de streaming Escolha o número de unidades de streaming de que precisa. Para obter mais informações, consulte Compreender e ajustar unidades de streaming.
  3. Selecione Rever e criar e, em seguida, Criar.

Rever os recursos implementados

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

portal do Azure

Quando a implementação terminar, selecione Ir para o recurso para aceder à página de Trabalho de Análise de Fluxos 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 pelo ID da sua subscrição do Azure, pelo nome do seu grupo de recursos e pelo nome da tarefa 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 marcadores de posição pelo ID da sua subscrição do Azure, pelo nome do grupo de recursos e pelo nome da tarefa do Stream Analytics.

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

Limpar recursos

Se planeias continuar com tutoriais seguintes, talvez queiras manter estes recursos. Quando já não precisares destes recursos, elimina o grupo de recursos. Eliminar 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óximos passos

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