RESTART REPLICAT
Utilice RESTART REPLICAT para parar y, a continuación, iniciar un grupo de Replicat. Para confirmar que Se ha iniciado Replicat, utilice el comando INFO REPLICAT o STATUS REPLICAT.
Punto de inicio normal
Replicat se puede iniciar en su punto de inicio normal (desde los puntos de control inicial o actual) o desde una posición alternativa especificada por el usuario en la pista.
RESTART REPLICAT, sin ninguna opción, permite que Replicat empiece a procesar en uno de los siguientes puntos para mantener la integridad de datos:
-
Después de una terminación correcta o anormal: en la primera transacción no procesada en la pista desde la ejecución anterior, tal y como está representada por el punto de control de lectura actual.
-
Primer inicio después de la creación del grupo: desde el principio del archivo del pista activo (
seqno 0,rba 0).
Punto de inicio alternativo
Las opciones SKIPTRANSACTION, ATCSN y AFTERCSN de START REPLICAT provocan a que Replicat como un todo, o a que threads específicos de un Replicat coordinado, inicien el procesamiento en una transacción en la pista distinta del punto inicial normal. Utilice estas opciones para:
-
Especificar una posición de recuperación lógica cuando un error impide a Replicat moverse hacia delante en la pista. Replicat se puede posicionar para omitir la transacción o las transacciones incorrectas con el conocimiento de que los datos no se aplicarán en el destino.
-
Omitir transacciones replicadas que provocarán errores que indican que un registro está duplicado o que falta un registro después de aplicar una copia de seguridad en el destino durante una carga inicial. Con estas opciones se hace que Replicat deseche las transacciones que se hayan producido antes del grupo de cambios más recientes capturados en la copia de seguridad. Puede asignar el valor del identificador serie que se corresponda con la finalización de la copia de seguridad en un valor de CSN y, a continuación, iniciar Replicat para empezar a aplicar las transacciones desde el CSN especificado en adelante.
Sintaxis
RESTART REPLICAT group_name_wildcard
[SKIPTRANSACTION | {ATCSN csn | AFTERCSN csn}]
[FILTERDUPTRANSACTIONS | NOFILTERDUPTRANSACTIONS]
[THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...]])]
group_name_wildcard
Nombre de un grupo o comodín de Replicat (*) para especificar varios grupos. Por ejemplo, T* inicia todos los grupos de Replicat cuyos nombres empiece por T.
SKIPTRANSACTION
Provoca que Replicat omita la primera transacción después de su posición de inicio esperada en la pista. Se excluyen todas las operaciones a partir de esa primera transacción.
Si también se está empleando el parámetro MAXTRANSOPS para este Replicat, es posible que el proceso empiece a leer el archivo de pista desde un lugar en medio de la transacción. En ese caso, se omite el resto de la transacción parcial y Replicat reanuda el procesamiento normal desde el siguiente registro de inicio de transacción del archivo. Los registros omitidos se escriben en el archivo de desecho si está utilizando el parámetro DISCARDFILE; en caso contrario, se escribe un mensaje en el archivo de informe similar al siguiente:
User requested START SKIPTRANSACTION. The current transaction will be skipped. Transaction ID txid, position Seqno seqno, RBA rba
SKIPTRANSACTION solo es válido cuando la pista que está leyendo Replicat es parte de una configuración de sincronización del cambio en línea (con puntos de control). No es válido para cargas iniciales de tipo de tarea (donde SPECIALRUN se utiliza con ADD REPLICAT).
ATCSN csn |
AFTERCSN csn |
Define un punto de inicio definido por el usuario en un CSN específico. Cuando se utiliza ATCSN o AFTERCSN, se escribe un mensaje similar a uno de los siguientes en el archivo de informe:
User requested start at commit sequence number (CSN) csn-string
User requested start after commit sequence number (CSN) csn-string
Información general sobre estas opciones:
-
Solo es válido cuando la pista que está leyendo Replicat forma parte de una configuración de sincronización de cambios en línea (con puntos de control). No es válido para cargas iniciales de tipo de tarea (donde
SPECIALRUNse utiliza conADD REPLICAT). -
Para admitir el inicio en, o después, del CSN, la pista debe ser de la versión Oracle GoldenGate 10.0.0 o posterior, porque el CSN se almacena en el primer registro de pista de cada transacción. Si Replicat se inicia con
AFTERCSNen una versión en pista anterior, Replicat finalizara anormalmente y escribirá un error en el informe que indica que el formato de pista no está soportado.ATCSNProvoca que Replicat inicie el procesamiento en la transacción que tiene el CSN especificado. Se omiten todas las transacciones de la pista que tienen valores de CSN que son menores que el especificado.
AFTERCSNProvoca que Replicat inicie el procesamiento en la transacción que se ha producido después de la que tiene el CSN especificado. Se omiten todas las transacciones de la pista que tienen valores de CSN que son menores o iguales que el especificado.
csnEspecifica un valor de CSN. Introduzca el valor de CSN con el formato que es válido para la base de datos. Consulte Commit Sequence Number (CSN) para conocer los formatos y las descripciones de CSN. Replicat finaliza anormalmente si el formato no es válido y escribe un mensaje en el archivo de informe.
Para determinar el CSN que se debe proporcionar tras la finalización de una carga inicial, utilice el identificador de confirmación en el que la utilidad de carga ha completado la carga. En caso contrario, siga las instrucciones del procedimiento de carga inicial para determinar cuándo se debe iniciar Replicat.
FILTERDUPTRANSACTIONS | NOFILTERDUPTRANSACTIONS
Provoca que Replicat ignore las transacciones que ya ha procesado. Utilícelo cuando Extract se haya reposicionado en un nuevo momento de inicio (consulte la opción ATCSN o AFTERCSN de "START EXTRACT") y esté seguro que hay transacciones duplicadas en la pista que pueden provocar que Replicat finalicen anormalmente. Esta opción requiere el uso de una tabla de puntos de control. Si la base de datos es Oracle, esta opción solo es válida para Replicat en modo no integrado. En el caso de modo integrado y la regeneración automática de un archivo de pista de destino, el modo integrado gestiona de forma transparente las transacciones duplicadas. El valor por defecto es FILTERDUPTRANSACTIONS.
THREADS thread_list
Válido para SKIPTRANSACTION, ATCSN y AFTERCSN cuando Replicat está en el modo coordinado. No válido para RESTART REPLICAT sin esas opciones. Inicia el thread o los threads de Replicat especificados en la ubicación especificada.
thread_list
Lista de rangos delimitada por comas con el formato threadIDlow-threadIDhigh, threadIDlow-threadIDhigh.
!
(Signo de exclamación) Reinicia inmediatamente Replicat. Se para la transacción.
Ejemplos
RESTART REPLICAT finance
Con lo siguiente se inicia Replicat en un CSN específico.
RESTART REPLICAT finance, ATCSN 6488359
En el siguiente ejemplo se provoca que los threads 4 y 5 de un Replicat coordinado omitan la primera transacción después de su último punto de control cuando se inicia Replicat. Si este fuera un Replicat coordinado de 10 threads, los threads 0-3 y 6-10 se iniciarían todos en el punto de inicio normal, es decir, el de su último punto de control.
RESTART REPLICAT fin SKIPTRANSACTION THREADS (4-5)
En el siguiente ejemplo se provoca que los threads 1-3 de un Replicat coordinado se inicien en CSN 6488359, que los threads 9-10 se inicien después de CSN 6488360 y que los threads 7 y 8 omitan la primera transacción después de su último punto de control.
RESTART REPLICAT fin ATCSN 6488359 THREADS (1-3), AFTERCSN 6488360 THREADS (9-10), SKIPTRANSACTION THREADS (7,8)