DEF.FILE

Valido per

DEFGEN

Descrizione

Utilizzare il parametro DEFSFILE per identificare il nome del file in cui DEFGEN scriverà le definizioni dei dati. Per impostazione predefinita, il file delle definizioni dei dati viene scritto nel set di caratteri del sistema operativo locale. Il set di caratteri può essere modificato con l'opzione CHARSET.

Predefinito

Nessuno

Sintassi

DEFSFILE <file_name> [APPEND | PURGE] [CHARSET <character_set>] [FORMAT RELEASE <major>.<minor>]

<file_name>

Nome file relativo o completamente qualificato. Il file viene creato quando si esegue DEFGEN.

APPEND

Indica a DEFGEN di scrivere nuovo contenuto (dall'esecuzione corrente) alla fine di qualsiasi contenuto esistente, se il file specificato esiste già. Se il file delle definizioni esiste già, ma è di una versione precedente della release di Oracle GoldenGate, è possibile impostare l'opzione FORMAT RELEASE sulla stessa versione del file esistente per evitare errori. In caso contrario, DEFGEN tenterà di aggiungere nuove funzioni di metadati e di interrompere. Di seguito sono riportate le limitazioni per l'utilizzo di APPEND.

• Se il file delle definizioni dati esistente è in un formato precedente a Oracle GoldenGate 11.2.1, DEFGEN aggiunge le definizioni di tabella nel vecchio formato, in cui i nomi di tabella e colonna con caratteri multibyte e speciali non sono supportati.

• Se il file delle definizioni dati esistente è nel formato più recente introdotto nella versione 11.2.1, DEFGEN aggiunge le definizioni di tabella nel set di caratteri esistente del file.

• Se il file esistente proviene dalla versione 11.2 o precedente, è stato scritto quando DEFGEN non supporta i nomi degli oggetti in tre parti e causerà un errore se i nuovi metadati contengono nomi in tre parti. È possibile specificare oggetti da un container database Oracle se si rimuove la parte contenitore o catalogo utilizzando il parametro NOCATALOG nel file dei parametri DEFGEN.

PURGE

Indica a DEFGEN di rimuovere il file specificato prima di scrivere il nuovo contenuto dall'esecuzione corrente. Quando si utilizza PURGE, è possibile sovrascrivere un file di definizioni esistente creato da una versione precedente di DEFGEN con metadati più recenti che supportano funzioni più recenti, ad esempio nomi di oggetti in tre parti.

CHARSET <character_set>

Genera il file delle definizioni nel set di caratteri specificato. Senza CHARSET, viene utilizzato il set di caratteri predefinito del sistema operativo. Se la modalità APPEND è specificata per un file di definizioni con versione 11.2.1 o successiva, CHARSET viene ignorato e viene utilizzato il set di caratteri del file di definizioni esistente.

FORMAT RELEASE <major.minor>

Specifica il formato dei metadati delle definizioni inviate da DEFGEN al file delle definizioni. I metadati indicano al processo del lettore se i record dei file 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. Utilizzare FORMAT quando il file delle definizioni verrà utilizzato da un processo di una versione precedente di Oracle GoldenGate rispetto a quella corrente.

• FORMAT è una parola chiave obbligatoria.

• 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 dalla versione 9.0 al numero di versione X.x di Oracle GoldenGate corrente, ad esempio 11.2 o 12.1. Se si utilizza una versione di Oracle GoldenGate precedente alla 9.0, specificare la versione 9.0 o 9.5.

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

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 11.1 e il numero di versione X.x di Oracle GoldenGate corrente, ad esempio 11.2 o 12.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.

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, è supportata l'impostazione FORMAT RELEASE 12.2 o versione successiva.

• Per Oracle Database 12.2 non CDM o versione successiva con compatibilità impostata su 12.2, è supportata l'impostazione FORMAT RELEASE 12.2 o versione successiva.

• Per Oracle Database 12.2 CDB/PDB o versione successive con compatibilità impostata su 12.2, sono supportati solo valori FORMAT RELEASE 12.3 o versione successiva. 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.

Esempio

DEFSFILE ./dirdef/orcldef CHARSET ISO-8859-11 FORMAT RELEASE 11.2