Gestionar datos de entrada

Puedes configurar las tablas de entrada directamente desde Transformaciones de datos para asegurarte de que tus datos de entrada cumplen los requisitos de tu aplicación de proceso. La opción Administrar la configuración de los datos de entrada te permite configurar fácilmente las tablas de entrada existentes o crear nuevas tablas de entrada a partir de archivos recién cargados.

Sigue estos pasos para gestionar la configuración de los datos de entrada.

1. En la sección Entrada , localiza la carpeta Tablas .

2. Localiza la tabla para la que quieres gestionar los archivos y selecciona el icono del menú contextual para abrir el panel Editar tabla para la tabla seleccionada.

Se muestra la página Tablas , que muestra las tablas de origen que ya están presentes para tu aplicación de proceso.

Asignación y configuración de tablas de entrada

Al cargar uno o más archivos, se añade automáticamente una nueva tabla en la sección Tablas de origen para cada archivo cargado y se crea una tabla de entrada correspondiente en la sección Tablas de destino . De forma predeterminada, el nombre del archivo cargado se utiliza como nombre de las tablas. Se muestra un mensaje de advertencia que indica que la tabla necesita configuración antes de que se puedan cargar los datos para la tabla.

Asignar tablas de entrada

Tus datos de entrada deben cumplir con el modelo de datos definido para tu aplicación. Si es necesario, puedes asignar una tabla de origen a una tabla de destino diferente.

Configurar tablas de entrada

Los ajustes de la tabla de entrada de destino se detectan automáticamente y solo tienes que comprobarlos.

Sigue estos pasos para editar la configuración de una tabla de entrada.

1. Localiza la tabla que quieres configurar y selecciona el icono Editar tabla para abrir el panel Editar tabla para la tabla seleccionada.

2. Edita la configuración como desees y selecciona Guardar.

La siguiente tabla describe la configuración de la tabla.

Configuración	Descripción
Nombre de la tabla	El nombre de la tabla de entrada en Transformaciones de datos.
Obligatorio	Opción para definir la tabla como obligatoria. Si TRUE, la tabla será necesaria más adelante al publicar o importar la aplicación de proceso. Si la tabla no se carga, se produce un error. Si FALSE, la tabla se considera Opcional al publicar o importar la aplicación. Si la tabla no se carga, se creará una tabla vacía para que las consultas SQL posteriores no fallen.
Codificación	La codificación utilizada en el archivo.
Delimitador	El delimitador que separa los diferentes campos.
FinalDeLínea	El carácter que se utiliza para indicar el final de una línea y el inicio de una nueva.
Citar carácter	El carácter de comillas utilizado en los campos de casos está entre comillas.
Tipo de carga	El tipo de carga para la tabla. Nota: Si seleccionas Incremental como Tipo de carga, debes especificar ajustes adicionales para configurar la carga incremental para la tabla.

Carga de datos incremental

Con una carga completa, todos los datos se extraen del origen y se cargan en el sistema de destino, independientemente de si los datos han cambiado o permanecido igual desde la última carga. Una carga incremental solo extrae los datos que han cambiado (añadidos o actualizados) desde la última carga. Una carga incremental suele ser más rápida y requiere menos recursos que una carga completa, especialmente cuando se trata de grandes volúmenes de datos en los que solo un pequeño subconjunto puede cambiar con frecuencia.

Para habilitar la carga de datos incremental para una tabla, debes establecer el Tipo de carga para la tabla en Incremental. La carga incremental requiere un identificador único para garantizar que los datos se cargan correctamente, y un campo (como una marca de tiempo o una versión) para realizar un seguimiento de los cambios en los datos de origen.

La siguiente tabla describe los ajustes adicionales necesarios para la carga incremental .

Configuración	Descripción
Claves primarias	El campo o campos de clave principal que identifican de forma única cada registro en el origen de datos.
Campo de marca de tiempo	El campo que se utiliza para realizar un seguimiento de cuándo se actualizó o añadió por última vez cada registro.
Formato de marca de tiempo	El formato del valor de la marca de tiempo utilizado en el campo Marca de tiempo .

Importante:

El método de extracción utilizado para cargar datos puede requerir una configuración adicional o específica para la extracción incremental.

Check out Loading data using CData Sync for more information on how to set up incremental extraction for CData Sync.

Check out Loading data using DataUploader for more information on how to set up DataUploader for incremental extraction.

Atención: si vuelves a cambiar el Tipo de carga a Completo, asegúrate de configurar el método de extracción utilizado en consecuencia.

Eliminar un archivo de origen

Si seleccionas accidentalmente un archivo de origen mientras cargas los datos de origen, puedes eliminarlo de la pantalla Datos de entrada.

