Azure Digital Twins Explorer (versão prévia)

Este artigo contém informações sobre o Azure Digital Twins Explorer, incluindo seus casos de uso e uma visão geral de seus recursos. Para ver as etapas detalhadas sobre como usar cada recurso, confira Usar o Azure Digital Twins Explorer (versão prévia).

O Azure Digital Twins Explorer é uma ferramenta de desenvolvedor para visualizar e interagir com os dados em sua instância Azure Digital Twins, incluindo seus modelos e grafo gêmeo.

Veja uma exibição da janela do Explorer, mostrando modelos e gêmeos que foram preenchidos para um grafo de exemplo:

A interface visual é uma ótima ferramenta para explorar e compreender a forma de seu gráfico e conjunto de modelos. Ela também permite que você faça alterações pontuais para gêmeos individuais e relações.

Quando usar

O Azure Digital Twins Explorer é uma ferramenta visual projetada para usuários que querem explorar seu grafo gêmeo e modificar gêmeos e relações no contexto de seu grafo.

Os desenvolvedores podem achar essa ferramenta especialmente útil nos seguintes cenários:

• Exploração: use o Explorer para saber mais sobre os Gêmeos Digitais do Azure e a maneira como ele representa seu ambiente do mundo real. Importe modelos de exemplo e grafos que você pode exibir e editar para se familiarizar com o serviço. Para ver as etapas guiadas para começar a usar o Azure Digital Twins Explorer, confira o Introdução ao Azure Digital Twins Explorer.
• Desenvolvimento: Use o explorador para visualizar e validar seu grafo gêmeo. Você também pode usá-lo para investigar propriedades específicas de modelos, gêmeos e relações. Faça modificações pontuais no seu grafo e nos dados dele. Para receber instruções detalhadas sobre como usar cada recurso, confira Usar o Azure Digital Twins Explorer.

A principal finalidade do Explorer é ajudar você a visualizar e a entender o grafo e atualizá-lo conforme necessário. Para soluções em grande escala e para o trabalho que deve ser repetido ou automatizado, considere usar as APIs e SDKs para interagir com sua instância por meio de código.

Importante

O Azure Digital Twins Explorer não dá suporte para os pontos de extremidade privados. Se quiser usar o Azure Digital Twins Explorer com uma instância do Azure Digital Twins que usa o Link Privado para desabilitar o acesso público, você pode implantar a base de código do Azure Digital Twins Explorer de forma privada na nuvem. Para obter instruções sobre como fazer isso, confira o Azure Digital Twins Explorer: em execução na nuvem.

Como acessar

A principal forma de acessar o Azure Digital Twins Explorer é usando o portal do Azure.

Para abrir o Azure Digital Twins Explorer em uma instância dos Gêmeos Digitais do Azure, primeiro navegue até a instância no portal pesquisando-a pelo nome na barra de pesquisa do portal.

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

Isso abrirá o Azure Digital Twins Explorer em uma nova guia. Se esta for a primeira vez que você usa 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 especifique uma URL dos Gêmeos Digitais do Azure. (Caso não veja essa caixa na tela, o Azure Digital Twins Explorer já concluiu essa etapa automaticamente.)

Se você vir esta caixa, insira https:// no campo, seguido pelo nome do host da sua instância (pode ser encontrado na página de 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.

Importante

O Azure Digital Twins Explorer não dá suporte para os pontos de extremidade privados. Se quiser usar o Azure Digital Twins Explorer com uma instância do Azure Digital Twins que usa o Link Privado para desabilitar o acesso público, você pode implantar a base de código do Azure Digital Twins Explorer de forma privada na nuvem. Para obter instruções sobre como fazer isso, confira o Azure Digital Twins Explorer: em execução na nuvem.

Características e recursos

O Azure Digital Twins Explorer é organizado em painéis, cada um com um conjunto diferente de capacidades para explorar e gerenciar seus modelos, gêmeos e relações.

As seções do Explorer são as seguintes:

• Explorador de Consultas: execute consultas no grafo de gêmeos e veja os resultados visuais no painel Grafo de Gêmeos.
• Modelos: exiba uma lista de seus modelos e execute ações de modelo, como adicionar, remover e exibir detalhes do modelo.
• Gêmeos exiba uma lista de seus gêmeos e dos relacionamentos associados a eles.
• Grafo de gêmeos: veja seus gêmeos e relações como um grafo de gêmeos personalizável. Crie e exclua gêmeos e relações, e veja ou edite suas propriedades.
• Grafo de Modelo: veja os seus modelos e as maneiras como eles estão interconectados na forma de um grafo de modelo personalizável.

Para receber instruções detalhadas sobre como usar cada recurso, confira Usar o Azure Digital Twins Explorer.

Observação

Atualmente, o Azure Digital Twins Explorer dá suporte total a modelos DTDL v2 e funcionalidade limitada para modelos DTDL v3.

No Azure Digital Twins Explorer, os modelos DTDL v3 podem ser exibidos no painel Modelos e os gêmeos criados com modelos DTDL v3 podem ser exibidos e editados (inclusive aqueles com propriedades de matriz). Entretanto, os modelos DTDL v3 não serão exibidos no painel do Gráfico de Modelos e não poderão ser importados usando o Azure Digital Twins Explorer. Para importar modelos DTDL v3 para sua instância, utilize outra interface de desenvolvedor, como as APIs e SDKs ou a CLI do Azure.

Como colaborar

O Azure Digital Twins Explorer é uma ferramenta de software livre que recebe contribuições para o código e a documentação. O aplicativo hospedado é implantado regularmente de um repositório de código-fonte no GitHub.

Para ver o código-fonte da ferramenta e ler instruções detalhadas sobre como contribuir com o código, visite o repositório GitHub: digital-twins-explorer.

Para ver instruções para contribuir com esta documentação, examine o guia do colaborador.

Outras considerações

Suporte a regiões

O Azure Digital Twins Explorer está disponível para uso com todas as instâncias dos Gêmeos Digitais do Azure em todas as regiões com suporte.

No entanto, durante a visualização pública, os dados podem ser enviados para processamento via regiões diferentes daquelas em que a instância está hospedada. Para evitar que os dados sejam roteados dessa maneira em situações em que a soberania de dados é uma preocupação, você pode baixar o código de software livre para criar uma versão do Explorer hospedada localmente em seu próprio computador.

Cobrança

O Azure Digital Twins Explorer é uma ferramenta gratuita de interação com o serviço de Gêmeos Digitais do Azure. Embora a ferramenta em si seja gratuita, custos podem ser cobrados durante o uso quando solicitações forem enviadas para o serviço de Gêmeos Digitais do Azure, de acordo com estas diretrizes de preços: Preços dos Gêmeos Digitais do Azure.

Próximas etapas

Saiba como usar os recursos do Azure Digital Twins Explorer em detalhes: Usar o Azure Digital Twins Explorer.