Partilhar via

az dt data-history connection create

  • Referência

Nota

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 do Digital Twins e os recursos suportados.

Comandos

Name Description Tipo Estado
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.

 Extensão GA

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

--adx-database-name --adxd

Nome do banco de dados do Azure Data Explorer ao qual se 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 EventHub.

Parâmetros Opcionais

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

valor predefinido: 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.

valores aceites: false, true
valor predefinido: 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 esta propriedade não for especificada.

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

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

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

valor predefinido: 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.

--ehc --eventhub-consumer-group

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

valor predefinido: $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.

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

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

valor predefinido: 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.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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