SEND REPLICAT

Utilice SEND REPLICAT para comunicarse con un proceso Replicat en ejecución o que se está iniciando. La solicitud se procesa cuando Replicat está listo para aceptar comandos de los usuarios.

Sintaxis

SEND REPLICAT group_name[threadID],
{
CACHEMGR {CACHESTATS | CACHEQUEUES | CACHEVMUSAGE} |
DEPENDENCYINFO [TXNCOUNT num] |
FORCESTOP |
GETLAG |
GETPARAMINFO [parameter_name] [FILE output_file] |
HANDLECOLLISIONS | NOHANDLECOLLISIONS [table_spec] |
INTEGRATEDPARAMS(parameter_specification) |
LOGEND |
REPORT [HANDLECOLLISIONS [table_spec]] |
RESUME |
STATUS |
STOP |
TRACE[2] [DDLINCLUDE | DDL[ONLY]] file_name |
TRACE[2] OFF |
TRACE OFF file_name |
TRACEINIT |
THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])
}

group_name[threadID]

Nombre del grupo del Replicat o nombre de un thread específico de un Replicat coordinado; por ejemplo, fin003. Si el comando se emite para un thread específico, la opción que se utilice se aplica solo a ese thread. Como alternativa, puede emitir SEND REPLICAT con la opción THREADS en lugar de incluir threadID con el nombre de grupo. Si Replicat no se está ejecutando, se devuelve un error.

CACHEMGR {CACHESTATS | CACHEQUEUES | CACHEVMUSAGE}

Devuelve las estadísticas sobre el gestor de caché de memoria de Oracle GoldenGate. CACHEMGR solo se debe utilizar como explícitamente lo indiquen los Servicios de Soporte Oracle.

CACHESTATS

Devuelve las estadísticas del almacenamiento en caché de los archivos.

CACHEQUEUES

Devuelve las estadísticas solo de las colas libres.

CACHEVMUSAGE

Devuelve las estadísticas del uso de memoria virtual.

DEPENDENCYINFO [TXNCOUNT num]

Imprime información del gráfico de dependencias de transacciones de relaciones públicas. Primero imprime los grupos de transacciones que se están ejecutando actualmente y, a continuación, las transacciones en espera que dependen de otras transacciones. TXNCOUNT determina el número de transacciones en espera que se imprimirán. El valor por defecto es 10 y el valor máximo es 99.

FORCESTOP

Fuerza a Replicat a parar, omitiendo todas las notificaciones. Este comando realizará un rollback de todas las transacciones activas y parará el proceso inmediatamente. Este comando se aplica a Replicat en su totalidad y no se puede utilizar para un thread de Replicat específico.

GETLAG

Muestra un tiempo de demora verdadero entre Replicat y la pista. El tiempo de demora es la diferencia en segundos entre la hora a la que Replicat procesó el último registro y el registro de hora del registro en la pista. Los resultados son iguales que LAG REPLICAT.

GETPARAMINFO [parameter_name] [FILE output_file]

Utilice GETPARAMINFO para consultar los valores de los parámetros de tiempo de ejecución de una instancia en Ejecución, incluidas Extract, Replicat y el gestor. Puede consultar un único parámetro o todos los parámetros y enviar la salida a la consola o a un archivo de texto

parameter_name

El comportamiento por defecto es mostrar todos los parámetros en uso, (es decir, aquellos parámetros que ha consultado alguna vez la aplicación) los parámetros y sus valores actuales. Si especifica un parámetro en particular, el resultado se filtrará por ese nombre.

FILE output_file

Nombre del archivo de texto hacia el que se redirecciona la salida.

HANDLECOLLISIONS NOHANDLECOLLISIONS [table_spec]

Controla el comportamiento de HANDLECOLLISIONS. En lugar de utilizar esta opción, puede especificar el parámetro HANDLECOLLISIONS o NOHANDLECOLLISIONS en el archivo de parámetros de Replicat. Consulte HANDLECOLLISIONS \| NOHANDLECOLLISIONS en Referencia de parámetros y funciones para Oracle GoldenGate. Este comando se puede enviar directamente a un thread individual mediante SEND REPLICAT group_name[threadID] o puede utilizar la opción THREADS para enviar el comando a través del thread del coordinador para que afecte a varios threads.

HANDLECOLLISIONS

Utilice HANDLECOLLISIONS para activar el manejo automático de errores al realizar cargas a los datos iniciales mientras la base datos de origen está activa. Asegúrese de desactivar HANDLECOLLISIONS, ya sea mediante el envío de SEND REPLICAT con la opción NOHANDLECOLLISIONS o mediante el retiro del parámetro del archivo de parámetro, una vez que se haya completado la carga inicial y se hayan aplicado el cambio de datos en línea en las tablas de destino. Nota: Mensaje devuelto por `SEND

                                            REPLICAT` with `HANDLECOLLISIONS`, when issued for a specific Replicat thread, shows that the command set `HANDLECOLLISIONS` for all `MAP` statements, not only the one handled by the specified thread. This is a known issue. The command actually affects only the `MAP` statement that includes the specified thread.
                                            {: .infoboxnote}

