@GETENV

Utilisez la fonction @GETENV pour renvoyer des informations sur l'environnement Oracle GoldenGate. Vous pouvez utiliser les informations en tant qu'entrées dans les éléments suivants :

Procédures ou requêtes stockées (avec SQLEXEC)
Correspondances de colonne (avec l'option COLMAP de TABLE ou MAP)
Jetons utilisateur (définis avec l'option TOKENS de TABLE et mis en correspondance avec les colonnes cible à l'aide de la fonction @TOKEN)
La fonction d'exit utilisateur GET_ENV_VALUE (voir "GET_ENV_VALUE")

Remarque : Toutes les options de syntaxe doivent être placées entre guillemets, comme indiqué dans les descriptions de syntaxe.
Extrayez la valeur du paramètre DB_UNIQUE_NAME des bases de données source ou cible, en fonction des processus (extraction ou réplication) qui exécutent la fonction.

Syntaxe

@GETENV (
'LAG' , '<unit>' |
'LASTERR' , '<error_info>' |
'JULIANTIMESTAMP' |
'JULIANTIMESTAMP_PRECISE' |
'RECSOUTPUT' |
{'STATS'|'DELTASTATS'}, ['TABLE', '<table>'], '<statistic>' |
'GGENVIRONMENT', '<environment_info>' |
'GGFILEHEADER', '<header_info>'|
'GGHEADER', '<header_info>' |
'RECORD', '<location_info>' |
'DBENVIRONMENT', '*<database_info>,*',
'TRANSACTION', '<transaction_info>' |
'OSVARIABLE', '<variable>' |
'TLFKEY', SYSKEY, <unique_key>
'USERNAME',
'OSUSERNAME',
'MACHINENAME',
'PROGRAMNAME',
'CLIENTIDENTIFIER',
'SOURCEDATABASEINFO'
)

`'LAG' , '<unit>'`

Valide pour l'extraction et le réplication.

Utilisez l'option LAG de @GETENV pour renvoyer des informations de décalage. Le décalage est la différence entre l'heure à laquelle un enregistrement a été traité par l'extraction ou l'horloge système et l'horodatage de cet enregistrement dans la source des données.

Syntaxe

SEC

‘SEC’

Renvoie le décalage en secondes. Il s'agit de la valeur par défaut lorsqu'une unité n'est pas explicitement fournie pour LAG.

‘MSEC’

Renvoie le décalage en millisecondes.

‘MIN’

Renvoie le décalage en minutes.

`'LASTERR' , '<error_info>'`

Valide pour la réplication.

Utilisez l'option LASTERR de @GETENV pour renvoyer des informations sur la dernière opération ayant échoué traitée par le processus de réplication.

Syntaxe

@GETENV ('LASTERR', {'DBERRNUM'|'DBERRMSG'|'OPTYPE'|'ERRTYPE'})

‘DBERRNUM’

Renvoie le numéro d'erreur de base de données associé à l'opération ayant échoué.

‘DBERRMSG’

Renvoie le message d'erreur de base de données associé à l'opération ayant échoué.

‘OPTYPE’

Renvoie le type d'opération tenté.

‘ERRTYPE’

Renvoie le type de l'erreur. Les résultats possibles sont les suivants :

DB (pour les erreurs de base de données)
MAP (pour les erreurs de mapping)

'JULIANTIMESTAMP'|'JULIANTIMESTAMP_PRECISE'

Valide pour l'extraction et le processus de réplication.

Utilisez l'option JULIANTIMESTAMP de @GETENV pour renvoyer l'heure actuelle au format julien. L'unité est de microsecondes (un millionième de seconde). Sur une machine Windows, la valeur est complétée par des zéros (0) car la granularité de l'horodatage Windows est de la milliseconde (millième de seconde). Par exemple, le mapping de colonne suivant est classique :

MAP dbo.tab8451, Target targ.tabjts, COLMAP (USEDEFAULTS, &
JTSS = @GETENV ('JULIANTIMESTAMP')
JTSFFFFFF = @date ('yyyy-mm-dd hh:mi:ss.ffffff', 'JTS', &
@getenv ('JULIANTIMESTAMP') ) )
;

Les valeurs possibles des colonnes JTSS et JTSFFFFFF sont :

212096320960773000 2010-12-17:16:42:
40.773000
212096321536540000 2010-12-17:16:52:16.540000
212096322856385000 2010-12-17:17:14:16.385000
212096323062919000 2010-12-17:17:17:42.919000
212096380852787000 2010-12-18:09:20:52.787000

Les trois derniers chiffres (les microsecondes) du nombre contiennent tous le remplissage de 0s .

Vous pouvez éventuellement utiliser l'option 'JULIANTIMESTAMP_PRECISE' pour obtenir un horodatage avec une grande précision, ce qui peut affecter les performances.

Remarque : N'utilisez pas ces valeurs pour les opérations de tri. Utilisez plutôt la valeur suivante : @COMPUTE(@COMPUTE(@NUMSTR(@GETENV ("RECORD", "FILESEQNO")*100000000000)+@NUMSTR(@GETENV ("RECORD", "FILERBA")))".

Syntaxe

@GETENV ('JULIANTIMESTAMP')
@GETENV ('JULIANTIMESTAMP_PRECISE')

'RECSOUTPUT'

Valide pour le processus d'extraction.

Utilisez l'option RECSOUTPUT de @GETENV pour extraire le nombre en cours d'enregistrements que le processus Extract a écrits dans le fichier trace depuis le démarrage du processus. La valeur renvoyée n'est pas unique pour une table ou une transaction, mais pour la session Extract elle-même. Le nombre est réinitialisé à 1 chaque fois que l'extraction s'arrête, puis redémarre.

Syntaxe

@GETENV ('RECSOUTPUT')

`{'STATS'|'DELTASTATS'}, ['TABLE', '<table>'], '<statistic>'`

Valide pour l'extraction et le processus de réplication.

Utilisez les options STATS et DELTASTATS de @GETENV pour renvoyer le nombre d'opérations qui ont été traitées par table pour tout ou partie des éléments suivants :

Opérations INSERT
Opérations UPDATE
Opérations DELETE
Opérations TRUNCATE
Nombre total d'opérations DML
Nombre total d'opérations DDL
Nombre de conflits survenus, si la fonction Détection et résolution des conflits (CDR) est utilisée.
Nombre de résolutions CDR réussies
Nombre de résolutions CDR ayant échoué

Toute erreur dans le traitement de cette fonction, telle qu'une entrée de table non résolue ou une syntaxe incorrecte, renvoie un zéro (0) pour la valeur de statistiques demandée.

Comprendre l'impact des spécifications de table récurrentes sur les nombres d'opérations

Une extraction qui traite la même table source vers plusieurs traces de sortie renvoie des statistiques en fonction de chaque trace de sortie localisée vers laquelle la table liée à @GETENV est écrite. Par exemple, si le processus Extract capture 100 insertions pour la table ABC et écrit la table ABC dans trois traces, le résultat de @GETENV est 300.

EXTRACT ABC
...
EXTTRAIL c:\north\aa;
TABLE TEST.ABC;
EXTTRAIL c:\north\bb;
TABLE TEST.ABC;
TABLE EMI, TOKENS (TOKEN-CNT = @GETENV ('STATS', 'TABLE', 'ABC', 'DML'));
EXTTRAIL c:\north\cc;
TABLE TEST.ABC;

Dans le cas d'une extraction qui écrit plusieurs fois une table source dans une trace de sortie unique, ou dans le cas d'une réplication qui comporte plusieurs instructions MAP pour la même table TARGET, les résultats des statistiques sont basés sur toutes les entrées TARGET correspondantes. Par exemple, si le processus Replicat filtre 20 lignes pour REGION 'WEST, 10 lignes pour REGION 'EAST, 5 lignes pour REGION 'NORTH et 2 lignes pour REGION 'SOUTH' (toutes pour la table ABC), le résultat de @GETENV est 37.

REPLICAT ABC
...
MAP TEST.ABC, TARGET TEST.ABC, FILTER (@STREQ (REGION, 'WEST'));
MAP TEST.ABC, TARGET TEST.ABC, FILTER (@STREQ (REGION, 'EAST'));
MAP TEST.ABC, TARGET TEST.ABC, FILTER (@STREQ (REGION, 'NORTH'));
MAP TEST.ABC, TARGET TEST.ABC, FILTER (@STREQ (REGION, 'SOUTH'));
MAP TEST.EMI, TARGET TEST.EMI, &
    COLMAP (CNT = @GETENV ('STATS', 'TABLE', 'ABC', 'DML'));

Capturer plusieurs statistiques

Vous pouvez exécuter plusieurs instances de @GETENV pour obtenir des nombres pour différents types d'opération.

Cet exemple renvoie des statistiques uniquement pour les opérations INSERT et UPDATE :

REPLICAT TEST
..
..
MAP TEST.ABC, TARGET TEST.ABC, COLMAP (USEDEFAULTS, IU = @COMPUTE (@GETENV &
    ('STATS', 'TABLE', 'ABC', 'DML') - (@GETENV ('STATS', 'TABLE', &
    'ABC', 'DELETE'));

Cet exemple renvoie des statistiques pour les opérations DDL et TRUNCATE :

REPLICAT TEST2
..
..
MAP TEST.ABC, TARGET TEST.ABC, COLMAP (USEDEFAULTS, DDL = @COMPUTE &
(@GETENV ('STATS', 'DDL') + (@GETENV ('STATS', 'TRUNCATE'));

Exemple de scénario d'utilisation

Dans le cas d'emploi suivant, si tous les éléments DML de la source sont appliqués à la cible, le processus Replicat suspend au moyen de EVENTACTIONS avec SUSPEND, jusqu'à ce qu'ils reprennent à partir de GGSCI avec SEND REPLICAT avec RESUME.

GETENV utilisé dans le fichier de paramètres d'extraction :

TABLE HR1.HR*;
TABLE HR1.STAT, TOKENS ('env_stats' = @GETENV ('STATS', 'TABLE', &
    'HR1.HR*', 'DML'));

GETENV utilisé dans le fichier de paramètres de réplication :

MAP HR1.HR*, TARGET HR2.*;
MAP HR1.STAT, TARGET HR2.STAT, filter (
    @if (
    @token ('stats') =
    @getenv ('STATS', 'TABLE', 'TSSCAT.TCUSTORD', 'DML'), 1, 0 )
    ),
    eventactions (suspend);

Utiliser des statistiques dans les clauses FILTER

Les statistiques renvoyées par STATS et DELTASTATS sont des valeurs dynamiques et sont incrémentées après l'exécution du mapping. Par conséquent, lorsque vous utilisez des statistiques CDR dans une clause FILTER dans chacune des instructions MAP multiples, vous devez classer les instructions MAP par ordre décroissant des valeurs de statistiques. Si la commande n'est pas correcte, Oracle GoldenGate renvoie l'erreur OGG-01921. Pour plus d'informations sur cette exigence, reportez-vous au document 1556241.1 dans la base de connaissances de My Oracle Support à l'adresse https://support.oracle.com.

Exemple 4-1 Instructions MAP contenant des statistiques dans les clauses FILTER

Dans l'exemple suivant, les instructions MAP contenant le filtre pour la statistique CDR_CONFLICTS sont triées par ordre décroissant de la statistique : >3, =3, puis <3.

MAP TEST.GG_HEARTBEAT_TABLE, TARGET TEST.GG_HEARTBEAT_TABLE COMPARECOLS (ON UPDATE ALL),RESOLVECONFLICT(UPDATEROWEXISTS,(DEFAULT, OVERWRITE)),FILTER (@GETENV ("STATS", "CDR_CONFLICTS") > 3),EVENTACTIONS (LOG INFO);MAP TEST.GG_HEARTBEAT_TABLE, TARGET TEST.GG_HEARTBEAT_TABLE COMPARECOLS (ON UPDATE ALL),RESOLVECONFLICT(UPDATEROWEXISTS,(DEFAULT, OVERWRITE)),FILTER (@GETENV ("STATS", "CDR_CONFLICTS") = 3),EVENTACTIONS (LOG WARNING);MAP TEST.GG_HEARTBEAT_TABLE, TARGET TEST.GG_HEARTBEAT_TABLE COMPARECOLS (ON UPDATE ALL),RESOLVECONFLICT(UPDATEROWEXISTS,(DEFAULT, OVERWRITE)),FILTER (@GETENV ("STATS", "CDR_CONFLICTS") < 3),EVENTACTIONS (LOG WARNING);

Syntaxe

@GETENV ({'STATS' | 'DELTASTATS'}, ['TABLE', '<table>'], '<statistic>')

{‘STATS’ ‘DELTASTATS’}

STATS renvoie les nombres depuis le démarrage du processus, tandis que DELTASTATS renvoie les nombres depuis la dernière exécution d'une instruction DELTASTATS.

La logique d'exécution est la suivante :

Lorsque le processus d'extraction traite un enregistrement de transaction qui satisfait @GETENV avec STATS ou DELTASTATS, le nom de la table est mis en correspondance avec les tables source résolues dans l'instruction TABLE.
Lorsque le processus de réplication traite un enregistrement de trace qui satisfait @GETENV avec STATS ou DELTASTATS, le nom de la table est mis en correspondance avec les tables cible résolues dans la clause TARGET de l'instruction MAP.

‘TABLE’, ‘<table>’

Exécute STATS ou DELTASTATS uniquement pour la ou les tables indiquées. Sans cette option, les nombres sont renvoyés pour toutes les tables indiquées dans les paramètres TABLE (Extract) ou MAP (Replicat) dans le fichier de paramètres.

Les valeurs <table_name> valides sont les suivantes :

'<schema.table>' indique une table.
<'table'> indique une table du schéma par défaut.
'*schema.' indique toutes les tables d'un schéma.
'*' indique toutes les tables du schéma par défaut.

Par exemple, les opérations DML suivantes sont comptabilisées uniquement pour les tables du schéma hr :

MAP fin.*, TARGET fin.*;
MAP hr.*, TARGET hr.*;
MAP hq.rpt, TARGET hq.rpt, COLMAP (USEDEFAULTS, CNT = @GETENV ('STATS', 'TABLE', 'hr.*', 'DML'));

De même, les opérations DML suivantes sont comptabilisées uniquement pour la table emp dans le schéma hr :

MAP fin.*, TARGET fin.*;
MAP hr.*, TARGET hr.*;
MAP hq.rpt, TARGET hq.rpt, COLMAP (USEDEFAULTS, CNT = @GETENV ('STATS', 'TABLE', 'hr.emp', 'DML'));

En revanche, comme aucune table spécifique n'est indiquée pour STATS dans l'exemple suivant, la fonction compte toutes les opérations INSERT, UPDATE et DELETE pour toutes les tables de tous les schémas représentés dans les clauses TARGET des instructions MAP :

MAP fin.*, TARGET fin.*;
MAP hr.*, TARGET hr.*;
MAP hq.rpt, TARGET hq.rpt, COLMAP (USEDEFAULTS, CNT = &
@GETENV ('STATS', 'DML'));

<'statistic>’

Type de statistique à renvoyer. Pour plus d'informations importantes sur l'utilisation des statistiques dans les clauses FILTER dans plusieurs instructions TABLE ou MAP, reportez-vous à Utilisation des statistiques dans les clauses FILTER.

‘INSERT’

Renvoie le nombre d'opérations INSERT qui ont été traitées.

‘UPDATE’

Renvoie le nombre d'opérations UPDATE qui ont été traitées.

‘DELETE’

Renvoie le nombre d'opérations DELETE qui ont été traitées.

‘DML’

Renvoie le total des opérations INSERT, UPDATE, et DELETE qui ont été traitées.

‘TRUNCATE’

Renvoie le nombre d'opérations TRUNCATE qui ont été traitées. Cette variable renvoie un nombre uniquement si la réplication DDL d'Oracle GoldenGate n'est pas utilisée. Si la réplication DDL est utilisée, cette variable renvoie un zéro.

‘DDL’

Renvoie le nombre d'opérations DDL qui ont été traitées, y compris les opérations TRUNCATE et DDL spécifiées dans les clauses INCLUDE et EXCLUDE du paramètre DDL, toutes les portées (MAPPED, UNMAPPED, OTHER). Cette variable renvoie un nombre uniquement si la réplication DDL d'Oracle GoldenGate est utilisée. Cette variable n'est pas valide pour 'DELTASTATS'.

‘CDR_CONFLICTS’

Renvoie le nombre de conflits détectés par le processus Replicat lors de l'exécution de la fonction de détection et de résolution des conflits (CDR).

Exemple pour un élément <table> spécifique :

@GETENV ('STATS','TABLE','HR.EMP','CDR_CONFLICTS')

Exemple pour toutes les tables traitées par Replicat :

@GETENV ('STATS','CDR_CONFLICTS')

‘CDR_RESOLUTIONS_SUCCEEDED’

Renvoie le nombre de conflits résolus par le processus Replicat lors de l'exécution de la fonction de détection et de résolution des conflits (CDR).

Exemple pour un élément <table> spécifique :

@GETENV ('STATS','TABLE','HR.EMP', 'CDR_RESOLUTIONS_SUCCEEDED')

Exemple pour toutes les tables traitées par Replicat :

@GETENV ('STATS','CDR_RESOLUTIONS_SUCCEEDED')

‘CDR_RESOLUTIONS_FAILED’

Renvoie le nombre de conflits que le processus Replicat n'a pas pu résoudre lors de l'exécution de la fonctionnalité de détection et de résolution des conflits (CDR).

Exemple pour un élément <table> spécifique :

@GETENV ('STATS','TABLE','HR.EMP', 'CDR_RESOLUTIONS_FAILED')

Exemple pour toutes les tables traitées par Replicat :

@GETENV ('STATS','CDR_RESOLUTIONS_FAILED')

`'GGENVIRONMENT' , '<environment_info>'`

Valide pour l'extraction et le réplication.

Utilisez l'option GGENVIRONMENT de @GETENV pour renvoyer des informations sur l'environnement Oracle GoldenGate.

Syntaxe

@GETENV ('GGENVIRONMENT', {'DOMAINNAME'|'GROUPDESCRIPTION'|'GROUPNAME'|
   'GROUPTYPE'|'HOSTNAME'|'OSUSERNAME'|'PROCESSID')

‘DOMAINNAME’

(Windows uniquement) Renvoie le nom de domaine associé à l'utilisateur qui a démarré le processus.

‘GROUPDESCRIPTION’

Renvoie la description du groupe, extraite du fichier de point de reprise. Nécessite qu'une description ait été fournie avec le paramètre DESCRIPTION lors de la création du groupe avec la commande ADD.

‘GROUPNAME’

Renvoie le nom du groupe de traitements.

‘GROUPTYPE’

Renvoie le type de processus, EXTRACT ou REPLICAT.

‘HOSTNAME’

Renvoie le nom du système qui exécute le traitement d'extraction ou de réplication.

‘OSUSERNAME’

Renvoie le nom d'utilisateur du système d'exploitation qui a démarré le processus.

‘PROCESSID’

Renvoie le processus ID attribué au processus par le système d'exploitation.

`'GGHEADER' , '<header_info>'`

Valide pour l'extraction et le réplication.

Utilisez l'option GGHEADER de @GETENV pour renvoyer les informations de la partie d'en-tête d'un enregistrement de trace Oracle GoldenGate. L'en-tête décrit l'environnement de transaction de l'enregistrement. Pour plus d'informations sur les en-têtes et les types d'enregistrement, voir Format d'enregistrement de trace.

Syntaxe

@GETENV ('GGHEADER', {'BEFOREAFTERINDICATOR'|'COMMITTIMESTAMP'|'LOGPOSITION'|
   'LOGRBA'|'OBJECTNAME'|'TABLENAME'|'OPTYPE'|'RECORDLENGTH'|
   'TRANSACTIONINDICATOR'})

Remarque : n'utilisez pas TIMESTAMP_PRECISE pour commander des opérations. Utilisez plutôt la valeur suivante : @COMPUTE`(`@COMPUTE`(`@NUMSTR`(`@GETENV` ("RECORD``",

                "`FILESEQNO`"))*100000000000)+`@NUMSTR`(`@GETENV` ("`RECORD`",

            "`FILERBA`")))`
            {: .infoboxnote}

‘BEFOREAFTERINDICATOR’

Renvoie l'indicateur avant ou après indiquant si l'enregistrement est une image avant ou une image après. Les résultats possibles sont les suivants :

BEFORE (avant image)
AFTER (après l'image)

‘COMMITTIMESTAMP’

Renvoie l'horodatage de la transaction (heure à laquelle la transaction a été validée) exprimé au format YYYY-MM-DD HH:MI:SS.FFFFFF, par exemple :

2011-01-24 17:08:
59.000000

‘LOGPOSITION’

Renvoie la position du traitement Extract dans la source de données. (Voir l'option LOGRBA.)

‘LOGRBA’

LOGRBA et LOGPOSITION stockent les détails de la position dans la source de données de l'enregistrement. Pour les produits transactionnels basés sur un journal, LOGRBA est le numéro de séquence et LOGPOSITION est l'adresse d'octet relative. Toutefois, ces valeurs varient en fonction de la méthode de capture et du type de base de données.

‘OBJECTNAME’ ‘TABLENAME’

Renvoie le nom de la table ou de l'objet (s'il ne s'agit pas d'un objet de table).

‘OPTYPE’

Renvoie le type d'opération. Les résultats possibles sont les suivants :

INSERT
UPDATE
DELETE
SQL COMPUPDATE
PK UPDATE
TRUNCATE

Si l'opération n'est pas de l'un des types ci-dessus, la fonction renvoie le mot TYPE avec le numéro affecté au type.

‘RECORDLENGTH’

Renvoie la longueur d'enregistrement (en octets).

‘TRANSACTIONINDICATOR’

Renvoie l'indicateur de transaction. La valeur correspond au champ TransInd de l'en-tête d'enregistrement, qui peut être consulté à l'aide de l'utilitaire Logdump.

Les résultats possibles sont les suivants :

BEGIN (représente TransInD sur 0, premier enregistrement d'une transaction)
MIDDLE (représente TransInD sur 1, un enregistrement au milieu d'une transaction)
END (représente TransInD sur 2, dernier enregistrement d'une transaction)
WHOLE (représente TransInD sur 3, le seul enregistrement d'une transaction.)

'GGFILEHEADER' , 'header_info'

Valide pour la réplication uniquement.

Utilisez l'option GGFILEHEADER de @GETENV pour extraire les attributs d'un fichier d'extraction ou d'un fichier trace Oracle GoldenGate. Ces attributs sont stockés en tant que jetons dans l'en-tête du fichier. Remarque : si une version de base de données, de système d'exploitation ou d'Oracle GoldenGate donnée ne fournit pas d'informations relatives à un jeton donné, une valeur NULL est renvoyée.

Syntaxe

@GETENV ('GGFILEHEADER', {'COMPATIBILITY'|'CHARSET'|'CREATETIMESTAMP'|
   'FILENAME'|'FILETYPE'|'FILESEQNO'|'FILESIZE'|'FIRSTRECCSN'|
   'LASTRECCSN'|'FIRSTRECIOTIME'|'LASTRECIOTIME'|'URI'|'URIHISTORY'|
   'GROUPNAME'|'DATASOURCE'|'GGMAJORVERSION'|'GGMINORVERSION'|
   'GGVERSIONSTRING'|'GGMAINTENANCELEVEL'|'GGBUGFIXLEVEL'|'GGBUILDNUMBER'|
   'HOSTNAME'|'OSVERSION'|'OSRELEASE'|'OSTYPE'|'HARDWARETYPE'|
   'DBNAME'| 'DBUNIQUENAME'|'DBINSTANCE'|'DBTYPE'|'DBCHARSET'|'DBMAJORVERSION'|
   'DBMINORVERSION'|'DBVERSIONSTRING'|'DBCLIENTCHARSET'|'DBCLIENTVERSIONSTRING'|
   'LASTCOMPLETECSN'|'LASTCOMPLETEXIDS'|'LASTCSN'|'LASTXID'|
   'LASTCSNTS'|'RECOVERYMODE'})

‘COMPATIBILITY’

Renvoie le niveau de compatibilité du fichier trace. Le niveau de compatibilité de la version actuelle d'Oracle GoldenGate doit être supérieur ou égal au niveau de compatibilité du fichier trace pour pouvoir lire les enregistrements de données dans ce fichier. Les valeurs actuelles valides sont comprises entre 0 et 6.

1 signifie que le fichier trace est de la version 10.0 ou ultérieure d'Oracle GoldenGate, qui prend en charge les en-têtes de fichier contenant des informations de gestion des versions de fichier.
0 signifie que le fichier trace est une version d'Oracle GoldenGate antérieure à 10.0. Les en-têtes de fichier ne sont pas pris en charge dans ces versions. La valeur 0 est utilisée pour la compatibilité descendante avec ces versions d'Oracle GoldenGate.
5 signifie que le fichier trace est de la version 12.2 ou ultérieure d'Oracle GoldenGate.
6 signifie que le fichier trace est de la version 12.3.0.1 d'Oracle GoldenGate.

Cette valeur ne cesse d'augmenter en fonction de la version d'Oracle GoldenGate en fonction de la version du fichier trace.

‘CHARSET’

Renvoie le jeu de caractères global du fichier trace. Exemple :

WCP1252-1

‘CREATETIMESTAMP’

Renvoie l'heure de création de la trace, en heure julienne GMT locale dans INT64.

‘FILENAME’

Renvoie le nom du fichier trace. Il peut s'agir d'un chemin absolu ou relatif, avec une barre oblique ou une barre oblique inverse selon le système de fichiers.

‘FILETYPE’

Renvoie une valeur numérique indiquant si le fichier trace est un fichier unique (tel qu'un fichier créé pour une exécution de batch) ou un fichier numéroté séquentiellement qui fait partie d'une trace pour un traitement en ligne continu. Les valeurs valides sont les suivantes :

0 - EXTFILE
1 - EXTTRAIL
2 - UNIFIED and EXTFILE
3 - UNIFIED and EXTTRAIL

‘FILESEQNO’

Renvoie le numéro de séquence du fichier trace, sans zéro à gauche. Par exemple, si un numéro de séquence de fichier est aa000026, FILESEQNO renvoie 26.

‘FILESIZE’

Renvoie la taille du fichier trace. Elle renvoie NULL sur un fichier actif et une valeur de taille lorsque le fichier est plein et que la trace est restaurée.

‘FIRSTRECCSN’

Renvoie le numéro de séquence de validation (CSN) du premier enregistrement du fichier trace. La valeur est NULL jusqu'à ce que le fichier trace soit terminé.

‘LASTRECCSN’

Renvoie le numéro de séquence de validation (CSN) du dernier enregistrement du fichier trace. La valeur est NULL jusqu'à ce que le fichier trace soit terminé.

‘FIRSTRECIOTIME’

Renvoie l'heure à laquelle le premier enregistrement a été écrit dans le fichier trace. La valeur est NULL jusqu'à ce que le fichier trace soit terminé.

‘LASTRECIOTIME’

Renvoie l'heure à laquelle le dernier enregistrement a été écrit dans le fichier trace. La valeur est NULL jusqu'à ce que le fichier trace soit terminé.

‘RECOVERYMODE’

Renvoie les informations de récupération pour l'utilisation interne d'Oracle GoldenGate. Elle est généralement définie sur APPENDMODE.

‘URI’

Renvoie l'identificateur de ressource universel du processus qui a créé le fichier trace, au format suivant :

<host_name>:<dir>:[:<dir>][:<dir_n>]<group_name>

Où :

host_name est le nom du serveur qui héberge le processus.
dir est un sous-répertoire du chemin d'installation d'Oracle GoldenGate.
group_name est le nom du groupe de processus lié au processus.

L'exemple suivant montre où la trace a été traitée et par quel processus. Cela inclut un historique des exécutions précédentes.

sys1:home:oracle:v9.5:extora

‘URIHISTORY’

Renvoie la liste des URI des processus qui ont écrit dans le fichier trace avant le processus en cours.

Pour une extraction principale, ce champ est vide.
Pour une pompe de données, ce champ est URIHistory + URI du fichier trace d'entrée.

‘GROUPNAME’

Renvoie le nom du groupe associé au traitement Extract qui a créé la trace. Le nom de groupe est celui qui a été fourni lors de l'exécution de la commande ADD EXTRACT.

‘DATASOURCE’

Renvoie la source de données qui a été lue par le processus sous forme de nombre. La valeur renvoyée peut être l'une des suivantes :

DS_EXTRACT_TRAILS : la source était un fichier d'extraction Oracle GoldenGate, avec des données de modification. La valeur de retour est 0.
DS_DATABASE: La source était une sélection directe dans la table de base de données écrite dans une trace, utilisée pour le chargement initial piloté par SOURCEISTABLE. La valeur de retour est 2.
DS_TRAN_LOGS : source du journal des transactions de base de données. La valeur de retour est 3.
DS_INITIAL_DATA_LOAD : la source était une sélection directe dans les tables de base de données pour un chargement initial. La valeur de retour est 4.
DS_VAM_EXTRACT: La source était un module d'accès fournisseur (VAM). La valeur de retour est 5.
DS_VAM_TWO_PHASE_COMMIT: La source était une trace VAM. La valeur de retour est 6.

‘GGMAJORVERSION’

Renvoie la version principale du processus Extract qui a créé la trace, exprimée sous forme d'entier. Par exemple, si une version est 1.2.3, elle renvoie 1.

‘GGMINORVERSION’

Renvoie la version mineure du processus Extract qui a créé la trace, exprimée sous forme d'entier. Par exemple, si une version est 1.2.3, elle renvoie 2.

‘GGVERSIONSTRING’

Renvoie le niveau de maintenance (ou de patch) du processus Extract qui a créé la trace, exprimé sous la forme d'un entier. Par exemple, si une version est 1.2.3, elle renvoie 3.

‘GGMAINTENANCELEVEL’

Renvoie la version de maintenance du processus (xx.xx.xx)).

‘GGBUGFIXLEVEL’

Renvoie la version de patch du processus (xx.xx.xx.xx)).

‘GGBUILDNUMBER’

Renvoie le numéro de build du processus.

‘HOSTNAME’

Renvoie le nom DNS de l'ordinateur sur lequel le processus Extract qui a écrit la trace est exécuté. Exemple :

sysa
sysb
paris
hq25

‘OSVERSION’

Renvoie la version principale du système d'exploitation de la machine sur laquelle le processus Extract qui a écrit la trace est en cours d'exécution. Exemple :

Version s10_69
#1 SMP Fri Feb 24 16:56:28 EST 2006
5.00.2195 Service Pack 4

‘OSRELEASE’

Renvoie la version du système d'exploitation de l'ordinateur sur lequel le processus Extract qui a écrit la trace est exécuté. Par exemple, les versions des exemples donnés pour OSVERSION peuvent être les suivantes :

5.10
2.6.9-34.ELsmp

‘OSTYPE’

Renvoie le type de système d'exploitation de l'ordinateur sur lequel le processus Extract qui a écrit la trace est exécuté. Exemple :

SunOS
Linux
Microsoft Windows

‘HARDWARETYPE’

Renvoie le type de matériel de l'ordinateur sur lequel le processus Extract qui a écrit la trace est exécuté. Exemple :

sun4u
x86_64
x86

‘DBNAME’

Renvoie le nom de la base de données, par exemple findb.

‘DBUNIQUENAME’

Renvoie la valeur du jeton DB_UNIQUE_NAME telle que lue dans l'en-tête du fichier trace source. Sa valeur correspond au paramètre DB_UNIQUE_NAME de la base de données source.

‘DBINSTANCE’

Renvoie le nom de l'instance de base de données, s'il est applicable au type de base de données, par exemple ORA1022A.

‘DBTYPE’

Renvoie le type de base de données qui a produit les données dans le fichier trace. Valeurs possibles :

DB2 UDB
DB2 ZOS
MSSQL
MYSQL
ORACLE
TERADATA
ODBC

‘DBCHARSET’

Renvoie le jeu de caractères utilisé par la base de données qui a généré les données dans le fichier trace. (Pour certaines bases de données, ce champ est vide.)

‘DBMAJORVERSION’

Renvoie la version principale de la base de données qui a produit les données dans le fichier trace.

‘DBMINORVERSION’

Renvoie la version mineure de la base de données qui a produit les données dans le fichier trace.

‘DBVERSIONSTRING’

Renvoie le niveau de maintenance (patch) de la base de données qui a produit les données dans le fichier trace.

‘DBCLIENTCHARSET’

Renvoie le jeu de caractères utilisé par le client de base de données.

‘DBCLIENTVERSIONSTRING’

Renvoie le niveau de maintenance (patch) du client de base de données. (Pour certaines bases de données, ce champ est vide.)

‘LASTCOMPLETECSN’