Azure Digital Twins Explorer (visualização)

Artigo
04/25/2024

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 obter etapas detalhadas sobre como usar cada recurso, consulte Usar o Azure Digital Twins Explorer (visualização).

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

Aqui está uma exibição da janela do explorador, mostrando modelos e gêmeos que foram preenchidos para um gráfico de exemplo:

A interface visual é uma ótima ferramenta para explorar e entender a forma do seu gráfico e conjunto de modelos. Ele também permite que você faça mudanças pontuais, no local, para gêmeos individuais e relacionamentos.

Quando utilizar o

O Azure Digital Twins Explorer é uma ferramenta visual projetada para usuários que desejam explorar seu gráfico de gêmeos e modificar gêmeos e relacionamentos no contexto de seu gráfico.

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

Exploração: use o explorador para saber mais sobre os Gêmeos Digitais do Azure e a maneira como ele representa seu ambiente do mundo real. Importe modelos e gráficos de exemplo que você pode visualizar e editar para se familiarizar com o serviço. Para obter etapas guiadas para começar a usar o Azure Digital Twins Explorer, consulte Introdução ao Azure Digital Twins Explorer.
Desenvolvimento: Use o explorador para visualizar e validar seu gráfico gêmeo. Você também pode usá-lo para investigar propriedades específicas de modelos, gêmeos e relacionamentos. Faça modificações no local em seu gráfico e seus dados. Para obter instruções detalhadas sobre como usar cada recurso, consulte Usar o Azure Digital Twins Explorer.

O principal objetivo do explorador é ajudá-lo a visualizar e entender seu gráfico, e atualizá-lo conforme necessário. Para soluções de grande escala e para trabalhos que devem ser repetidos ou automatizados, 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 suporta pontos de extremidade privados. Se quiser usar o Azure Digital Twins Explorer com uma instância do Azure Digital Twins que usa o Private Link 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, consulte Azure Digital Twins Explorer: Running in the cloud.

Como aceder

A principal maneira de acessar o Azure Digital Twins Explorer é por meio do portal do Azure.

Para abrir o Azure Digital Twins Explorer para uma instância do Azure Digital Twins, primeiro navegue até a instância no portal, pesquisando seu nome na barra de pesquisa do portal.

Em seguida, selecione o botão Abrir o Azure Digital Twins Explorer (visualização).

Isso abrirá o Azure Digital Twins Explorer em uma nova guia. Se esta for a 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 do Azure Digital Twins. (Se não vir esta caixa no ecrã, o Azure Digital Twins Explorer já concluiu este passo automaticamente.)

Se você vir essa caixa, digite https:// no campo, seguido pelo nome do host da sua instância (isso pode ser encontrado novamente na página Visão geral da instância no portal). Esses valores juntos compõem a URL da instância. Selecione Salvar para se conectar à sua instância.

Importante

Funcionalidades e capacidades

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

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

Explorador de Consultas: execute consultas no gráfico gêmeo e veja os resultados visuais no painel Gráfico gêmeo.
Modelos: exiba uma lista de seus modelos e execute ações de modelo, como adicionar, remover e exibir detalhes do modelo.
Gêmeos: Veja uma lista de seus gêmeos e seus relacionamentos associados.
Twin Graph: Visualize seus gêmeos e relacionamentos como um gráfico de gêmeos personalizável. Crie e exclua gêmeos e relacionamentos e visualize ou edite suas propriedades.
Gráfico de modelo: visualize seus modelos e as maneiras como eles estão interconectados na forma de um gráfico de modelo personalizável.

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

Nota

Atualmente, o Azure Digital Twins Explorer suporta totalmente modelos DTDL v2 e suporta 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 (incluindo aqueles com propriedades de matriz). No entanto, os modelos DTDL v3 não aparecerão no painel Gráfico de modelo e não podem ser importados usando o Azure Digital Twins Explorer. Para importar modelos DTDL v3 para sua instância, use outra interface de desenvolvedor, como APIs e SDKs ou a CLI do Azure.

Como contribuir

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

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

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

Outras considerações

Suporte de região

O Azure Digital Twins Explorer está disponível para utilização com todas as instâncias dos Azure Digital Twins em todas as regiões suportadas.

Durante a visualização pública, no entanto, os dados podem ser enviados para processamento por regiões diferentes da região onde 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-fonte aberto para criar uma versão hospedada localmente do explorador em sua própria máquina.

Faturação

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

Próximos passos

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