SEND REPLICAT

Utilisez SEND REPLICAT pour communiquer avec un processus Replicat en cours de démarrage ou d'exécution. La demande est traitée dès que la réplication est prête à accepter des commandes provenant d'utilisateurs.

Syntaxe

SEND REPLICAT group_name[threadID],
{
CACHEMGR {CACHESTATS | CACHEQUEUES | CACHEVMUSAGE} |
DEPENDENCYINFO [TXNCOUNT num] |
FORCESTOP |
GETLAG |
GETPARAMINFO [parameter_name] [FILE output_file] |
HANDLECOLLISIONS | NOHANDLECOLLISIONS [table_spec] |
INTEGRATEDPARAMS(parameter_specification) |
LOGEND |
REPORT [HANDLECOLLISIONS [table_spec]] |
RESUME |
STATUS |
STOP |
TRACE[2] [DDLINCLUDE | DDL[ONLY]] file_name |
TRACE[2] OFF |
TRACE OFF file_name |
TRACEINIT |
THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])
}

group_name[threadID]

Nom du groupe du processus de réplication ou d'un thread spécifique d'une réplication coordonnée, par exemple fin003. Si la commande est émise pour un thread spécifique, toute option utilisée s'applique uniquement à ce dernier. Vous pouvez également émettre SEND REPLICAT avec l'option THREADS, plutôt que d'inclure threadID avec le nom de groupe. Si la réplication n'est pas en cours d'exécution, une erreur survient.

CACHEMGR {CACHESTATS | CACHEQUEUES | CACHEVMUSAGE}

Renvoie des statistiques concernant le gestionnaire de cache mémoire d'Oracle GoldenGate. L'option CACHEMGR doit être uniquement utilisée que pour une demande explicite du support technique Oracle.

CACHESTATS

Renvoie des statistiques sur la mise en cache des fichiers.

CACHEQUEUES

Renvoie des statistiques concernant les files d'attente libres uniquement.

CACHEVMUSAGE

Renvoie des statistiques sur l'utilisation de la mémoire virtuelle.

DEPENDENCYINFO [TXNCOUNT num]

Imprime les informations du graphique des dépendances de transaction PR. Il imprime d'abord les groupes de transactions en cours d'exécution, puis les transactions en attente qui dépendent d'autres transactions. TXNCOUNT détermine le nombre de transactions en attente à imprimer. La valeur par défaut est 10 et le maximum est 99.

FORCESTOP

Force l'arrêt de la réplication, en ignorant toutes les notifications. Cette commande annule toutes les transactions actives et arrête immédiatement le processus. Cette commande s'applique à la réplication dans sa globalité et ne peut pas être utilisée pour un thread de réplication spécifique.

GETLAG

Affiche le véritable décalage entre la réplication et la trace. Le décalage est la différence (en secondes) entre l'heure à laquelle le dernier enregistrement a été traité par la réplication et l'horodatage de l'enregistrement dans la trace. Les résultats sont les mêmes que pour LAG REPLICAT.

GETPARAMINFO [parameter_name] [FILE output_file]

Utilisez GETPARAMINFO pour interroger les valeurs de paramètre d'exécution d'une instance en cours d'exécution, y compris l'extraction, la réplication et le gestionnaire. Vous pouvez interroger un seul paramètre ou tous les paramètres, et envoyer la sortie à la console ou à un fichier texte.

parameter_name

Le comportement par défaut affiche tous les paramètres utilisés, c'est-à-dire les paramètres qui ont été interrogés par l'application, les autres paramètres et leur valeur en cours. Si vous indiquez un paramètre en particulier, la sortie est filtrée par ce nom.

FILE output_file

Nom du fichier texte vers lequel la sortie est réacheminée.

HANDLECOLLISIONS NOHANDLECOLLISIONS [table_spec]

Contrôle du comportement HANDLECOLLISIONS. Au lieu d'utiliser cette option, vous pouvez indiquer le paramètre HANDLECOLLISIONS ou NOHANDLECOLLISIONS dans le fichier de paramètres du processus de réplication. Reportez-vous à HANDLECOLLISIONS \| NOHANDLECOLLISIONS dans Référence des paramètres et des fonctions pour Oracle GoldenGate. Cette commande peut être envoyée directement à un thread spécifique à l'aide de SEND REPLICAT group_name[threadID]. Vous pouvez également utiliser l'option THREADS pour l'envoyer via le thread de coordonnateur et l'appliquer ainsi à plusieurs threads.

HANDLECOLLISIONS

