az dt data-history connection create

Note

Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.67.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar uma conexão az dt data-history create comando. Saiba mais sobre extensões.

Cria uma conexão de histórico de dados entre uma instância do Digital Twins e os recursos suportados.

Comandos

Name	Description	Tipo	Status
az dt data-history connection create adx	Cria uma conexão de histórico de dados entre uma instância do Digital Twins e um banco de dados do Azure Data Explorer. Requer recursos pré-criados do Azure Data Explorer e do Hub de Eventos.	Extension	disponibilidade geral

az dt data-history connection create adx

Cria uma conexão de histórico de dados entre uma instância do Digital Twins e um banco de dados do Azure Data Explorer. Requer recursos pré-criados do Azure Data Explorer e do Hub de Eventos.

Solicitará que o usuário adicione as seguintes funções e permissões na instância Digital Twins ou na Identidade Atribuída pelo Usuário necessárias para criar a conexão com êxito:

Função 'Colaborador' para o escopo do Banco de Dados do Azure Data Explorer
Permissão 'Administrador de Banco de Dados' para o escopo do Banco de Dados do Azure Data Explorer
Função 'Proprietário de Dados dos Hubs de Eventos do Azure' para o escopo do Hub 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]

Exemplos

Adiciona uma conexão de histórico de dados a uma instância de Digital Twins de destino com o grupo de consumidores do Hub de Eventos $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}

Adiciona uma conexão de histórico de dados a uma instância de Gêmeos Digitais de destino usando uma Identidade Atribuída pelo Usuário associada ao gêmeo Digital com o grupo de consumidores do Hub de Eventos $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}

Adiciona uma conexão de histórico de dados a uma instância de Gêmeos Digitais de destino com um nome de tabela personalizado do Azure Data Explorer e um grupo de consumidores do Hub 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}

Adiciona uma conexão de histórico de dados a uma instância de Gêmeos Digitais de destino integrando-se a um Hub de Eventos e instâncias do Azure Data Explorer em diferentes grupos de recursos e assinaturas da instância 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}

Adiciona uma conexão de histórico de dados a uma instância de Gêmeos Digitais de destino com o grupo de consumidores do Hub de Eventos $Default e ignora os prompts de atribuição de função.

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}

Adiciona uma conexão de histórico de dados a uma instância de Gémeos Digitais de destino com o grupo de consumidores do Hub de Eventos $Default e permite a remoção de propriedades e itens de registo. Uma coluna adicional será adicionada à tabela usada para armazenar atualizações de propriedades de gêmeos e relacionamentos (padrão para 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

Adiciona uma conexão de histórico de dados a uma instância de Gêmeos Digitais de destino com o grupo de consumidores do Hub de Eventos $Default e cria duas tabelas extras no banco de dados do Azure Data Explorer. Uma tabela será para registrar eventos de ciclo de vida gêmeos e a outra para eventos de ciclo de vida de relacionamento.

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}

Adiciona uma conexão de histórico de dados a uma instância de Gêmeos Digitais de destino com o grupo de consumidores do Hub de Eventos $Default, usa um nome de tabela de eventos de propriedade gêmea personalizada e cria duas tabelas extras no banco de dados do 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 Obrigatórios

--adx-cluster-name --adxc

Nome do cluster do Azure Data Explorer com o qual integrar.

Propriedade	Valor
Grupo de parâmetros:	Azure Data Explorer Arguments

--adx-database-name --adxd

Nome do banco de dados do Azure Data Explorer ao qual se integrar.

Propriedade	Valor
Grupo de parâmetros:	Azure Data Explorer Arguments

--cn --conn-name

Nome da conexão do histórico de dados.

--dt-name --dtn -n

Nome da instância do Digital Twins.

--eh --eventhub

Nome do EventHub com o qual integrar.

Propriedade	Valor
Grupo de parâmetros:	Event Hub Arguments

--ehn --eventhub-namespace

Identificador de namespace EventHub.

Propriedade	Valor
Grupo de parâmetros:	Event Hub Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

O nome da tabela do Azure Data Explorer usada para armazenar atualizações para propriedades de gêmeos e relacionamentos.

Propriedade	Valor
Grupo de parâmetros:	Azure Data Explorer Arguments
Default value:	AdtPropertyEvents

--adx-record-removals --adxrr

Especifica se as remoções de itens e propriedades gêmeas/de relacionamento devem ou não ser registradas, incluindo remoções de valores indexados ou chaveados (como entradas de mapa, elementos de matriz, etc.). Definir essa propriedade como 'true' gerará uma coluna adicional na tabela de eventos de propriedade no ADX.

Propriedade	Valor
Grupo de parâmetros:	Azure Data Explorer Arguments
Default value:	False
Valores aceites:	false, true

--adx-relationship-events-table --adxret

O nome da tabela do Azure Data Explorer usada para registrar eventos do ciclo de vida do relacionamento. A tabela não será criada se esta propriedade não for especificada.

Propriedade	Valor
Grupo de parâmetros:	Azure Data Explorer Arguments

--adx-resource-group --adxg

Nome do grupo de recursos do Azure Data Explorer. Se não for fornecido, utilizará o grupo de recursos do Digital Twin.

Propriedade	Valor
Grupo de parâmetros:	Azure Data Explorer Arguments

--adx-subscription --adxs

Nome ou id da assinatura onde o Azure Data Explorer existe. Se não for fornecida, usará a assinatura que contém a Instância do Gêmeo Digital.

Propriedade	Valor
Grupo de parâmetros:	Azure Data Explorer Arguments

--adx-table-name --adxt

Preterido

A opção '--adx-table-name' foi preterida e será removida em uma versão futura. Use '--adx-property-events-table' em vez disso.

O nome da tabela do Azure Data Explorer usada para armazenar atualizações para propriedades de gêmeos e relacionamentos.

Propriedade	Valor
Grupo de parâmetros:	Azure Data Explorer Arguments
Default value:	AdtPropertyEvents

--adx-twin-events-table --adxtet

O nome da tabela do Azure Data Explorer usada para registrar eventos de ciclo de vida gêmeos. A tabela não será criada se esta propriedade não for especificada.

Propriedade	Valor
Grupo de parâmetros:	Azure Data Explorer Arguments

--ehc --eventhub-consumer-group

O grupo de consumidores do EventHub a ser usado quando o ADX ler do EventHub.

Propriedade	Valor
Grupo de parâmetros:	Event Hub Arguments
Default value:	$Default

--ehg --eventhub-resource-group

Nome do grupo de recursos do EventHub. Se não for fornecido, utilizará o grupo de recursos do Digital Twin.

Propriedade	Valor
Grupo de parâmetros:	Event Hub Arguments

--ehs --eventhub-subscription

Nome ou id da assinatura onde o EventHub existe. Se não for fornecida, usará a assinatura que contém a Instância do Gêmeo Digital.

Propriedade	Valor
Grupo de parâmetros:	Event Hub Arguments

--mi-user-assigned --user

Use uma identidade gerenciada atribuída pelo usuário para autenticação de conexão do histórico de dados. Aceita a ID do recurso de identidade. Se não for fornecido, usará a identidade do sistema.

--no-wait

Não espere que a operação de longa duração termine.

Propriedade	Valor
Default value:	False

--resource-group -g

Grupo de recursos de instância de gêmeos digitais. Você pode configurar o grupo padrão usando az configure --defaults group={name}.

--yes -y

Não solicite confirmação ao atribuir as funções necessárias.

Propriedade	Valor
Default value:	False

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

Feedback

Esta página foi útil?