NOHANDLECOLLISIONS

Desactiva el parámetro HANDLECOLLISIONS pero no lo elimina del archivo del parámetro. Para evitar que se active HANDLECOLLISIONS la siguiente vez que Se inicie Replicat, elimínelo del archivo de parámetros.

table_spec

table_spec restringe HANDLECOLLISIONS o NOHANDLECOLLISIONSa una tabla objetivo específica o a un grupo de tablas de destino especificado con un comodín estándar (*).

INTEGRATEDPARAMS(parameter_specification)

(Oracle) Soporta un Replicat integrado. Envía una especificación de parámetro a un servidor entrante de base de datos mientras se está ejecutando Replicat en modo integrado. Solo se puede enviar una especificación de parámetro cada vez con este comando. Para enviar varios cambios de parámetro, emita varios comandos SEND REPLICAT como en el siguiente ejemplo.

SEND REPLICAT repe INTEGRATEDPARAMS (parallelism 4)
SEND REPLICAT repe INTEGRATEDPARAMS (max_sga_size 250)

Para conservar la continuidad del procesamiento, el cambio de parámetro se realiza en un límite de transacción.

LOGEND

Confirma si Replicat ha procesado o no todos los registros del origen de datos.

REPORT [HANDLECOLLISIONS [table_spec]]

Genera un informe estadístico provisional en el archivo de informe de Extract. Las estadísticas que se muestran dependen del parámetro STATOPTIONS cuando se utiliza con la opción RESETREPORTSTATS | NORESETREPORTSTATS. Consulte STATOPTIONS.

HANDLECOLLISIONS

Muestra las tablas para las que se ha activado HANDLECOLLISIONS.

table spec

Restringe la salida a una tabla de destino específica o a un grupo de tablas de destino especificado con un comodín estándar (*).

RESUME

Reanuda (activa) un proceso que había suspendido un evento EVENTACTIONS SUSPEND. El proceso reanuda su procesamiento normal a partir del punto en el que fue suspendido.

STATUS

Devuelve la ubicación actual en la pista e información relacionada con la transacción actual. Las salidas de los campos son:

Estado de procesamiento (por thread, si es un Replicat coordinado)
Posición en el archivo de pista (por thread, si es un Replicat coordinado)
Número de secuencia de pista (por thread, si es un Replicat coordinado)
RBA en la pista
Nombre de pista

Los mensajes de estado de procesamiento posibles son:

Delaying: esperando más datos
Suspended: esperando la reanudación
Waiting on deferred apply: retraso del procesamiento según el parámetro DEFERAPPLYINTERVAL.
Processing data: procesamiento de datos
Skipping current transaction: se ha utilizado START REPLICAT con SKIPTRANSACTION.
Searching for START ATCSN csn: se ha utilizado START REPLICAT con ATCSN.
Searching for START AFTERCSN csn: se ha utilizado START REPLICAT con AFTERCSN.
Performing transaction timeout recovery: cancelando la transacción incompleta actual y realizando el reposicionamiento para iniciar una nueva (consulte el parámetro TRANSACTIONTIMEOUT).
Waiting for data at logical EOF after transaction timeout recovery: esperando a recibir el resto de las transacciones de origen incompletas tras una terminación TRANSACTIONTIMEOUT.
At EOF (end of file): no hay más registros que procesar

Los posibles mensajes de estado de thread cuando se utiliza THREADS o se emite el comando para un thread específico son los siguientes:

Waiting for consensus stop point: indica que los threads están intentando sincronizarse para una transacción con barrera.
Waiting for Watermark: indica que todos los threads están intentando parar en el mismo límite de transacción en la pista, conocido como límite global.
Waiting on all threads to start up: indica que el thread está esperando que se inicien todos los threads después de una transacción con barrera o un inicio de Replicat correcto.

Los mensajes de estado de thread de coordinador posibles son:

Waiting for all threads to register: indica que se están analizando todas las sentencias MAP para determinar los identificadores de thread especificados en ellas.
Processing data: indica que la información se está procesando con normalidad.
Suspended, waiting to be resumed: indica que se ha enviado un comando SEND REPLICAT con una solicitud SUSPEND a Replicat.
At EOF: indica que no hay más datos en la pista que procesar.
Waiting to register MAP statistics: indica que Replicat está recopilando estadísticas de procesamiento para enviarlas al archivo de informe.

STOP

