Partilhar via

az dt job import

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 um comando az dt job import. Saiba mais sobre extensões.

Gerencie e configure trabalhos para importar dados de modelos, gêmeos e relacionamentos para uma instância de gêmeo digital.

Comandos

Nome Descrição Tipo Estado
az dt job import cancel

Cancele um trabalho de importação de dados executado em uma instância de gêmeos digitais.

 Extension disponibilidade geral
az dt job import create

Crie e execute um trabalho de importação de dados em uma instância de gêmeo digital.

 Extension disponibilidade geral
az dt job import delete

Exclua um trabalho de importação de dados executado em uma instância de gêmeos digitais.

 Extension disponibilidade geral
az dt job import list

Liste todos os trabalhos de importação de dados executados em uma instância de gêmeos digitais.

 Extension disponibilidade geral
az dt job import show

Mostrar detalhes de um trabalho de importação de dados executado em uma instância de gêmeos digitais.

 Extension disponibilidade geral

az dt job import cancel

Cancele um trabalho de importação de dados executado em uma instância de gêmeos digitais.

az dt job import cancel --dt-name --dtn
                        --job-id
                        [--resource-group]
                        [--yes]

Exemplos

Cancelar um trabalho de importação de dados por ID do trabalho.

az dt job import cancel -n {instance_or_hostname} -j {job_id}

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--job-id -j

Id do trabalho. Um id gerado pelo sistema é atribuído quando esse parâmetro é omitido durante a criação do trabalho.

Parâmetros Opcionais

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

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

Propriedade Valor
Valor padrão: False
Parâmetros globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--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 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
Valor padrão: False

az dt job import create

Crie e execute um trabalho de importação de dados em uma instância de gêmeo digital.

O comando requer um arquivo de dados de importação de entrada (no formato .ndjson) para estar presente no contêiner de blob de entrada. Além disso, a instância DT que está sendo usada deve ter a função 'Colaborador de Dados de Blob de Armazenamento' definida na conta de armazenamento de entrada. Quando o trabalho for concluído, um arquivo de saída contendo logs e erros do trabalho será criado.

az dt job import create --data-file --df
                        --dt-name --dtn
                        --ibc --input-blob-container
                        --input-storage-account --isa
                        [--job-id]
                        [--obc --output-blob-container]
                        [--of --output-file]
                        [--osa --output-storage-account]
                        [--resource-group]

Exemplos

Cria um trabalho para importar o arquivo de dados armazenado em um Contêiner de Armazenamento do Azure. O arquivo de saída do trabalho de importação é criado no contêiner de blob do arquivo de entrada.

az dt job import create -n {instance_or_hostname} --data-file {data_file_name} --input-blob-container {input_blob_container_name} --input-storage-account {input_storage_account_name} --output-file {output_file_name}

Cria um trabalho para importar o arquivo de dados armazenado em um contêiner de armazenamento azure. O arquivo de saída do trabalho de importação é criado na conta de armazenamento definida pelo usuário e no contêiner de blob.

az dt job import create -n {instance_or_hostname} --data-file {data_file_name} --input-blob-container {input_blob_container_name} --input-storage-account {input_storage_account_name} --output-file {output_file_name} --output-blob-container {output_blob_container_name} --output-storage-account {output_storage_account_name}

Parâmetros Obrigatórios

--data-file --df

Nome da entrada do arquivo de dados para o trabalho de importação em massa. O ficheiro deve estar no formato 'ndjson'. Exemplo de arquivo de dados de entrada: https://github.com/Azure/azure-iot-cli-extension/tree/dev/docs/samples/adt-bulk-import-data-sample.ndjson.

Propriedade Valor
Grupo de parâmetros: Bulk Import Job Arguments
--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--ibc --input-blob-container

Nome do contêiner de blob de Armazenamento do Azure que contém o arquivo de dados de importação em massa.

Propriedade Valor
Grupo de parâmetros: Bulk Import Job Arguments
--input-storage-account --isa

Nome da conta de Armazenamento do Azure que contém o contêiner de blob que armazena o arquivo de dados de importação em massa.

Propriedade Valor
Grupo de parâmetros: Bulk Import Job Arguments

Parâmetros Opcionais

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

--job-id -j

Id do trabalho. Um id gerado pelo sistema é atribuído quando esse parâmetro é omitido durante a criação do trabalho.

--obc --output-blob-container

Nome do contêiner de blob de Armazenamento do Azure onde o arquivo de saída do trabalho de importação em massa será criado. Se não for fornecido, usará o contêiner de blob de entrada.

Propriedade Valor
Grupo de parâmetros: Bulk Import Job Arguments
--of --output-file

Nome do arquivo de saída do trabalho de importação em massa. Este arquivo conterá logs, bem como informações de erro. O arquivo é criado automaticamente quando o trabalho é concluído. O arquivo será substituído se já existir. Se não for fornecido, o arquivo de saída será criado com o nome: {job_id}_output.txt.

Propriedade Valor
Grupo de parâmetros: Bulk Import Job Arguments
--osa --output-storage-account

Nome da conta de Armazenamento do Azure que contém o contêiner de blob onde o arquivo de saída do trabalho de importação em massa será criado. Se não for fornecido, usará a conta de armazenamento de entrada.

Propriedade Valor
Grupo de parâmetros: Bulk Import Job Arguments
--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}.

Parâmetros globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--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 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
Valor padrão: False

az dt job import delete

Exclua um trabalho de importação de dados executado em uma instância de gêmeos digitais.

az dt job import delete --dt-name --dtn
                        --job-id
                        [--resource-group]
                        [--yes]

Exemplos

Exclua um trabalho de importação de dados por ID do trabalho.

az dt job import delete -n {instance_or_hostname} -j {job_id}

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--job-id -j

Id do trabalho. Um id gerado pelo sistema é atribuído quando esse parâmetro é omitido durante a criação do trabalho.

Parâmetros Opcionais

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

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

Propriedade Valor
Valor padrão: False
Parâmetros globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--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 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
Valor padrão: False

az dt job import list

Liste todos os trabalhos de importação de dados executados em uma instância de gêmeos digitais.

az dt job import list --dt-name --dtn
                      [--resource-group]

Exemplos

Liste todos os trabalhos de importação de dados em uma instância de gêmeos digitais de destino.

az dt job import list -n {instance_or_hostname}

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

Parâmetros Opcionais

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

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

Parâmetros globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--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 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
Valor padrão: False

az dt job import show

Mostrar detalhes de um trabalho de importação de dados executado em uma instância de gêmeos digitais.

az dt job import show --dt-name --dtn
                      --job-id
                      [--resource-group]

Exemplos

Mostrar detalhes de um trabalho de importação de dados por ID do trabalho.

az dt job import show -n {instance_or_hostname} -j {job_id}

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--job-id -j

Id do trabalho. Um id gerado pelo sistema é atribuído quando esse parâmetro é omitido durante a criação do trabalho.

Parâmetros Opcionais

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

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

Parâmetros globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--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 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
Valor padrão: False