Share via

az dt data-history connection create

  • Referencia

Nota:

Esta referencia forma parte de la extensión azure-iot para la CLI de Azure (versión 2.37.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az dt data-history connection create . Obtenga más información sobre las extensiones.

Crea una conexión de historial de datos entre una instancia de Digital Twins y los recursos admitidos.

Comandos

Nombre Description Tipo Estado
az dt data-history connection create adx

Crea una conexión de historial de datos entre una instancia de Digital Twins y una base de datos de Azure Data Explorer. Requiere recursos de Azure Data Explorer y Event Hubs creados previamente.

 Extensión GA

az dt data-history connection create adx

Crea una conexión de historial de datos entre una instancia de Digital Twins y una base de datos de Azure Data Explorer. Requiere recursos de Azure Data Explorer y Event Hubs creados previamente.

Solicitará al usuario que agregue los siguientes roles y permisos en la instancia de Digital Twins o la identidad asignada por el usuario necesarias para crear correctamente la conexión:

  • Rol "Colaborador" para el ámbito de la base de datos de Azure Data Explorer
  • Permiso "Database Administración" para el ámbito de la base de datos de Azure Data Explorer
  • Rol "Propietario de datos de Azure Event Hubs" para el ámbito del centro de eventos.
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]

Ejemplos

Agrega una conexión del historial de datos a una instancia de Digital Twins de destino con el grupo de consumidores del centro de eventos de $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}

Agrega una conexión de historial de datos a una instancia de Digital Twins de destino mediante una identidad asignada por el usuario asociada al gemelo digital con el grupo de consumidores del centro de eventos de $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} --mi-user-assigned {resource_id}

Agrega una conexión de historial de datos a una instancia de Digital Twins de destino con un nombre de tabla personalizado de Azure Data Explorer y un grupo de consumidores del centro de eventos.

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}

Agrega una conexión de historial de datos a una instancia de Digital Twins de destino que se integra con un centro de eventos y instancias de Azure Data Explorer en diferentes grupos de recursos y suscripciones de la instancia de destino.

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}

Agrega una conexión de historial de datos a una instancia de Digital Twins de destino con el grupo de consumidores del centro de eventos de $Default y omite las solicitudes de asignación de roles.

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}

Agrega una conexión de historial de datos a una instancia de Digital Twins de destino con el grupo de consumidores del centro de eventos de $Default y habilita las eliminaciones de elementos y propiedades de registro. Se agregará una columna adicional a la tabla utilizada para almacenar actualizaciones en las propiedades de gemelos y relaciones (de forma predeterminada a 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

Agrega una conexión de historial de datos a una instancia de Digital Twins de destino con el grupo de consumidores del centro de eventos de $Default y crea dos tablas adicionales en la base de datos de Azure Data Explorer. Una tabla será para grabar eventos de ciclo de vida de gemelos y el otro para los eventos del ciclo de vida de las relaciones.

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}

Agrega una conexión de historial de datos a una instancia de Digital Twins de destino con el grupo de consumidores del centro de eventos de $Default, usa un nombre de tabla de eventos de propiedad de gemelo personalizado y crea dos tablas adicionales en la base de datos de 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}

Parámetros requeridos

--adx-cluster-name --adxc

Nombre del clúster de Azure Data Explorer con el que se va a integrar.

--adx-database-name --adxd

Nombre de la base de datos de Azure Data Explorer con la que se va a integrar.

--cn --conn-name

Nombre de la conexión del historial de datos.

--dt-name --dtn -n

Nombre de instancia de Digital Twins.

--eh --eventhub

Nombre de EventHub con el que se va a integrar.

--ehn --eventhub-namespace

Identificador del espacio de nombres de EventHub.

Parámetros opcionales

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

Nombre de la tabla de Azure Data Explorer que se usa para almacenar actualizaciones en propiedades de gemelos y relaciones.

valor predeterminado: AdtPropertyEvents
--adx-record-removals --adxrr

Especifica si se van a registrar o no las eliminaciones de propiedades y elementos gemelos o de elementos, incluidas las eliminaciones de valores indexados o con clave (como entradas de mapa, elementos de matriz, etc.). Al establecer esta propiedad en "true", se generará una columna adicional en la tabla de eventos de propiedad en ADX.

valores aceptados: false, true
valor predeterminado: False
--adx-relationship-events-table --adxret

Nombre de la tabla de Azure Data Explorer que se usa para registrar eventos del ciclo de vida de las relaciones. La tabla no se creará si esta propiedad no se especifica.

--adx-resource-group --adxg

Nombre del grupo de recursos de Azure Data Explorer. Si no se proporciona, usará el grupo de recursos de Digital Twin.

--adx-subscription --adxs

Nombre o identificador de la suscripción donde existe Azure Data Explorer. Si no se proporciona, usará la suscripción que contiene la instancia de Digital Twin.

--adx-table-name --adxt
Obsoleto

La opción "--adx-table-name" está en desuso y se quitará en una versión futura. Use "--adx-property-events-table" en su lugar.

Nombre de la tabla de Azure Data Explorer que se usa para almacenar actualizaciones en propiedades de gemelos y relaciones.

valor predeterminado: AdtPropertyEvents
--adx-twin-events-table --adxtet

Nombre de la tabla de Azure Data Explorer que se usa para grabar eventos de ciclo de vida de gemelos. La tabla no se creará si esta propiedad no se especifica.

--ehc --eventhub-consumer-group

El grupo de consumidores de EventHub que se usará cuando ADX lee de EventHub.

valor predeterminado: $Default
--ehg --eventhub-resource-group

Nombre del grupo de recursos de EventHub. Si no se proporciona, usará el grupo de recursos de Digital Twin.

--ehs --eventhub-subscription

Nombre o identificador de la suscripción donde existe EventHub. Si no se proporciona, usará la suscripción que contiene la instancia de Digital Twin.

--mi-user-assigned --user

Use una identidad administrada asignada por el usuario para la autenticación de conexión del historial de datos. Acepta el identificador del recurso de identidad. Si no se proporciona, usará la identidad del sistema en su lugar.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--yes -y

No solicite confirmación al asignar roles necesarios.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.