Início Rápido: Exportar dados de um aplicativo do IoT Central

Neste início rápido, você configura seu aplicativo do IoT Central para exportar dados do Azure Data Explorer. O Azure Data Explorer permite armazenar, consultar e processar a telemetria de dispositivos como o aplicativo de smartphone IoT Plug and Play .

Neste início rápido, você:

• Use o recurso de exportação de dados no IoT Central para a telemetria do aplicativo de smartphone para um banco de dados do Azure Data Explorer.
• Use o Azure Data Explorer para executar consultas na telemetria.

A conclusão deste guia de início rápido gera um pequeno custo na sua conta do Azure para a instância do Azure Data Explorer. Os dois primeiros dispositivos em seu aplicativo do IoT Central são gratuitos.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• Conclua o primeiro Início Rápido, Início Rápido – Use seu smartphone como um dispositivo para enviar telemetria para um aplicativo da IoT Central. O segundo Início Rápido, Início Rápido: Configurar regras e ações para seu dispositivo no Azure IoT Central, é opcional.
• Você precisa do prefixo de URL do aplicativo IoT Central que escolheu no primeiro início rápido, Início rápido: use seu smartphone como dispositivo para enviar telemetria a uma aplicação IoT Central.

• Utilize o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.

  

• Se você preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga as etapas exibidas em seu terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.

Instalar serviços do Azure

Antes de exportar dados de seu aplicativo do IoT Central, você precisa de um cluster e banco de dados do Azure Data Explorer. Neste início rápido, você executará um script bash no Azure Cloud Shell para criá-los e configurá-los.

O script conclui as seguintes etapas:

• Solicita que você entre em sua assinatura do Azure para que ele possa gerar um token de portador para autenticar as chamadas à API REST.
• Cria um cluster e um banco de dados do Azure Data Explorer.
• Cria uma identidade gerenciada para seu aplicativo IoT Central.
• Configura a identidade gerenciada com permissão para acessar o banco de dados do Azure Data Explorer.
• Adiciona uma tabela ao banco de dados para armazenar a telemetria de entrada do IoT Central.

Execute os seguintes comandos para baixar o script no ambiente do Azure Cloud Shell:

wget https://raw.githubusercontent.com/Azure-Samples/iot-central-docs-samples/main/quickstart-cde/createADX.sh
chmod u+x createADX.sh

Use o comando a seguir para executar o script:

• Substitua CLUSTER_NAME por um nome exclusivo para o cluster do Azure Data Explorer. O nome do cluster pode conter apenas letras minúsculas e números. O comprimento do nome do cluster deve ter entre 4 e 22 caracteres.
• Substitua CENTRAL_URL_PREFIX pelo prefixo de URL que você escolheu no primeiro início rápido para seu aplicativo do IoT Central.
• Quando solicitado, siga as instruções para entrar em sua conta. É necessário que o script entre porque ele gera um token de portador para autenticar uma chamada à API REST.

./createADX.sh CLUSTER_NAME CENTRAL_URL_PREFIX

Anote a saída da URL do Azure Data Explorer pelo script. Você usará esse valor posteriormente no início rápido.

Configurar a exportação de dados

Para configurar o destino de exportação de dados do IoT Central:

1. Navegue até a página exportação de dados em seu aplicativo do IoT Central.
2. Selecione a guia Destinos e, em seguida, Adicione um destino.
3. Insira o Azure Data Explorer como o nome de destino. Selecione Azure Data Explorer como tipo de destino.
4. Na URL do Cluster, insira a URL do Azure Data Explorer da qual você anotou anteriormente.
5. No nome do banco de dados, insira phonedata.
6. No nome da tabela, insira aceleração.
7. Na Autorização, selecione a identidade gerenciada atribuída pelo sistema.
8. Clique em Salvar.

Para configurar a exportação de dados:

1. Na página Exportação de dados , selecione a guia Exportações e, em seguida, Adicione uma exportação.

