Créer une connexion d’historique des données pour Azure Digital Twins

L’historique des données est une fonctionnalité Azure Digital Twins permettant d’historiser automatiquement les mises à jour de graphe vers Azure Data Explorer. Vous pouvez interroger ces données à l’aide du plug-in de requête Azure Digital Twins pour Azure Data Explorer afin d’obtenir des insights sur votre environnement dans le temps.

Cet article explique comment configurer une connexion d’historique des données entre Azure Digital Twins et Azure Data Explorer. Il utilise Azure CLI et le portail Azure pour configurer et connecter les ressources d’historique de données nécessaires, notamment :

• Une instance d’Azure Digital Twins
• Un espace de noms Event Hubs contenant un hub d’événements
• Un cluster Azure Data Explorer contenant une base de données

Il contient également un exemple de graphe de jumeau que vous pouvez utiliser pour voir les mises à jour de graphique historisées dans Azure Data Explorer.

Conseil

Bien que cet article utilise la Portail Azure, vous pouvez également utiliser l’historique des données à l’aide de la version 2022-05-31 des API REST.

Prérequis

Préparation de votre environnement pour Azure CLI

• Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.

  

• Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.

  • Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.

  • Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.

  • Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Remarque

Si vous préférez, vous pouvez utiliser Azure Cloud Shell dans l’environnement PowerShell au lieu de l’environnement Bash. Les commandes de cette page sont écrites pour l’environnement Bash. Elles peuvent donc nécessiter quelques petits ajustements dans PowerShell.

Configurer une session CLI

Pour commencer à utiliser Azure Digital Twins dans l’interface CLI, vous devez d’abord vous connecter et définir votre abonnement en tant que contexte CLI pour cette session. Exécutez les commandes suivantes dans votre fenêtre CLI :

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

Conseil

Vous pouvez également utiliser le nom de votre abonnement à la place de l’ID dans la commande ci-dessus.

Si vous utilisez cet abonnement avec Azure Digital Twins pour la première fois, exécutez cette commande pour vous inscrire auprès de l’espace de noms Azure Digital Twins. (En cas de doute, il est possible de la réexécuter même si vous l’avez fait par le passé.)

az provider register --namespace 'Microsoft.DigitalTwins'

Vous allez ensuite ajouter l’extension Microsoft Azure IoT pour Azure CLI afin d’activer les commandes permettant d’interagir avec Azure Digital Twins et d’autres services IoT. Exécutez cette commande pour vous assurer de disposer de la version la plus récente de l’extension :

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

Vous êtes maintenant prêt à utiliser Azure Digital Twins dans Azure CLI.

Vous pouvez le vérifier en exécutant az dt --help à tout moment pour voir la liste des commandes Azure Digital Twins de niveau supérieur disponibles.

Configurer des variables locales pour une session CLI

Cet article fournit des commandes CLI que vous pouvez utiliser pour créer les ressources de l’historique des données. Afin de faciliter la copie et l’exécution de ces commandes pour la prochaine fois, vous pouvez configurer des variables locales dans votre session CLI dès maintenant, puis vous référer à ces variables ultérieurement dans les commandes CLI lorsque vous créerez vos ressources. Mettez à jour les espaces réservés (identifiables par les crochets <...>) dans les commandes ci-dessous, puis exécutez ces commandes pour créer les variables. Veillez à suivre les règles de nommage décrites dans les commentaires. Ces valeurs seront utilisées ultérieurement lors de la création des ressources.

Remarque

Ces commandes sont écrites pour l’environnement Bash. Celles-ci peuvent être ajustées pour PowerShell si vous préférez utiliser un environnement CLI 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>"

Créer une instance Azure Digital Twins avec une identité managée

Si vous disposez déjà d’une instance Azure Digital Twins, vérifiez que vous avez activé une identité managée affectée par le système pour celle-ci.

Si vous n’avez pas d’instance Azure Digital Twins, suivez les instructions fournies dans Créer une instance avec une identité managée pour créer une instance Azure Digital Twins avec une identité managée affectée par le système pour la première fois.

Assurez-vous ensuite que vous avez le rôle Propriétaire de données Azure Digital Twins sur l’instance. Vous trouverez des instructions dans Configurer les autorisations d’accès utilisateur.

