Criar uma conexão de histórico de dados para os Gêmeos Digitais do Azure

O histórico de dados é um recurso dos Gêmeos Digitais do Azure para registrar automaticamente as atualizações de gráficos no Azure Data Explorer. Esses dados podem ser consultados usando o plug-in de consulta de Gêmeos Digitais do Azure para o Azure Data Explorer para obter informações sobre o ambiente ao longo do tempo.

Este artigo mostra como configurar uma conexão de histórico de dados de trabalho entre os Gêmeos Digitais do Azure e o Azure Data Explorer. Ele usa a CLI do Azure e o portal do Azure para configurar e conectar os recursos de histórico de dados necessários, incluindo:

• uma instância dos Gêmeos Digitais do Azure
• um namespace de Hubs de Eventos que contém um hub de eventos
• um cluster do Azure Data Explorer que contém um banco de dados

Ele também contém um gráfico duplo de exemplo que você pode usar para ver as atualizações de gráfico historizado no Azure Data Explorer.

Dica

Embora este artigo use o portal do Azure, você também pode trabalhar com o histórico de dados usando a versão de 31/05/2022 das APIs REST.

Pré-requisitos

Preparar o ambiente para a CLI do Azure

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções 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 estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com 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 extensões com a CLI do Azure.

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

Observação

Você também pode usar o Azure Cloud Shell no ambiente PowerShell em vez de no ambiente Bash, se preferir. Os comandos nesta página são escritos para o ambiente Bash, portanto, eles possam exigir a execução de alguns pequenos ajustes no PowerShell.

Configurar sessão da CLI

Para começar a trabalhar com os Gêmeos Digitais do Azure na CLI, faça logon e defina o contexto da CLI da sua assinatura para esta sessão. Execute estes comandos na janela da CLI:

az login
az account set --subscription "<your-Azure-subscription-ID>"

Dica

Você também pode usar o nome da sua assinatura em vez da ID no comando acima.

Se esta é a primeira vez que você usa essa assinatura com os Gêmeos Digitais do Azure, execute este comando para se registrar no namespace dos Gêmeos Digitais do Azure. (Se você não tiver certeza disso, não haverá problemas em executá-lo novamente mesmo que já tenha feito isso no passado.)

az provider register --namespace 'Microsoft.DigitalTwins'

Em seguida, você adicionará a Extensão de IoT do Microsoft Azure para a CLI do Azure para habilitar comandos para interagir com os Gêmeos Digitais do Azure e com outros serviços de IoT. Execute este comando para verificar se você tem a última versão da extensão:

az extension add --upgrade --name azure-iot

Agora você está pronto para trabalhar com os Gêmeos Digitais do Azure na CLI do Azure.

É possível verificar isso executando az dt --help a qualquer momento para ver uma lista dos comandos dos Gêmeos Digitais do Azure de nível superior que estão disponíveis.

Configurar variáveis locais para a sessão da CLI

Este artigo fornece comandos da CLI que você pode usar para criar os recursos de histórico de dados. Para facilitar a cópia e a execução desses comandos posteriormente, você pode configurar variáveis locais em sua sessão da CLI agora e, em seguida, referir-se a essas variáveis posteriormente nos comandos da CLI ao criar os recursos. Atualize os espaços reservados (identificados com <...> colchetes) nos comandos abaixo e execute estes comandos para criar as variáveis. Certifique-se de seguir as regras de nomenclatura descritas nos comentários. Esses valores serão usados posteriormente na criação dos novos recursos.

Observação

Esses comandos são escritos para o ambiente Bash. Eles poderão ser ajustados para o PowerShell se você preferir usar um ambiente da CLI do PowerShell.

## General Setup
location="<your-resource-region>"
resourcegroup="<your-resource-group-name>"

## Azure Digital Twins Setup
# Instance name can contain letters, numbers, and hyphens. It must start and end with a letter or number, and be between 4 and 62 characters long.
dtname="<name-for-your-digital-twins-instance>"
# Connection name can contain letters, numbers, and hyphens. It must contain at least one letter, and be between 3 and 50 characters long.
connectionname="<name-for-your-data-history-connection>"

