INFO EXTRACT

Utilisez INFO EXTRACT pour afficher les informations suivantes.

Statut de l'extraction (STARTING, RUNNING, STOPPED ou ABENDED). STARTING indique que le processus a démarré mais n'a pas encore verrouillé le fichier de point de reprise pour traitement.
Décalage d'extraction approximatif.
Informations sur le point de reprise.
Historique d'exécution du traitement.
Traces dans lesquelles l'extraction est écrite.
Statut de la mise à niveau vers l'extraction intégrée ou du retour à la version antérieure.

Syntaxe

INFO EXTRACT group_name
[, SHOWCH [checkpoint_number]]
[, DETAIL]
[, TASKS | ALLPROCESSES]
[, UPGRADE | DOWNGRADE]
[, CONTAINERS]

group_name

Nom d'un groupe d'extraction ou caractère générique (*) pour indiquer plusieurs groupes. Par exemple, T* affiche des informations sur tous les groupes d'extraction dont le nom commence par T. Vous pouvez répertorier les bases de données pluggables inscrites auprès d'un nom de groupe d'extraction indiqué.

SHOWCH [checkpoint_number]

La commande de base affiche des informations concernant les points de reprise d'extraction en cours. Les positions de point de reprise d'extraction sont constituées de points de reprise de lecture dans la source de données et de points de reprise d'écriture dans la trace. Le type de trace EXTTRAIL est également noté.

Indiquez éventuellement une valeur pour checkpoint_number afin d'inclure le nombre indiqué de Points de Reprise précédents ainsi que le nombre en cours.

Remarque : la sortie peut contenir des retraits et des espaces irréguliers. Il s'agit d'un phénomène normal qui n'a aucune incidence sur l'exactitude des informations.

Reportez-vous à la section A propos des points de reprise, qui inclut des descriptions des types de points de reprise créés par chaque processus et des entrées de métadonnées internes incluses dans l'affichage.

DETAIL

Affiche les éléments suivants :

Historique d'exécution d'extraction, y compris les points de départ et d'arrêt dans la source de données, indiqués sous la forme de valeur temporelle.
Traces dans lesquelles l'extraction est écrite.

TASKS

Affiche uniquement les tâches d'extraction. Les tâches indiquées à l'aide d'un argument avec caractères génériques ne sont pas affichées par INFO EXTRACT.

ALLPROCESSES

Affiche tous les groupes d'extraction, y compris les tâches.

UPGRADE | DOWNGRADE

Valide pour une base de données Oracle uniquement.

UPGRADE indique si l'extraction peut être mise à niveau du mode à capture classique vers le mode à capture intégrée.
DOWNGRADE indique si l'extraction peut être rétablie, du Mode de capture intégré vers le Mode de capture classique.

Si l'extraction ne peut pas être mise à niveau ou revenir à la version antérieure, la raison est indiquée.

Un nom d'extraction avec des caractères génériques n'est pas autorisé avec cette option.

Avant d'utiliser cette commande, émettez la commande DBLOGIN.

CONTAINERS

Répertorie les bases de données pluggables inscrites auprès d'un groupe d'extraction indiqué. Toutefois, la commande génère une erreur si elle est exécutée dans un mode autre que le mode de base de données Conteneur ou si le groupe d'extraction n'existe pas. Emettez la commande DBLOGIN avant d'utiliser cette option.

L'extraction peut être en cours d'exécution ou arrêtée lorsque la commande INFO EXTRACT est émise. Dans le cas d'un processus en cours d'exécution, le statut RUNNING peut indiquer l'un des deux états suivants :

Actif : le processus est en cours d'exécution et traite (ou est en mesure de traiter) les données. Il s'agit de l'état normal d'un processus après son démarrage.
Suspendu : le processus est en cours d'exécution mais suspendu en raison d'une action EVENTACTIONS SUSPEND. Si le processus est en suspens, il n'est pas actif et aucune donnée n'a pu être traitée. Toutefois, l'état de l'exécution en cours est conservé et celui-ci peut être poursuivi par l'émission de la commande SEND EXTRACT avec l'option RESUME. L'adresse d'octet relative dans la commande INFO reflète la dernière position de point d'arrêt avant l'action de mise en suspens. Pour savoir si l'état est actif ou suspendu, émettez la commande SEND EXTRACT avec l'option STATUS.

La commande de base affiche uniquement des informations concernant les processus d'extraction en ligne (continus). Les tâches sont exclues.

Remarque : lorsqu'une chaîne de connexion inclut plusieurs hôtes, mais que certains hôtes sont inaccessibles alors que d'autres sont accessibles, la commande INFO EXTRACT ne parvient pas à extraire le statut du processus. Pour vérifier le statut du processus dans ce cas, vous devez créer un élément alias distinct qui inclut uniquement l'hôte accessible.

A bout E xtract L ag

Le champ Checkpoint Lag de la sortie INFO EXTRACT reflète le décalage, en secondes, au moment de l'écriture du dernier point d'enregistrement dans la trace. Par exemple, si :

Heure actuelle = 15:00:00
Dernier point de reprise = 14:59:00
Horodatage du dernier enregistrement traité = 14:58:00

Le décalage indiqué est 00:01:00 (une minute, la différence entre 14:58 et 14:59).

La valeur de décalage UNKNOWN indique que le processus pourrait être en cours d'exécution mais n'a pas encore traité les enregistrements ou que l'horloge du système source est à l'avance sur l'horloge du système cible (en raison d'une imprécision de l'horloges et non d'un décalage de fuseau horaire). Voir LAG EXTRACT. Pour un calcul plus précis du décalage et pour déterminer le décalage global, utilisez la table de signal d'activité. Reportez-vous à ADD HEARTBEATTABLE.

Exemples

INFO EXTRACT ext*, SHOWCH

INFO EXTRACT *, TASKS

INFO EXTRACT exte UPGRADE

L'exemple suivant illustre l'utilisation de la commande INFO EXTRACT à partir du client d'administration.

INFO EXTRACT exte

EXTRACT    exte  Initialized   2019-11-20 23:22   Status STOPPED
Checkpoint Lag       00:00:00 (updated 00:00:09 ago)
Log Read Checkpoint  Oracle Redo Logs
                     2019-11-20 23:22:54  Seqno 0, RBA 0
                     SCN 0.0 (0)
Auto Start           Delay:   0
Encryption Profile   LocalWallet

L'exemple suivant illustre la sortie de commande avec DBLOGIN pour PostgreSQL :

EXTRACT extw
Last Started 2020-07-01 01:40 Status RUNNING
Checkpoint Lag 00:00:00 (updated 00:00:09 ago)
Process ID 101094
VAM Read Checkpoint 2020-07-01 01:40:15.170802

Replication Slot edf_tc1_2c59ae112747afa1 is active with PID 101120 in database postgres
Slot Restart LSN 1/B982ED98
Slot Flush LSN 1/B982ED98
Current Log Position 1/B982EDD0

L'exemple suivant illustre la sortie de commande sans DBLOGIN pour PostgreSQL :

EXTRACT extw Last Started 2020-07-01 01:40 Status RUNNING
Checkpoint Lag 00:00:00 (updated 00:00:04 ago)
Process ID 101094
VAM Read Checkpoint 2020-07-01 01:44:16.045693
LSN: 1/B99B7E60
Replication Slot Unavailable(requires DBLOGIN)
Slot Restart LSN Unavailable(requires DBLOGIN)
Slot Flush LSN Unavailable(requires DBLOGIN)
Current Log Position Unavailable(requires DBLOGIN)