ADD EXTTRAIL

Utilice ADD EXTTRAIL para crear una pista para la ejecución en línea en el sistema local y:

Asócielo con un grupo de Extract.
Asignar un tamaño de archivo máximo.
Al intentar crear varios archivos de pista mediante ADD EXTTRAIL, a partir de un único proceso de extracción, la operación fallará si el número de archivos de pista supera un determinado límite. Específicamente, cuando se crean más de 12 pistas, se puede producir el siguiente error:
```
2025-11-05T21:16:04Z  INFO    OGG-08100  Exceeded checkpoint record size (32,768/32,767) in

checkpoint file /path/to/checkpoint/file.cpe.
```
Este error se produce debido a que el archivo de punto de control supera el límite de tamaño de 32 767 registros. El archivo de punto de control contiene CSN (número de secuencia de confirmación), XID (ID de transacción) y números de registro, que contribuyen al tamaño del archivo.

Para evitar este error, se recomienda no crear varios archivos de pista a partir de un único Extract, especialmente por motivos de rendimiento. El enfoque preferido es que una sola extracción capture todos los datos necesarios y utilice el servicio de distribución para distribuirlos a diferentes destinos.

Otra opción alternativa es ejecutar varios procesos de extracción si es necesario reducir el tamaño del archivo de pista para cada destino individual.

Consulte EXTTRAIL en la Referencia de parámetros y funciones para Oracle GoldenGate

Sintaxis

ADD EXTTRAIL trail_name, EXTRACT group_name
[, MEGABYTES n]
[SEQNO n]

trail_name

Nombre de pista de dos caracteres. Se recomienda que ambos caracteres sean alfabéticos, pero el primer carácter no debe ser un número. Oracle GoldenGate agrega este nombre con un número de secuencia de nueve dígitos siempre que se crea un nuevo archivo.

El nombre de pista también puede tener un prefijo con un directorio. Por ejemplo, una pista denominada north/ea tendría archivos de pista denominados ea000000000, ea000000001 en el subdirectorio $OGG_DATA_HOME/north.

group_name

Nombre del grupo de Extract al que está enlazada la pista. Una pista solo se puede asignar a un Extract. Varios Extracts no pueden escribir en la misma pista. Sin embargo, un Extract puede escribir en varias pistas distintas si es necesario, pero esto no es necesario normalmente.

MEGABYTES n

Tamaño máximo, en megabytes, de cada archivo de pista en la secuencia. El valor por defecto es 500 MB y el valor máximo es 2000 MB.

SEQNO n

Especifica que el primer archivo de la pista empezará con el número de secuencia de pista especificado. No incluya ningún valor cero de relleno. Por ejemplo, para empezar en las secuencias 3 de una pista denominada tr, especifique SEQNO 3. El archivo real se denominaría /ea000000003. Esta opción se puede utilizar durante la resolución de problemas cuando sea necesario reposicionar Replicat a un número determinado de secuencia de pista. Elimina la necesidad de modificar Replicat para leer el número que es necesario. El valor por defecto es 1.

Limitaciones

Al crear una pista de Extract con el mismo nombre que una pista de Extract anterior, asegúrese de que se han suprimido todas las pistas de ese directorio con el mismo trail_name.

Al realizar la captura desde una base de datos MySQL activada para replicación de grupos, solo se permite una pista para un Extract.

Ejemplos

El siguiente comando crea un nombre de pista ea:

ADD EXTTRAIL north/ea, EXTRACT exte, MEGABYTES 200

La salida se muestra de la siguiente manera:

2019-11-20T23:49:19Z  INFO    OGG-08100  EXTTRAIL added.