## Event Hub Setup
# Namespace can contain letters, numbers, and hyphens. It must start with a letter, end with a letter or number, and be between 6 and 50 characters long.
eventhubnamespace="<name-for-your-event-hub-namespace>"
# Event hub name can contain only letters, numbers, periods, hyphens and underscores. It must start and end with a letter or number.
eventhub="<name-for-your-event-hub>"

## Azure Data Explorer Setup
# Cluster name can contain only lowercase alphanumeric characters. It must start with a letter, and be between 4 and 22 characters long.
clustername="<name-for-your-cluster>"  
# Database name can contain only alphanumeric, spaces, dash and dot characters, and be up to 260 characters in length.
databasename="<name-for-your-database>"

# Enter a name for the table where relationship create and delete events will be stored.
relationshiplifecycletablename="<name-for-your-relationship-lifecycle-events-table>"
# Enter a name for the table where twin create and delete events will be stored.
twinlifecycletablename="<name-for-your-twin-lifecycle-events-table>"
# Optionally, enter a custom name for the table where twin property updates will be stored. If not provided, the table will be named AdtPropertyEvents.
twinpropertytablename="<name-for-your-twin-property-events-table>"

Criar uma instância de Gêmeos Digitais do Azure com uma identidade gerenciada

Se você já tiver uma instância de Gêmeos Digitais do Azure, verifique se habilitou uma identidade gerenciada pelo sistema para ela.

Caso não tiver uma instância dos Gêmeos Digitais do Azure, siga as instruções em Criar a instância com uma identidade gerenciada para criar uma instância dos Gêmeos Digitais do Azure com uma identidade gerenciada atribuída pelo sistema pela primeira vez.

Verifique se você tem a função de Proprietário de Dados dos Gêmeos Digitais do Azure na instância. Você pode encontrar instruções em Configurar permissões de acesso do usuário.

Se você quiser adicionar o nome da instância às variáveis da CLI local para que ela seja conectada automaticamente a comandos posteriores copiados deste artigo, armazene-a na variável dtname da seguinte maneira:

dtname="<name-of-your-instance>"

Crie um namespace de Hubs de Eventos e um hub de eventos

A próxima etapa é criar um namespace de Hubs de Eventos e um hub de eventos. Esse hub receberá notificações de atualização de propriedade e ciclo de vida do gráfico da instância do Gêmeos Digitais do Azure e, em seguida, encaminhará as mensagens para o cluster do Azure Data Explorer de destino.

Como parte da configuração de conexão do histórico de dados mais tarde, você concederá à instância de Gêmeos Digitais do Azure a função de Proprietário de dados dos Hubs de Eventos do Azure no recurso de hub de eventos.

Para obter mais informações sobre os hubs de eventos e seus recursos, consulte a Documentação dos hubs de eventos.

Observação

Ao configurar o histórico de dados, a autorização local deve ser habilitada no hub de eventos. Se, em última análise, você quiser ter a autorização local desabilitada no hub de eventos, desabilite a autorização depois de configurar a conexão. Você também precisará ajustar algumas permissões, descritas em Restringir o acesso à rede a recursos do histórico de dados mais adiante neste artigo.

CLI

Use os comandos da CLI a seguir para criar os recursos necessários. Os comandos usam diversas variáveis locais ($location, $resourcegroup, $eventhubnamespace e $eventhub) que foram criadas anteriormente em Configurar variáveis locais para a sessão da CLI.

Criar um namespace de Hubs de Eventos:

az eventhubs namespace create --name $eventhubnamespace --resource-group $resourcegroup --location $location

Criar um hub de eventos no namespace:

az eventhubs eventhub create --name $eventhub --resource-group $resourcegroup --namespace-name $eventhubnamespace

Portal

Siga as instruções em Criar um hub de eventos usando o portal do Azure para criar um namespace de Hubs de eventos e um hub de eventos. (O artigo também contém instruções sobre como criar um novo grupo de recursos. Você pode criar um novo grupo de recursos para os recursos dos Hubs de Eventos ou ignorar essa etapa e usar um grupo de recursos existente para os novos recursos dos Hubs de Eventos.)

