ADD REPLICAT

Utilisez ADD REPLICAT pour créer un groupe de réplication. Cette commande crée un groupe de processus en ligne qui créé des points de reprise afin d'assurer l'exécution de la continuité du traitement. La taille ne peut pas dépasser 500 octets pour l'ensemble des mots-clés et des entrées, y compris les textes saisis dans l'option DESC.

Oracle GoldenGate prend en charge jusqu'à 5 000 groupes d'extraction et de réplication simultanés par instance du gestionnaire de service Oracle GoldenGate. Au niveau pris en charge, vous pouvez contrôler et visualiser tous les groupes en entier à l'aide de commandes telles que INFO et STATUS,

Oracle GoldenGate recommande de ne pas dépasser le nombre par défaut de groupes d'extraction et de réplication (tous confondus) défini sur 300 afin de gérer efficacement votre environnement.

(Oracle) Cette commande crée un groupe de réplication en mode non intégré sauf si l'option INTEGRATED est utilisée.

Syntaxe

ADD REPLICAT group_name
[, PARALLEL [, INTEGRATED] | INTEGRATED | COORDINATED [MAXTHREADS number]]
{, EXTTRAIL trail_name}
[, BEGIN {NOW | yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]}]
[, EXTRBA rba]
{, CHECKPOINTTABLE owner.table}
[, DESC 'description']
[, ENCRYPTIONPROFILE encryption-profile-name ]
                [ CRITICAL        [ YES | NO ]  ]
                [ PROFILE          profile-name
[ AUTOSTART
                [ YES | NO ]
                [ DELAY delay-number ] ]
                [ AUTORESTART [ YES | NO ]
                [ RETRIES      retries-number ]
                [ WAITSECONDS  wait-number    ]
                [ RESETSECONDS reset-number   ]
                [ DISABLEONFAILURE [ YES | NO ]     ] ] ]

group_name

Nom du groupe de réplication. Si vous n'indiquez aucune option, la commande crée une réplication classique. Le nom d'un groupe de réplication coordonnée et parallèle doit être composé de cinq caractères au maximum. Le nom d'un groupe de réplication standard peut contenir huit caractères au maximum.

INTEGRATED

(Oracle) Crée la réplication en mode intégré. Sans cette option, ADD REPLICAT crée la réplication en mode non intégré (classique). Cette option fonctionne également pour les réplications parallèles. Dans ce mode, le processus Replicat exploite la fonctionnalité de traitement d'application des modifications disponible dans Oracle AI Database. Dans ce mode, la réplication fonctionne comme suit :

Elle lit la trace Oracle GoldenGate.
Elle effectue le filtrage des données, leur mise en correspondance et leur conversion.
Elle construit des enregistrements de modification logiques qui représentent les transactions DDL ou DML de base de données source, dans l'ordre de validation.
Elle effectue l'attachement à un processus en arrière-plan de la base de données cible appelé serveur entrant de base de données à l'aide d'une interface de transmission en continu légère.
Elle transmet les enregistrements de modification logiques au serveur entrant, qui applique les données à la base de données cible.
Vous devez employer une réplication en mode intégré (intégré ou intégré parallèle) si vous utilisez l'une des fonctions suivantes :
- Détection et résolution automatiques des conflits
- Réplication procédurale
- Gestionnaires DML ou DDL

INTEGRATED doit être utilisé pour une réplication de synchronisation des modifications en ligne qui lit à partir d'une trace locale indiquée par EXTTRAIL.

La réplication intégrée et la réplication parallèle en mode intégré conservent la table de point de reprise si elle existe. Reportez-vous également à ADD CHECKPOINTTABLE.

TRACETABLE n'est pas maintenu par la réplication intégrée ou la réplication parallèle en mode intégré.

En mode intégré, la réplication ne prend pas en charge les paramètres suivants :