Para Replicat correctamente. Este comando se aplica a Replicat en su totalidad y no se puede utilizar para un thread de Replicat específico.

THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])

Emite el comando solo para el thread o threads especificados de un Replicat coordinado. Puede utilizar esta opción o puede utilizar groupname con threadID. Sin ninguna de estas opciones, el comando se aplica a todos los threads activos.

threadID[, threadID][, ...]

Especifica un identificador de thread o una lista delimitada por comas de threads con el formato threadID, threadID, threadID.

thread_range[, thread_range][, ...]

Especifica un rango de threads con el formato de threadIDlow-threadIDhigh o una lista de rangos delimitados por comas con el formato de threadIDlow-threadIDhigh, threadIDlow-threadIDhigh.

Se permiten una combinación de estos formatos, como threadID, threadID, threadIDlow-threadIDhigh.

TRACE[2] [DDLINCLUDE DDL[ONLY]] file_name

Activa y desactiva el rastreo. El rastreo captura la información en el archivo especificado para revelar cuellos de botella de procesamiento. El rastreo también se puede activar mediante los parámetros de Replicat TRACE y TRACE2.

Si el Replicat está en modo coordinado y se utiliza TRACE con una lista o rango de THREADS, se crea un archivo en rastreo para cada thread actualmente activo. Cada nombre de archivo se agrega con su identificador de thread asociado. Este método de identificación de archivos rastreo por identificador de thread no se aplica cuando SEND REPLICAT lo emite groupname con threadID (como en SEND REPLICAT fin003 TRACE...) o cuando solo se especifica un thread con THREADS.

Póngase en contacto con los Servicios de Soporte Oracle para obtener asistencia si el rastreo revela que hay cuellos de botella de procesamiento significativos.

TRACE

Captura la información de procesamiento paso a paso.

TRACE2

Identifica segmentos de código en lugar de pasos específicos.

DDLINCLUDE | DDLONLY

(Solo en Replicat) Activa el rastreo de DDL y especifica cómo se incluye el rastreo de DDL en el informe de rastreo.

DDLINCLUDE incluye el rastreo de DDL además del rastreo normal del procesamiento de datos transaccionales.
DDL[ONLY] excluye el rastreo del procesamiento de datos transaccionales y solo rastrea el DDL. Esta opción se puede abreviar a DDL.

file_name

file_name especifica el nombre relativo o totalmente cualificado de un archivo en los que Oracle GoldenGate registra la información de rastreo. Si un rastreo ya está en curso, el archivo del rastreo existente se cierra y el rastreo se reanuda al archivo especificado con file_name. Por ejemplo:

SEND REPLICAT group_name TRACE file_name DDLINCLUDE

Si ninguna otra opción seguirá al nombre de archivo, se puede omitir la palabra clave FILE; por ejemplo:

SEND REPLICAT group_name TRACE DDLINCLUDE file_name

TRACE[2] OFF

Desactiva el rastreo.

TRACE OFF file_name

Desactiva el rastreo solo para el archivo de rastreo especificado. Esta opción soporta la función EVENTACTIONS, en las que puede haber varios archivos del rastreo debido a varias sentencias EVENTACTIONS.

TRACEINIT

Restablece las estadísticas de rastreo a 0 y, a continuación, empieza a acumular estadísticas de nuevo. Utilice esta opción para realizar un seguimiento del comportamiento actual frente al comportamiento histórico del procesamiento.

Ejemplos

SEND REPLICAT repe, HANDLECOLLISIONS

SEND REPLICAT repe, REPORT HANDLECOLLISIONS rep_*

SEND REPLICAT repe, GETLAG

SEND REPLICAT repe, INTEGRATEDPARAMS(parallelism 10)

En el siguiente ejemplo se obtiene una demora para el thread 3 de un Replicat coordinado.

SEND REPLICAT repe, GETLAG

En el siguiente ejemplo se activa el rastreo solo para el thread 1 de un Replicat coordinado. En este caso, debido a que solo se está rastreando el thread, el archivo de rastreo no tendrá una extensión threadID. El nombre de archivo es trace.trc.

SEND REPLICAT repe, TRACE THREADS(1) FILE ./dirrpt/trace.trc

En el siguiente ejemplo se activa el rastreo para los threads 1, 2 y 3 de un Replicat coordinado. Si todos los threads están activos, el rastreo produce los archivos trace001, trace002 y trace003.

SEND REPLICAT repe TRACE THREADS(1-3) FILE ./dirrpt/trace.trc

En el siguiente ejemplo se activa el rastreo solo para el thread 1 de un Replicat coordinado. Debido a que el comando se ha emitido directamente para la subproceso 1 sin el uso de una cláusula THREAD, se denomina trace (sin un sufijo de identificador de subproceso).

SEND REPLICAT repe TRACE FILE ./dirrpt/trace.trc