ADD EXTTRAIL

Utilizzare ADD EXTTRAIL per creare un trail per l'elaborazione in linea nel sistema locale e:

associare il trail a un gruppo Extract;
assegnare la dimensione massima del file.
Quando si tenta di creare più file trail utilizzando ADD EXTTRAIL, da un singolo processo Extract, l'operazione non riuscirà se il numero di file trail supera un determinato limite. In particolare, quando vengono creati più di 12 percorsi, può verificarsi il seguente errore:
```
2025-11-05T21:16:04Z  INFO    OGG-08100  Exceeded checkpoint record size (32,768/32,767) in

checkpoint file /path/to/checkpoint/file.cpe.
```
Questo errore si verifica a causa del file di checkpoint che supera il limite di dimensione di 32.767 record. Il file di checkpoint contiene CSN (Commit Sequence Number), XID (Transaction ID) e numeri di record, che contribuiscono alla dimensione del file.

Per evitare questo errore, si consiglia di non creare più file trail da un singolo Extract, in particolare per motivi di prestazioni. L'approccio preferito consiste nel fare in modo che un'unica estrazione acquisisca tutti i dati richiesti e utilizzi il servizio di distribuzione per distribuirli a destinazioni diverse.

Un'altra opzione alternativa è quella di eseguire più processi Extract se è necessario ridurre la dimensione del file trail per ogni singola destinazione.

Consulta EXTTRAIL in Riferimento su parametri e funzioni per Oracle GoldenGate

Sintassi

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

trail_name

Nome trail a due caratteri. Si consiglia che entrambi i caratteri siano alfabetici, ma il primo carattere non deve essere un numero. Oracle GoldenGate aggiunge questo nome a un numero di sequenza costituito da nove cifre a ogni creazione di un nuovo file.

Il nome del trail può anche essere preceduto da una directory. Ad esempio, per un trail denominato north/ea ai file Verrebbero assegnati i nomi ea000000000, ea000000001 nella sottodirectory $OGG_DATA_HOME/north.

group_name

Nome del gruppo Extract al quale è associato il trail. Un trail può essere assegnato a un solo Extract. Più Extract non possono scrivere nello stesso trail. Tuttavia, un Extract può scrivere in più trail distinti se necessario, ma in genere non lo è.

MEGABYTES n

Dimensione massima, in megabyte, di ogni file di trail nella sequenza. Il valore predefinito è 500 MB e il valore massimo è 2000 MB.

SEQNO n

Specifica che il primo file nel trail verrà avviato con il numero di sequenza trail specificato. Non includere zeri di riempimento. Ad esempio, per avviare il file dalla sequenza 3 di un trail denominato tr, specificare SEQNO 3. Al file effettivo verrebbe assegnato il nome /ea000000003. Questa opzione può essere utilizzata durante la risoluzione dei problemi quando Replicat deve essere riposizionato su un determinato numero della sequenza trail. L'opzione evita di ricorrere alla modifica di Replicat per leggere il numero della sequenza richiesto. Il valore predefinito è 1.

Limitazioni

Quando si crea un trail Extract con lo stesso nome di un trail Extract precedente, assicurarsi che tutti i trail in tale directory con lo stesso trail_name siano stati eliminati.

Quando si esegue l'acquisizione da un database MySQL abilitato per la replica dei gruppi, è consentito un solo trail per ciascun Extract.

Esempi

Il comando seguente crea un nome trail ea:

ADD EXTTRAIL north/ea, EXTRACT exte, MEGABYTES 200

Di seguito è riportato l'output visualizzato.

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