Início Rápido: Criar um trabalho do Stream Analytics usando o portal do AzureQuickstart: Create a Stream Analytics job by using the Azure portal

Este início rápido mostra como começar com a criação de um trabalho do Stream Analytics.This quickstart shows you how to get started with creating a Stream Analytics job. Neste início rápido, você define um trabalho do Stream Analytics que lê dados de streaming em tempo real e filtra mensagens indicando temperatura acima de 27 graus.In this quickstart, you define a Stream Analytics job that reads real-time streaming data and filters messages with a temperature greater than 27. Seu trabalho do Stream Analytics lerá dados do Hub IoT, transformará os dados e fará write-back para um contêiner no armazenamento de blobs.Your Stream Analytics job will read data from IoT Hub, transform the data, and write the data back to a container in blob storage. Os dados de entrada usados neste início rápido são gerados por um simulador online do Raspberry Pi.The input data used in this quickstart is generated by a Raspberry Pi online simulator.

Antes de começarBefore you begin

Preparar os dados de entradaPrepare the input data

Antes de definir o trabalho do Stream Analytics, você deve preparar os dados de entrada.Before defining the Stream Analytics job, you should prepare the input data. Os dados de sensor em tempo real são incluídos no Hub IoT, posteriormente configurado como a entrada do trabalho.The real-time sensor data is ingested to IoT Hub, which later configured as the job input. Para preparar os dados de entrada exigidos pelo trabalho, complete as seguintes etapas:To prepare the input data required by the job, complete the following steps:

  1. Entre no Portal do Azure.Sign in to the Azure portal.

  2. Selecione Criar um recurso > Internet das Coisas > Hub IoT.Select Create a resource > Internet of Things > IoT Hub.

  3. No painel do Hub IoT, insira as seguintes informações:In the IoT Hub pane, enter the following information:

    ConfiguraçãoSetting Valor sugeridoSuggested value DescriçãoDescription
    AssinaturaSubscription <Sua assinatura><Your subscription> Selecione a assinatura do Azure que você deseja usar.Select the Azure subscription that you want to use.
    Grupo de recursosResource group asaquickstart-resourcegroupasaquickstart-resourcegroup Selecione Criar Novo e insira um novo nome de grupo de recursos para a conta.Select Create New and enter a new resource-group name for your account.
    RegiãoRegion <Selecione a região mais próxima de seus usuários><Select the region that is closest to your users> Selecione uma localização geográfica na qual você possa hospedar o Hub IoT.Select a geographic location where you can host your IoT Hub. Use a localização mais próxima dos usuários.Use the location that's closest to your users.
    Nome do Hub IoTIoT Hub Name MyASAIoTHubMyASAIoTHub Selecione um nome para o Hub IoT.Select a name for your IoT Hub.

    Crie um Hub IoT

  4. Selecione Avançar: Definir o tamanho e a escala.Select Next: Set size and scale.

  5. Escolha Tipo de preço e escala.Choose your Pricing and scale tier. Para este início rápido, selecione a camada F1 – Gratuita, caso ela ainda esteja disponível em sua assinatura.For this quickstart, select the F1 - Free tier if it's still available on your subscription. Para obter mais informações, consulte Preço do Hub IoT.For more information, see IoT Hub pricing.

    Dimensionar a solução do Hub IoT

  6. Selecione Examinar + criar.Select Review + create. Examine as informações do Hub IoT e clique em Criar.Review your IoT Hub information and click Create. A criação do Hub IoT pode levar alguns minutos.Your IoT Hub might take a few minutes to create. Você pode monitorar o progresso no painel Notificações.You can monitor the progress in the Notifications pane.

  7. No menu de navegação do Hub IoT, clique em Adicionar em Dispositivos IoT.In your IoT Hub navigation menu, click Add under IoT devices. Adicione uma ID do dispositivo e clique em Salvar.Add a Device ID and click Save.

    Adicionar um dispositivo ao Hub IoT

  8. Assim que o dispositivo tiver sido criado, abra-o na lista Dispositivos IoT.Once the device is created, open the device from the IoT devices list. Copie a Cadeia de conexão – chave primária e salve-a em um bloco de notas para uso futuro.Copy the Connection string -- primary key and save it to a notepad to use later.

    Copiar a cadeia de conexão do dispositivo do Hub IoT

Criar o armazenamento de blobsCreate blob storage

  1. No canto superior esquerdo do portal do Azure, selecione Criar um recurso > Armazenamento > Conta de armazenamento.From the upper left-hand corner of the Azure portal, select Create a resource > Storage > Storage account.

  2. No painel Criar conta de armazenamento, insira um nome para a conta de armazenamento, um local e um grupo de recursos.In the Create storage account pane, enter a storage account name, location, and resource group. Escolha o mesmo local e grupo de recursos do Hub IoT criado.Choose the same location and resource group as the IoT Hub you created. Clique em Revisar + criar para criar a conta.Then click Review + create to create the account.

    Criar Conta de Armazenamento

  3. Assim que sua conta de armazenamento tiver sido criada, selecione o bloco Blobs no painel Visão geral.Once your storage account is created, select the Blobs tile on the Overview pane.

    Visão geral da conta de armazenamento

  4. Na página Serviço Blob, selecione Contêiner e forneça um nome a ele, por exemplo, conteiner1.From the Blob Service page, select Container and provide a name for your container, such as container1. Deixe o Nível de acesso público como Particular (sem acesso anônimo) e selecione OK.Leave the Public access level as Private (no anonymous access) and select OK.

    Criar contêiner de blobs

Criar um trabalho de Stream AnalyticsCreate a Stream Analytics job

  1. Entre no Portal do Azure.Sign in to the Azure portal.

  2. Selecione Criar um recurso no canto superior esquerdo do portal do Azure.Select Create a resource in the upper left-hand corner of the Azure portal.

  3. Selecione Analytics > Trabalho do Stream Analytics na lista de resultados.Select Analytics > Stream Analytics job from the results list.

  4. Preencha a página de trabalho do Stream Analytics com as seguintes informações:Fill out the Stream Analytics job page with the following information:

    ConfiguraçãoSetting Valor sugeridoSuggested value DescriçãoDescription
    Nome do trabalhoJob name MyASAJobMyASAJob Insira um nome para identificar o trabalho do Stream Analytics.Enter a name to identify your Stream Analytics job. O nome do trabalho do Stream Analytics pode conter somente caracteres alfanuméricos, hifens e sublinhados e deve ter entre 3 e 63 caracteres.Stream Analytics job name can contain alphanumeric characters, hyphens, and underscores only and it must be between 3 and 63 characters long.
    AssinaturaSubscription <Sua assinatura><Your subscription> Selecione a assinatura do Azure que você deseja usar para este trabalho.Select the Azure subscription that you want to use for this job.
    Grupo de recursosResource group asaquickstart-resourcegroupasaquickstart-resourcegroup Selecione o mesmo grupo de recursos do Hub IoT.Select the same resource group as your IoT Hub.
    Local padrãoLocation <Selecione a região mais próxima de seus usuários><Select the region that is closest to your users> Selecione a localização geográfica onde você pode hospedar seu trabalho do Stream Analytics.Select geographic location where you can host your Stream Analytics job. Use o local mais próximo de seus usuários para melhorar o desempenho e reduzir o custo de transferência dos dados.Use the location that's closest to your users for better performance and to reduce the data transfer cost.
    Unidades de transmissãoStreaming units 11 As unidades de streaming representam os recursos de computação necessários para executar um trabalho.Streaming units represent the computing resources that are required to execute a job. Por padrão, esse valor é definido como 1.By default, this value is set to 1. Para saber mais sobre como dimensionar unidades de streaming, consulte o artigo Entendendo e ajustando as unidades de streaming.To learn about scaling streaming units, refer to understanding and adjusting streaming units article.
    Ambiente de hospedagemHosting environment NuvemCloud Os trabalhos do Stream Analytics podem ser implantados na nuvem ou na borda.Stream Analytics jobs can be deployed to cloud or edge. O Cloud permite que você implante no Azure Cloud e o Edge permite que você implante em um dispositivo IoT Edge.Cloud allows you to deploy to Azure Cloud, and Edge allows you to deploy to an IoT Edge device.

    Criar trabalho

  5. Marque a caixa Fixar no painel para colocar o trabalho no painel e, em seguida, selecione Criar.Check the Pin to dashboard box to place your job on your dashboard and then select Create.

  6. Você deve ver uma notificação de Implantação em andamento... exibida no canto superior direito da janela do navegador.You should see a Deployment in progress... notification displayed in the top right of your browser window.

