Guia de início rápido: criar um trabalho do Azure Stream Analytics usando um modelo ARM

Neste início rápido, você usa um modelo do Azure Resource Manager (modelo ARM) para criar um trabalho do Azure Stream Analytics. Depois que o trabalho for criado, você validará 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 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

O modelo utilizado neste início rápido pertence aos Modelos de Início Rápido do 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'))]"
    }
  }
}

O recurso do Azure definido no modelo é Microsoft.StreamAnalytics/StreamingJobs: cria um trabalho do Azure Stream Analytics.

Implementar o modelo

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

  1. Selecione a imagem seguinte para iniciar sessão no Azure e abrir um modelo. O modelo cria um trabalho 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.

    Criar trabalho do Azure Stream Analytics usando um modelo do Azure Resource Manager

    Forneça os seguintes valores:

    Property 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 + Criar e, em seguida, clique em Criar.

Rever os recursos implementados

Você pode usar o portal do Azure para verificar o trabalho do Azure Stream Analytics ou usar a CLI do Azure ou o script do Azure PowerShell para listar o recurso.

Portal do Azure

Após a conclusão da implantação, selecione Ir para o recurso para navegar até a página Trabalho do Stream Analytics para o trabalho.

CLI do Azure

Use o comando az stream-analytics job show para obter detalhes sobre o trabalho que você criou. Substitua espaços reservados pela ID da assinatura do Azure, nome do grupo de recursos e 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 espaços reservados pela ID da assinatura do Azure, nome do grupo de recursos e nome do trabalho do Stream Analytics.

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

Clean up resources (Limpar recursos)

Se você planeja continuar com os tutoriais subsequentes, talvez queira deixar esses recursos no lugar. Quando não for mais necessário, exclua o grupo de recursos, que exclui 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 saber como exportar um modelo ARM para um trabalho existente usando o VS Code.