Migración de fechas en Jitterbit App Builder

Descripción general

La función de Migración de Fechas de App Builder proporciona soporte para migrar fechas de una zona horaria a otra.

Recomendaciones

Se recomienda la Migración de Fechas para desarrolladores que buscan convertir columnas DateTime de una zona horaria a otra.

La zona horaria ideal para su fuente de datos es, quizás, debatible; sin embargo, la práctica recomendada es configurar sus servidores y fuentes de datos para que todas utilicen la misma zona horaria. UTC es probablemente la mejor opción, ya que cualquier otra zona horaria es propensa a cambiar si la ubicación del servidor cambia. También tenga en cuenta que las instancias de Amazon están configuradas por defecto para usar UTC.

Otra cosa a tener en cuenta es que configurar la zona horaria de su servidor de base de datos para que sea la misma que la zona horaria de su fuente de datos asegurará que las llamadas a 'Now()' devuelvan el valor esperado. Now() devuelve la hora actual según la zona horaria de la base de datos.

Al mantener todas sus zonas horarias de fuentes de datos sincronizadas, puede evitar el dolor de cabeza de convertir datos DateTime de una zona horaria a otra. Hoy en día, esto no se hace automáticamente, aunque puede implementarse en una futura versión.

Limitaciones y advertencias

Aunque las columnas DateTime son migradas, hay otros aspectos de su aplicación de App Builder que pueden requerir modificación, incluyendo:

• Los valores DateTime codificados de forma rígida en las reglas no se ajustan. Si sus reglas incluyen cláusulas where o select con fechas codificadas, deberá ajustarlas manualmente a la nueva zona horaria esperada.
• Cualquier columna que utilice DateAdd o funciones similares para ajustar zonas horarias manualmente también se dejará tal como está. Los desarrolladores deberán corregir esto manualmente.
• Las versiones de MS SQL Server anteriores a 2016 no soportan la función AT TIME ZONE. Como resultado, la Migración de Fechas se realizará utilizando un desplazamiento de zona horaria calculado a partir de las zonas horarias de origen y destino en el momento actual. Esto puede causar problemas con zonas horarias que utilizan el horario de verano.
• Las Migraciones de Fechas se ejecutan en una sola transacción cuando su aplicación/fuente de datos se está actualizando a través de un LP. La transacción puede agotar el tiempo dependiendo de la cantidad de datos a migrar. Si esto sucede, establecer un CommandTimeOut más largo en su archivo de conexión ayudará a mitigar el tiempo de espera.

Configurar la migración de fechas

Para realizar una migración de fechas, ejecute los siguientes pasos:

• Navegue a IDE > Configuraciones Adicionales > Migración de Fechas
• Haga clic en + Migración en el panel de Migraciones de Fechas
• Seleccione una Fuente de Datos
• Seleccione una Zona Horaria de Origen. Esta configuración ya estará poblada para las Fuentes de Datos que tengan una Zona Horaria no nula.
• Seleccione una Zona Horaria de Destino
• Haga clic en Guardar

En este punto, el panel del lado derecho debería poblarse con todas las columnas de DateTime en la Fuente de Datos seleccionada. Desde aquí puede configurar los ajustes de Migración de Fechas para columnas individuales.

Si su Fuente de Datos no tiene una zona horaria configurada, notará que las columnas de DateTime de Auditoría utilizarán la zona horaria del servidor de aplicaciones de App Builder como la Zona Horaria de Origen. Los datos de auditoría se escriben utilizando la zona horaria del servidor de aplicaciones cuando la Fuente de Datos no tiene una zona horaria configurada. También tenga en cuenta que App Builder utiliza los Tipos de Uso de las columnas AddedOn y ChangedOn para determinar si una columna se considera datos de auditoría.

Una vez que haya terminado de ajustar las columnas individuales, puede proceder con los siguientes pasos:

• En la misma pantalla que arriba, haga clic en el botón Migrar en el panel de Migración de Fechas.

Esto ejecutará un trabajo en segundo plano para migrar todas las columnas configuradas. La migración de fechas se ejecuta dentro de una única transacción y bloqueará tablas en el proceso. Debe asegurarse de que el tráfico en su servidor sea mínimo o nulo para evitar bloqueos.

También se agregarán pasos de gestión de cambios para cada tabla que se migre.

Después de que las fechas hayan sido migradas, el estado de la Migración de Fechas cambiará a Completo.

Si ocurre un fallo, la transacción de Migración de Fechas se revertirá y se puede encontrar un registro adicional en el historial de trabajos en segundo plano.

Solución de problemas

Para la solución de problemas relacionada, consulte lo siguiente en la guía de solución de problemas de App Builder:

• La migración de fechas se agota en conjuntos de datos grandes