Si vous souhaitez ajouter le nom de votre instance à vos variables CLI locales afin qu’elle soit automatiquement connectée aux commandes ultérieures copiées à partir de cet article, stockez-la dans la variable dtname comme suit :

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

Créer un espace de noms Event Hubs et un hub d’événements

La prochaine étape consiste à créer un espace de noms Event Hubs et un hub d’événements. Ce hub reçoit des notifications de cycle de vie de graphique et de mise à jour des propriétés de l’instance Azure Digital Twins, puis transfère les messages au cluster Azure Data Explorer cible.

Plus tard, dans le cadre de la configuration de la connexion d’historique des données, vous accorderez à l’instance Azure Digital Twins le rôle de Propriétaire de données Azure Event Hubs pour la ressource de hub d’événements.

Pour plus d’informations sur les hubs d’événements et leurs fonctionnalités, consultez la documentation Event Hubs.

Remarque

Lors de la configuration de l’historique des données, l’autorisation locale doit être activée sur le hub d’événements. Si vous souhaitez finalement que l’autorisation locale soit désactivée sur votre hub d’événements, désactivez l’autorisation après avoir configuré la connexion. Vous devrez également ajuster certaines autorisations, décrites dans Restriction de l’accès réseau aux ressources d’historique des données plus loin dans cet article.

INTERFACE DE LIGNE DE COMMANDE

Utilisez les commandes CLI suivantes pour créer les ressources nécessaires. Les commandes utilisent plusieurs variables locales ($location, $resourcegroup, $eventhubnamespace et $eventhub) qui ont été créées précédemment dans Configurer des variables locales pour une session CLI.

Créez un espace de noms Event Hubs :

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

Créez un hub d’événements dans votre espace de noms :

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

Portail

Pour créer un espace de noms Event Hubs et un hub d’événements, suivez les instructions fournies dans Créer un hub d’événements avec le portail Azure. (Cet article contient également des instructions sur la création d’un groupe de ressources. Vous pouvez créer un nouveau groupe de ressources pour les ressources Event Hubs, ou ignorer cette étape et utiliser un groupe de ressources existant pour vos nouvelles ressources Event Hubs.)

Notez bien les noms que vous donnez à ces ressources car vous en aurez besoin plus tard.

Créer un cluster et une base de données Kusto (Azure Data Explorer)

Ensuite, créez un cluster et une base de données Kusto (Azure Data Explorer) pour recevoir les données envoyées par Azure Digital Twins.

Dans le cadre de la configuration de la connexion d’historique des données, vous accorderez à l’instance Azure Digital Twins le rôle Contributeur pour la base de données (et le cluster, si vous le souhaitez) ainsi que le rôle Administrateur pour la base de données.

Important

Vérifiez que le cluster dispose d’un accès réseau public activé. Si le cluster Azure Data Explorer dispose d’un accès réseau public désactivé, Azure Digital Twins ne peut pas configurer les tables et d’autres artefacts requis, et la configuration de l’historique des données échoue.

INTERFACE DE LIGNE DE COMMANDE

Utilisez les commandes CLI suivantes pour créer les ressources nécessaires. Les commandes utilisent plusieurs variables locales ($location, $resourcegroup, $clustername et $databasename) qui ont été créées précédemment dans Configurer des variables locales pour une session CLI.

Commencez par ajouter l’extension Kusto à votre session CLI, si ce n’est déjà fait.

az extension add --name kusto

Ensuite, créez le cluster Kusto. La commande suivante nécessite 5 à 10 minutes pour s’exécuter, et crée un cluster E2A v4 dans le niveau Développeur. Ce type de cluster comprend un seul nœud pour le moteur et le cluster de gestion des données. En outre, il s’applique aussi bien aux scénarios de développement qu’aux scénarios de test. Pour plus d’informations sur les niveaux dans Azure Data Explorer et sur la manière dont vous pouvez sélectionner les options appropriées pour votre charge de travail de production, consultez Sélectionner la bonne référence SKU de calcul pour votre cluster Azure Data Explorer et Tarifs 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

Créez une base de données dans votre nouveau cluster Kusto (en utilisant le nom de cluster ci-dessus et le même emplacement). Cette base de données sera utilisée pour stocker des données Azure Digital Twins contextualisées. La commande ci-dessous crée une base de données avec une période de suppression réversible de 365 jours, et une période de mise en cache chaud de 31 jours. Pour plus d’informations sur les options qui sont disponibles pour cette commande, consultez az kusto database create.

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