Utilisez HANDLECOLLISIONS pour activer la gestion automatique de l'erreur lorsque vous effectuez un chargement de données initial alors que la base de données source est active. Veillez à désactiver HANDLECOLLISIONS, soit en émettant SEND REPLICAT avec l'option NOHANDLECOLLISIONS, soit en supprimant le paramètre du fichier de paramètres, une fois le chargement initial terminé et les modifications de données en ligne appliquées aux tables cible. Remarque : le message renvoyé par `SEND

                                            REPLICAT` with `HANDLECOLLISIONS`, when issued for a specific Replicat thread, shows that the command set `HANDLECOLLISIONS` for all `MAP` statements, not only the one handled by the specified thread. This is a known issue. The command actually affects only the `MAP` statement that includes the specified thread.
                                            {: .infoboxnote}

NOHANDLECOLLISIONS

Désactive le paramètre HANDLECOLLISIONS, mais ne l'enlève pas de ce fichier. Pour éviter d'activer HANDLECOLLISIONS lors du prochain démarrage du processus Replicat, enlevez-le du fichier des paramètres.

table_spec

table_spec limite HANDLECOLLISIONS ou NOHANDLECOLLISIONS à une table cible spécifique ou à un groupe de tables cible indiqué avec un caractère générique standard (*).

INTEGRATEDPARAMS(parameter_specification)

(Oracle) Prend en charge les réplications intégrées. Envoie une spécification de paramètre au serveur entrant de base de données lorsque la réplication est exécutée en mode intégré. Cette commande ne peut envoyer qu'une seule spécification de paramètre à la fois. Pour envoyer plusieurs modifications de paramètre, émettez plusieurs commandes SEND REPLICAT, comme dans l'exemple suivant.

SEND REPLICAT repe INTEGRATEDPARAMS (parallelism 4)
SEND REPLICAT repe INTEGRATEDPARAMS (max_sga_size 250)

Pour assurer la continuité du traitement, la modification de paramètre est effectuée au niveau d'une limite de transaction.

LOGEND

Vérifie que la réplication a traité tous les enregistrements de la source de données.

REPORT [HANDLECOLLISIONS [table_spec]]

Génère un rapport de statistiques temporaires vers le fichier de rapport de l'extraction. Les statistiques affichées dépendent de la configuration du paramètre STATOPTIONS lorsque celui-ci est employé avec l'option RESETREPORTSTATS | NORESETREPORTSTATS. Reportez-vous à STATOPTIONS.

HANDLECOLLISIONS

Affiche les tables pour lesquelles HANDLECOLLISIONS a été activé.

table spec

Limite la sortie à une table cible spécifique ou à un groupe de tables cible indiqué par un caractère générique standard (*).

RESUME

Reprend (active) un processus qui était suspendu par un événement EVENTACTIONS SUSPEND. Le processus reprend le traitement normal à partir du point au niveau duquel il a été suspendu.

STATUS

Renvoie l'emplacement en cours dans la trace et des informations sur la transaction actuelle. Sortie des champs :

Statut de traitement (par thread, si la réplication est coordonnée)
Position dans le fichier trace (par thread, si la réplication est coordonnée)
Numéro de séquence de trace (par thread, si la réplication est coordonnée)
Adresse d'octet relative dans la trace
Nom de trace

Messages de statut de traitement possibles :

Delaying : en attente de données supplémentaires
Suspended : en attente de reprise
Waiting on deferred apply : traitement différé conformément au paramètre DEFERAPPLYINTERVAL.
Processing data : données de traitement
Skipping current transaction : START REPLICAT avec SKIPTRANSACTION a été utilisé.
Searching for START ATCSN csn – La commande START REPLICAT avec ATCSN a été utilisée.
Searching for START AFTERCSN csn – La commande START REPLICAT avec AFTERCSN a été utilisée.
Performing transaction timeout recovery : annulation de la transaction incomplète en cours et repositionnement pour commencer une autre (reportez-vous au paramètre TRANSACTIONTIMEOUT).
Waiting for data at logical EOF after transaction timeout recovery : attente de réception du reste d'une transaction source incomplète après une interruption TRANSACTIONTIMEOUT.
At EOF (end of file) : aucun autre enregistrement à traiter

Messages de statut de thread possibles quand THREADS est utilisé ou que la commande est émise pour un thread spécifique :

Waiting for consensus stop point : indique que les threads tentent de se synchroniser pour une transaction barrière.
Waiting for Watermark : indique que tous les threads tentent de s'arrêter au niveau de la même transaction dans la trace, appelée repère Watermark global.
Waiting on all threads to start up : indique que le thread attend le démarrage des tous les threads après la réussite d'une transaction barrière ou un démarrage du processus Replicat.

Messages de statut de thread de coordinateur possibles :

Waiting for all threads to register : indique que les instructions MAP sont toutes analysées pour déterminer les ID de thread qui y sont spécifiés.
Processing data : indique que des données sont traitées normalement.
Suspended, waiting to be resumed : indique qu'une commande SEND REPLICAT avec une demande SUSPEND a été envoyée à la réplication.
At EOF : indique qu'il n'y a plus aucune donnée dans la trace à traiter.
Waiting to register MAP statistics : indique que la réplication collecte des statistiques de traitement à envoyer au fichier de rapport.

STOP

Arrête la réplication progressivement. Cette commande s'applique à la réplication dans sa globalité et ne peut pas être utilisée pour un thread de réplication spécifique.

THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])

Emet la commande uniquement pour les threads spécifiés d'une réplication coordonnée. Vous pouvez utiliser cette option ou groupname avec threadID. Si aucune de ces options n'est précisée, la commande s'applique à tous les threads actifs.

threadID[, threadID][, ...]

Indique un ID de thread ou une liste de threads séparés par une virgule au format threadID, threadID, threadID.

thread_range[, thread_range][, ...]

Indique une plage de threads au formatthreadIDlow-threadIDhigh ou une liste de plages délimitées par une virgule au formatthreadIDlow-threadIDhigh, threadIDlow-threadIDhigh.

Vous pouvez combiner ces formats. Par exemple, threadID, threadID, threadIDlow-threadIDhigh.

TRACE[2] [DDLINCLUDE DDL[ONLY]] file_name

Active et désactive la trace. La fonction de trace capture les informations vers le fichier indiqué afin de repérer les goulets d'étranglement de traitement. La fonction de trace peut également être activée par les paramètres de réplication TRACE et TRACE2.

Si la réplication est en mode coordonné et que l'option TRACE est utilisée avec une liste ou un intervalle THREADS, un fichier trace est créé pour chaque thread actuellement actif. Chaque nom de fichier est complété par l'ID de thread associé. Cette méthode consistant à identifier les fichiers trace par l'ID du thread ne s'applique pas si SEND REPLICAT est émis par groupname avec threadID (comme dans SEND REPLICAT fin003 TRACE...) ou si un seul thread est indiqué avec THREADS.

Si la trace repère des goulets d'étranglement de traitement importants, contactez le support technique Oracle afin d'obtenir de l'aide.

TRACE

Capture les informations de traitement détaillées.

TRACE2

Identifie les segments de code plutôt que les détails spécifiques.

DDLINCLUDE | DDLONLY

(Réplication uniquement) Active la fonction de trace DDL et indique comment elle est incluse dans le rapport de trace.

DDLINCLUDE inclut la fonction de trace DDL en plus de la fonction de trace standard du traitement de données transactionnelles.
DDL[ONLY] exclut la fonction de trace des données transactionnelles et génère uniquement la trace de DDL. Cette option peut être abrégée en DDL.

file_name

file_name indique le nom qualifié complet ou relatif d'un fichier dans lequel Oracle GoldenGate journalise les informations de trace. Si une trace est déjà en cours, le fichier trace existant est fermé et la trace revient dans le fichier indiqué par file_name. Exemple :

SEND REPLICAT group_name TRACE file_name DDLINCLUDE

Si aucune autre option ne peut suivre le nom de fichier, le mot-clé FILE peut être omis, par exemple :

SEND REPLICAT group_name TRACE DDLINCLUDE file_name

TRACE[2] OFF

Désactive la fonction de trace.

TRACE OFF file_name

Désactive la fonction de trace uniquement pour le fichier trace indiqué. Cette option prend en charge la fonctionnalité EVENTACTIONS, qui peut causer plusieurs fichiers trace en raison de multiples instructions EVENTACTIONS.

TRACEINIT

Rétablit la valeur des statistiques de trace sur 0, puis reprend l'accumulation de statistiques. Utilisez cette option pour suivre le comportement actuel du traitement et non son comportement historique.

Exemples

SEND REPLICAT repe, HANDLECOLLISIONS

SEND REPLICAT repe, REPORT HANDLECOLLISIONS rep_*

SEND REPLICAT repe, GETLAG

SEND REPLICAT repe, INTEGRATEDPARAMS(parallelism 10)

L'exemple suivant obtient le décalage du thread 3 d'une réplication coordonnée.

SEND REPLICAT repe, GETLAG

L'exemple suivant n'active la fonction de trace que pour le thread 1 d'une réplication coordonnée. Dans ce cas, le fichier trace étant généré pour un seul thread, le fichier trace n'a pas d'extension threadID. Le fichier est nommé trace.trc.

SEND REPLICAT repe, TRACE THREADS(1) FILE ./dirrpt/trace.trc

L'exemple suivant active la fonction de trace pour les threads 1, 2 et 3 d'une réplication coordonnée. Si tous les threads sont actifs, la trace génère des fichiers trace001, trace002 et trace003.

SEND REPLICAT repe TRACE THREADS(1-3) FILE ./dirrpt/trace.trc

L'exemple suivant n'active la fonction de trace que pour le thread 1 d'une réplication coordonnée. La commande ayant été émise directement pour le thread 1 sans recours à la clause THREAD, le fichier trace est nommé trace (sans suffixe d'ID de thread).

SEND REPLICAT repe TRACE FILE ./dirrpt/trace.trc