Início Rápido – Introdução ao Azure Digital Twins Explorer com um cenário de amostra

Este guia de início rápido é uma introdução aos Gêmeos Digitais do Azure, mostrando como os Gêmeos Digitais do Azure representam dados e demonstrando como é interagir com um grafo de gêmeo digital de um edifício físico. Você usa o site do portal do Azure e o Azure Digital Twins Explorer, que é uma ferramenta para visualizar e interagir com dados dos Gêmeos Digitais do Azure em um navegador da Web.

Neste guia de início rápido, você analisa modelos de exemplo predefinidos que definem digitalmente os conceitos de um Edifício, um Andar e uma Sala e usa essas definições de modelo para criar gêmeos digitais que representam andares e salas específicos de um edifício físico. Esses indivíduos gêmeos são conectados a um grafo de gêmeos virtual que reflete suas relações entre si, formando uma representação digital completa do edifício de amostra. O grafo com o qual você está trabalhando representa um edifício que contém dois andares e cada andar contém salas. O grafo se parece com esta imagem:

Estas são as etapas que você usa para explorar o grafo neste artigo:

1. Crie uma instância dos Gêmeos Digitais do Azure e abra-a no Azure Digital Twins Explorer.
2. Carregue modelos predefinidos e dados de grafo para construir o cenário de exemplo. Adicione mais um gêmeo manualmente.
3. Simule a alteração dos dados de IoT e consulte o grafo para ver os resultados.
4. Revise seus aprendizados com a experiência.

Pré-requisitos

Você precisa de uma assinatura do Azure para concluir este início rápido. Se ainda não tiver uma, crie uma gratuitamente agora.

Você também precisa baixar os materiais do grafo de exemplo usado no quickstart. Use as instruções a seguir para baixar os arquivos necessários. Posteriormente, siga mais instruções para carregá-las nos Gêmeos Digitais do Azure.

• Arquivos de modelo: navegue até cada link a seguir, clique com o botão direito do mouse em qualquer lugar na tela e selecione Salvar como no menu de clique com o botão direito do mouse do navegador. Use a janela Salvar como para salvar o arquivo em algum lugar no computador.

  • Building.json: esse arquivo de modelo define digitalmente um edifício. Ele especifica que os edifícios podem conter andares.
  • Floor.json: esse arquivo de modelo define digitalmente um piso. Ele especifica que os andares podem conter salas.
  • Room.json: esse arquivo de modelo define digitalmente uma sala. Ele tem uma propriedade de temperatura.

• buildingScenario.xlsx: essa planilha contém os dados de um grafo gêmeo de exemplo, incluindo cinco gêmeos digitais que representam um edifício específico com andares e salas. Os gêmeos são baseados nos modelos genéricos e conectados a relacionamentos que indicam quais elementos contêm uns aos outros. Dependendo das configurações do navegador, a seleção desse link pode baixar o arquivo buildingScenario.xlsx automaticamente para o local de download padrão ou pode abrir o arquivo no navegador com uma opção para download. Esta é a aparência dessa opção de download no Microsoft Edge:

  

Configurar os Gêmeos Digitais do Azure

A primeira etapa para trabalhar com os Gêmeos Digitais do Azure é criar uma instância dos Gêmeos Digitais do Azure que contém todos os dados do grafo. Nesta seção, você criará uma instância do serviço e a abrirá no Azure Digital Twins Explorer.

Criar uma instância dos Gêmeos Digitais do Azure

Nesta seção, você criará uma instância dos Gêmeos Digitais do Azure usando o portal do Azure. Acesse o portal e conecte-se com suas credenciais.

1. Após entrar no portal, comece clicando em Criar um recurso no menu da home page de serviços do Azure.

   

2. Pesquise os Gêmeos Digitais do Azure na caixa de pesquisa, depois escolha o serviço dos Gêmeos Digitais do Azure nos resultados.

   Deixe o campo Plano definido como Gêmeos Digitais do Azure selecione o botão Criar para começar a criar uma nova instância do serviço.

   