Portail

Pour créer un cluster Azure Data Explorer et une base de données dans ce cluster, suivez les instructions fournies dans Créer un cluster et une base de données Azure Data Explorer.

Notez bien les noms que vous donnez à ces ressources car vous en aurez besoin plus tard.

Configurer la connexion d’historique des données

Maintenant que vous avez créé les ressources requises, utilisez la commande de cette section pour créer une connexion d’historique des données entre l’instance Azure Digital Twins, le hub d’événements et le cluster Azure Data Explorer.

Cette commande crée également trois tables dans votre base de données Azure Data Explorer pour stocker les mises à jour des propriétés de jumeau, les événements de cycle de vie des jumeaux et les événements de cycle de vie des relations, respectivement. Pour plus d’informations sur ces types de données historisées et leurs tables Azure Data Explorer correspondantes, consultez Types de données et schémas.

INTERFACE DE LIGNE DE COMMANDE

Utilisez la commande de cette section pour créer une connexion d’historique des données et les tables dans Azure Data Explorer. La commande crée toujours une table pour les événements de propriété de jumeau historisée, et inclut des paramètres pour créer les tables pour le cycle de vie des relations et les événements de cycle de vie des jumeaux.

Remarque

Par défaut, cette commande suppose que toutes les ressources se trouvent dans le même groupe de ressources que l’instance Azure Digital Twins. Vous pouvez spécifier des ressources qui se trouvent dans différents groupes de ressources à l’aide des options de paramètre de cette commande.

La commande ci-dessous utilise des variables locales créées précédemment dans Configurer des variables locales pour la session CLI et a plusieurs paramètres, notamment...

• Les noms des tables de cycle de vie des relations et du cycle de vie des jumeaux dans Azure Data Explorer (ces paramètres sont facultatifs si vous ne souhaitez pas historiser ces types d’événements, mais requis si vous souhaitez historiser ces types d’événements)
• Paramètre facultatif pour spécifier le nom de la table d’événements de propriété de jumeau (si cette valeur n’est pas fournie, cette table sera nommée AdtPropertyEvents par défaut). Si vous ne souhaitez pas spécifier un autre nom, supprimez le --adx-property-events-table paramètre de la commande avant de l’exécuter.
• Paramètre --adx-record-removals facultatif à activer l’historisation pour les suppressions de propriétés de jumeau (événements qui suppriment entièrement les propriétés)

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

Lorsque vous exécuterez la commande ci-dessus, l’outil vous proposera d’attribuer automatiquement les autorisations nécessaires à la configuration de votre connexion d’historique des données (si vous avez déjà attribué les autorisations nécessaires, vous pouvez ignorer ces invites). Ces autorisations sont accordées à l’identité managée de votre instance Azure Digital Twins. Les rôles dont vous devez disposer au minimum sont les suivants :

• Propriétaire des données Azure Event Hubs pour le hub d’événements
• Contributeur, appliqué au moins à la base de données spécifiée (et éventuellement au cluster)
• Attribution du principal de base de données avec le rôle Administrateur (pour la création et la gestion de table) appliqué à la base de données spécifiée

Pour une utilisation normale des plans de données, vous pouvez réduire ces rôles à un seul rôle Expéditeur de données Azure Event Hubs, si vous le souhaitez.

Portail

Commencez par accéder à votre instance Azure Digital Twins dans le portail Azure (vous pouvez la trouver en entrant son nom dans la barre de recherche du portail). Ensuite, effectuez les tâches suivantes.

1. Sélectionnez Historique des données dans la section Connect Outputs (Connecter les sorties) du menu de l’instance.

   Sélectionnez Créer une connexion. Cela démarrera le processus de création d’une connexion d’historique des données.

2. (POUR CERTAINS UTILISATEURS) Si vous n’avez pas encore activé l’identité managée pour votre instance Azure Digital Twins, vous verrez d’abord cette page vous demandant d’activer l’identité pour l’instance avant de passer à la connexion d’historique des données.

   

   Si vous avez déjà activé une identité managée, votre programme d’installation ignorera cette étape et vous verrez immédiatement la page suivante.

3. Dans la page Envoyer, entrez les détails des ressources Event Hubs que vous avez créées précédemment.

   Cliquez sur Suivant.