Lembre-se dos nomes que você dá a esses recursos para que possa usá-los mais tarde.

Criar um banco de dados e um cluster do Kusto (Azure Data Explorer)

Em seguida, crie um banco de dados e um cluster do Kusto (Azure Data Explorer) para receber os dados dos Gêmeos Digitais do Azure.

Como parte da configuração de conexão do histórico de dados mais tarde, você concederá à instância dos Gêmeos Digitais do Azure a função de Colaborador pelo menos no banco de dados (seu escopo pode também ser definido para o cluster) e a função de Administrador no banco de dados.

Importante

Verifique se o cluster tem acesso à rede pública habilitado. Se o cluster do Azure Data Explorer tiver o acesso à rede pública desabilitado, os Gêmeos Digitais do Azure não poderão configurar as tabelas e outros artefatos necessários, e a configuração do histórico de dados falhará.

CLI

Use os comandos da CLI a seguir para criar os recursos necessários. Os comandos usam diversas variáveis locais ($location, $resourcegroup, $clustername e $databasename) que foram criadas anteriormente em Configurar variáveis locais para a sessão da CLI.

Comece adicionando a extensão do Kusto à sua sessão da CLI, se você ainda não a tiver.

az extension add --name kusto

Em seguida, crie o cluster do Kusto. O comando a seguir requer 5 a 10 minutos para ser executado e criará um cluster de E2a v4 na camada de desenvolvedor. Esse tipo de cluster tem um único nó para o mecanismo e o cluster de gerenciamento de dados e é aplicável a cenários de desenvolvimento e teste. Para obter mais informações sobre as camadas no Azure Data Explorer e como selecionar as opções certas para sua carga de trabalho de produção, consulte Selecionar a SKU de computação correta para seu cluster do Azure Data Explorer e Preço do Azure Data Explorer.

az kusto cluster create --cluster-name $clustername --sku name="Dev(No SLA)_Standard_E2a_v4" tier="Basic" --resource-group $resourcegroup --location $location --type SystemAssigned

Crie um banco de dados no novo cluster do Kusto (usando o nome do cluster acima e no mesmo local). Esse banco de dados será usado para armazenar dados contextualizados dos Gêmeos Digitais do Azure. O comando a seguir cria um banco de dados com um período de exclusão temporária de 365 dias e um período de cache frequente de 31 dias. Para obter mais informações sobre as opções disponíveis para esse comando, consulte Criação de banco de dados do AZ Kusto.

az kusto database create --cluster-name $clustername --database-name $databasename --resource-group $resourcegroup --read-write-database soft-delete-period=P365D hot-cache-period=P31D location=$location

Portal

Siga as instruções em Criar um banco de dados e um cluster do Azure Data Explorer para criar um banco de dados e um cluster do Azure Data Explorer no cluster.

Lembre-se dos nomes que você dá a esses recursos para que possa usá-los mais tarde.

Configurar conexão de histórico de dados

Agora que você criou os recursos necessários, use o comando nesta seção para criar uma conexão de histórico de dados entre a instância do Gêmeos Digitais do Azure, o hub de eventos e o cluster do Azure Data Explorer.

Esse comando também criará três tabelas em seu banco de dados do Azure Data Explorer para armazenar atualizações de propriedade gêmea, eventos de ciclo de vida gêmeos e eventos de ciclo de vida de relacionamento, respectivamente. Para obter mais informações sobre esses tipos de dados históricos e suas tabelas correspondentes do Azure Data Explorer, consulte Tipos de dados e esquemas.

CLI

Use o comando nesta seção para criar uma conexão de histórico de dados e as tabelas no Azure Data Explorer. O comando sempre criará uma tabela para eventos de propriedade gêmea historizada e inclui parâmetros para criar as tabelas para eventos de ciclo de vida de relacionamento e ciclo de vida de gêmeos.

Observação

Por padrão, esse comando assume que todos os recursos estão no mesmo grupo de recursos que a instância dos Gêmeos Digitais do Azure. Você pode especificar recursos que estão em grupos de recursos diferentes usando as opções de parâmetro para esse comando.

O comando abaixo usa variáveis locais que foram criadas anteriormente em Configurar variáveis locais para sessão da CLI e tem vários parâmetros, incluindo...

