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). La extensión instalará automáticamente la primera vez que ejecute un comando az dt data-history connection create. Learn more about extensions.

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.	Extension	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 "Administrador de base de datos" 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 --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]

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.

Propiedad	Valor
Parameter group:	Azure Data Explorer Arguments

--adx-database-name --adxd

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

Propiedad	Valor
Parameter group:	Azure Data Explorer Arguments

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

Propiedad	Valor
Parameter group:	Event Hub Arguments

--ehn --eventhub-namespace

Identificador del espacio de nombres de EventHub.

Propiedad	Valor
Parameter group:	Event Hub Arguments

Parámetros opcionales

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

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

Propiedad	Valor
Parameter group:	Azure Data Explorer Arguments
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.

Propiedad	Valor
Parameter group:	Azure Data Explorer Arguments
Valor predeterminado:	False
Valores aceptados:	false, true

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

Propiedad	Valor
Parameter group:	Azure Data Explorer Arguments

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

Propiedad	Valor
Parameter group:	Azure Data Explorer Arguments

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

Propiedad	Valor
Parameter group:	Azure Data Explorer Arguments

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

Propiedad	Valor
Parameter group:	Azure Data Explorer Arguments
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.

Propiedad	Valor
Parameter group:	Azure Data Explorer Arguments

--ehc --eventhub-consumer-group

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

Propiedad	Valor
Parameter group:	Event Hub Arguments
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.

Propiedad	Valor
Parameter group:	Event Hub Arguments

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

Propiedad	Valor
Parameter group:	Event Hub Arguments

--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 a que finalice la operación de ejecución prolongada.

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

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False