Configurer la réplication bidirectionnelle

Avant de commencer

Ce démarrage rapide nécessite que deux bases de données existent dans la même location et la même région. Si vous avez besoin de données-échantillons, téléchargez Archive.zip, puis suivez les instructions sous Laboratoire 1, Tâche 3 : Charger le schéma ATP.

Aperçu

Les étapes suivantes vous guident lors de l'instanciation d'une base de données cible à l'aide d'Oracle Data Pump et la configuration de la réplication bidirectionnelle (dans les deux sens) entre deux bases de données de la même région.

Description de l'illustration bidirectional.png

Tâche 1 : Configurer l'environnement

Créez un déploiement.
Créez des connexions à vos bases de données.
Affectez les connexions au déploiement.
Activez la journalisation supplémentaire :
```
ALTER DATABASE ADD SUPPLEMENTAL LOG DATA
```
Exécutez l'interrogation suivante pour vous assurer que support_mode=FULL pour toutes les tables de la base de données source :
```
select * from DBA_GOLDENGATE_SUPPORT_MODE where owner = 'SRC_OCIGGLL';
```
Exécutez l'interrogation suivante sur la base de données B pour vous assurer que support_mode=FULL pour toutes les tables de la base de données :
```
select * from DBA_GOLDENGATE_SUPPORT_MODE where owner = 'SRCMIRROR_OCIGGLL';
```

Tâche 2 : Ajouter des informations sur les transactions et une table de points de vérification pour les deux bases de données

Dans la console de déploiement de GoldenGate pour OCI, allez à l'écran Configuration du service d'administration, puis effectuez les opérations suivantes :

Ajoutez des informations sur les transactions pour les bases de données A et B :
1. Pour la base de données A, entrez le nom de schéma SRC_OCIGGLL.
2. Pour la base de données B, entrez le nom de schéma SRCMIRROR_OCIGGLL.
Note :
Les noms de schéma doivent être uniques et correspondre à vos noms de schéma de base de données si vous utilisez un jeu de données différent de cet exemple.
Créez une table de points de vérification pour les bases de données A et B :
1. Pour la base de données A, entrez "SRC_OCIGGLL"."ATP_CHECKTABLE" pour la table de points de vérification.
2. Pour la base de données B, entrez "SRCMIRROR_OCIGGLL"."CHECKTABLE" pour la table de points de vérification.

Tâche 3 : Créer le processus d'extraction intégrée

Une extraction intégrée saisit les modifications en cours apportées à la base de données source.

Dans la page Détails du déploiement, cliquez sur Lancer la console.

Ajouter et exécuter une extraction intégrée.

Note :

Voir Options de paramètre d'extraction supplémentaires pour plus d'informations sur les paramètres que vous pouvez utiliser pour spécifier des tables sources.

Dans la page Paramètres d'extraction, ajoutez les lignes suivantes sous EXTTRAIL <extract-name> :

-- Capture DDL operations for listed schema tables
ddl include mapped

-- Add step-by-step history of 
-- to the report file. Very useful when troubleshooting.
ddloptions report 

-- Write capture stats per table to the report file daily.
report at 00:01 

-- Rollover the report file weekly. Useful when IE runs
-- without being stopped/started for long periods of time to
-- keep the report files from becoming too large.
reportrollover at 00:01 on Sunday 

-- Report total operations captured, and operations per second
-- every 10 minutes.
reportcount every 10 minutes, rate 

-- Table list for capture
table SRC_OCIGGLL.*;

-- Exclude changes made by GGADMIN
tranlogoptions excludeuser ggadmin

Note :

tranlogoptions excludeuser ggadmin évite la récapitulation des transactions appliquées par ggadmin dans les scénarios de réplication bidirectionnelle.

Recherchez les transactions de longue durée :
1. Exécutez le script suivant sur votre base de données source :
```
select start_scn, start_time from gv$transaction where start_scn < (select max(start_scn) from dba_capture);
```
  Si l'interrogation retourne des rangées, vous devez localiser le numéro SCN de la transaction, puis valider ou repositionner celle-ci.

Tâche 4 : Exporter des données à l'aide d'Oracle Data Pump (ExpDP)

Utilisez Oracle Data Pump (ExpDP) pour exporter des données de la base de données source vers le magasin d'objets Oracle.

Créez un seau du magasin d'objets Oracle.

Notez l'espace de noms et le nom du seau à utiliser avec les scripts d'exportation et d'importation.
Créez un jeton d'authentification, puis copiez et collez la chaîne du jeton dans un éditeur de texte pour une utilisation ultérieure.
Créez des données d'identification dans votre base de données source, en remplaçant <user-name> et <token> par le nom d'utilisateur de votre compte Oracle Cloud et la chaîne du jeton que vous avez créée à l'étape précédente :
```
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'ADB_OBJECTSTORE', 
    username => '<user-name>',
    password => '<token>'
  );
END;
```

