az dt job import

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). La extensión se instalará automáticamente la primera vez que ejecute un comando az dt job import. Learn more about extensions.

Administre y configure trabajos para importar datos de modelo, gemelos y relaciones a una instancia de gemelo digital.

Comandos

Nombre	Description	Tipo	Estado
az dt job import cancel	Cancele un trabajo de importación de datos ejecutado en una instancia de gemelos digitales.	Extension	GA
az dt job import create	Cree y ejecute un trabajo de importación de datos en una instancia de gemelo digital.	Extension	GA
az dt job import delete	Elimine un trabajo de importación de datos ejecutado en una instancia de gemelos digitales.	Extension	GA
az dt job import list	Enumere todos los trabajos de importación de datos ejecutados en una instancia de gemelos digitales.	Extension	GA
az dt job import show	Mostrar detalles de un trabajo de importación de datos ejecutado en una instancia de gemelos digitales.	Extension	GA

az dt job import cancel

Cancele un trabajo de importación de datos ejecutado en una instancia de gemelos digitales.

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

Ejemplos

Cancelar un trabajo de importación de datos por identificador de trabajo.

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

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia o nombre de host de Digital Twins. Si se proporciona un nombre de instancia, primero se consulta la suscripción de usuario para que la instancia de destino recupere el nombre de host. Si se proporciona un nombre de host, se omite la consulta de suscripción y el valor proporcionado se usa para la interacción posterior.

--job-id -j

Id. de trabajo. Se asigna un identificador generado por el sistema cuando se omite este parámetro durante la creación del trabajo.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group={name}.

--yes -y

No solicita confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az dt job import create

Cree y ejecute un trabajo de importación de datos en una instancia de gemelo digital.

El comando requiere que un archivo de datos de importación de entrada (en formato .ndjson) esté presente en el contenedor de blobs de entrada. Además, la instancia de DT que se usa debe tener el rol "Colaborador de datos de Storage Blob" establecido en la cuenta de almacenamiento de entrada. Una vez completado el trabajo, se creará un archivo de salida que contenga los registros y errores del trabajo.

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]

Ejemplos

Crea un trabajo para importar el archivo de datos almacenado en un contenedor de Azure Storage. El archivo de salida del trabajo de importación se crea en el contenedor de blobs del archivo 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}

Crea un trabajo para importar el archivo de datos almacenado en un contenedor de azure Storage. El archivo de salida del trabajo de importación se crea en la cuenta de almacenamiento definida por el usuario y en el contenedor de blobs.

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 requeridos

--data-file --df

Nombre de la entrada del archivo de datos en el trabajo de importación masiva. El archivo debe estar en formato "ndjson". Archivo de datos de entrada de ejemplo: https://github.com/Azure/azure-iot-cli-extension/tree/dev/docs/samples/adt-bulk-import-data-sample.ndjson.

Propiedad	Valor
Parameter group:	Bulk Import Job Arguments

--dt-name --dtn -n

Nombre de instancia o nombre de host de Digital Twins. Si se proporciona un nombre de instancia, primero se consulta la suscripción de usuario para que la instancia de destino recupere el nombre de host. Si se proporciona un nombre de host, se omite la consulta de suscripción y el valor proporcionado se usa para la interacción posterior.

--ibc --input-blob-container

Nombre del contenedor de blobs de Azure Storage que contiene el archivo de datos de importación masiva.

Propiedad	Valor
Parameter group:	Bulk Import Job Arguments

--input-storage-account --isa

Nombre de la cuenta de Azure Storage que contiene el contenedor de blobs que almacena el archivo de datos de importación masiva.

Propiedad	Valor
Parameter group:	Bulk Import Job Arguments

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--job-id -j

Id. de trabajo. Se asigna un identificador generado por el sistema cuando se omite este parámetro durante la creación del trabajo.

--obc --output-blob-container

Nombre del contenedor de blobs de Azure Storage donde se creará el archivo de salida del trabajo de importación masiva. Si no se proporciona, usará el contenedor de blobs de entrada.

Propiedad	Valor
Parameter group:	Bulk Import Job Arguments

--of --output-file

Nombre del archivo de salida del trabajo de importación masiva. Este archivo contendrá registros, así como información de error. El archivo se crea automáticamente una vez finalizado el trabajo. El archivo se sobrescribe si ya existe. Si no se proporciona el archivo de salida se crea con el nombre: {job_id}_output.txt.

Propiedad	Valor
Parameter group:	Bulk Import Job Arguments

--osa --output-storage-account

Nombre de la cuenta de Azure Storage que contiene el contenedor de blobs donde se creará el archivo de salida del trabajo de importación masiva. Si no se proporciona, usará la cuenta de almacenamiento de entrada.

Propiedad	Valor
Parameter group:	Bulk Import Job Arguments

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group={name}.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az dt job import delete

Elimine un trabajo de importación de datos ejecutado en una instancia de gemelos digitales.

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

Ejemplos

Elimine un trabajo de importación de datos por identificador de trabajo.

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

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia o nombre de host de Digital Twins. Si se proporciona un nombre de instancia, primero se consulta la suscripción de usuario para que la instancia de destino recupere el nombre de host. Si se proporciona un nombre de host, se omite la consulta de suscripción y el valor proporcionado se usa para la interacción posterior.

--job-id -j

Id. de trabajo. Se asigna un identificador generado por el sistema cuando se omite este parámetro durante la creación del trabajo.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group={name}.

--yes -y

No solicita confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az dt job import list

Enumere todos los trabajos de importación de datos ejecutados en una instancia de gemelos digitales.

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

Ejemplos

Enumere todos los trabajos de importación de datos en una instancia de gemelos digitales de destino.

az dt job import list -n {instance_or_hostname}

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia o nombre de host de Digital Twins. Si se proporciona un nombre de instancia, primero se consulta la suscripción de usuario para que la instancia de destino recupere el nombre de host. Si se proporciona un nombre de host, se omite la consulta de suscripción y el valor proporcionado se usa para la interacción posterior.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group={name}.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az dt job import show

Mostrar detalles de un trabajo de importación de datos ejecutado en una instancia de gemelos digitales.

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

Ejemplos

Mostrar detalles de un trabajo de importación de datos por identificador de trabajo.

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

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia o nombre de host de Digital Twins. Si se proporciona un nombre de instancia, primero se consulta la suscripción de usuario para que la instancia de destino recupere el nombre de host. Si se proporciona un nombre de host, se omite la consulta de suscripción y el valor proporcionado se usa para la interacción posterior.

--job-id -j

Id. de trabajo. Se asigna un identificador generado por el sistema cuando se omite este parámetro durante la creación del trabajo.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group={name}.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False