3. Preencha os campos na guia Noções básicas da configuração, incluindo sua assinatura, grupo de recursos, um nome de recurso para sua nova instância e região. Marque a caixa Atribuir a Função de Proprietário de Dados dos Gêmeos Digitais do Azure para se dar permissões para gerenciar dados na instância.

   

   Observação

   Se a caixa Atribuir Função de Proprietário de Dados dos Gêmeos Digitais do Azure estiver acinzentada, significará que você não tem permissões em sua assinatura do Azure para gerenciar o acesso do usuário aos recursos. Você pode continuar criando a instância nesta seção e então fazer com que alguém com as permissões necessárias atribua essa função a você na instância antes da conclusão do restante deste início rápido.

   Funções comuns que atendem a esse requisito são Proprietário, Administrador da conta ou a combinação de Colaborador e Administrador de Acesso do Usuário.

4. Selecione Examinar + criar para concluir a criação da instância.

5. Você verá uma página de resumo mostrando os detalhes inseridos. Confirme e crie a instância selecionando Criar.

Essa ação leva você a uma página visão geral que acompanha o status de implantação da instância.

Aguarde até que a página diga que a implantação foi concluída.

Abra a instância no Azure Digital Twins Explorer

Após a conclusão da implantação, use o botão Ir para o recurso para navegar até a página Visão geral da instância no portal.

Em seguida, selecione o botão Abrir o Azure Digital Twins Explorer (versão prévia).

Essa ação abre o Azure Digital Twins Explorer em uma nova guia. Se esta for sua primeira vez usando o Explorer, você verá um modal de boas-vindas resumindo seus principais recursos.

O Azure Digital Twins Explorer pode se conectar automaticamente à sua instância. Caso contrário, você verá a tela a seguir solicitando que você especifique uma URL dos Gêmeos Digitais do Azure. (Se você não vir essa caixa na tela, o Azure Digital Twins Explorer concluiu essa etapa automaticamente.)

Se você vir essa caixa, insira https:// no campo, seguido pelo nome do host da instância (esse valor pode ser encontrado novamente na página Visão Geral da instância no portal). Juntos, esses valores compõem a URL da instância. Selecione Salvar para conectar-se à instância.

Criar o cenário de exemplo

Em seguida, use o Azure Digital Twins Explorer para configurar os modelos de exemplo e o grafo gêmeo. Comece importando os arquivos de modelo e o arquivo de grafo gêmeo que você baixou para seu computador na seção Pré-requisitos . Em seguida, você conclui o cenário criando mais um gêmeo manualmente.

Modelos

A primeira etapa na criação de um grafo dos Gêmeos Digitais do Azure é definir o vocabulário do ambiente. Modelos são definições genéricas para cada tipo de entidade que existe no ambiente. Este cenário de construção de exemplo contém um prédio, pisos e salas. Portanto, você precisa de uma definição de modelo que descreva o que é um Edifício , uma definição de modelo que descreve o que é um Piso e uma definição de modelo que descreve o que é um Room . Depois, você pode criar gêmeos digitais que são instâncias desses modelos, representando edifícios, andares e salas específicos.

Os modelos dos Gêmeos Digitais do Azure são escritos em DTDL (Linguagem de Definição de Gêmeo Digital), uma linguagem de objeto de dados semelhante à JSON-LD. Cada modelo descreve um tipo de entidade em termos de suas propriedades, relações e componentes.

Para esta introdução rápida, os arquivos de modelo já estão preparados para você. Você baixou Building.json, Floor.jsone Room.json na seção Pré-requisitos e agora os carregou na instância dos Gêmeos Digitais do Azure usando o Azure Digital Twins Explorer.

Carregar os modelos (arquivos .json)

No Azure Digital Twins Explorer, siga estas etapas para carregar os modelos de Edifício, Andar e Sala (os arquivos .json que você baixou anteriormente).