• Os nomes do ciclo de vida do relacionamento e das tabelas de ciclo de vida gêmeos no Azure Data Explorer (esses parâmetros são opcionais se você não quiser historiar esses tipos de evento, mas obrigatórios se quiser historiar esses tipos de evento)
• Um parâmetro opcional para especificar o nome da tabela de eventos de propriedade gêmea (se esse valor não for fornecido, essa tabela será denominada AdtPropertyEvents por padrão). Se você não quiser especificar outro nome, remova o --adx-property-events-table parâmetro do comando antes de executá-lo.
• O parâmetro --adx-record-removals opcional para ativar a historização para exclusões de propriedades gêmeas (eventos que removem propriedades completamente)

az dt data-history connection create adx --dt-name $dtname --cn $connectionname --adx-cluster-name $clustername --adx-database-name $databasename --eventhub $eventhub --eventhub-namespace $eventhubnamespace --adx-property-events-table $twinpropertytablename --adx-twin-events-table $twinlifecycletablename --adx-relationship-events-table $relationshiplifecycletablename --adx-record-removals true

Ao executar o comando acima, você terá a opção de atribuir as permissões necessárias exigidas para configurar a conexão de histórico de dados em seu nome (se você já tiver atribuído as permissões necessárias, poderá ignorar essas solicitações). Essas permissões são concedidas à identidade gerenciada de sua instância de Gêmeos Digitais do Azure. As funções mínimas necessárias são:

• Proprietário dos dados dos Hubs de Eventos do Azure no hub de eventos
• Colaborador com escopo pelo menos para o banco de dados especificado (ele também pode ter o escopo definido para o cluster)
• Atribuição de entidade de segurança de banco de dados com a função de Administrador (para criação/gerenciamento de tabela) com escopo definido para o banco de dados especificado

Para a operação regular do plano de dados, essas funções podem ser reduzidas para uma única função de Remetente de dados dos Hubs de Eventos do Azure, se desejado.

Portal

Comece navegando até a instância de Gêmeos Digitais do Azure no portal do Azure (você pode encontrar a instância inserindo seu nome na barra de pesquisa do portal). Em seguida, conclua as etapas abaixo.

1. Selecione Histórico de dados na seção Saídas de conexão do menu da instância.

   Selecione Criar uma conexão. Isso iniciará o processo de criação de uma conexão de histórico de dados.

2. (ALGUNS USUÁRIOS) Se você ainda não tiver uma identidade gerenciada habilitada para sua instância dos Gêmeos Digitais do Azure, você verá esta página primeiro, solicitando que ative a Identidade para a instância como a primeira etapa para a conexão de histórico de dados.

   

   Se você já tiver uma identidade gerenciada habilitada, sua configuração ignorará esta etapa, e você verá a próxima página imediatamente.

3. Na página Enviar, insira os detalhes dos recursos dos Hubs de Eventos criados anteriormente.

   Selecione Avançar.

4. Na página Loja, insira os detalhes dos recursos do Azure Data Explorer que você criou anteriormente. Você pode escolher um nome personalizado para a tabela que armazenará atualizações de propriedade gêmea ou deixá-la em branco para usar o nome de tabela padrão de AdtPropertyEvents, e pode escolher se as exclusões de propriedade gêmea (eventos que removem propriedades completamente) devem ser incluídas com os dados históricos. Se você quiser historiar eventos do ciclo de vida de gêmeos e do ciclo de vida do relacionamento, insira nomes personalizados para essas tabelas.

   Selecione Avançar.

5. Na página Permissão, marque todas as caixas de seleção para dar à sua instância de Gêmeos Digitais do Azure permissão para se conectar aos Hubs de Eventos e aos recursos do Azure Data Explorer. Se você já tiver permissões iguais ou superiores em uso, poderá ignorar esta etapa.

   Selecione Avançar.

6. Na página Revisar + criar, revise os detalhes de seus recursos e selecione Criar conexão.

Quando a criação da conexão terminar, você será levado de volta para a página Histórico de dados da instância de Gêmeos Digitais do Azure, que agora mostra detalhes da conexão de histórico de dados que você criou.

