Início rápido: criar uma tarefa do Stream Analytics no Visual Studio

Neste guia de início rápido, irá criar uma tarefa do Stream Analytics ao utilizar as ferramentas do Azure Stream Analytics para o Visual Studio. O trabalho de exemplo lê dados em streaming de um dispositivo hub IoT. Defines um trabalho que calcula a temperatura média quando o valor é superior a 27° e escreve os eventos de saída resultantes num novo ficheiro no armazenamento de blobs.

Pré-requisitos

Antes de começar, certifique-se de que tem os seguintes pré-requisitos definidos.

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

• Visual Studio 2019. As edições Enterprise (Ultimate/Premium), Professional e Community funcionam, mas a edição Express não.

• Ferramentas de Stream Analytics para Visual Studio instaladas.

Preparar os dados de entrada

Antes de definir o trabalho de Análise de Fluxos, prepare os dados que depois configura como entrada de trabalho. Para preparar os dados de entrada, complete os seguintes passos:

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 o seu hub IoT.
   Região	<Selecione a região mais próxima dos seus utilizadores>	Selecione um local geográfico onde possa alojar o 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.

   

4. Selecione Verificar + criar. Revise as informações do seu hub IoT e selecione Criar. O seu hub IoT pode demorar alguns minutos a ser criado. Monitore o progresso no painel Notificações .

5. Após a implementação terminar, selecione Ir para o recurso para navegar até à 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.

   

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

   

9. Depois de criares o dispositivo, abre-o na lista de dispositivos IoT . Se ainda não vir o dispositivo, atualize a página.

   

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

Armazenamento de blobs

Nesta secção, cria uma conta Armazenamento do Azure e um contentor de blob para armazenar os eventos de saída do seu trabalho.

1. No canto superior esquerdo do portal do Azure, selecione Criar um recurso>Armazenamento>Conta de armazenamento.

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.

   

3. Depois de criar a sua conta de armazenamento, selecione o mosaico serviço Blob no painel Descrição geral.

   

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.

   

Criar um projeto do Stream Analytics

Crie um projeto de Análise de Fluxos no Visual Studio para definir as entradas, saídas e consulta do trabalho.

1. Inicie o Visual Studio.

2. Selecione Arquivo>Novo Projeto.

3. Na lista de modelos, selecione Stream Analytics e depois Azure Stream Analytics Application.

4. Introduza o Nome do projeto, Localização e Nome da Solução, e selecione Criar.

   

5. Repare nos elementos num projeto Azure Stream Analytics.

   

Escolha a subscrição necessária

Ligue o Visual Studio à subscrição do Azure que contém os recursos que criou.

1. No Visual Studio, no menu Vista, selecione Explorador de Servidores.
2. Selecione e mantenha premido (ou clique com o botão direito do rato) Azure, selecione Ligar à subscrição do Microsoft Azure e, em seguida, inicie sessão com a sua conta do Azure.

Definir entrada

Configure a entrada do trabalho para ler dados em streaming do hub IoT que criou.

1. Em Explorador de Soluções, expanda o nó Inputs e abra 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 do trabalho.
   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 subscrição do Azure que tem o hub IoT que criou.
   Hub IoT	MyASAIoTHub	Escolha ou introduza o nome do seu hub IoT. Os nomes dos hubs IoT aparecem automaticamente se os criares na mesma subscrição.

3. Deixe outras opções para os valores padrão e selecione Salvar para salvar as configurações.

   

Definir saída

Configure a saída da tarefa para gravar os resultados no seu contentor de armazenamento de blobs.

1. Em Explorador de Soluções, expanda o nó Outputs e abra 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	Introduza 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 assume que criou uma conta de armazenamento na mesma subscrição.
   Conta de armazenamento	AsaQuickStartStorage	Escolha ou insira o nome da conta de armazenamento. Os nomes das contas de armazenamento aparecem automaticamente se os criares na mesma subscrição.
   Container	contentor1	Selecione o contêiner existente que você criou em sua conta de armazenamento.
   Padrão de caminho	output	Introduza o nome de um caminho de ficheiro para criar dentro do contentor.

3. Deixe outras opções para os valores padrão e selecione Salvar para salvar as configurações.

   

Definir a consulta de transformação

Defina uma consulta que filtre os dados em streaming e envie os resultados para a saída.

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

Submeta a consulta ao Azure para criar o trabalho de Stream Analytics.

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 a localização que usou no início do quickstart.

8. Selecione Enviar.

   

Execute o simulador de IoT

Execute o simulador Raspberry Pi para enviar dados de amostra dos sensores para o seu hub IoT.

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

2. Substitua o marcador na linha 15 pela cadeia de conexão do dispositivo Hub IoT do Azure que guardou numa secção anterior.

3. Selecione Executar. A saída deve mostrar os dados dos sensores e as mensagens enviadas para o seu hub IoT.

   

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

Inicie o trabalho e verifique se processa eventos de entrada e grava a saída no armazenamento de blobs.

1. Ao criar a sua tarefa, a vista da tarefa abre-se automaticamente. Selecione o botão de seta verde para iniciar o trabalho.

   

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

   

3. O estado da tarefa muda para Em Execução, e aparecem eventos de entrada e saída. Esta mudança pode demorar alguns minutos. Selecione o botão Atualizar na barra de ferramentas para atualizar as métricas.

   

4. Para ver resultados, no menu View , selecione Cloud Explorer e vá à conta de armazenamento no seu grupo de recursos. Em Blob Containers, abre o contentor 1 e depois o caminho do ficheiro de saída.

   

Limpeza de recursos

Quando já não precisares deles, elimina o grupo de recursos, o trabalho de streaming e todos os recursos relacionados. Eliminar a tarefa interrompe a faturação das unidades de streaming que esta consome. Se planeias usar o trabalho no futuro, pára-o e reinicia-o mais tarde, quando precisares. Se não planeia voltar a usar este trabalho, use os seguintes passos para eliminar todos os recursos que este quickstart criou:

1. No menu esquerdo do portal Azure, selecione Grupos de Recursos e depois 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.

Conteúdo relacionado

• Usar o Visual Studio para exibir trabalhos do Azure Stream Analytics
• Criar um trabalho do Stream Analytics usando o portal do Azure
• Crie um trabalho de Análise de Fluxos usando o PowerShell