Configurar entrada de trabalhoConfigure job input

Nesta seção, você configurará uma entrada de dispositivo do Hub IoT para um trabalho do Stream Analytics.In this section, you will configure an IoT Hub device input to the Stream Analytics job. Use o Hub IoT criado na seção anterior do início rápido.Use the IoT Hub you created in the previous section of the quickstart.

  1. Navegue até o trabalho do Stream Analytics.Navigate to your Stream Analytics job.

  2. Selecione Entradas > Adicionar entrada do Stream > Hub IoT.Select Inputs > Add Stream input > IoT Hub.

  3. Preencha a página Hub IoT com os seguintes valores:Fill out the IoT Hub page with the following values:

    ConfiguraçãoSetting Valor sugeridoSuggested value DescriçãoDescription
    Alias de entradaInput alias IoTHubInputIoTHubInput Insira um nome para identificar a entrada do trabalho.Enter a name to identify the job’s input.
    AssinaturaSubscription <Sua assinatura><Your subscription> Selecione a assinatura do Azure que tem a conta de armazenamento criada.Select the Azure subscription that has the storage account you created. A conta de armazenamento pode estar na mesma assinatura ou em uma diferente.The storage account can be in the same or in a different subscription. Este exemplo pressupõe que você criou a conta de armazenamento na mesma assinatura.This example assumes that you have created storage account in the same subscription.
    Hub IoTIoT Hub MyASAIoTHubMyASAIoTHub Insira o nome do Hub IoT criado na seção anterior.Enter the name of the IoT Hub you created in the previous section.
  4. Deixe as outras opções com os valores padrão e selecione Salvar para salvar as configurações.Leave other options to default values and select Save to save the settings.

    Configurar dados de entrada

Configurar saída de trabalhoConfigure job output

  1. Navegue até o trabalho do Stream Analytics criado anteriormente.Navigate to the Stream Analytics job that you created earlier.

  2. Selecione Saídas > Adicionar > Armazenamento de blobs.Select Outputs > Add > Blob storage.

  3. Preencha a página Armazenamento de Blob com estes valores:Fill out the Blob storage page with the following values:

    ConfiguraçãoSetting Valor sugeridoSuggested value DescriçãoDescription
    Alias de saídaOutput alias BlobOutputBlobOutput Insira um nome para identificar a saída do trabalho.Enter a name to identify the job’s output.
    AssinaturaSubscription <Sua assinatura><Your subscription> Selecione a assinatura do Azure que tem a conta de armazenamento criada.Select the Azure subscription that has the storage account you created. A conta de armazenamento pode estar na mesma assinatura ou em uma diferente.The storage account can be in the same or in a different subscription. Este exemplo pressupõe que você criou a conta de armazenamento na mesma assinatura.This example assumes that you have created storage account in the same subscription.
    Conta de armazenamentoStorage account asaquickstartstorageasaquickstartstorage Escolha ou insira o nome da conta de armazenamento.Choose or enter the name of the storage account. Os nomes das contas de armazenamento são detectados automaticamente quando elas são criadas na mesma assinatura.Storage account names are automatically detected if they are created in the same subscription.
    ContêinerContainer container1container1 Selecione o contêiner existente que você criou em sua conta de armazenamento.Select the existing container that you created in your storage account.
  4. Deixe as outras opções com os valores padrão e selecione Salvar para salvar as configurações.Leave other options to default values and select Save to save the settings.

    Configurar saída