1. No painel Modelos, selecione o ícone Carregar um Modelo, que mostra uma seta apontando para cima.

   

2. Na janela Abrir exibida, navegue até a pasta que contém os arquivos .json baixados no computador.

3. Selecione Building.json, Floor.json e Room.json e selecione Abrir para carregá-los todos de uma só vez.

O Azure Digital Twins Explorer carrega esses arquivos de modelo para sua instância dos Gêmeos Digitais do Azure. Eles devem aparecer no painel Modelos e exibir os nomes amigáveis e as IDs de modelo completo.

Você pode selecionar Exibir Modelo de qualquer uma das opções dos modelos para ver o código DTDL que define cada tipo de modelo.

Gêmeos e o grafo de gêmeos

Agora que algumas definições de modelo são carregadas na instância dos Gêmeos Digitais do Azure, você pode usar essas definições para criar gêmeos digitais para os elementos em seu ambiente.

Cada gêmeo digital na sua solução representa uma entidade do ambiente físico. Você pode criar muitos gêmeos com base no mesmo tipo de modelo, como vários gêmeos de sala que usam o modelo Room. Neste início rápido, você precisa de um gêmeo digital para o edifício e um gêmeo digital para cada andar e sala do prédio. Os gêmeos estão conectados por relacionamentos em um gráfico de gêmeos que representa todo o ambiente do prédio.

Nesta seção, você carregará um grafo pré-criado contendo um gêmeo de construção, gêmeos de dois andares e dois gêmeos de sala.

Importar o grafo (arquivo .xlsx)

No Azure Digital Twins Explorer, siga estas etapas para importar o grafo de exemplo (o arquivo .xlsx que você baixou anteriormente).

1. No painel do Grafo de Gêmeo, selecione o ícone Importar Grafo que mostra uma seta apontando para uma nuvem.

   

2. Na janela Abrir, navegue até o arquivo de buildingScenario.xlsx que você baixou anteriormente. Este arquivo contém dados de gêmeos e de relacionamentos para o grafo de exemplo. Selecione Abrir.

   Após alguns segundos, o Azure Digital Twins Explorer abre uma exibição Importar que mostra uma visualização do grafo que será carregado.

3. Para concluir a importação do grafo, selecione o ícone Salvar no canto superior direito da visualização do grafo.

   

4. O Azure Digital Twins Explorer usa o arquivo carregado para criar os gêmeos solicitados e as relações entre eles. Verifique se você vê a caixa de diálogo a seguir indicando que a importação foi bem-sucedida antes de prosseguir.

   

   Selecione Fechar.

   O gráfico foi carregado no Azure Digital Twins Explorer e o painel Twin Graph é recarregado. Parece vazio.

5. Para ver o grafo, selecione o botão Executar Consulta no painel Gerenciador de Consultas, próximo à parte superior da janela do Azure Digital Twins Explorer.

   

Essa ação executa a consulta padrão para selecionar e exibir todos os gêmeos digitais. O Azure Digital Twins Explorer recupera todos os gêmeos e relações do serviço. Ele desenha o grafo definido por eles no painel Grafo Gêmeo. Agora, você pode ver o grafo carregado do cenário de exemplo.

Os círculos ("nós" do grafo) representam os gêmeos digitais. As linhas representam as relações. O gêmeo BuildingA "contém" os gêmeos Floor0 e Floor1, o gêmeo Floor0 "contém" Room0 e o gêmeo Floor1 "contém" Room1. Se você estiver usando um mouse, poderá clicar e arrastar no grafo para mover os elementos.

Adicionar outro gêmeo

Você pode continuar editando a estrutura de um grafo de gêmeo digital após sua criação. Imagine que outra sala foi construída recentemente no Piso1 deste edifício de exemplo. Nesta seção, você adicionará um novo gêmeo ao grafo para representar a nova sala.

