Compartilhar via

az dt data-history connection create

  • Referência

Observação

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

Cria uma conexão de histórico de dados entre uma instância de Gêmeos Digitais e recursos com suporte.

Comandos

Nome Description Tipo Status
az dt data-history connection create adx

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

 Extensão GA

az dt data-history connection create adx

Cria uma conexão de histórico de dados entre uma instância de Gêmeos Digitais 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 de Gêmeos Digitais ou na Identidade Atribuída ao 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
                                         --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]

Exemplos

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 do $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 ao Usuário associada ao Gêmeo Digital com o grupo de consumidores do Hub de Eventos do $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 que se integra 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 do $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 do $Default e habilita a remoção de propriedades e itens de registro. 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 do $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 personalizado 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 Exigidos

--adx-cluster-name --adxc

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

--adx-database-name --adxd

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

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

--ehn --eventhub-namespace

Identificador de namespace do EventHub.

Parâmetros Opcionais

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

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

valor padrão: AdtPropertyEvents
--adx-record-removals --adxrr

Especifica se a propriedade twin/relationship deve ou não ser registrada e remoções de itens, 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.

valores aceitos: false, true
valor padrão: False
--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 essa propriedade não for especificada.

--adx-resource-group --adxg

Nome do grupo de recursos do Azure Data Explorer. Se não for fornecido, usará o grupo de recursos do Gêmeo Digital.

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

--adx-table-name --adxt
Preterido

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

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

valor padrão: 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 essa propriedade não for especificada.

--ehc --eventhub-consumer-group

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

valor padrão: $Default
--ehg --eventhub-resource-group

Nome do grupo de recursos EventHub. Se não for fornecido, usará o grupo de recursos do Gêmeo Digital.

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

--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 aguarde a conclusão da operação de execução longa.

valor padrão: 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 funções necessárias.

valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.