ADD REPLICAT

Utilice ADD REPLICAT para crear un grupo de Replicat. Este comando crea un grupo de proceso en línea que crea puntos para que la continuidad de procesamiento se mantenga de ejecución en ejecución. No puede tener más de 500 bytes de tamaño para todas las palabras clave y las entradas, incluido cualquier texto que introduzca para la opción DESC.

Oracle GoldenGate soporta hasta 5000 grupos de Extract y Replicat simultáneos por instancia del gestor de servicios de Oracle GoldenGate. En el nivel soportado, todos los grupos se pueden controlar y visualizar por completo mediante comandos como los comandos INFO y STATUS.

Oracle GoldenGate recomienda guardar el número de grupos de Extract y Replicat (combinados) en el nivel por defecto 300 o uno inferior para gestionar el entorno de manera eficaz.

(Oracle) A menos que se utilice la opción INTEGRATED, este comando crea un grupo de Replicat en modo no integrado.

Sintaxis

ADD REPLICAT group_name
[, PARALLEL [, INTEGRATED] | INTEGRATED | COORDINATED [MAXTHREADS number]]
{, EXTTRAIL trail_name}
[, BEGIN {NOW | yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]}]
[, EXTRBA rba]
{, CHECKPOINTTABLE owner.table}
[, DESC 'description']
[, ENCRYPTIONPROFILE encryption-profile-name ]
                [ CRITICAL        [ YES | NO ]  ]
                [ PROFILE          profile-name
[ AUTOSTART
                [ YES | NO ]
                [ DELAY delay-number ] ]
                [ AUTORESTART [ YES | NO ]
                [ RETRIES      retries-number ]
                [ WAITSECONDS  wait-number    ]
                [ RESETSECONDS reset-number   ]
                [ DISABLEONFAILURE [ YES | NO ]     ] ] ]

group_name

Nombre del grupo de Replicat. Si no se especifica ninguna opción, crea un Replicat clásico. El nombre del grupo de Replicat coordinado y paralelo puede contener un máximo de cinco caracteres. El nombre de un grupo de Replicat normal puede contener hasta ocho caracteres.

INTEGRATED

(Oracle) Crea el Replicat en modo integrado. Sin esta opción, ADD REPLICAT crea el Replicat en modo de no integrado (clásico). Esta opción también funciona para el Replicat paralelo. En este modo, el proceso Replicat utiliza la funcionalidad del procesamiento de aplicación que está disponible en Oracle AI Database. En este modo, Replicat funciona como se indica a continuación:

Lee la pista de Oracle GoldenGate.
Realiza el filtrado, la asignación y la conversión de los datos.
Crea registros lógicos de cambio (LCR) que representan las transacciones de DDL o DML de la base de datos de origen (en orden de confirmación).
Se asocia a un proceso en segundo plano en la base de datos de destino como un servidor entrante de base de datos mediante una interfaz de streaming sencilla.
Transmite el LCR al servidor entrante, el cual aplica los datos a la base de datos de destino.
Se debe utilizar un Replicat en modo integrado (ya sea integrado normal o integrado paralelo) si se utiliza alguna de las funciones siguientes:
- Detección y resolución automática de conflictos
- Replicación de procedimiento
- Manejadores DML o DDL

INTEGRATED se debe utilizar para un Replicat de sincronización en línea que lea de una pista especificada por EXTTRAIL local.

Tanto el Replicat integrado como el Replicat paralelo en el modo integrado mantienen la tabla de puntos de control si existe una. Consulte también ADD CHECKPOINTTABLE.

TRACETABLE no se mantiene en Replicat integrado ni en Replicat paralelo en modo integrado.

En el modo integrado, Replicat no soporta los siguientes parámetros:

BULKLOAD (No utilice un Replicat integrado como Replicat de carga inicial).
GENLOADFILES
SHOWSYNTAX
MAXTRANSOPS (se ignora)

PARALLEL

Válida para todas las bases de datos soportadas.

Agrega el Replicat en modo paralelo. En este modo, el Replicat aplica las transacciones en paralelo para mejorar el rendimiento. Tiene en cuenta las dependencias entre transacciones. PARALLEL INTEGRATED El Replicat solo es válido para Oracle. Agrega el Replicat paralelo en modo integrado, que al igual que Integrated Replicat utiliza la funcionalidad del procesamiento que está disponible en Oracle AI Database.

Nota: Al configurar el Replicat paralelo para Sybase, asegúrese de actualizar a la versión 16.0 SP3 PL15 y superior para evitar que el servicio de administración se desconecte de forma intermitente.

COORDINATED [MAXTHREADS number]

Crea el Replicat en modo coordinado. Un Replicat coordinado tiene varios threads para activar el procesamiento paralelo. Esta opción agrega el coordinador (que se Identifica por el Nombre de Grupo) y el número máximo de threads de procesamiento especificados por defecto o con MAXTHREADS. Las dependencias las calcula y coordina el coordinador, y el procesamiento SQL lo realizan los threads.

Para crear un Replicat COORDINATED, es necesaria una tabla de puntos de comprobación.

COORDINATED se debe utilizar para un Replicat de sincronización en línea que lea de una pista especificada por EXTTRAIL local. Nota: El nombre de grupo de un Replicat coordinado solo puede contener cinco caracteres.

MAXTHREADS number

Especifica el número máximo de threads de procesamiento que puede generar este grupo de Replicat. Todos estos subprocesos se crean en el inicio, pero dependiendo de lo que se haya especificado en las sentencias MAP en el archivo de parámetro, algunos o todos estos subprocesos procesarán la carga de trabajos en el momento dado. Como regla general, especifique dos veces el número de threads en las sentencias MAP cuando realice la partición de la carga de trabajo. Esto le permite agregar hilos en el caso de que aumente la carga de trabajo sin tener que borrar y volver a creación el grupo de Replicat; consulte TABLE \| MAP para ver más información sobre cómo hacer la partición de la carga de trabajo en las hilos.

El número de threads por defecto es 25 si se omite MAXTHREADS. El número máximo de threads es 500.

MAXTHREADS tiene una relación con el parámetro MAXGROUPS. MAXGROUPS controla el número máximo de grupos de proceso (Extract y Replicat) permitidos por instancia de Oracle GoldenGate. Cada thread de Replicat se considera un grupo de Replicat en el contexto de MAXGROUPS. Por lo tanto, el número de grupos de Extract y Replicat en la instancia deOracle GoldenGate, más el valor de MAXTHREADS, no puede superar el valor de MAXGROUPS; consulte MAXGROUPS

EXTTRAIL trail_name

Especifica el nombre relativo o completo de una pista que se ha creado con el comando ADD EXTTRAIL.

BEGIN {NOW yyyy-mm-ddT[ hh:mm[:ss[.cccccc]]]Z}

Define un punto de control inicial en la pista.

NOW

Empieza la replicación de cambios desde la hora a la que se crea el grupo.

yyyy-mm-ddT[ hh:mm[:ss[.cccccc]]]Z

Empieza la extracción de cambios desde la hora especificada.

EXTRBA extrba

Válido para Db2 z/OS.

Especifica la dirección del byte relativa en el archivo de pista especificado por EXTSEQNO. Póngase en contacto con los Servicios de Soporte Oracle antes de utilizar esta opción.

CHECKPOINTTABLE {owner.table NODBCHECKPOINT}

No válido para Oracle GoldenGate Applications Adapter u Oracle GoldenGate Big Data.

NODBCHECKPOINT no es válido para Oracle AI Database de destino. Oracle recomienda utilizar una tabla de puntos de control. El Replicat paralelo y coordinado en el modo integrado y en el no integrado requiere una tabla de puntos de control.

Especifica que este grupo de Replicat escribirá los puntos de control en la tabla especificada de la base de datos. Incluya el nombre de propietario y la tabla, como en ggadmin.ggs_checkpoint. Este argumento sustituye cualquier especificación CHECKPOINTTABLE por defecto en el archivo GLOBALS. La tabla se debe agregar primero con el comando ADD CHECKPOINTTABLE.

Para las bases de datos que no son de destino Oracle, si se especifica NODBCHECKPOINT, el grupo de Replicat no escribirá puntos de Control en una tabla de puntos. Este argumento sustituye cualquier especificación CHECKPOINTTABLE por defecto en el archivo GLOBALS. Este argumento es necesario si no desea utilizar una tabla de puntos de control con el grupo de Replicat que se va a crear.

Para el destino de Oracle AI Database, Oracle GoldenGate 26ai y versiones posteriores no soportarán el parámetro NODBCHECKPOINT al agregar un Replicat. Después de actualizar a Oracle GoldenGate 26ai, si el Replicat existente para Oracle AI Database se ha creado con NODBCHECKPOINT y no se ha especificado ningún punto de control de base de datos por defecto en GLOBALS, Replicat finaliza de forma anormal al iniciar. Para evitarlo, debe realizar una de las siguientes tareas:

Opción 1: Oracle recomienda especificar una tabla de puntos de control de base de datos por defecto en GLOBALS

o bien

Opción 2: cree un nuevo Replicat con una tabla de puntos de control especificada y reinicie desde SCN, que reemplaza el Replicat con la nueva versión.

DESC ‘description’

Especifica una descripción del grupo, como 'Loads account_tab on Serv2'. Introduzca la descripción entre comillas.

ENCRYPTIONPROFILE

Especifica el nombre del perfil de cifrado para el Replicat.

CRITICAL

Indica si el proceso es crítico para el despliegue.

PROFILE

Nombre del perfil de inicio automático.

AUTOSTART

Especifica si el proceso gestionado se tiene que iniciar automáticamente cuando se inicia el servicio de administración. El valor por defecto es YES.

DELAY

Tiempo de espera, en segundos, antes de iniciar el proceso.

AUTORESTART

Controla cómo se reiniciará el proceso en caso de que termine.

RETRIES

Número máximo de intentos para reiniciar la tarea antes de cancelar los esfuerzos de reintento. Esto es opcional.

WAITSECONDS

Duración (en segundos) en la que se cuentan los reintentos.

RESETSECONDS

Restablece la duración en la que se cuentan los reintentos.

DISABLEONFAILURE

Si se define en TRUE, la tarea se desactiva cuando se agota el número de reintentos.

Ejemplos

En el siguiente ejemplo se agrega un Replicat integrado denominado reps. La salida se muestra utilizando el comando INFO.

ADD REPLICAT reps, INTEGRATED, EXTTRAIL ea, checkpointtable ggadmin.ckpt1

El resultado se muestra como:

2019-11-21T20:01:10Z  INFO    OGG-08100  REPLICAT (Integrated) added.

A continuación se muestra un ejemplo de adición de un Replicat paralelo denominado repw.

ADD REPLICAT repw, INTEGRATED, PARALLEL, EXTTRAIL ea, checkpointtable ggadmin.ggs_checkpoint

La salida muestra:

2019-11-21T20:07:26Z  INFO    OGG-08100  REPLICAT (Parallel) added.