4. Dans la page Store , entrez les détails des ressources Azure Data Explorer que vous avez créées précédemment. Vous pouvez choisir un nom personnalisé pour la table qui stockera les mises à jour des propriétés de jumeau ou laissez-le vide pour utiliser le nom de table par défaut d’AdtPropertyEvents, et vous pouvez choisir si les suppressions de propriétés de jumeau (événements qui suppriment entièrement les propriétés) doivent être incluses avec les données historisées. Si vous souhaitez historiser le cycle de vie des jumeaux et les événements de cycle de vie des relations, entrez des noms personnalisés pour ces tables.

   Cliquez sur Suivant.

5. Dans la page Autorisation, cochez toutes les cases pour autoriser votre instance Azure Digital Twins à se connecter aux ressources Event Hubs et Azure Data Explorer. Si vous disposez déjà de telles autorisations ou d’autorisations supérieures, vous pouvez ignorer cette étape.

   Cliquez sur Suivant.

6. Dans la page Vérifier + créer, vérifiez les détails de vos ressources, puis sélectionnez Créer une connexion.

Une fois la connexion créée, vous serez redirigé vers la page Historique des données de l’instance Azure Digital Twins qui affiche désormais les détails de la connexion d’historique des données que vous avez créée.

Après avoir configuré la connexion d’historique des données, vous pouvez, si vous le souhaitez, supprimer les rôles accordés à votre instance Azure Digital Twins pour l’accès aux ressources Event Hubs et Azure Data Explorer. Pour utiliser l’historique des données, le seul rôle dont l’instance aura besoin par la suite est Expéditeur de données Azure Event Hubs (ou un rôle avec des privilèges plus élevés comprenant ces autorisations, comme Propriétaire des données Azure Event Hubs) pour la ressource Event Hubs.

Remarque

Une fois la connexion configurée, les paramètres par défaut de votre cluster Azure Data Explorer entraîneront une latence d’ingestion d’environ 10 minutes ou moins. Vous pouvez réduire cette latence en activant l’ingestion par streaming (moins de 10 secondes de latence) ou une stratégie d’ingestion par lots. Pour plus d’informations sur la latence d’ingestion d’Azure Data Explorer, consultez Latence d’ingestion de bout en bout.

Restreindre l’accès réseau aux ressources d’historique des données

Si vous souhaitez restreindre l’accès réseau aux ressources impliquées dans l’historique des données (votre instance Azure Digital Twins, event hub ou cluster Azure Data Explorer), vous devez définir ces restrictions après avoir configuré la connexion d’historique des données. Cela inclut la désactivation de l’accès local pour vos ressources, entre autres mesures pour réduire l’accès réseau.

Pour vous assurer que vos ressources d’historique des données peuvent communiquer entre elles, vous devez également modifier la connexion de données pour la base de données Azure Data Explorer afin d’utiliser une identité managée affectée par le système.

Suivez l’ordre des étapes ci-dessous pour vous assurer que votre connexion d’historique des données est correctement configurée lorsque vos ressources ont besoin d’un accès réseau réduit.

1. Vérifiez que l’autorisation locale est activée sur vos ressources d’historique des données (votre instance Azure Digital Twins, event hub et cluster Azure Data Explorer)
2. Créer la connexion d’historique des données
3. Mettez à jour la connexion de données pour la base de données Azure Data Explorer afin d’utiliser une identité managée affectée par le système. Dans le Portail Azure, vous pouvez le faire en accédant au cluster Azure Data Explorer et en utilisant des bases de données dans le menu pour accéder à la base de données d’historique des données. Dans le menu de base de données, sélectionnez Connexions de données. Dans l’entrée de table de votre connexion d’historique des données, vous devez voir l’option Affecter une identité managée, où vous pouvez choisir Affectée par le système.
4. À présent, vous pouvez désactiver l’autorisation locale ou définir d’autres restrictions réseau pour vos ressources souhaitées, en modifiant les paramètres d’accès sur votre instance Azure Digital Twins, event Hub ou cluster Azure Data Explorer.

Résoudre les problèmes de configuration de connexion

Voici quelques erreurs courantes que vous pouvez rencontrer lors de la configuration d’une connexion d’historique des données et comment les résoudre.

• Si vous avez un accès réseau public désactivé pour votre cluster Azure Data Explorer, vous rencontrerez une erreur indiquant que le service n’a pas pu créer la connexion d’historique des données, avec le message « La ressource n’a pas pu AGIR en raison d’une erreur de serveur interne ». La configuration de l’historique des données échoue si le cluster Azure Data Explorer dispose d’un accès réseau public désactivé, car Azure Digital Twins ne peut pas configurer les tables et d’autres artefacts requis.
• (Utilisateurs de l’interface CLI) Si vous rencontrez l’erreur « Impossible de créer une connexion d’instance Azure Digital Twins. Impossible de créer une table et une règle de mappage dans la base de données. Vérifiez vos autorisations Azure Database Explorer et exécutez az login pour actualiser vos informations d’identification », vous pouvez la résoudre en vous ajoutant comme AllDatabasesAdmin sous Autorisations dans votre cluster Azure Data Explorer.
• (Utilisateurs de Cloud Shell) Si vous utilisez Cloud Shell et que vous rencontrez l’erreur « Échec de la connexion à MSI. Vérifiez que MSI est correctement configuré », essayez d’exécuter la commande avec une installation Azure CLI locale à la place.

Effectuer une vérification à l’aide d’un exemple de graphe de jumeau

Maintenant que votre connexion d’historique des données est configurée, vous pouvez la tester avec les données de vos jumeaux numériques.

Si vous avez déjà des jumeaux dans votre instance Azure Digital Twins qui reçoivent activement des mises à jour de graphe (y compris les mises à jour des propriétés de jumeau ou les mises à jour de la modification de la structure du graphique en créant ou en supprimant des éléments), vous pouvez ignorer cette section et visualiser les résultats à l’aide de vos propres ressources.

Sinon, passez à cette section pour configurer un exemple de graphique qui subira des événements de cycle de vie des jumeaux et des relations et générera des mises à jour de propriétés de jumeau.

Vous pouvez configurer un exemple de graphe pour ce scénario à l’aide du simulateur de données Azure Digital Twins. Le simulateur de données Azure Digital Twins crée des jumeaux et des relations dans votre instance Azure Digital Twins, et envoie en continu des mises à jour de propriété aux jumeaux.

Créer un exemple de graphe

Vous pouvez utiliser le simulateur de données Azure Digital Twins pour provisionner un exemple de graphe et envoyer (push) des mises à jour de propriétés de jumeaux à ce dernier. Le graphe de jumeau créé ici modélise les processus de pasteurisation d’une société laitière.

Commencez par ouvrir le simulateur de données Azure Digital Twins dans votre navigateur. Définissez ces champs :

• URL d’instance : entrez le nom d’hôte de votre instance Azure Digital Twins. Le nom d’hôte se trouve dans la page du portail de votre instance, et son format est le suivant <Azure-Digital-Twins-instance-name>.api.<region-code>.digitaltwins.azure.net.
• Type de simulation : sélectionnez Dairy facility dans le menu déroulant.

Sélectionnez Generate Environment (Générer l’environnement).

Des messages de confirmation s’afficheront pour chaque création de modèle, de jumeau et de relation dans votre environnement. Cela génère également des événements de création de jumeaux et de relations, qui seront historisés dans Azure Data Explorer en tant qu’événements de cycle de vie des jumeaux et des relations, respectivement.

Lorsque la simulation est prête, le bouton Start simulation (Démarrer la simulation) est activé. Faites défiler vers le bas et sélectionnez Démarrer la simulation pour envoyer (push) des données simulées à votre instance Azure Digital Twins. Pour mettre à jour en continu les jumeaux dans votre instance Azure Digital Twins, conservez cette fenêtre de navigateur au premier plan sur votre bureau et effectuez d’autres actions de navigateur dans une fenêtre distincte. Cela génère en permanence des événements de mise à jour de propriétés de jumeau qui seront historisés vers Azure Data Explorer.

Afficher les mises à jour historisées dans Azure Data Explorer

Cette section vous montre comment afficher les trois types de mises à jour historisées générées par le simulateur et stockées dans des tables Azure Data Explorer.

Dans le portail Azure, accédez au cluster Azure Data Explorer que vous avez créé précédemment. Choisissez le volet Bases de données dans le menu de gauche pour ouvrir la vue Base de données. Recherchez la base de données que vous avez créée pour cet article et cochez la case en regard de celle-ci, puis sélectionnez Interroger.