Nota: Un archivo de origen solo puede eliminarse si no se han cargado datos para él.

Sigue estos pasos para eliminar un archivo de origen.

1. Localiza el archivo de origen que quieres eliminar en la lista Tablas de origen .
2. Pasa el ratón por encima de la tabla y selecciona Eliminar archivo.

El archivo de entrada se elimina.

Asignación y configuración de campos de entrada

Cuando hayas terminado de configurar las tablas de entrada, puedes asignar y configurar los campos de entrada para las tablas.

1. Selecciona Siguiente en la página Tablas . Se mostrará la página Campos .

Para cada tabla, los campos del archivo de origen se detectan automáticamente y se asignan a los campos correspondientes de la tabla de destino.

Asignación de campos de entrada

Tus datos de entrada deben cumplir con el modelo de datos definido para tu aplicación. Si es necesario, puedes asignar un campo de origen a un campo de destino diferente.

Configurar campos de entrada

Los ajustes de los campos de entrada de destino se detectan automáticamente y solo tienes que comprobarlos.

Sigue estos pasos para editar la configuración de un campo de entrada.

1. Localiza el campo que quieres configurar y selecciona el icono Editar campo para abrir el panel Editar campo para el campo seleccionado.

2. Edita la configuración como desees y selecciona Guardar.

La siguiente tabla describe la configuración de la tabla.

Configuración	Descripción
Nombre	El nombre del campo. Nota: El nombre es un campo obligatorio.
Tipo	El tipo de datos del campo. Texto Entero Decimal Booleano Fecha Datetime Nota: Dependiendo del tipo de campo, debes especificar la configuración de análisis para configurar el campo.
Obligatorio	Opción para definir el campo como obligatorio. Si se selecciona, el campo es obligatorio al publicar o importar la aplicación de proceso. Se produce un error si falta el campo. Si no se selecciona, el campo se considera opcional. Cuando falta, el campo se agregará con valores NULL, de modo que las consultas SQL posteriores no fallen.
Exclusivo	Opción para definir que el valor del campo tenga un valor distinto o único para cada registro.
No nula	Opción para definir que el campo debe tener un valor para cada registro. El campo no puede dejarse vacío ni rellenarse con un valor NULL.

Configuración de análisis para tipos de campo

La siguiente tabla describe la configuración de análisis disponible para los diferentes tipos de campo.

Tipo de campo	Configuración de análisis
Entero	Separador de miles Ninguno Punto (.) Coma (,)
Decimal	Separador decimal Punto (.) Coma (,) Separador de miles Ninguno Punto (.) Coma (,)
Booleano	Valor verdadero: TRUE o 1 Valor falso FALSE o 0 Nota: El valor Verdadero y el valor Falso son ajustes obligatorios y deben ser diferentes.
Fecha	Formato de fecha (consulta Configuración de análisis de ejemplo para formatos de fecha).
Datetime	Formato de fecha y hora Formato de fecha (consulta Ejemplo de configuración de análisis para formatos de fecha y hora).

Ejemplo de configuración de análisis para formatos de fecha

Formato	Ejemplo
dd-MM-aaaa	2025-04-05 2025-4-5
aaaa-dd-mm	2025-05-04 2025-5-4
dd/mm/aa	04/05/25 4/5/25
dd-mm-aaaa	04-05-2025 4-5-2025
dd-mm-aaaa	04-2025-05 4-2025-5
dd-mm-aaaa	05-04-2025 5-4-2025
dd-aaaa-mm	05-2025-04 5-2025-4

Ejemplo de configuración de análisis para formatos de fecha y hora

Formato	Ejemplo
aaaa-mm-dd hh:mm:ss	2025-04-05 14:30:45 2025-4-5 14:30:45
aaaa-mm-dd hh:mm:ss[.nnn]	2025-04-05 14:30:45.123 2025-4-5 14:30:45.123
aaaa-mm-ddThh:mm:ss[.nnn]	2025-04-05T14:30:45.123 2025-4-5T14:30:45.123
aaaa-dd-mm hh:mm:ss[.nnn]	2025-05-04 14:30:45.123 2025-5-4 14:30:45.123
mm/dd/aa hh:mm:ss AM/PM	04/05/25 02:30:45 PM 4/5/25 02:30:45 PM
mm-dd-aaaa hh:mm:ss[.nnn]	04-05-2025 14:30:45.123 4-5-2025 14:30:45.123 04-05-2025 14:30:45 4-5-2025 14:30:45
mm-aaaa-dd hh:mm:ss[.nnn]	04-2025-05 14:30:45.123 4-2025-5 14:30:45.123 04-2025-05 14:30:45 4-2025-5 14:30:45
dd-mm-aaaa hh:mm:ss[.nnn]	05-04-2025 14:30:45.123 5-4-2025 14:30:45.123 05-04-2025 14:30:45 5-4-2025 14:30:45
dd-aaaa-mm hh:mm:ss[.nnn]	05-2025-04 14:30:45.123 5-2025-4 14:30:45.123 05-2025-04 14:30:45 5-2025-4 14:30:45
aaaa-mm-ddThh:mm:ss[.nnn]+00:00*	2025-04-05T14:30:45.123+02:00 2025-04-05T14:30:45-03:00 2025-04-05T14:30:45 2025-4-5T14:30:45.123+02:00 2025-4-5T14:30:45-03:00 2025-4-5T14:30:45Z
aaaa-mm-ddThh:mm:ss+00:00*	2025-04-05T14:30:45+02:00 2025-04-05T14:30:45 2025-4-5T14:30:45-03:00 2025-4-5T14:30:45Z
dd/mm/aaaa hh:mm:ss[.nnn]	05/04/2025 14:30:45.123 5/4/2025 14:30:45.123

