defgen

Nota: assicurarsi di impostare le variabili di ambiente come descritto nella sezione Programmi Oracle GoldenGate per poter utilizzare la utility DEFGEN.

Utilizzare la utility DEFGEN per generare le definizioni dei metadati della tabella di origine, che può essere utilizzata da Replicat per leggere da un file trail in una release di formato precedente a Oracle GoldenGate 12.2 e che non contiene metadati della tabella di origine. Il programma DEFGEN viene installato nella directory bin della home di Oracle GoldenGate.

Sintassi per Windows, UNIX e Linux

defgen PARAMFILE <parameter_file>
[NOEXTATTR]
[PAUSEATEND | NOPAUSEATEND]
[REPORTFILE <report_file>]
[UPDATECS <characterset> ]

PARAMFILE <parameter_file>

Obbligatorio Specifica il percorso relativo o assoluto del file dei parametri per il programma DEFGEN in esecuzione. Il file dei parametri deve essere creato manualmente e elencherà un file defs per l'output della definizione della tabella, le informazioni di connessione al database e le tabelle per generare le definizioni.

NOEXTATTR

Può essere utilizzato per supportare la compatibilità con le versioni precedenti di Oracle GoldenGate precedenti alla Release 11.2.1 e non supporta set di caratteri diversi da ASCII, né distinzione tra maiuscole e minuscole o nomi di oggetti racchiusi tra virgolette con spazi. NOEXTATTR impedisce a DEFGEN di includere le impostazioni nazionali e il set di caratteri del database che supportano le funzioni di globalizzazione introdotte in Oracle GoldenGate Release 11.2.1. Se il nome della tabella o della colonna contiene caratteri multibyte o speciali, ad esempio spazi vuoti, DEFGEN non include la definizione della tabella quando viene specificato NOEXTATTR. Se nel file dei parametri viene utilizzata la modalità APPEND, NOEXTATTR viene ignorato e la nuova definizione della tabella viene aggiunta nel formato di file esistente, indipendentemente dal fatto che si tratti di attributi aggiuntivi o meno.

PAUSEATEND

NOPAUSEATEND (predefinito)

(Solo Windows) Quando il processo si arresta, richiede a un utente di Oracle GoldenGate di esaminare l'output della console e quindi individuare qualsiasi chiave per cancellarlo. Indica anche se il processo è terminato normalmente o in modo anomalo.

REPORTFILE <report_file>

Invia l'output del comando al file di report specificato. Senza l'opzione reportfile, l'output del comando viene stampato sullo schermo.

defs_file UPDATECS <charset>

Converte il set di caratteri di un file di definizioni in un set di caratteri diverso se il file viene trasferito in un sistema operativo con un set di caratteri incompatibile. Questa procedura utilizza come input il nome del file delle definizioni e il set di caratteri di destinazione. Ad esempio: defgen source.def UPDATECS UTF-8.

UPDATECS aiuta in situazioni come quando un nome di tabella giapponese su Windows giapponese viene scritto in Windows CP932 nel file delle definizioni dei dati e quindi il file delle definizioni viene trasferito in UNIX giapponese. Il file non può essere utilizzato a meno che UNIX non sia configurato nella versione locale PCK. Pertanto, è necessario utilizzare UPDATECS per convertire la codifica del file delle definizioni nel formato corretto.

Esempio

Di seguito è riportato un esempio di file dei parametri DEFGEN, defgenparam.prm. Per ulteriori informazioni, vedere il parametro DEFSFILE.

DEFSFILE /home/oracle/ogg/ora/bin/ora.defs, PURGE
USERIDALIAS oracle_source
TABLE hr.employees;

Per eseguire il programma DEFGEN, usare il comando seguente:

$OGG_HOME/bin/defgen PARAMFILE defgenparam.prm