Saltar al contenido

¡Transforma tus conexiones en dinero para el final del año con nuestro nuevo Programa de Indicación de Clientes! Descubre más

Esta documentación es para la versión 4 y posteriores de App Builder, el nuevo nombre de Vinyl. Accede a la documentación de Vinyl aquí.

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 huso horario a otra.

Advertencia

La migración de fechas es una herramienta muy potente, pero también potencialmente peligrosa, ya que afectará a todos los datos seleccionados. DateTime Columnas en su fuente de datos. Se recomienda precaución y realizar pruebas adecuadas.

Recomendaciones

Se recomienda la migración de fecha para los desarrolladores que buscan convertir DateTime columnas de una huso horario a otra.

La huso horario ideal para su fuente de datos es, quizás, discutible; sin embargo, se recomienda configurar sus servidores y fuentes de datos para que todos usen la misma huso horario. UTC es probablemente la mejor opción, ya que cualquier otra huso horario puede cambiar si cambia la ubicación del servidor. Tenga en cuenta también que las instancias de Amazon están configuradas para usar UTC por defecto.

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

Al mantener sincronizadas todas las husos horarios de su fuente de datos, puede evitar el dolor de cabeza que supone convertir DateTime Datos de una huso horario a otra. Actualmente, esto no se realiza automáticamente, aunque podría desplegarse en una versión futura.

Limitaciones y advertencias

A pesar de DateTime Una vez migradas las columnas, hay otros aspectos de su aplicación App Builder que pueden requerir modificaciones, incluidos:

  • Codificado de forma rígida DateTime Los valores de las reglas no se ajustan. Si sus reglas incluyen where o select cláusulas con fechas codificadas, deberá ajustarlas manualmente a la nueva huso horario esperada.
  • Cualquier columna que utilice DateAdd Las funciones similares para ajustar manualmente las husos horarios también se mantendrán intactas. Los desarrolladores deberán corregirlas manualmente.
  • Las versiones de MS SQL Server anteriores a 2016 no admiten el AT TIME ZONE Función. Como resultado, la migración de fecha se realizará utilizando una diferencia huso horario calculada a partir de las husos horarios de origen y destino en el momento actual. Esto puede causar problemas con las husos horarios que utilizan el horario de verano. Las migraciones de fecha se ejecutan en una sola transacción cuando la aplicación o fuente de datos se actualiza mediante un LP. La transacción puede expirar según la cantidad de datos a migrar. Si esto sucede, se recomienda configurar un tiempo más largo. CommandTimeOut 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 fecha ejecute los siguientes pasos:

  • Vaya a IDE > Configuración adicional > Migración de fecha
  • Haga clic en + Migración en el panel Migraciones de fecha
  • Seleccione una Fuente de datos
  • Seleccione una Huso horario de origen. Esta configuración ya estará configurada para las fuentes de datos con un valor distinto de nulo. Time Zone.
  • Seleccione una Huso horario de destino
  • Haga clic en Guardar

En este punto, el panel lateral derecho debería llenarse con todos los DateTime Columnas en la Fuente de Datos seleccionada. Desde aquí, puede configurar la migración de fechas para cada columna.

Si su Fuente de datos no tiene una huso horario configurada, notará que Auditoría DateTime Las columnas utilizarán la huso horario del servidor de aplicaciones de App Builder como Source Time ZoneLos datos de auditoría se escriben utilizando la huso horario del servidor de aplicaciones cuando la Fuente de Datos no tiene una huso horario configurada. Tenga en cuenta también que App Builder utiliza la AddedOn y ChangedOn Tipos de uso de columnas para determinar si una columna se considera datos de auditoría.

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

  • En la misma pantalla que la anterior, haga clic en el botón Migrar del panel Migración de fecha.

Esto ejecutará un trabajo en segundo plano para migrar todas las columnas configuradas. La migración de fecha se ejecuta dentro de una sola transacción y bloqueará las 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.

Una vez migradas las fechas, el estado de la migración de fecha cambiará a Complete Si se produce un error, la transacción de migración de fecha se revertirá y se podrá encontrar información adicional en el historial de trabajos en segundo plano.