Compartir a través de


Ejecutar importación de datos

La importación de datos se ejecuta directamente en el servidor de Microsoft Dataverse. Para ejecutar la importación de datos, configure trabajos asincrónicos para ejecutarse en segundo plano que realicen lo siguiente, en este orden:

  • Analizar datos de origen incluidos en el archivo de importación.
  • Transformar datos analizados mediante la asignación de datos.
  • Cargar datos transformados en Dataverse.

Todos los usuarios de Dataverse que dispongan de los permisos adecuados podrán ejecutar la importación de datos.

Analizar datos de origen

El análisis de los datos de origen incluye el análisis de todos los archivos de importación asociados con una importación determinada (importación de datos).

Los datos analizados se almacena en las tablas de análisis temporales creadas para cada archivo importado. El nombre de la tabla de análisis se almacena en la columna ImportFile.ParsedTableName. Los encabezados de la columna del archivo de origen se especifican en la columna ImportFile.HeaderRow. Si el archivo de origen no incluye una primera fila que contenga los encabezados de columna, esta columna especifica los encabezados de columna predeterminados generados por el sistema.

Guarde los datos analizados en la tabla de análisis con el mensaje ParseImport. Recupere datos de la tabla de análisis con el mensaje GetDistinctValuesImportFile y el mensaje RetrieveParsedDataImportFile.

En la siguiente tabla se enumeran los mensajes que puede usar para analizar los archivos de importación y para recuperar los datos analizados de las tablas de análisis.

Publicación
Clase de SDK
Acción o función de API web
Descripción
ParseImportRequest
ParseImportRequest Class
ParseImport Action
Envía un trabajo asincrónico que analiza todos los archivos de importación asociados con la importación especificada (importación de datos). Pase el Id. de importación asociado (importación de datos) en la propiedad de ImportId de esta solicitud. El identificador del trabajo asincrónico que se ejecuta en segundo plano y realiza el análisis de datos se devuelve en la propiedad AsyncOperationId de la respuesta.
GetDistinctValuesImportFile
GetDistinctValuesImportFileRequest Class
GetDistinctValuesImportFile Function
Devuelve los valores distintos para una columna en el archivo de origen que contiene valores de lista. Pase el identificador del archivo de importación asociado en la propiedad de ImportFileId de esta solicitud. Los valores distintos se devuelven en una matriz de cadenas, en la propiedad Values de la respuesta. Use este mensaje después de crear una tabla de análisis con el mensaje de ParseImport.
Importante: No use este mensaje después de utilizar el mensaje de ImportRecordsImport. No se puede obtener acceso a la tabla de análisis después de que el trabajo de importación enviado por el mensaje de ImportRecordsImport haya finalizado de ejecutarse.
RetrieveParsedDataImportFile
RetrieveParsedDataImportFileRequest Class
RetrieveParsedDataImportFile Function
Recupera los datos de la tabla de análisis. Pase el identificador del archivo de importación asociado en la propiedad de ImportFileId de esta solicitud. Los datos analizados se devuelven en una matriz bidimensional de cadenas en la propiedad Values de la respuesta. Los datos se devuelven con el mismo orden de columnas que el del archivo de origen. Use este mensaje después de crear una tabla de análisis con el mensaje de ParseImport.
Importante: No use este mensaje después de utilizar el mensaje de ImportRecordsImport. No se puede obtener acceso a la tabla de análisis después de que el trabajo de importación enviado por el mensaje de ImportRecordsImport haya finalizado de ejecutarse.

Datos de análisis de transformación

Durante la transformación, cambia datos analizados aplicando todas las asignaciones y transformaciones de datos disponibles asociadas con una importación determinada (importación de datos) a los datos.

Utilice el mensaje TransformImport con TransformImportRequest Class o TransformImport Action para enviar un trabajo asincrónico para transformar los datos analizados. Pase un identificador único de la importación asociada (importación de datos) en la columna de Import.ImportId de la solicitud. Un identificador único del trabajo asincrónico que se ejecuta en segundo plano y realiza la transformación se devuelve en la propiedad de AsyncOperationId de respuesta del mensaje.

Cargar datos transformados al servidor de destino

Tras completar correctamente la transformación, los datos están listos para cargarse en el servidor de Dataverse.

Utilice el mensaje ImportRecordsImport con ImportRecordsImportRequest Class o ImportRecordsImport Action para enviar un trabajo asincrónico para cargar los datos transformados en Dataverse. El identificador único de la importación asociada (importación de datos) debe especificarse en el parámetro ImportId de la solicitud. Un identificador único del trabajo asincrónico que se ejecuta en segundo plano y carga los datos en Dataverse se devuelve en la propiedad AsyncOperationId de la respuesta. Todos los archivos de importación asociados con la importación especificada (importación de datos) se importan.

Cada trabajo de importación tiene un número de secuencia único que almacena en la columna de ImportSequenceNumber de registros que crea. La columna de Organization.CurrentImportSequenceNumber contiene un número de secuencia único del pasado trabajo de importación que se ejecutó en el sistema. Puede usar estos números de secuencia únicos para efectuar un seguimiento de los registros que pertenecen a un trabajo de importación.

Errores de registro

Se puede producir un error de importación de un registro durante el análisis, la transformación o la carga de datos. Los motivos del error y otra información detallada sobre los registros que no se importaron se capturan en la tabla del registro de importación (ImportLog).

Para averiguar cuántos registros no se importaron correctamente, recupere la columna de ImportFile.FailureCount del registro. Para comprobar cuántos registros tenían errores parciales durante la importación, recupere la columna de ImportData.HasError. Si la columna de HasError es true, se ha producido un error parcial, si es false, el registro se ha importado correctamente.

Importación de datos de auditoría

Las tablas de Dataverse disponen de cuatro columnas predeterminadas que se usan para el seguimiento de la fecha y hora en que se ha creado y modificado un registro por última vez, así como la persona que lo ha creado y modificado.

La columna de createdon especifica la fecha y la hora en que se creó el registro. Para importar datos en la columna de createdon, asigne la columna de origen que incluye estos datos a la columna de overriddencreatedon. Durante la importación, la columna de createdon del registro se actualiza con el valor que se asignó la columna de overriddencreatedon y la columna de overriddencreatedon se establece en la fecha y hora en que se importaron los datos. Si no se asigna ningún valor de origen a la columna de overriddencreatedon, la columna de createdon se establece en la fecha y hora de importación de los datos y la columna de overriddencreatedon no se establece en ningún valor.

Nota

Para reemplazar el valor de la columna de createdon durante la importación, necesita disponer del privilegio de prvOverrideCreatedOnCreatedBy. Tenga en cuenta que el nombre del privilegio implica que también puede reemplazar la columna de createdby durante la importación. Sin embargo, actualmente esta función no es compatible.

No puede importar datos en las columnas de modifiedon, createdby y modifiedby. Si tiene que almacenar datos relacionados con la persona que creó y modificó los datos y cuándo se han modificado los datos, puede crear columnas personalizadas en Dataverse y asignar las columnas de origen a las nuevas columnas personalizadas.

Vea también

Importar datos
Preparar archivos de origen para importar
Crear asignaciones de datos para importar
Agregar asignaciones de transformación para la importación
Configurar la importación de datos
Tablas de importación de datos
Ejemplo: exportar e importar una asignación de datos
Ejemplo: importar datos mediante la asignación de datos complejos
Entrada de blog: Cómo importar los datos adjuntos mediante programación

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).