EXTTRAIL

Válido para

Extracción

Descripción

Utilice el parámetro EXTTRAIL para especificar una pista en el sistema local que se creó con el comando ADD EXTTRAIL. La pista se lee mediante una ruta de distribución o mediante un Replicat en el sistema local.

EXTTRAIL debe preceder a todas las sentencias TABLE asociadas. Se pueden utilizar varias sentencias EXTTRAIL para definir diferentes pistas para un Extract, excepto para un Extract MySQL al utilizar el posicionamiento del juego de GTID, ya que solo se soporta una pista.

A partir de Oracle GoldenGate 19c, el Extract principal escribe los archivos de pista con el mismo formato que el formato de los archivos de pista existentes durante un cambio de versión, a menos que especifique explícitamente la versión del formato de archivo de pista mediante la opción FORMAT RELEASE. Esto evita que los Replicats posteriores se acaben de forma anormal si no se actualizan.

Puede cifrar los datos de esta pista mediante el parámetro ENCRYPTTRAIL. Consulte "ENCRYPTTRAIL \| NOENCRYPTTRAIL" para obtener más información.

Nota: Al utilizar el parámetro ENCRYPTRAIL con el parámetro EXTTRAIL, asegúrese de que el parámetro ENCRYPTRAIL se menciona antes que EXTTRAIL; de lo contrario, la pista no se cifrará.

Nota: Las pistas locales que debe consumir una ruta de distribución que envía a NSK, debe utilizar TRAILBYTEORDER BIGENDIAN. No se puede modificar en el pump de datos.

Valor por defecto

Ninguno

Sintaxis

EXTTRAIL <file_name>
[, FORMAT RELEASE <major>.<minor>]
[, TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}]

<trail_name>

Nombre de ruta de acceso relativa o totalmente cualificada de la pista. El nombre de pista solo puede contener dos caracteres.

Nota: En Microservices Architecture, el prefijo del nombre de archivo de pista de dos caracteres debe empezar solo con un carácter alfabético.

Oracle GoldenGate agrega este nombre con un número de secuencia de nueve dígitos siempre que se crea un nuevo archivo. Por ejemplo, una pista denominada /tr tendría archivos denominados /tr000000001, /tr000000002.

FORMAT RELEASE <major.minor>

Válido para un Extract. Especifica el formato de metadatos de los datos que envía Extract a una pista, un archivo o (si se trata de una tarea remota) a otro proceso. Los metadatos indican al proceso del lector si los registros de datos son de una versión que éste soporte. El formato de los metadatos depende de la versión del proceso de Oracle GoldenGate. Las versiones anteriores de Oracle GoldenGate contienen metadatos distintos a los de las más recientes.

FORMAT RELEASE especifica una versión de Oracle GoldenGate. major es el número del versión principal, y minor es el número del secundario. Los valores major.minor deben reflejar una Versión actual o anterior disponible de manera generalizada (GA) de Oracle GoldenGate. Los valores válidos son de 11,2 a través del número de versión X.x de Oracle GoldenGate actual, por ejemplo, 23,26 o 19,1.

La versión se asigna de forma programática al nivel de compatibilidad de formato de pista adecuado. El valor por defecto es la versión actual del proceso que escribe en esta pista. Nota: Las versiones RELEASE anteriores a la 12.1 no soportan nombres de objeto de tres partes.

Nota: Si se utilizan varias pistas en un único Extract, solo pueden coexistir las versiones RELEASE que son iguales.

TRAILBYTEORDER {BIGENDIAN

LITTLEENDIAN

NATIVEENDIAN}

Define el formato de bytes de los archivos de pista. Válido solo para pistas que tengan una versión FORMAT RELEASE de al menos 12.1. Los valores válidos son BIGENDIAN (big endian), LITTLEENDIAN (little endian) y NATIVEENDIAN. El valor por defecto es NATIVEENDIAN. Consulte la versión GLOBALS de TRAILBYTEORDER para obtener instrucciones de uso adicionales.

Ejemplos

Ejemplo 1

EXTTRAIL ny

Ejemplo 2

En Linux:

EXTTRAIL trails/ny, FORMAT RELEASE 12.3

Ejemplo 3

En Windows:

EXTTRAIL trails\ny, FORMAT RELEASE 12.3

Ejemplo 4

Dos formatos de pista dentro de los mismos juegos de tablas que se capturan:

EXTTRAIL ea
TABLE hr.tab1
TABLE hr.tab2
EXTTRAIL eb
TABLE scott.tab3
TABLE scott.tab4