FILE ESTERNO

Valido per

Estrai e Replicat

Descrizione

Utilizzare il parametro EXTFILE per specificare un file di estrazione nel sistema locale che verrà creato da Extract di caricamento iniziale e letto da Replicat di caricamento iniziale quando si utilizza SPECIALRUN.

Utilizzare questo parametro per le configurazioni di caricamento iniziale. Per la sincronizzazione delle modifiche in linea, utilizzare il parametro EXTTRAIL.

EXTFILE deve precedere tutte le istruzioni TABLE o MAP associate. È possibile utilizzare più istruzioni EXTFILE per definire file diversi.

Replicat supporta solo il valore file_name e nessuna opzione.

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

Predefinito

Nessuno

Sintassi

EXTFILE <file_name>
[ APPEND]
[, PURGE]
[, FORMAT RELEASE <major>.<minor>]
[, MEGABYTES <megabytes>]
[, OBJECTDEFS]
[, TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}]

<file_name>

Nome relativo o completamente qualificato del trail. Utilizzare solo due caratteri per il nome del trail. Se si utilizzano più di due caratteri, verrà creato il file con quel nome, ma senza alcun numero di sequenza. Quando i file trail invecchiano, a questo nome verrà aggiunto un numero di sequenza di sei caratteri, ad esempio /ogg/dirdat/ef000001. Se si utilizza FORMAT RELEASE 12.2 o versioni precedenti, il file trail creato è un file statico che non aumenta e la convenzione di denominazione non è limitata a due caratteri.

APPEND

Aggiunge i dati correnti ai dati esistenti nel file. Se si utilizza APPEND, non utilizzare PURGE.

PURGE

Elimina un file esistente prima di crearne uno nuovo. Se si utilizza PURGE, non utilizzare APPEND.

FORMAT RELEASE <major.minor>

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. X.x deve indicare una release corrente o precedente, generalmente disponibile (GA) di Oracle GoldenGate. I valori validi sono compresi tra la versione 12.2 e il numero di versione X.x di Oracle GoldenGate corrente, ad esempio 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.2 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.

Per Oracle Database 12.2 e versioni successive sono supportate le impostazioni riportate di seguito.

• Per Oracle Database 12.2 non CDM o versione successive con compatibilità impostata su 12.1 o versione successiva, è supportata l'impostazione FORMAT RELEASE 12.2 o versione successive a causa del valore SCN più grande.

• Per Oracle Database 12.2 CDB/PDB o versione successive con compatibilità impostata su 12.2 o versione successiva, sono supportati solo i valori FORMAT RELEASE 12. e versioni successive. Ciò è dovuto all'uso dell'undo locale per i PDB, che richiede l'aggiunta del numero della transazione ID al PDB per garantire l'univocità degli ID trx.

MEGABYTES <megabytes>

Dimensione massima, in megabyte, di un file nel trail. L'impostazione predefinita è 2000.

OBJECTDEFS

Utilizzare l'opzione OBJECTDEFS per includere le definizioni degli oggetti nel trail. Questa opzione è applicabile solo se il trail di output è formattato in formato canonico Oracle GoldenGate e la release del formato trail è successiva alla 12.2. In caso contrario, questa opzione viene ignorata poiché non verrà aggiunto alcun record di metadati al trail.

TRAILBYTEORDER {BIGENDIAN

LITTLEENDIAN

NATIVEENDIAN}

Imposta il formato byte dei file trail. Valido solo per i file trail con versione FORMAT RELEASE almeno 12.2. 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

EXTFILE dirdat/ef

Esempio 2

EXTFILE dirdat/ef, MEGABYTES 200

Esempio 3

EXTFILE /ggs/dirdat/extdat, FORMAT RELEASE 18.1