Partager via

az dt data-history connection create

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). L’extension installe automatiquement la première fois que vous exécutez une az dt data-history connection create command. Learn more about 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 État
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 --adxc
                                         --adx-database-name --adxd
                                         --cn --conn-name
                                         --dt-name --dtn
                                         --eh --eventhub
                                         --ehn --eventhub-namespace
                                         [--adx-property-events-table --adxpet]
                                         [--adx-record-removals --adxrr {false, true}]
                                         [--adx-relationship-events-table --adxret]
                                         [--adx-resource-group --adxg]
                                         [--adx-subscription --adxs]
                                         [--adx-table-name --adxt]
                                         [--adx-twin-events-table --adxtet]
                                         [--ehc --eventhub-consumer-group]
                                         [--ehg --eventhub-resource-group]
                                         [--ehs --eventhub-subscription]
                                         [--mi-user-assigned --user]
                                         [--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.

Propriété Valeur
Parameter group: Azure Data Explorer Arguments
--adx-database-name --adxd

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

Propriété Valeur
Parameter group: Azure Data Explorer Arguments
--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.

Propriété Valeur
Parameter group: Event Hub Arguments
--ehn --eventhub-namespace

Identificateur d’espace de noms EventHub.

Propriété Valeur
Parameter group: Event Hub Arguments

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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.

Propriété Valeur
Parameter group: Azure Data Explorer Arguments
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.

Propriété Valeur
Parameter group: Azure Data Explorer Arguments
Valeur par défaut: False
Valeurs acceptées: false, true
--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.

Propriété Valeur
Parameter group: Azure Data Explorer Arguments
--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.

Propriété Valeur
Parameter group: Azure Data Explorer Arguments
--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.

Propriété Valeur
Parameter group: Azure Data Explorer Arguments
--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.

Propriété Valeur
Parameter group: Azure Data Explorer Arguments
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.

Propriété Valeur
Parameter group: Azure Data Explorer Arguments
--ehc --eventhub-consumer-group

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

Propriété Valeur
Parameter group: Event Hub Arguments
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.

Propriété Valeur
Parameter group: Event Hub Arguments
--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.

Propriété Valeur
Parameter group: Event Hub Arguments
--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.

Propriété Valeur
Valeur par défaut: False
--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group={name}.

--yes -y

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

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False