Exécutez le script suivant dans la base de données source pour créer la tâche d'exportation de données. Assurez-vous de remplacer les valeurs <region>, <namespace> et <bucket-name> dans l'URI du magasin d'objets en conséquence. SRC_OCIGGLL.dmp est un fichier qui sera créé lors de l'exécution de ce script.

DECLARE
ind NUMBER;              -- Loop index
h1 NUMBER;               -- Data Pump job handle
percent_done NUMBER;     -- Percentage of job complete
job_state VARCHAR2(30);  -- To keep track of job state
le ku$_LogEntry;         -- For WIP and error messages
js ku$_JobStatus;        -- The job status from get_status
jd ku$_JobDesc;          -- The job description from get_status
sts ku$_Status;          -- The status object returned by get_status

BEGIN
-- Create a (user-named) Data Pump job to do a schema export.
h1 := DBMS_DATAPUMP.OPEN('EXPORT','SCHEMA',NULL,'SRC_OCIGGLL_EXPORT','LATEST');

-- Specify a single dump file for the job (using the handle just returned
-- and a directory object, which must already be defined and accessible
-- to the user running this procedure.
DBMS_DATAPUMP.ADD_FILE(h1,'https://objectstorage.<region>.oraclecloud.com/n/<namespace>/b/<bucket-name>/o/SRC_OCIGGLL.dmp','ADB_OBJECTSTORE','100MB',DBMS_DATAPUMP.KU$_FILE_TYPE_URIDUMP_FILE,1);

-- A metadata filter is used to specify the schema that will be exported.
DBMS_DATAPUMP.METADATA_FILTER(h1,'SCHEMA_EXPR','IN (''SRC_OCIGGLL'')');

-- Start the job. An exception will be generated if something is not set up properly.
DBMS_DATAPUMP.START_JOB(h1);

-- The export job should now be running. In the following loop, the job
-- is monitored until it completes. In the meantime, progress information is displayed.
percent_done := 0;
job_state := 'UNDEFINED';
while (job_state != 'COMPLETED') and (job_state != 'STOPPED') loop
  dbms_datapump.get_status(h1,dbms_datapump.ku$_status_job_error + dbms_datapump.ku$_status_job_status + dbms_datapump.ku$_status_wip,-1,job_state,sts);
  js := sts.job_status;

-- If the percentage done changed, display the new value.
if js.percent_done != percent_done
then
  dbms_output.put_line('*** Job percent done = ' || to_char(js.percent_done));
  percent_done := js.percent_done;
end if;

-- If any work-in-progress (WIP) or error messages were received for the job, display them.
if (bitand(sts.mask,dbms_datapump.ku$_status_wip) != 0)
then
  le := sts.wip;
else
  if (bitand(sts.mask,dbms_datapump.ku$_status_job_error) != 0)
  then
    le := sts.error;
  else
    le := null;
  end if;
end if;
if le is not null
then
  ind := le.FIRST;
  while ind is not null loop
    dbms_output.put_line(le(ind).LogText);
    ind := le.NEXT(ind);
  end loop;
end if;
  end loop;

  -- Indicate that the job finished and detach from it.
  dbms_output.put_line('Job has completed');
  dbms_output.put_line('Final job state = ' || job_state);
  dbms_datapump.detach(h1);
END;

Tâche 5 : Instancier la base de données cible à l'aide d'Oracle Data Pump (ImpDP)

Utilisez Oracle Data Pump (ImpDP) pour importer des données dans la base de données cible à partir du fichier SRC_OCIGGLL.dmp exporté à partir de la base de données source.

Créez des données d'identification dans la base de données cible pour accéder au magasin d'objets Oracle (à l'aide des mêmes informations que dans la section précédente).
```
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL( 
    credential_name => 'ADB_OBJECTSTORE',
    username => '<user-name>',
    password => '<token>'
  );
END;
```

Exécutez le script suivant dans la base de données cible pour importer les données du fichier SRC_OCIGGLL.dmp. Assurez-vous de remplacer les valeurs <region>, <namespace> et <bucket-name> dans l'URI du magasin d'objets en conséquence :

DECLARE
ind NUMBER;  -- Loop index
h1 NUMBER;  -- Data Pump job handle
percent_done NUMBER;  -- Percentage of job complete
job_state VARCHAR2(30);  -- To keep track of job state
le ku$_LogEntry;  -- For WIP and error messages
js ku$_JobStatus;  -- The job status from get_status
jd ku$_JobDesc;  -- The job description from get_status
sts ku$_Status;  -- The status object returned by get_status
BEGIN

-- Create a (user-named) Data Pump job to do a "full" import (everything
-- in the dump file without filtering).
h1 := DBMS_DATAPUMP.OPEN('IMPORT','FULL',NULL,'SRCMIRROR_OCIGGLL_IMPORT');

-- Specify the single dump file for the job (using the handle just returned)
-- and directory object, which must already be defined and accessible
-- to the user running this procedure. This is the dump file created by
-- the export operation in the first example.

DBMS_DATAPUMP.ADD_FILE(h1,'https://objectstorage.<region>.oraclecloud.com/n/<namespace>/b/<bucket-name>/o/SRC_OCIGGLL.dmp','ADB_OBJECTSTORE',null,DBMS_DATAPUMP.KU$_FILE_TYPE_URIDUMP_FILE);


-- A metadata remap will map all schema objects from SRC_OCIGGLL to SRCMIRROR_OCIGGLL.
DBMS_DATAPUMP.METADATA_REMAP(h1,'REMAP_SCHEMA','SRC_OCIGGLL','SRCMIRROR_OCIGGLL');

-- If a table already exists in the destination schema, skip it (leave
-- the preexisting table alone). This is the default, but it does not hurt
-- to specify it explicitly.
DBMS_DATAPUMP.SET_PARAMETER(h1,'TABLE_EXISTS_ACTION','SKIP');

-- Start the job. An exception is returned if something is not set up properly.
DBMS_DATAPUMP.START_JOB(h1);

-- The import job should now be running. In the following loop, the job is
-- monitored until it completes. In the meantime, progress information is
-- displayed. Note: this is identical to the export example.
percent_done := 0;
job_state := 'UNDEFINED';
while (job_state != 'COMPLETED') and (job_state != 'STOPPED') loop
  dbms_datapump.get_status(h1,
    dbms_datapump.ku$_status_job_error +
    dbms_datapump.ku$_status_job_status +
    dbms_datapump.ku$_status_wip,-1,job_state,sts);
    js := sts.job_status;

  -- If the percentage done changed, display the new value.
  if js.percent_done != percent_done
  then
    dbms_output.put_line('*** Job percent done = ' ||
    to_char(js.percent_done));
    percent_done := js.percent_done;
  end if;

  -- If any work-in-progress (WIP) or Error messages were received for the job, display them.
  if (bitand(sts.mask,dbms_datapump.ku$_status_wip) != 0)
  then
    le := sts.wip;
  else
    if (bitand(sts.mask,dbms_datapump.ku$_status_job_error) != 0)
    then
      le := sts.error;
    else
      le := null;
    end if;
  end if;
  if le is not null
  then
    ind := le.FIRST;
    while ind is not null loop
      dbms_output.put_line(le(ind).LogText);
      ind := le.NEXT(ind);
    end loop;
  end if;
end loop;

-- Indicate that the job finished and gracefully detach from it.
dbms_output.put_line('Job has completed');
dbms_output.put_line('Final job state = ' || job_state);
dbms_datapump.detach(h1);
END;

Tâche 6 : Ajouter et exécuter un processus de réplication non intégrée

Ajoutez et exécutez une réplication.

Dans l'écran Fichier de paramètre, remplacez MAP *.*, TARGET *.*; par le script suivant :

-- Capture DDL operations for listed schema tables
--
ddl include mapped
--
-- Add step-by-step history of ddl operations captured
-- to the report file. Very useful when troubleshooting.
--
ddloptions report
--
-- Write capture stats per table to the report file daily.
--
report at 00:01
--
-- Rollover the report file weekly. Useful when PR runs
-- without being stopped/started for long periods of time to
-- keep the report files from becoming too large.
--
reportrollover at 00:01 on Sunday
--
-- Report total operations captured, and operations per second
-- every 10 minutes.
--
reportcount every 10 minutes, rate
--
-- Table map list for apply
--
DBOPTIONS ENABLE_INSTANTIATION_FILTERING;
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;

Note :

DBOPTIONS ENABLE_INSTATIATION_FILTERING permet le filtrage du CSN sur les tables importées à l'aide d'Oracle Data Pump. Pour plus d'informations, voir Informations de référence sur DBOPTIONS.

Effectuez des modifications dans la base de données A pour voir celles-ci répliquées dans la base de données B.

Tâche 7 : Configurer la réplication de la base de données B vers la base de données A

Les tâches 1 à 6 ont configuré la réplication de la base de données A vers la base de données B. Les étapes suivantes permettent de configurer la réplication de la base de données B vers la base de données A.

Ajoutez et exécutez un processus d'extraction sur la base de données B. Dans la page des paramètres d'extraction, après EXTRAIL <extract-name>, ajoutez :
```
-- Table list for capture
table SRCMIRROR_OCIGGLL.*;

-- Exclude changes made by GGADMIN
tranlogoptions excludeuser ggadmin
```
Ajoutez et exécutez un processus de réplication vers la base de données A. Dans la page Paramètres, remplacez MAP *.*, TARGET *.*; par :
```
MAP SRCMIRROR_OCIGGLL.*, TARGET SRC_OCIGGLL.*;
```
Effectuez des modifications dans la base de données B pour voir celles-ci répliquées dans la base de données A.