Depois de configurar a conexão de histórico de dados, você pode, opcionalmente, remover as funções concedidas à sua instância de Gêmeos Digitais do Azure para acessar os Hubs de Eventos e os recursos do Data Explorer Azure. Para usar o histórico de dados, a única função de que a instância precisa depois é o Remetente de Dados dos Hubs de Eventos do Azure (ou uma função superior que inclui essas permissões, como Proprietário dos dados dos Hubs de Eventos do Azure) no recurso Hubs de eventos.

Observação

Depois que a conexão for configurada, as configurações padrão no cluster do Azure Data Explorer resultarão em uma latência de ingestão de aproximadamente 10 minutos ou menos. Você pode reduzir essa latência habilitando a ingestão de streaming (menos de 10 segundos de latência) ou uma política de envio em lote de ingestão. Para obter mais informações sobre a latência de ingestão do Azure Data Explorer, consulte Latência de ingestão de ponta a ponta.

Restringir o acesso à rede aos recursos do histórico de dados

Se você quiser restringir o acesso à rede aos recursos envolvidos no histórico de dados (sua instância do Gêmeos Digitais do Azure, hub de eventos ou cluster do Azure Data Explorer), defina essas restrições depois de configurar a conexão do histórico de dados. Isso inclui desabilitar o acesso local para seus recursos, entre outras medidas para reduzir o acesso à rede.

Para garantir que seus recursos de histórico de dados possam se comunicar entre si, você também deve modificar a conexão de dados do banco de dados do Azure Data Explorer para usar uma identidade gerenciada atribuída pelo sistema.

Siga a ordem das etapas abaixo para garantir que sua conexão com o histórico de dados esteja configurada corretamente quando seus recursos precisarem de acesso reduzido à rede.

1. Verifique se a autorização local está habilitada em seus recursos de histórico de dados (sua instância do Gêmeos Digitais do Azure, o hub de eventos e o cluster do Azure Data Explorer)
2. Criar a conexão do histórico de dados
3. Atualize a conexão de dados do banco de dados do Azure Data Explorer para usar uma identidade gerenciada atribuída pelo sistema. No portal do Azure, você pode fazer isso navegando até o cluster do Azure Data Explorer e usando Bancos de Dados no menu para navegar até o banco de dados de histórico de dados. No menu do banco de dados, selecione Conexões de dados. Na entrada de tabela para sua conexão de histórico de dados, você verá a opção Atribuir identidade gerenciada, onde você pode escolher Atribuído ao sistema.
4. Agora, você pode desabilitar a autorização local ou definir outras restrições de rede para os recursos desejados, alterando as configurações de acesso na instância do Gêmeos Digitais do Azure, no hub de eventos ou no cluster do Azure Data Explorer.

Solucionar problemas de configuração de conexão

Aqui estão alguns erros comuns que você pode encontrar ao configurar uma conexão de histórico de dados e como resolvê-los.

• Se você tiver o acesso à rede pública desabilitado para seu cluster do Azure Data Explorer, encontrará um erro informando que o serviço falhou ao criar a conexão do histórico de dados, com a mensagem "O recurso não pôde ACT devido a um erro interno do servidor". A configuração do histórico de dados falhará se o cluster do Azure Data Explorer tiver o acesso à rede pública desabilitado, já que os Gêmeos Digitais do Azure não poderão configurar as tabelas e outros artefatos necessários.
• (Usuários da CLI) Se você encontrar o erro "Não foi possível criar conexão de instância do Gêmeos Digitais do Azure. Não foi possível criar uma tabela e uma regra de mapeamento no banco de dados. Verifique suas permissões para o Azure Data Explorer e execute az login para atualizar as credenciais", resolva o erro se adicionando como um AllDatabasesAdmin em Permissões no cluster do Azure Data Explorer.
• (Usuários do Cloud Shell) Se você estiver usando o Cloud Shell e encontrar o erro "Falha ao se conectar ao MSI. Verifique se a MSI está configurada corretamente", tente executar o comando com uma instalação da CLI do Azure local.

Verificar com um grafo gêmeo de amostra

Agora que a conexão de histórico de dados está configurada, você pode testá-la com os dados de seus gêmeos digitais.

Se você já tiver gêmeos em sua instância de Gêmeos Digitais do Azure que estão recebendo ativamente atualizações de gráfico (incluindo atualizações de propriedade gêmea ou atualizações de alterar a estrutura do gráfico criando ou excluindo elementos), você pode ignorar esta seção e visualizar os resultados usando seus próprios recursos.

Caso contrário, continue nesta seção para configurar um gráfico de exemplo que passará por eventos de ciclo de vida de gêmeos e relacionamentos e gerará atualizações de propriedades gêmeas.

Você pode configurar um grafo de amostra para esse cenário usando o Simulador de dados dos Gêmeos Digitais do Azure. O Simulador de Dados de Gêmeos Digitais do Azure cria gêmeos e relacionamentos em sua instância de Gêmeos Digitais do Azure e envia continuamente atualizações de propriedade para os gêmeos.

Criar um grafo de amostra

Você pode usar o Simulador de dados dos Gêmeos Digitais do Azure para provisionar um grafo gêmeo de amostra e efetuar push dos dados de atualizações de propriedades para ele. O grafo gêmeo criado aqui modela processos de pasteurização para uma empresa de laticínios.

Comece abrindo o Simulador de Dados dos Gêmeos Digitais do Azure no navegador. Defina estes campos:

• URL da instância: insira o nome do host de sua instância dos Gêmeos Digitais do Azure. O nome do host pode ser encontrado na página do portal para sua instância e tem um formato semelhante a <Azure-Digital-Twins-instance-name>.api.<region-code>.digitaltwins.azure.net.
• Tipo de simulação: selecione Instalação de laticínios no menu suspenso.

Selecione Gerar ambiente.

Você verá mensagens de confirmação na tela conforme modelos, gêmeos e relações são criados no ambiente. Isso também gerará eventos de criação de gêmeos e relacionamentos, que serão registrados no Azure Data Explorer como eventos de ciclo de vida de gêmeos e relacionamentos, respectivamente.

Quando a simulação estiver pronta, o botão Iniciar simulação será habilitado. Role para baixo e selecione Iniciar simulação para enviar dados simulados por push para sua instância do Gêmeos Digitais do Azure. Para atualizar continuamente os gêmeos em sua instância de Gêmeos Digitais do Azure, mantenha essa janela do navegador em primeiro plano na área de trabalho e conclua outras ações do navegador em uma janela separada. Isso gerará continuamente eventos de atualizações de propriedade gêmea que serão registrados no Azure Data Explorer.

Exibir as atualizações historizadas no Azure Data Explorer

Esta seção mostrará como exibir todos os três tipos de atualizações historizadas que foram geradas pelo simulador e armazenadas em tabelas do Azure Data Explorer.

Comece no portal do Azure e navegue até o cluster do Azure Data Explorer criado anteriormente. Escolha o painel Bancos de dados no menu à esquerda para abrir a exibição do banco de dados. Encontre o banco de dados criado para este artigo e marque a caixa de seleção ao lado dele e, em seguida, selecione Consulta.

Em seguida, expanda o cluster e o banco de dados no painel esquerdo para ver o nome das tabelas de histórico de dados. Deve haver três: um para eventos do ciclo de vida do relacionamento, um para eventos do ciclo de vida do gêmeo e um para eventos de atualização de propriedade gêmea. Você usará esses nomes de tabela para executar consultas nas tabelas para verificar e exibir os dados históricos.

Verificar entradas de tabela

Para verificar se os eventos estão sendo registrados no banco de dados, comece copiando o comando a seguir. Ele tem um espaço reservado para o nome da tabela de eventos do ciclo de vida do relacionamento e alterará a ingestão da tabela para o modo em lotes para que ele ingera dados da simulação ao vivo a cada 10 segundos.

.alter table <relationship-lifecycle-events-table-name> policy ingestionbatching @'{"MaximumBatchingTimeSpan":"00:00:10", "MaximumNumberOfItems": 500, "MaximumRawDataSizeMB": 1024}'

Cole o comando na janela de consulta, substituindo o espaço reservado pelo nome da tabela de eventos de relacionamento. Selecione o botão Executar para executar o comando.

Repita o comando mais duas vezes usando o nome da tabela de eventos de ciclo de vida gêmeo e, em seguida, a tabela de atualização de propriedade para atualizar o modo de ingestão das outras tabelas também.

Em seguida, adicione os seguintes comandos à janela de consulta e execute-os. Cada comando contém um espaço reservado para o nome de uma das tabelas, e os comandos produzirão o número de itens nas tabelas.

Observação

Pode levar até 5 minutos para que o primeiro lote de dados ingeridos seja exibido.

<relationship-lifecycle-events-table-name>
| count

<twin-lifecycle-events-table-name>
| count

<twin-property-updates-table-name>
| count

Você deve ver nos resultados que a contagem de itens em cada tabela é algo maior que 0, indicando que os eventos de ciclo de vida de relacionamento, ciclo de vida duplo e atualização de propriedade estão sendo registrados em suas respectivas tabelas.

Explore a tabela de atualizações de propriedades gêmeas

Nesta seção, você fará mais alguma exploração com os dados de atualização de propriedade gêmea que estão na tabela.

Primeiro, execute o seguinte comando para exibir 100 registros na tabela:

<twin-property-updates-table-name>
| limit 100

Em seguida, execute uma consulta com base nos dados de seus gêmeos para ver os dados de séries temporárias contextualizados.

Use a consulta abaixo para traçar o fluxo de saída de todos os gêmeos de máquinas de sal na fábrica de laticínios Oslo de amostra. Essa consulta do Kusto usa o plug-in dos Gêmeos Digitais do Azure para selecionar os gêmeos de interesse, une esses gêmeos em relação à série temporal de histórico de dados no Azure Data Explorer e, em seguida, faz o gráfico dos resultados. Certifique-se de substituir o espaço reservado pelo nome do host da instância e o <ADT-instance-host-name> <table-name> espaço reservado pelo nome da tabela de eventos de propriedade gêmea.

let ADTendpoint = "https://<ADT-instance-host-name>";
let ADTquery = ```SELECT SALT_MACHINE.$dtId as tid
FROM DIGITALTWINS FACTORY 
JOIN SALT_MACHINE RELATED FACTORY.contains 
WHERE FACTORY.$dtId = 'OsloFactory'
AND IS_OF_MODEL(SALT_MACHINE , 'dtmi:assetGen:SaltMachine;1')```;
evaluate azure_digital_twins_query_request(ADTendpoint, ADTquery)
| extend Id = tostring(tid)
| join kind=inner (<table-name>) on Id
| extend val_double = todouble(Value)
| where Key == "OutFlow"
| render timechart with (ycolumns = val_double)

Os resultados devem mostrar os números de fluxo de saída mudando ao longo do tempo.

Solucionar problemas de conexão

Se você não vir dados no Azure Data Explorer, o fluxo de dados de historização não está funcionando corretamente. Você pode investigar o problema exibindo seu namespace de Hubs de Eventos no portal do Azure, que exibe gráficos mostrando o fluxo de mensagens para dentro e para fora do namespace. Isso permitirá que você verifique o fluxo de mensagens de entrada dos Gêmeos Digitais do Azure e as mensagens de saída para o Azure Data Explorer, para ajudá-lo a identificar qual parte do fluxo não está funcionando.

Próximas etapas

Para continuar explorando o cenário de laticínios, você pode exibir mais consultas de amostra no GitHub que mostram como você pode monitorar o desempenho da operação de laticínios com base em tipo de máquina, fábrica, técnico de manutenção e várias combinações desses parâmetros.

Para criar painéis do Grafana que visualizam o desempenho da operação de laticínios, leia Criando painéis com Gêmeos Digitais do Azure, Azure Data Explorer e Grafana.

Para obter mais informações sobre como usar o plug-in de consulta dos Gêmeos Digitais do Azure para o Azure Data Explorer, confira Consultando com o plug-in do Data Explorer do Azure e esta postagem no blog. Você também pode ler mais sobre o plug-in aqui: Consultando com o plug-in do Azure Data Explorer.