Comece selecionando o modelo que define o tipo de gêmeo que você deseja criar. No painel Modelos à esquerda, abra o menu de opções para o modelo Room. Selecione Criar um Gêmeo para criar uma instância desse tipo de modelo.

Insira Room2 para o Nome do Novo Gêmeo e selecione Salvar. Essa ação cria um novo gêmeo digital, que ainda não está conectado por relações com o restante do grafo.

Em seguida, adicione uma relação indicando que o Floor1 contém o Room2. Use as teclas CTRL/CMD ou SHIFT para selecionar simultaneamente Floor1 e Room2 no grafo. Quando os dois gêmeos estiverem selecionados, clique com o botão direito do mouse em Room2 e escolha Adicionar relacionamentos.

Essa ação abre uma caixa de diálogo Criar Relação, pré-preenchida com os detalhes de uma relação "contém" de Floor1 a Sala2. Clique em Salvar.

Agora Room2 está conectado no grafo. Se você estiver usando um mouse, poderá clicar e arrastar os gêmeos no grafo para organizá-los em uma configuração que você goste.

Exibir propriedades do gêmeo

Você pode selecionar um gêmeo para ver uma lista das propriedades e dos valores dele no painel Propriedades do gêmeo.

Estas são as propriedades de Room0. Observe que Room0 tem uma temperatura de 70.

Estas são as propriedades de Room1. Observe que Room1 tem uma temperatura de 80.

Room2 ainda não tem valores definidos para as respectivas propriedades, já que esse gêmeo foi criado manualmente. Para definir seus valores de propriedade, edite os campos para que a umidade seja 50 e a temperatura seja 72. Selecione o ícone Salvar.

Consultar alterando dados de IoT

No Azure digital gêmeos, você pode consultar seu gráfico de alta para responder a perguntas sobre seu ambiente, usando a linguagem de consulta do Gêmeos Digitais do Azurede estilo SQL. Uma forma de consultar os gêmeos no seu gráfico é pelas propriedades deles. Fazer consultas com base em propriedades pode ajudar a responder a perguntas sobre seu ambiente. Em um cenário totalmente conectado, controlado por dados, as propriedades dos gêmeos mudam com frequência em resposta aos dados de IoT dos sensores em seu ambiente ou outras fontes de dados conectadas. Neste início rápido, você altera os valores manualmente para simular uma alteração na leitura do sensor.

Comece executando uma consulta para ver quantos gêmeos em seu ambiente têm uma temperatura acima de 75. Execute a consulta a seguir no painel Gerenciador de Consultas.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Lembre-se de exibir as propriedades dos gêmeos antes que Room0 tenha uma leitura de temperatura de 70, Room1 tenha uma leitura de temperatura de 80 e Room2 tenha uma leitura de temperatura de 72. Os gêmeos do edifício e do andar não têm uma propriedade de temperatura. Por esses motivos, somente Room1 aparece nos resultados aqui.

Editar dados de temperatura

Em uma solução de Gêmeos Digitais do Azure totalmente conectada, os gêmeos em seu grafo recebem atualizações dinâmicas de dispositivos IoT reais e de outras fontes de dados e atualizam as propriedades automaticamente para permanecerem sincronizados com o ambiente do mundo real. Para simplificar esse guia de início rápido, você usará o Azure Digital Twins Explorer aqui para definir manualmente a temperatura de Sala0 como 24.

Primeiro, execute novamente a consulta a seguir a fim de selecionar todos os gêmeos digitais. Essa ação exibe o grafo completo no painel do Grafo Gêmeo novamente.

SELECT * FROM DIGITALTWINS

Selecione Room0 para abrir sua lista de propriedades no painel Propriedades do gêmeo.

Altere o valor da temperatura de 70 para 76 e selecione o ícone Salvar para atualizar a temperatura.

Depois de uma atualização de propriedade bem-sucedida, você verá uma caixa Informações de Patch mostrando o código do patch que foi usado nos bastidores com as APIs dos Gêmeos Digitais do Azure para fazer a atualização.

Feche as informações do patch.

Consultar para ver o novo resultado

Para ver a nova temperatura para Room0 refletida no grafo, execute novamente a consulta anterior para obter todos os gêmeos no ambiente com temperatura acima de 75.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Agora que a temperatura de Room0 mudou de 70 para 76, tanto Room0 quanto Room1 devem aparecer no resultado.

Examinar e contextualizar aprendizados

Neste guia de início rápido, você criou uma instância dos Gêmeos Digitais do Azure e usou o Azure Digital Twins Explorer para preenchê-la com um cenário de amostra. Você também adicionou um gêmeo digital manualmente.

Depois, você explorou o grafo, incluindo...

• Usando uma consulta para responder a uma pergunta sobre o cenário.
• Editando uma propriedade em um gêmeo digital.
• Executando a consulta novamente para ver como a resposta foi alterada em decorrência da sua atualização.

A intenção deste exercício é demonstrar como você pode usar o grafo dos Gêmeos Digitais do Azure para responder a perguntas sobre seu ambiente, principalmente conforme os ambiente de IoT continuam mudando.

Neste início rápido, você fez a atualização da temperatura manualmente. É comum nos Gêmeos Digitais do Azure conectar gêmeos digitais a dispositivos IoT reais para que eles recebam atualizações automaticamente, com base nos dados do dispositivo. Você também pode conectar outras fontes de dados, integrando dados de diferentes sistemas e definindo uma lógica própria de como os gêmeos são atualizados. Dessa forma, você pode criar um grafo dinâmico que sempre reflete o estado real do ambiente. Você pode usar consultas para obter informações sobre o que está acontecendo em seu ambiente em tempo real.

Você também pode exportar dados dos Gêmeos Digitais do Azure para controle histórico, análise de dados e serviços de IA para permitir insights maiores e executar simulações de ambiente. A integração dos Gêmeos Digitais do Azure às suas soluções de IoT pode ajudar você a acompanhar o passado de maneira mais eficaz, controlar o presente e prever o futuro.

Limpar os recursos

Para limpar os recursos após este guia de início rápido, escolha quais recursos dos Gêmeos Digitais do Azure você removerá considerando o que fará em seguida.

• Se planejar continuar com os tutoriais e os inícios rápidos dos Gêmeos Digitais do Azure, você poderá reutilizar a instância neste guia de início rápido para estes artigos e não precisará removê-la.

• Se você quiser continuar usando a instância dos Gêmeos Digitais do Azure deste artigo, mas limpar todos os seus modelos, gêmeos e relações, execute o seguinte comando da CLI az dt job deletion:

  az dt job deletion create -n <name-of-Azure-Digital-Twins-instance> -y
  

  Se quiser apenas excluir alguns desses elementos, você poderá usar os comandos az dt twin relationship delete, az dt twin delete e az dt model delete para excluir seletivamente apenas os elementos que você deseja remover.

• Se você não precisar mais da instância dos Gêmeos Digitais do Azure, poderá excluí-la usando o portal do Azure.

  Navegue de volta para a página de Visão geral da instância no Portal. (Se você fechou essa guia, poderá encontrar a instância novamente pesquisando seu nome na barra de pesquisa do portal do Azure e selecionando-a nos resultados da pesquisa.)

  Selecione excluir para excluir a instância, incluindo todos os seus modelos e gêmeos.

  

Talvez você também queira excluir os arquivos de projeto de exemplo do computador local.

Próximas etapas

Vá para o próximo início rápido para visualizar um cenário dos Gêmeos Digitais do Azure em um ambiente 3D.

Ou prossiga para os tutoriais para se aprofundar nos SDKs, na criação dos grafo de gêmeos e na configuração do fluxo de eventos.

• Codificar um aplicativo cliente
• Criar um grafo nos Gêmeos Digitais do Azure
• Conectar uma solução de ponta a ponta