Partilhar via


Guia de início rápido: criar um trabalho do Azure Stream Analytics usando o Visual Studio

Este guia de início rápido mostra como criar e executar um trabalho do Stream Analytics usando as ferramentas do Azure Stream Analytics para Visual Studio. O trabalho de exemplo lê dados de streaming de um dispositivo do Hub IoT. Você define um trabalho que calcula a temperatura média quando acima de 27° e grava os eventos de saída resultantes em um novo arquivo no armazenamento de blobs.

Observação

  • É altamente recomendável usar as ferramentas do Stream Analytics para Visual Studio Code para obter a melhor experiência de desenvolvimento local. Há lacunas de recursos conhecidas nas ferramentas do Stream Analytics para Visual Studio 2019 (versão 2.6.3000.0) e ele não será melhorado no futuro.
  • As ferramentas Visual Studio e Visual Studio Code não oferecem suporte a trabalhos nas regiões Leste da China, Norte da China, Alemanha Central e Nordeste da Alemanha.

Antes de começar

  • Se você não tiver uma assinatura do Azure, crie uma conta gratuita.

  • Inicie sessão no portal Azure.

  • Instale o Visual Studio 2019, Visual Studio 2015 ou Visual Studio 2013 Atualização 4. As edições Enterprise (Ultimate/Premium), Professional e Community são suportadas. A edição Express não é suportada.

  • Siga as instruções de instalação para instalar as ferramentas do Stream Analytics para Visual Studio.

Preparar os dados de entrada

Antes de definir o trabalho do Stream Analytics, você deve preparar os dados, que são configurados posteriormente como a entrada do trabalho. Para preparar os dados de entrada exigidos pelo trabalho, conclua as seguintes etapas:

  1. Inicie sessão no portal Azure.

  2. Selecione Criar um recurso>Hub IoT da Internet das Coisas>.

  3. No painel Hub IoT , insira as seguintes informações:

    Setting Valor sugerido Descrição
    Subscription <A sua subscrição> Selecione a subscrição do Azure que pretende utilizar.
    Grupo de recursos asaquickstart-resourcegroup Selecione Criar novo e insira um novo nome de grupo de recursos para sua conta.
    Nome do Hub IoT MyASAIoTHub Selecione um nome para seu Hub IoT.
    Região <Selecione a região mais próxima dos seus utilizadores> Selecione uma localização geográfica onde você possa hospedar seu Hub IoT. Use o local mais próximo de seus usuários.
    Escalão de serviço Gratuito Para este início rápido, selecione Gratuito se ainda estiver disponível na sua subscrição. Se o nível gratuito não estiver disponível, escolha o nível mais baixo disponível. Para obter mais informações, consulte Preços do Hub IoT.

    Captura de ecrã que mostra o assistente Criar Hub IoT no portal do Azure.

  4. Selecione Verificar + criar. Revise as informações do Hub IoT e selecione Criar. Seu Hub IoT pode levar alguns minutos para ser criado. Você pode monitorar o progresso no painel Notificações .

  5. Após a conclusão da implantação, selecione Ir para o recurso para navegar até a página do Hub IoT do seu hub IoT.

  6. Na página Hub IoT , selecione Dispositivos em Gerenciamento de dispositivos no menu de navegação à esquerda.

  7. Na página Dispositivos , selecione + Adicionar dispositivo na barra de ferramentas.

    Captura de ecrã a mostrar a página Dispositivos com Adicionar dispositivo selecionada.

  8. Na página Criar um dispositivo , insira um nome para o dispositivo e selecione Salvar.

    Captura de ecrã a mostrar a página Criar um dispositivo.

  9. Depois que o dispositivo for criado, abra-o na lista de dispositivos IoT . Se ainda não vir o dispositivo, atualize a página.

    Captura de ecrã a mostrar a lista de dispositivos com o dispositivo que criou.

  10. Copie a cadeia de conexão principal e salve-a em um bloco de notas para usar mais tarde.

Armazenamento de blobs

  1. No canto superior esquerdo do portal do Azure, selecione Criar uma> recursos>.

  2. No painel Criar conta de armazenamento , insira um nome de conta de armazenamento, local e grupo de recursos. Escolha o mesmo local e grupo de recursos que o Hub IoT que você criou. Em seguida, selecione Revisar + criar para criar a conta.

    Captura de ecrã a mostrar a página Criar conta de armazenamento no portal do Azure.

  3. Depois que sua conta de armazenamento for criada, selecione o bloco Serviço de Blob no painel Visão geral .

    Captura de tela mostrando a página de visão geral da conta de armazenamento com o serviço de Blob selecionado.

  4. Na página Serviço de Blob , selecione + Contêiner na barra de ferramentas.

  5. Na página Novo contêiner , insira um nome para seu contêiner, como container1. Deixe o nível de acesso público como Privado (sem acesso anônimo) e selecione Criar.

    Captura de ecrã mostrando a página Novo contentor.

Criar um projeto do Stream Analytics

  1. Inicie o Visual Studio.

  2. Selecione Arquivo > Novo Projeto.

  3. Na lista de modelos à esquerda, selecione Stream Analytics e, em seguida, selecione Aplicativo Azure Stream Analytics.

  4. Insira o nome do projeto, o local e o nome da solução e selecione Criar.

    Captura de tela mostrando a caixa de diálogo Criar um projeto do Stream Analytics.

  5. Observe os elementos incluídos em um projeto do Azure Stream Analytics.

    Captura de tela mostrando a janela Gerenciador de Soluções para um projeto de aplicativo Stream Analytics de exemplo no Visual Studio.

Escolha a subscrição necessária

  1. No Visual Studio, no menu Vista, selecione Explorador de Servidores.
  2. Clique com o botão direito do rato no Azure, selecione Ligar à Subscrição do Microsoft Azure e, em seguida, inicie sessão com a sua conta do Azure.

Definir entrada

  1. No Gerenciador de Soluções, expanda o nó Entradas e clique duas vezes em Input.json.

  2. Preencha a configuração de entrada do Stream Analytics com os seguintes valores:

    Setting Valor sugerido Descrição
    Alias de entrada Entrada Insira um nome para identificar a entrada da tarefa.
    Tipo de fonte Fluxo de dados Escolha a fonte de entrada apropriada: Fluxo de dados ou Dados de referência.
    Fonte Hub IoT Escolha a fonte de entrada apropriada.
    Resource Escolher fonte de dados da conta corrente Opte por inserir dados manualmente ou selecione uma conta existente.
    Subscription <A sua subscrição> Selecione a assinatura do Azure que tem o Hub IoT que você criou.
    Hub IoT MyASAIoTHub Escolha ou insira o nome do seu Hub IoT. Os nomes do Hub IoT são detetados automaticamente se forem criados na mesma assinatura.
  3. Deixe outras opções para os valores padrão e selecione Salvar para salvar as configurações.

    Captura de tela mostrando a página Configuração de entrada do Stream Analytics.

Definir saída

  1. No Gerenciador de Soluções, expanda o nó Saídas e clique duas vezes em Output.json.

  2. Preencha a Configuração de saída do Stream Analytics com os seguintes valores:

    Setting Valor sugerido Descrição
    Alias de saída Resultado Insira um nome para identificar o resultado do trabalho.
    Lavatório Armazenamento Data Lake Gen 2/Armazenamento de Blob Escolha a pia apropriada.
    Resource Fornecer configurações de fonte de dados manualmente Opte por inserir dados manualmente ou selecione uma conta existente.
    Subscription <A sua subscrição> Selecione a assinatura do Azure que tem a conta de armazenamento que você criou. A conta de armazenamento pode estar na mesma assinatura ou em uma assinatura diferente. Este exemplo pressupõe que você tenha criado uma conta de armazenamento na mesma assinatura.
    Conta de armazenamento AsaQuickStartStorage Escolha ou insira o nome da conta de armazenamento. Os nomes das contas de armazenamento são detetados automaticamente se forem criados na mesma assinatura.
    Container contentor1 Selecione o contêiner existente que você criou em sua conta de armazenamento.
    Padrão de caminho output Insira o nome de um caminho de arquivo a ser criado dentro do contêiner.
  3. Deixe outras opções para os valores padrão e selecione Salvar para salvar as configurações.

    Captura de tela mostrando a página Configuração de saída do Stream Analytics.

Definir a consulta de transformação

  1. Abra Script.asaql no Gerenciador de Soluções no Visual Studio.

  2. Adicione a seguinte consulta:

    SELECT *
    INTO Output
    FROM Input
    WHERE Temperature > 27
    

Enviar uma consulta do Stream Analytics para o Azure

  1. No Editor de Consultas, selecione Enviar para o Azure no editor de scripts.

  2. Na janela Enviar trabalho , selecione Criar um novo trabalho do Azure Stream Analytics.

  3. Insira um nome de trabalho.

  4. Escolha a Assinatura do Azure.

  5. Escolha o Grupo de Recursos.

  6. Mantenha o valor padrão para Cluster.

  7. Selecione o Local usado no início do Guia de início rápido.

  8. Em seguida, selecione Enviar.

    Captura de tela mostrando a caixa de diálogo Enviar trabalho.

Execute o simulador de IoT

  1. Abra o Raspberry Pi Azure IoT Online Simulator em uma nova guia ou janela do navegador.

  2. Substitua o marcador de posição na Linha 15 pela cadeia de conexão de dispositivo do Hub IoT do Azure que você guardou em uma seção anterior.

  3. Selecione Executar. A saída deve mostrar os dados do sensor e as mensagens que estão sendo enviadas para o Hub IoT.

    Captura de tela mostrando o Simulador do Raspberry Pi Azure IoT Online.

Inicie o trabalho do Stream Analytics e verifique a saída

  1. Quando o trabalho é criado, a visualização do trabalho é aberta automaticamente. Selecione o botão de seta verde para iniciar o trabalho,

    Captura de tela mostrando o botão Iniciar para iniciar um trabalho do Stream Analytics a partir do Visual Studio.

  2. Altere o modo de início de saída do trabalho para JobStartTime e selecione Iniciar.

    Captura de tela mostrando a caixa de diálogo Configuração do Trabalho Inicial do Stream Analytics.

  3. Observe que o status do trabalho foi alterado para Executando e há eventos de entrada/saída. Esta operação poderá demorar alguns minutos. Selecione o botão Atualizar na barra de ferramentas para atualizar as métricas.

    Captura de tela mostrando o status do trabalho como em execução e as métricas do trabalho.

  4. Para ver os resultados, no menu Ver , selecione Cloud Explorer e navegue até à conta de armazenamento no seu grupo de recursos. Em Contêineres de Blob, clique duas vezes em container1 e, em seguida, no caminho do arquivo de saída .

    Ver resultados

Limpeza de recursos

Quando não for mais necessário, exclua o grupo de recursos, o trabalho de streaming e todos os recursos relacionados. A exclusão do trabalho evita o faturamento das unidades de streaming consumidas pelo trabalho. Se você estiver planejando usar o trabalho no futuro, poderá interrompê-lo e reiniciá-lo mais tarde, quando precisar. Se você não vai continuar a usar esse trabalho, exclua todos os recursos criados por este início rápido usando as seguintes etapas:

  1. No menu à esquerda no portal do Azure, selecione Grupos de recursos e, em seguida, selecione o nome do recurso que criou.
  2. Na página do grupo de recursos, selecione Excluir, digite o nome do recurso a ser excluído na caixa de texto e selecione Excluir.

Próximos passos

Neste início rápido, você implantou um trabalho simples do Stream Analytics usando o Visual Studio. Você também pode implantar trabalhos do Stream Analytics usando o portal do Azure e o PowerShell.

Para saber mais sobre as ferramentas do Azure Stream Analytics para Visual Studio, continue para o seguinte artigo: