Partager via

az dt data-history connection create

  • Référence

Remarque

Cette référence fait partie de l’extension azure-iot pour Azure CLI (version 2.46.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az dt data-history connection create . En savoir plus sur les extensions.

Crée une connexion d’historique des données entre une instance Digital Twins et des ressources prises en charge.

Commandes

Nom Description Type Statut
az dt data-history connection create adx

Crée une connexion d’historique des données entre une instance Digital Twins et une base de données Azure Data Explorer. Nécessite des ressources Azure Data Explorer et Event Hub précréée.

 Extension GA

az dt data-history connection create adx

Crée une connexion d’historique des données entre une instance Digital Twins et une base de données Azure Data Explorer. Nécessite des ressources Azure Data Explorer et Event Hub précréée.

Invite l’utilisateur à ajouter les rôles et autorisations suivants sur l’instance Digital Twins ou l’identité affectée par l’utilisateur nécessaire pour créer la connexion :

  • Rôle « Contributeur » pour l’étendue de la base de données Azure Data Explorer
  • Autorisation « Administrateur de base de données » pour l’étendue de la base de données Azure Data Explorer
  • Rôle « Propriétaire des données Azure Event Hubs » pour l’étendue Event Hub.
az dt data-history connection create adx --adx-cluster-name
                                         --adx-database-name
                                         --cn
                                         --dt-name
                                         --eh
                                         --ehn
                                         [--adx-property-events-table]
                                         [--adx-record-removals {false, true}]
                                         [--adx-relationship-events-table]
                                         [--adx-resource-group]
                                         [--adx-subscription]
                                         [--adx-table-name]
                                         [--adx-twin-events-table]
                                         [--ehc]
                                         [--ehg]
                                         [--ehs]
                                         [--mi-user-assigned]
                                         [--no-wait]
                                         [--resource-group]
                                         [--yes]

Exemples

Ajoute une connexion d’historique des données à une instance Digital Twins cible avec le groupe de consommateurs Event Hub $Default.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace}

Ajoute une connexion d’historique des données à une instance Digital Twins cible à l’aide d’une identité affectée par l’utilisateur associée au jumeau numérique avec le groupe de consommateurs $Default Event Hub.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --mi-user-assigned {resource_id}

Ajoute une connexion d’historique des données à une instance Digital Twins cible avec un nom de table Azure Data Explorer personnalisé et un groupe de consommateurs Event Hub.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --adx-property-events-table {adx_property_events_table_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --eventhub-consumer-group {event_hub_consumer_group}

Ajoute une connexion d’historique des données à une instance Digital Twins cible qui s’intègre à des instances Event Hub et Azure Data Explorer dans différents groupes de ressources et abonnements de l’instance cible.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --adx-resource-group {adx_resource_group} --adx-subscription {adx_subscription} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --eventhub-resource-group {event_hub_resource_group} --eventhub-subscription {event_subscription}

Ajoute une connexion d’historique des données à une instance Digital Twins cible avec le groupe de consommateurs Event Hub $Default et ignore les invites d’attribution de rôle.

az dt data-history connection create adx -n {instance_name} -y --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace}

Ajoute une connexion d’historique des données à une instance Digital Twins cible avec le groupe de consommateurs Event Hub $Default et active les suppressions de propriétés et d’éléments d’enregistrement. Une colonne supplémentaire sera ajoutée à la table utilisée pour stocker les mises à jour apportées aux propriétés des jumeaux et des relations (par défaut, adtPropertyEvents).

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --adx-record-removals true

Ajoute une connexion d’historique des données à une instance Digital Twins cible avec le groupe de consommateurs Event Hub $Default et crée deux tables supplémentaires dans la base de données Azure Data Explorer. Une table concerne l’enregistrement des événements de cycle de vie des jumeaux et l’autre pour les événements de cycle de vie des relations.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --adx-twin-events-table {adx_twin_events_table_name} --adx-relationship-events-table {adx_relationship_events_table_name}

Ajoute une connexion d’historique des données à une instance Digital Twins cible avec le groupe de consommateurs Event Hub $Default, utilise un nom de table d’événements de propriété de jumeau personnalisée et crée deux tables supplémentaires dans la base de données Azure Data Explorer.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --adx-property-events-table {adx_property_events_table_name} --adx-twin-events-table {adx_twin_events_table_name} --adx-relationship-events-table {adx_relationship_events_table_name}

Paramètres obligatoires

--adx-cluster-name --adxc

Nom du cluster Azure Data Explorer à intégrer.

--adx-database-name --adxd

Nom de la base de données Azure Data Explorer à intégrer.

--cn --conn-name

Nom de la connexion d’historique des données.

--dt-name --dtn -n

Nom de l’instance Digital Twins.

--eh --eventhub

Nom d’EventHub à intégrer.

--ehn --eventhub-namespace

Identificateur d’espace de noms EventHub.

Paramètres facultatifs

--adx-property-events-table --adxpet

Nom de la table Azure Data Explorer utilisée pour stocker les mises à jour sur les propriétés des jumeaux et des relations.

valeur par défaut: AdtPropertyEvents
--adx-record-removals --adxrr

Spécifie s’il faut enregistrer ou non des suppressions de jumeaux/relations et d’éléments, y compris les suppressions de valeurs indexées ou clé (telles que les entrées cartographiques, les éléments de tableau, etc.). La définition de cette propriété sur « true » génère une colonne supplémentaire dans la table des événements de propriété dans ADX.

valeurs acceptées: false, true
valeur par défaut: False
--adx-relationship-events-table --adxret

Nom de la table Azure Data Explorer utilisée pour enregistrer les événements de cycle de vie des relations. La table ne sera pas créée si cette propriété n’est pas spécifiée.

--adx-resource-group --adxg

Nom du groupe de ressources Azure Data Explorer. S’il n’est pas fourni, utilisez le groupe de ressources Digital Twin.

--adx-subscription --adxs

Nom ou ID d’abonnement où existe Azure Data Explorer. S’il n’est pas fourni, utilisez l’abonnement qui contient l’instance Digital Twin.

--adx-table-name --adxt
Déprécié

L’option '--adx-table-name' a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « --adx-property-events-table ».

Nom de la table Azure Data Explorer utilisée pour stocker les mises à jour sur les propriétés des jumeaux et des relations.

valeur par défaut: AdtPropertyEvents
--adx-twin-events-table --adxtet

Nom de la table Azure Data Explorer utilisée pour enregistrer les événements de cycle de vie des jumeaux. La table ne sera pas créée si cette propriété n’est pas spécifiée.

--ehc --eventhub-consumer-group

Groupe de consommateurs EventHub à utiliser quand ADX lit à partir d’EventHub.

valeur par défaut: $Default
--ehg --eventhub-resource-group

Nom du groupe de ressources EventHub. S’il n’est pas fourni, utilisez le groupe de ressources Digital Twin.

--ehs --eventhub-subscription

Nom ou ID d’abonnement où existe EventHub. S’il n’est pas fourni, utilisez l’abonnement qui contient l’instance Digital Twin.

--mi-user-assigned --user

Utilisez une identité managée affectée par l’utilisateur pour l’authentification de connexion de l’historique des données. Accepte l’ID de ressource d’identité. S’il n’est pas fourni, utilisez plutôt l’identité système.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--yes -y

N’invitez pas à confirmer l’attribution de rôles requis.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.