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 instalará automaticamente a 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 dos 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 dos 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.	Extension	GA

az dt data-history connection create adx

Cria uma conexão de histórico de dados entre uma instância dos 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 dos Gêmeos Digitais ou na Identidade Atribuída ao Usuário necessária 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 Gêmeos Digitais 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 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 $Default e ignore 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 dos Gêmeos Digitais de destino com o grupo de consumidores do Hub de Eventos $Default e permite remoções de propriedade de registro e item. Uma coluna adicional será adicionada à tabela usada para armazenar atualizações em propriedades de gêmeos e relações (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 de gêmeos e a outra para eventos de ciclo de vida de relação.

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êmeo 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 ao 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 de histórico de dados.

--dt-name --dtn -n

Nome da instância dos Gêmeos Digitais.

--eh --eventhub

Nome do EventHub ao qual integrar.

Propriedade	Valor
Grupo de parâmetros:	Event Hub Arguments

--ehn --eventhub-namespace

Identificador do Namespace do 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 se tornar obrigatórios para que o comando seja executado com sucesso.

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

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

Propriedade	Valor
Grupo de parâmetros:	Azure Data Explorer Arguments
Valor padrão:	AdtPropertyEvents

--adx-record-removals --adxrr

Especifica se a propriedade de gêmeo/relação e as remoções de item devem ou não ser registradas, incluindo remoções de valores indexados ou chave (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
Valor padrão:	False
Valores aceitos:	false, true

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

O nome da tabela do Azure Data Explorer usada para registrar eventos do ciclo de vida da relação. A tabela não será criada se essa 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, usará o grupo de recursos do Gêmeo Digital.

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

--adx-subscription --adxs

Nome ou id da assinatura em que o Azure Data Explorer existe. Se não for fornecido, 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. Em vez disso, use '--adx-property-events-table'.

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

Propriedade	Valor
Grupo de parâmetros:	Azure Data Explorer Arguments
Valor padrão:	AdtPropertyEvents

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

O nome da tabela do Azure Data Explorer usada para gravar eventos do ciclo de vida gêmeo. A tabela não será criada se essa 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
Valor padrão:	$Default

--ehg --eventhub-resource-group

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

Propriedade	Valor
Grupo de parâmetros:	Event Hub Arguments

--ehs --eventhub-subscription

Nome ou id da assinatura em que o EventHub existe. Se não for fornecido, 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 de 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 prolongada.

Propriedade	Valor
Valor padrão:	False

--resource-group -g

Grupo de recursos da instância dos 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.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Valor padrão:	False

Comentários

Esta página foi útil?