Ensuite, développez le cluster et la base de données dans le volet gauche pour afficher le nom des tables d’historique des données. Il doit y avoir trois : un pour les événements de cycle de vie des relations, un pour les événements de cycle de vie des jumeaux et un pour les événements de mise à jour de propriété de jumeau. Vous allez utiliser ces noms de tables pour exécuter des requêtes sur les tables pour vérifier et afficher les données historisées.

Vérifier les entrées de table

Pour vérifier que les événements sont historisés dans la base de données, commencez par copier la commande suivante. Il a un espace réservé pour le nom de la table d’événements de cycle de vie des relations, et il modifie l’ingestion de la table en mode par lots afin qu’elle ingère les données de la simulation dynamique toutes les 10 secondes.

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

Collez la commande dans la fenêtre de requête, en remplaçant l’espace réservé par le nom de votre table d’événements de relation. Sélectionnez le bouton Exécuter pour exécuter la commande.

Répétez la commande deux fois plus en utilisant le nom de la table des événements de cycle de vie des jumeaux, puis la table de mise à jour de propriété pour mettre à jour le mode d’ingestion des autres tables.

Ensuite, ajoutez les commandes suivantes à la fenêtre de requête et exécutez-les. Chaque commande contient un espace réservé pour le nom de l’une des tables, et les commandes affichent le nombre d’éléments dans les tables.

Remarque

L’affichage du premier lot de données ingérées peut prendre jusqu’à 5 minutes.

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

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

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

Vous devez voir dans les résultats que le nombre d’éléments de chaque table est supérieur à 0, ce qui indique que le cycle de vie des relations, le cycle de vie des jumeaux et les événements de mise à jour des propriétés sont historisés dans leurs tables respectives.

Explorer la table des mises à jour des propriétés de jumeau

Dans cette section, vous allez effectuer une exploration plus approfondie avec les données de mise à jour de propriété de jumeau qui se trouve dans la table.

Tout d’abord, exécutez la commande suivante pour afficher 100 enregistrements dans la table :

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

Ensuite, exécutez une requête basée sur les données de vos jumeaux pour afficher les données contextualisées de la série chronologique.

Utilisez la requête ci-dessous pour tracer le débit de tous les jumeaux de machine à sel dans l’exemple d’usine laitière Oslo. Cette requête Kusto utilise le plug-in Azure Digital Twins pour sélectionner les jumeaux d’intérêt, joindre ces jumeaux à la série chronologique de l’historique des données dans Azure Data Explorer, puis regrouper les résultats. Veillez à remplacer l’espace <ADT-instance-host-name> réservé par le nom d’hôte de votre instance et l’espace <table-name> réservé par le nom de votre table d’événements de propriété de jumeau.

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)

Dans les résultats, vous devez voir que les chiffres liés aux quantités de sel déversées changent au fil du temps.

Résoudre les problèmes de connexion

Si vous ne voyez pas de données dans Azure Data Explorer, le flux de données d’historisation ne fonctionne pas correctement. Vous pouvez examiner le problème en affichant votre espace de noms Event Hubs dans le Portail Azure, qui affiche les graphiques affichant le flux de messages dans et hors de l’espace de noms. Cela vous permet de vérifier à la fois le flux des messages entrants d’Azure Digital Twins et les messages sortants vers Azure Data Explorer pour vous aider à identifier la partie du flux qui ne fonctionne pas.

Étapes suivantes

Pour poursuivre l’exploration du scénario de la société laitière, vous pouvez afficher d’autres exemples de requêtes sur GitHub qui montrent comment monitorer les performances de la société en fonction du type de machine, de la fabrique, du technicien de maintenance et de différentes combinaisons de ces paramètres.

Pour créer des tableaux de bord Grafana permettant de visualiser les performances de la société laitière, consultez Créer des tableaux de bord avec Azure Digital Twins, Azure Data Explorer et Grafana.

Pour plus d’informations sur l’utilisation du plug-in de requête Azure Digital Twins pour Azure Data Explorer, consultez Plug-in de requête Azure Digital Twins pour Azure Data Explorer ainsi que ce billet de blog. Pour plus d’informations sur le plug-in, consultez : Interroger des données avec le plug-in Azure Data Explorer.