*) Las marcas de tiempo que incluyen información de zona horaria se convierten automáticamente a UTC durante la ingesta de datos.

Ajustar las aplicaciones de proceso existentes para utilizar la pantalla Gestionar datos de entrada

Introducción

Nota:

Aunque las aplicaciones de proceso existentes siguen siendo completamente funcionales, puedes ajustar las aplicaciones de proceso para utilizar la pantalla Gestionar datos de entrada en Process Mining. Con la pantalla Gestionar datos de entrada , puedes añadir fácilmente nuevas tablas de entrada y campos de entrada. Por lo tanto, se recomienda ajustar las aplicaciones de proceso para las que la estructura de los datos de entrada está sujeta a cambios. Si no prevés muchos cambios en la estructura de los datos de entrada, puedes considerar no ajustar la aplicación.

Si quieres empezar a utilizar la pantalla Gestionar datos de entrada para cargar las tablas y campos de una aplicación de proceso existente, debes realizar manualmente los pasos descritos en esta página.

Requisitos previos

Antes de empezar a ajustar tu aplicación:

1. Asegúrate de que se publiquen todos los cambios en la aplicación de proceso.

2. Exporta o clona la aplicación de proceso para guardar una copia de seguridad.

Pasos

Consejo:

Las consultas de entrada son los archivos SQL que hacen referencia a una tabla definida en la sección sources . Estos modelos suelen estar ubicados en la carpeta 1_input.

Sigue estos pasos para cada una de las consultas de entrada.

1. Asegúrate de que el archivo SQL de entrada solo contenga cambios de nombre y conversiones de tipo. Mueva otra lógica (filtrado, columnas derivadas, etc.) a archivos SQL posteriores.

   La siguiente ilustración muestra un archivo Event_log_input.sql de ejemplo que solo contiene cambios de nombre y conversiones de tipo.

   
   

   

   
   

2. Ve a Gestionar datos de entrada y ajusta las propiedades de campo para cada campo. Consulta Asignación y configuración de campos de entrada para obtener más información.

   1. Establece el tipo de datos y cambia el nombre utilizando la opción Gestionar configuración de datos de entrada en Transformaciones de datos.

   2. Comprueba los atributos del campo (Obligatorio, Único, no NULL) en el panel de propiedades del campo y asegúrate de que están configurados correctamente.

   
   

   

   
   
3. Comprueba todos los archivos SQL en busca de referencias a la tabla de entrada: {{ ref('table_name') }}, y actualiza estas referencias para utilizar la nueva tabla:
   Reemplaza cada aparición de {{ ref('table_name') }} con {{ source('sources', 'source_table_name') }}. Por ejemplo: reemplaza {{ ref('Event_log_input') }} que apuntaba a tus archivos SQL con {{ source('sources', 'Event_log_raw') }} para apuntar directamente a la tabla de origen.

   
   

   

   
   
   Nota:

   Estas referencias pueden ocurrir en cualquier archivo SQL.

4. Dado que el archivo SQL de entrada original ya no se utiliza, ahora puedes eliminarlo de forma segura.

Importante:

Si tus transformaciones contienen una configuración de formato que aún no está disponible en Gestionar la configuración de datos de entrada, la conversión de tipos debe permanecer en las transformaciones dbt . Por ejemplo, las fechas de SAP no están disponibles (AAAAMMDD).

Solución de problemas

Pregunta

El archivo que cargué antes no se puede cargar correctamente.

Posible solución

Inspecciona la codificación y los finales de línea de los archivos para comprobar si coinciden con la configuración de la tabla. Consulta Asignar y configurar tablas de entrada para obtener más información.