Definir a consulta de transformaçãoDefine the transformation query

  1. Navegue até o trabalho do Stream Analytics criado anteriormente.Navigate to the Stream Analytics job that you created earlier.

  2. Selecione Consulta e atualize a consulta da seguinte maneira:Select Query and update the query as follows:

    SELECT *
    INTO BlobOutput
    FROM IoTHubInput
    HAVING Temperature > 27
    
  3. Neste exemplo, a consulta lê os dados do Hub IoT e os copia para um novo arquivo no blob.In this example, the query reads the data from IoT Hub and copies it to a new file in the blob. Clique em Salvar.Select Save.

    Configurar transformação do trabalho

Executar o simulador de IoTRun the IoT simulator

  1. Abra o Simulador Online de IoT do Azure do Raspberry Pi.Open the Raspberry Pi Azure IoT Online Simulator.

  2. Substitua o espaço reservado na Linha 15 pela cadeia de conexão do dispositivo do Hub IoT do Azure salva em uma seção anterior.Replace the placeholder in Line 15 with the Azure IoT Hub device connection string you saved in a previous section.

  3. Clique em Executar.Click Run. A saída deve exibir os dados de sensor e as mensagens que estão sendo enviadas ao Hub IoT.The output should show the sensor data and messages that are being sent to your IoT Hub.

    Simulador online de IoT do Azure do Raspberry Pi

Iniciar o trabalho do Stream Analytics e verificar a saídaStart the Stream Analytics job and check the output

  1. Retorne para a página de visão geral do trabalho e selecione Iniciar.Return to the job overview page and select Start.

  2. Em Iniciar trabalho, selecione Agora no campo Hora de início da saída do trabalho.Under Start job, select Now, for the Job output start time field. Em seguida, selecione Iniciar para iniciar o trabalho.Then, select Start to start your job.

  3. Depois de alguns minutos, no portal, localize a conta de armazenamento e o contêiner que você configurou como saída para o trabalho.After few minutes, in the portal, find the storage account & the container that you have configured as output for the job. Agora você pode ver o arquivo de saída no contêiner.You can now see the output file in the container. O trabalho leva alguns minutos para ser iniciado pela primeira vez. Depois de iniciado, ele continuará a ser executado com a chegada dos dados.The job takes a few minutes to start for the first time, after it is started, it will continue to run as the data arrives.

    Saída transformada

Limpar recursosClean up resources

Quando não forem mais necessários, exclua o grupo de recursos, o trabalho do Stream Analytics e todos os recursos relacionados.When no longer needed, delete the resource group, the Stream Analytics job, and all related resources. A exclusão do trabalho evita a cobrança das unidades de streaming consumidas por ele.Deleting the job avoids billing the streaming units consumed by the job. Se você está planejando usar o trabalho no futuro, pode interrompê-lo e reiniciar mais tarde, quando necessário.If you're planning to use the job in future, you can stop it and restart it later when you need. Se você não for mais usar o trabalho, exclua todos os recursos criados neste início rápido usando as seguintes etapas:If you are not going to continue to use this job, delete all resources created by this quickstart by using the following steps:

  1. No menu à esquerda no Portal do Azure, selecione Grupos de recursos e selecione o nome do recurso criado.From the left-hand menu in the Azure portal, select Resource groups and then select the name of the resource you created.

  2. Em sua página de grupo de recursos, selecione Excluir, digite o nome do recurso para excluir na caixa de texto e selecione Excluir.On your resource group page, select Delete, type the name of the resource to delete in the text box, and then select Delete.

Próximas etapasNext steps

Neste guia de início rápido, você implantou um trabalho simples do Stream Analytics usando o portal do Azure.In this quickstart, you deployed a simple Stream Analytics job using Azure portal. Você também pode implantar trabalhos do Stream Analytics usando o PowerShell, o Visual Studio e o Visual Studio Code.You can also deploy Stream Analytics jobs using PowerShell, Visual Studio, and Visual Studio Code.

Para saber mais sobre como configurar outras fontes de entrada e executar detecção em tempo real, avance para o artigo a seguir:To learn about configuring other input sources and performing real-time detection, continue to the following article: