4D v16
SYNCHRONIZE
SYNCHRONIZE
|
SYNCHRONIZE |
||
El comando SYNCHRONIZE permite sincronizar dos tablas ubicadas en dos servidores 4D SQL diferentes. Todo cambio realizado en una de las tablas también se efectúa en el otro. El servidor 4D SQL que ejecuta el comando se llama servidor local y el otro servidor se llama servidor remoto.
El comando SYNCHRONIZE es una combinación de dos llamadas internas al comando REPLICATE. La primera llamada replica los datos desde el servidor remoto al servidor local y la segunda efectúa la operación inversa: replicación de los datos del servidor local al servidor remoto. Las tablas a sincronizar deben estar configuradas para la replicación
- Deben tener una llave primaria,
- La opción "Activar replicación" debe estar seleccionada en la ventana Inspector de cada tabla.
Para mayor información, consulte la descripción del comando REPLICATE.
El comando SYNCHRONIZE acepta cuatro marcadores (stamps) como "parámetros": dos marcadores en entrada y dos marcadores en salida (última modificación). Los marcadores de entrada se utilizan para indicar el momento de la última sincronización en cada servidor. Los marcadores de salida devuelven el valor de los marcadores de modificación en cada servidor justo después de la última modificación. Gracias a este principio, cuando el comando SYNCHRONIZE se llama regularmente, es posible usar los marcadores de salida de la última sincronización como marcadores de entrada para la siguiente.
Nota: los marcadores de entrada y de salida se expresan como valores numéricos (stamps) y no de marcadores de tiempo (timestamps). Para obtener más información sobre estos marcadores, consulte la descripción del comando REPLICATE.
En caso de error, el marcador de salida del servidor en cuestión contiene el marcador del registro al origen del error. Si el error se debe a una causa distinta a la sincronización (problemas de red por ejemplo), el marcador contendrá 0.
Hay dos códigos de error diferentes, uno para indicar un error de sincronización en el sitio local y otro para un error de sincronización en el sitio remoto.
Cuando ocurre un error, el estado de los datos dependerá de la de la transacción en el servidor local. En el servidor remoto, la sincronización se realiza siempre dentro de una transacción, de manera que los datos no puedan ser alterados por la operación. Sin embargo, en el servidor local, el proceso de sincronización queda bajo el control del desarrollador. Se efectúa fuera de cualquier transacción si la preferencia Transacciones Auto-commit no está activada, (de lo contrario, un contexto de transacción se crea automáticamente). El desarrollador puede optar por iniciar una transacción y es responsabilidad del desarrollador validar o cancelar esta transacción después de la sincronización de los datos.
Puede "forzar" la dirección de sincronización utilizando las cláusulas REMOTE OVER LOCAL y LOCAL OVER REMOTE, dependiendo de las características de su aplicación. Para mayor información sobre los mecanismos de implementación, consulte la descripción del comando REPLICATE.
Nota: las operaciones efectuadas por el comando SYNCHRONIZE no tienen en cuenta restricciones de integridad de los datos. Esto significa, por ejemplo, que las reglas que rigen las llaves foráneas, unicidad, etc. no son verificadas. Si los datos recibidos pueden afectar la integridad de datos, debe verificar los datos después de la operación de sincronización. La manera más simple es bloquear, vía el lenguaje 4D o SQL, los registros que deben modificarse.
Para entender los mecanismos involucrados en la operación de sincronización, vamos a examinar las diferentes posibilidades relativas a la actualización de un registro existente en las dos bases sincronizadas.
El método de sincronización es de la siguiente forma:
C_LONGINT(vRemoteStamp)
C_LONGINT(vLocalStamp)
C_LONGINT(vLatestRemoteStamp)
C_LONGINT(vLatestLocalStamp)
vRemoteStamp:=X... // ver valores en el array a continuación
vLocalStamp:=X... // ver valores en el array a continuación
vLatestRemoteStamp:=X... // valor devuelto en un anterior LATEST REMOTE STAMP
vLatestLocalStamp:=X... // valor devuelto en un anterior LATEST LOCAL STAMP
Begin SQL
SYNCHRONIZE
LOCAL MYTABLE (MyField)
WITH
REMOTE MYTABLE (MyField)
FOR REMOTE STAMP :vRemoteStamp,
LOCAL STAMP :vLocalStamp
LOCAL OVER REMOTE // or REMOTE OVER LOCAL, ver en el array a continuación
LATEST REMOTE STAMP :vLatestRemoteStamp,
LATEST LOCAL STAMP :vLatestLocalStamp;
End SQLLos datos iniciales son:
- El marcador del registro en la base LOCAL tiene un valor de 30 y el de la base REMOTA tiene un valor de 4000
- Los valores del campo MiCampo son los siguientes:
LOCAL REMOTE Antiguo valor Nuevo valor Antiguo valor Nuevo valor AAA BBB AAA CCC - Utilizamos los valores devueltos por las cláusulas anteriores LATEST LOCAL STAMP y LATEST REMOTE STAMP para sincronizar únicamente los valores que fueron modificados desde la última sincronización.
Estas son las sincronizaciones efectuadas por el comando SYNCHRONIZE en función de los valores pasados en los parámetros LOCAL STAMP y REMOTE STAMP como también la opción de prioridad utilizada: ROL (para REMOTE OVER LOCAL) o LOR (para LOCAL OVER REMOTE):
| LOCAL STAMP | REMOTE STAMP | Prioridad | LOCAL después de sinc | REMOTA después de sinc | Sincronización LOCAL - REMOTA |
| 20 | 3000 | ROL | CCC | CCC | <----> |
| 20 | 3000 | LOR | BBB | BBB | <----> |
| 31 | 3000 | ROL | CCC | CCC | <-- |
| 31 | 3000 | LOR | CCC | CCC | <-- |
| 20 | 4001 | ROL | BBB | BBB | --> |
| 20 | 4001 | LOR | BBB | BBB | --> |
| 31 | 4001 | ROL | BBB | CCC | Sin sincronización |
| 31 | 4001 | LOR | BBB | CCC | Sin sincronización |
| 40 | 3000 | ROL | CCC | CCC | <-- |
| 40 | 3000 | LOR | CCC | CCC | <-- |
| 20 | 5000 | ROL | BBB | BBB | --> |
| 20 | 5000 | LOR | BBB | BBB | --> |
| 40 | 5000 | ROL | BBB | CCC | Sin sincronización |
| 40 | 5000 | LOR | BBB | CCC | Sin sincronización |
Producto: 4D
Tema: Comandos SQL
Manual de SQL ( 4D v16)
