EXTTRAIL

Valido per

Extract

Descrizione

Utilizzare il parametro EXTTRAIL per specificare un trail nel sistema locale creato con il comando ADD EXTTRAIL. Il percorso viene letto da un percorso di distribuzione o da un Replicat sul sistema locale.

EXTTRAIL deve precedere tutte le istruzioni TABLE associate. È possibile utilizzare più istruzioni EXTTRAIL per definire percorsi diversi per un'estrazione, ad eccezione di un'estrazione MySQL quando si utilizza il posizionamento del set GTID come un solo trail.

A partire da Oracle GoldenGate 19c, Extract primario scrive i file trail nello stesso formato del formato dei file trail esistenti durante un aggiornamento, a meno che non si specifichi esplicitamente la versione del formato del file trail utilizzando l'opzione FORMAT RELEASE. Ciò impedisce ai Replicat successivi di interrompere se non vengono aggiornati.

È possibile cifrare i dati in questo trail utilizzando il parametro ENCRYPTTRAIL. Per ulteriori informazioni, vedere "ENCRYPTTRAIL \| NOENCRYPTTRAIL".

Nota: quando si utilizza il parametro ENCRYPTRAIL con il parametro EXTTRAIL, assicurarsi che il parametro ENCRYPTRAIL sia menzionato prima di EXTTRAIL, altrimenti il trail non verrà cifrato.

Nota: gli trail locali che devono essere utilizzati da un percorso di distribuzione che invia a NSK, è necessario utilizzare TRAILBYTEORDER BIGENDIAN. Non è possibile modificare questa impostazione nel Data Pump.

Predefinito

Nessuno

Sintassi

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

<trail_name>

Nome percorso relativo o completamente qualificato del trail. Il nome del trail può contenere solo due caratteri.

Nota: nell'architettura dei microservizi il prefisso di due caratteri dei nomi del file di trail deve iniziare solo con una lettera.

Oracle GoldenGate aggiunge questo nome a un numero di sequenza costituito da nove cifre a ogni creazione di un nuovo file. Ad esempio, per un trail denominato /tr ai file Verrebbero assegnati i nomi /tr000000001, /tr000000002.

FORMAT RELEASE <major.minor>

Valido per un'estrazione. Specifica il formato dei metadati dei dati inviati da Extract a un trail, a un file oppure, nel caso di un task remoto, a un altro processo. I metadati indicano al processo di lettura se i record dei dati sono di una versione supportata. Il formato dei metadati dipende dalla versione del processo Oracle GoldenGate. Le versioni meno recenti di Oracle GoldenGate contengono metadati diversi da quelli delle nuove versioni.

FORMAT RELEASE specifica una versione di release di Oracle GoldenGate. major è il numero della versione principale e minor è il numero della versione secondaria. I valori major.minor devono indicare una release corrente o precedente, generalmente disponibile (GA) di Oracle GoldenGate. I valori validi sono dalla versione 11.2 al numero di versione X.x di Oracle GoldenGate corrente, ad esempio 23.26 o 19.1.

La versione della release viene mappata a livello di programmazione al livello di compatibilità del formato di trail appropriato. L'impostazione predefinita è la versione corrente del processo che esegue le operazioni scrittura nel trail. Nota: le versioni di RELEASE anteriori alla 12.1 non supportano i nomi oggetto a tre partizioni.

Nota: se si utilizzano più trail in una sola estrazione, possono coesistere anche solo le versioni RELEASE uguali.

TRAILBYTEORDER {BIGENDIAN

LITTLEENDIAN

NATIVEENDIAN}

Imposta il formato byte dei file trail. Valido solo per i trail con versione FORMAT RELEASE almeno 12.1. I valori validi sono BIGENDIAN (big endian), LITTLEENDIAN (little endian) e NATIVEENDIAN. L'impostazione predefinita è NATIVEENDIAN. Per ulteriori istruzioni sull'uso, vedere la versione GLOBALS di TRAILBYTEORDER.

Esempi

Esempio 1

EXTTRAIL ny

Esempio 2

In Linux:

EXTTRAIL trails/ny, FORMAT RELEASE 12.3

Esempio 3

In Windows:

EXTTRAIL trails\ny, FORMAT RELEASE 12.3

Esempio 4

Due formati trail all'interno degli stessi set di tabelle acquisite:

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