DISCARDFILE | NODISCARDFILE

Valido per

Estrai e Replicat

Descrizione

Utilizzare il parametro DISCARDFILE per effettuare le operazioni riportate di seguito.

• Personalizzare il nome, la posizione, le dimensioni e la modalità di scrittura del file eliminato. Per impostazione predefinita, ogni volta che viene avviato un processo con il comando START viene generato un file ignorato. Per mantenere le proprietà predefinite, non è necessario un parametro DISCARDFILE.

• Specificare l'uso di un file di scarto per i metodi di elaborazione in cui il processo inizia dalla riga di comando del sistema operativo e non viene creato un file di scarto per impostazione predefinita.

Utilizzare il parametro NODISCARDFILE per disabilitare l'uso di un file dei dati scartati. Se si utilizza NODISCARDFILE con DISCARDFILE, il processo viene interrotto.

Quando si utilizza DISCARDFILE, utilizzare l'opzione PURGE o APPEND. In caso contrario, è necessario specificare un nome di file di scarto diverso prima di avviare ogni esecuzione del processo, poiché Oracle GoldenGate non scriverà in un file di scarto esistente senza una di queste istruzioni e terminerà.

Vedere "DISCARDROLLOVER" per informazioni su come controllare la frequenza di trasferimento del file eliminato in un nuovo file.

Per ulteriori informazioni sul file di scarto, vedere Panoramica sulla gestione degli errori di Oracle GoldenGate.

Predefinito

Se un processo viene avviato con il comando START, viene generato un file di scarto come indicato di seguito.

• Il nome del file deriva dal processo che lo crea, con estensione .dsc. Se il processo è un Replicat coordinato, genera un file per thread. Ogni nome file viene aggiunto al thread ID del thread corrispondente.

• Il file viene creato nella sottodirectory dirrpt della directory di installazione di Oracle GoldenGate.

• La dimensione massima del file è 50 MB

• All'avvio, se esiste un file di scarto, viene rimosso prima della scrittura dei nuovi dati.

• Il nome file massimo è di 250 caratteri inclusa la directory.

Quando si avvia un processo dalla riga di comando del sistema operativo, non è necessario generare un file di scarto per impostazione predefinita.

Sintassi

DISCARDFILE { [<file_name>]
[, APPEND | PURGE]
[, MAXBYTES <n> | MEGABYTES <n>] } |
NODISCARDFILE

DISCARDFILE

Indica che il nome o l'altro attributo del file eliminato è in fase di modifica.

<file_name>

Nome relativo o completamente qualificato del file eliminato, incluso il nome file effettivo. Per un Replicat coordinato, specificare un nome di file fino a cinque caratteri, perché ogni nome di file viene aggiunto al thread ID del thread che lo scrive. Per memorizzare il file nella directory Oracle GoldenGate, è sufficiente un nome di percorso relativo, poiché Oracle GoldenGate qualifica il nome con la directory di installazione di Oracle GoldenGate.

APPEND

Aggiunge nuovo contenuto al contenuto esistente se il file esiste già. Se non si utilizzano né APPEND né PURGE, è necessario specificare un nome file di scarto diverso prima di avviare ogni esecuzione del processo.

PURGE

Rimuove il file prima di scrivere nuovo contenuto. Se non si utilizzano né PURGE né APPEND, è necessario specificare un nome file di scarto diverso prima di avviare ogni esecuzione del processo.

MAXBYTES <n>

Imposta la dimensione massima del file in byte. L'intervallo valido è compreso tra 1 e 4096967295. Il valore predefinito è 3000000. Se la dimensione specificata viene superata, il processo si interrompe.

MEGABYTES <n>

Imposta la dimensione massima del file in megabyte. L'intervallo valido è compreso tra 1 e 4096. L'impostazione predefinita è 3. Se la dimensione specificata viene superata, il processo si interrompe.

NODISCARDFILE

Impedisce al processo di creare un file di scarto.

Esempio

Esempio 1

Questo esempio specifica un nome di file e un'estensione non predefiniti, una modalità di scrittura non predefinita e una dimensione massima del file non predefinita. Questo esempio mostra come è possibile modificare le proprietà predefinite di un file di scarto per un processo in linea o specificare l'uso di un file di scarto per un processo che inizia dalla riga di comando del sistema operativo e non dispone di un file di scarto per impostazione predefinita.

DISCARDFILE .dirrpt/discard.txt, APPEND, MEGABYTES 20

Esempio 2

In questo esempio viene modificata solo la modalità di scrittura del file di scarto predefinito per un processo online.

DISCARDFILE .dirrpt/finance.dsc, APPEND

Esempio 3

In questo esempio viene disabilitato l'uso di un file di scarto per un processo in linea.

NODISCARDFILE