BULKLOAD (N'utilisez pas de réplication intégrée comme réplication de chargement initial.)
GENLOADFILES
SHOWSYNTAX
MAXTRANSOPS (est ignoré)

PARALLEL

Valide pour toutes les bases de données prises en charge.

Ajoute la réplication en mode parallèle. Dans ce mode, la réplication applique les transactions en parallèle afin d'améliorer les performances. Elle tient compte des dépendances entre les transactions. La réplication PARALLEL INTEGRATED est uniquement valide pour Oracle. Il ajoute la réplication parallèle en mode intégré, qui, comme la réplication intégrée, tire parti de la fonctionnalité de traitement d'application des modifications disponible dans Oracle AI Database.

Remarque : lors de la configuration du processus Replicat parallèle pour Sybase, veillez à effectuer une mise à niveau vers la version 16.0 SP3 PL15 et les versions ultérieures afin d'empêcher le service d'administration de se déconnecter par intermittence.

COORDINATED [MAXTHREADS number]

Crée la réplication en mode coordonné. Une réplication coordonnée est multithread afin de permettre le traitement en parallèle. Cette option ajoute le coordinateur (identifié par le nom du groupe) et le nombre maximal de threads de traitement indiqué par défaut ou par la commande MAXTHREADS. Le coordinateur calcule et coordonne les dépendances, tandis que les threads effectuent le traitement SQL.

Pour créer une réplication COORDINATED, une table de point de reprise est requise.

COORDINATED doit être utilisé pour une réplication de synchronisation des modifications en ligne qui lit à partir d'une trace locale indiquée par EXTTRAIL. Remarque : le nom de groupe d'une réplication coordonnée peut contenir seulement cinq caractères.

MAXTHREADS number

Indique le nombre maximal de threads de traitement que ce groupe de réplication peut générer dynamiquement. Ces threads sont tous créés au démarrage mais, en fonction des éléments indiqués dans les instructions MAP du fichier des paramètres, une partie ou l'ensemble de ces threads traiteront la charge globale à tout moment. En règle générale, indiquez deux fois plus de threads que le nombre de threads spécifié dans les instructions MAP lors du partitionnement de la charge globale. Ainsi, vous bénéficiez de threads en cas d'augmentation de la charge globale, sans avoir à supprimer et à recréer le groupe de réplication. Reportez-vous à TABLE \| MAP pour plus d'informations sur la partitionnement de la charge globale sur ces threads.

Le nombre de threads par défaut est 25 si l'option MAXTHREADS est omise. Le nombre maximal de threads est 500.

MAXTHREADS est lié au paramètre MAXGROUPS. MAXGROUPS contrôle le nombre maximal de groupes de processus (extraction et réplication) autorisés par instance Oracle GoldenGate. Chaque thread de réplication est considéré comme un groupe de réplication dans le contexte de MAXGROUPS. Par conséquent, l'addition du nombre de groupes d'extraction et d'exécution dans l'instance Oracle GoldenGate et la valeur de MAXTHREADS ne peut pas dépasser la valeur de MAXGROUPS. Reportez-vous à MAXGROUPS

EXTTRAIL trail_name

Indique le nom qualifié complet ou relatif d'une trace créée à l'aide de la commande ADD EXTTRAIL.

BEGIN {NOW yyyy-mm-ddT[ hh:mm[:ss[.cccccc]]]Z}

Définit un point de reprise initial dans la trace.

NOW

Lance la réplication des modifications à partir de l'heure de création du groupe.

yyyy-mm-ddT[ hh:mm[:ss[.cccccc]]]Z

Lance l'extraction des modifications à partir d'une heure précise.

EXTRBA extrba

Valide pour DB2 z/OS.

Indique l'adresse d'octet relative dans le fichier trace spécifié par EXTSEQNO. Contactez le support technique Oracle avant d'utiliser cette option.

CHECKPOINTTABLE {owner.table NODBCHECKPOINT}

Non valide pour l'adaptateur d'applications Oracle GoldenGate ou Oracle GoldenGate Big Data.

NODBCHECKPOINT n'est pas valide pour la cible Oracle AI Database. Oracle recommande vivement d'utiliser une table de points de reprise. La réplication parallèle et coordonnée en mode intégré et en mode non intégré requiert une table de point de reprise.

Indique que ce groupe de réplication écrira des points de reprise dans la table de base de données indiquée. Incluez le nom de table et de propriétaire, comme dans ggadmin.ggs_checkpoint. Cet argument remplace toute spécification CHECKPOINTTABLE par défaut dans le fichier GLOBALS. La table doit d'abord être ajoutée à l'aide de la commande ADD CHECKPOINTTABLE.

Pour une base de données cible autre qu'Oracle, lorsque l'option NODBCHECKPOINT est indiquée, le groupe de réplication n'écrit pas de points de reprise dans une table de point de reprise. Cet argument remplace toute spécification CHECKPOINTTABLE par défaut dans le fichier GLOBALS. Cet argument est requis si vous ne voulez pas utiliser de table de point de reprise avec le groupe de réplication créé.

Pour la cible Oracle AI Database, Oracle GoldenGate 26ai et versions ultérieures ne prend pas en charge le paramètre NODBCHECKPOINT lors de l'ajout d'une réplication. Après la mise à niveau vers Oracle GoldenGate 26ai, si la réplication existante pour Oracle AI Database a été créée avec NODBCHECKPOINT et qu'aucun point de reprise de base de données par défaut n'a été indiqué dans GLOBALS, la réplication s'interrompt au démarrage. Pour éviter cette situation, vous devez effectuer l'une des tâches suivantes :

Option 1 : Oracle recommande d'indiquer une table de points de reprise de base de données par défaut dans GLOBALS

Option 2 : créez une réplication avec la table de point de reprise indiquée et redémarrez à partir du numéro SCN qui remplace la réplication mise à niveau.

DESC ‘description’

Indique la description du groupe. Exemple : 'Loads account_tab on Serv2. Placez la description entre apostrophes.

ENCRYPTIONPROFILE

Indique le nom du profil de cryptage de la réplication.

CRITICAL

Indique si le processus est essentiel pour le déploiement.

PROFILE

Nom du profil de démarrage automatique.

AUTOSTART

Indique si le processus géré doit être démarré automatiquement lors du démarrage du service d'administration. La valeur par défaut est YES.

DELAY

Temps d'attente (en secondes) avant de démarrer le processus.

AUTORESTART

Détermine le mode de redémarrage du processus en cas d'interruption.

RETRIES

Nombre maximal de tentatives de redémarrage de la tâche avant d'annuler les nouvelles tentatives. Cette option est facultative.

WAITSECONDS

Durée (en secondes) au cours de laquelle le nombre de tentatives est compté.

RESETSECONDS

Réinitialise la durée au cours de laquelle le nombre de tentatives est compté.

DISABLEONFAILURE

Si la valeur TRUE est définie, la tâche est désactivée lorsque le nombre de tentatives est épuisé.

Exemples

L'exemple suivant ajoute une réplication intégrée nommée reps. La sortie est affichée à l'aide de la commande INFO.

ADD REPLICAT reps, INTEGRATED, EXTTRAIL ea, checkpointtable ggadmin.ckpt1

La sortie se présente comme suit :

2019-11-21T20:01:10Z  INFO    OGG-08100  REPLICAT (Integrated) added.

Voici un exemple d'ajout d'une réplication parallèle nommée repw.

ADD REPLICAT repw, INTEGRATED, PARALLEL, EXTTRAIL ea, checkpointtable ggadmin.ggs_checkpoint

La sortie se présente comme suit :

2019-11-21T20:07:26Z  INFO    OGG-08100  REPLICAT (Parallel) added.