2. Insira "Acelerômetro do telefone" como nome de exportação.

3. Selecione Telemetria como o tipo de dados a serem exportados.

4. Use as informações na tabela a seguir para adicionar dois filtros:

   Nome	Operator	Value
   Modelo de dispositivo	É igual a	IoT Plug and Play para dispositivos móveis
   Sensores/Aceleração/X	Exists	N/A

   Verifique se a opção de exportar os dados se todas as condições forem verdadeiras está definida.

5. Adicione o Azure Data Explorer como um destino.

6. Adicione uma transformação de dados ao destino. Adicione a consulta a seguir no 2. Criar campo de consulta de transformação na página Transformação de dados:

   import "iotc" as iotc;
   {
       Device: .device.id,
       EnqueuedTime: .enqueuedTime,
       X: .telemetry | iotc::find(.name == "accelerometer").value.x,
       Y: .telemetry | iotc::find(.name == "accelerometer").value.y,
       Z: .telemetry | iotc::find(.name == "accelerometer").value.z
   }
   

   

   Para ver como a transformação funciona e experimentar a consulta, cole a seguinte mensagem de telemetria de exemplo em 1. Adicione sua mensagem de entrada:

   {
     "messageProperties": {},
     "device": {
       "id": "8hltz8xa7n",
       "properties": {
         "reported": []
       },
       "approved": true,
       "types": [],
       "name": "8hltz8xa7n",
       "simulated": false,
       "provisioned": true,
       "modules": [],
       "templateId": "urn:modelDefinition:vlcd3zvzdm:y425jkkpqzeu",
       "templateName": "IoT Plug and Play mobile",
       "organizations": [],
       "cloudProperties": [],
       "blocked": false
     },
     "component": "sensors",
     "applicationId": "00001111-aaaa-2222-bbbb-3333cccc4444",
     "messageSource": "telemetry",
     "telemetry": [
       {
         "id": "dtmi:azureiot:PhoneSensors:__accelerometer;1",
         "name": "accelerometer",
         "value": {
           "x": 0.09960123896598816,
           "y": 0.09541380405426025,
           "z": 9.907781600952148
         }
       }
     ],
     "enqueuedTime": "2021-11-12T10:01:30.588Z",
     "enrichments": {}
   }
   

7. Salve a transformação. Em seguida, salve a definição de exportação de dados.

Aguarde até que o status de exportação mostre Saudável:

Consultar dados exportados

Para consultar a telemetria exportada:

1. Use a URL do Azure Data Explorer produzida pelo script que você executou anteriormente para navegar até o ambiente do Azure Data Explorer.

2. Expanda o nó de cluster e selecione o banco de dados phonedata. O escopo da janela de consulta é alterado para Scope:yourclustername.eastus/phonedata.

3. No Azure Data Explorer, abra uma nova guia e cole na seguinte consulta Kusto e selecione Executar para plotar a telemetria do acelerômetro:

['acceleration'] 
    | project EnqueuedTime, Device, X, Y, Z
    | render timechart 

Talvez seja necessário aguardar vários minutos para coletar dados suficientes. Para ver a alteração dos valores de telemetria, tente manter seu telefone em orientações diferentes:

Limpar os recursos

Se você não planeja concluir mais guias de início rápido ou tutoriais do IoT Central, poderá excluir seu aplicativo do IoT Central:

1. Em seu aplicativo do IoT Central, navegue até o Gerenciamento de Aplicativos>.
2. Selecione Excluir e confirme sua ação.

Para remover a instância do Azure Data Explorer de sua assinatura e evitar ser cobrado desnecessariamente, exclua o grupo de recursos IoTCentralExportData-rg do portal do Azure ou execute o seguinte comando no Azure Cloud Shell:

az group delete --name IoTCentralExportData-rg

Próxima etapa

Neste início rápido, você aprendeu a exportar continuamente dados do IoT Central para outro serviço do Azure.

Agora que você já sabe exportar seus dados, a próxima etapa sugerida é: