Réplication de données d'Amazon RDS pour Oracle vers Oracle Object Storage

Découvrez comment répliquer des données d'Amazon RDS pour Oracle vers Oracle Object Storage à l'aide d'Oracle Cloud Infrastructure GoldenGate.

Avant de commencer

Pour mener à bien ce démarrage rapide, vous devez disposer des éléments suivants :

Connectez-vous à votre compte Oracle Cloud.
Instance Amazon RDS pour Oracle source, expliquée dans la configuration de l'environnement.

Configuration de l'environnement : Amazon RDS pour Oracle

Provisionner une instance Amazon RDS pour Oracle, puis utiliser les étapes suivantes pour configurer une base de données source à utiliser avec Oracle GoldenGate.

Activez la journalisation supplémentaire sur la base de données source.
Définissez le paramètre d'initialisation ENABLE_GOLDENGATE_REPLICATION sur true.
Activez l'archivage sur la base de données source et conservez les fichiers de journalisation archivés.
Créez un compte utilisateur Oracle GoldenGate sur la base de données source.

Accordez des privilèges de compte utilisateur sur la base de données source.

GRANT CREATE SESSION, ALTER SESSION TO GGADMIN;
GRANT RESOURCE TO GGADMIN;
GRANT SELECT ANY DICTIONARY TO GGADMIN;
GRANT FLASHBACK ANY TABLE TO GGADMIN;
GRANT SELECT ANY TABLE TO GGADMIN;
GRANT EXECUTE ON DBMS_FLASHBACK TO GGADMIN;
GRANT SELECT ON SYS.V_$DATABASE TO GGADMIN;
GRANT ALTER ANY TABLE TO GGADMIN;
EXEC rdsadmin.rdsadmin_dbms_goldengate_auth.grant_admin_privilege (
grantee                 => 'GGADMIN',
privilege_type          => 'capture',
grant_select_privileges => true,
do_grants               => TRUE);

Téléchargez et décompressez le schéma échantillon de base de données.
Chargez le schéma échantillon source et les données :
1. Connectez-vous à l'instance Amazon RDS for Oracle à partir de SQL Developer en tant qu'utilisateur SRC_OCIGGLL.
2. Copiez le script d'OCIGGLL_OCIGGS_SETUP_USERS_ATP.sql et collez- le dans la feuille SQL Worksheet.
3. Sélectionnez Exécuter le script. L'onglet Sortie de script affiche des messages de confirmation.
4. Effacez la feuille SQL Worksheet, puis copiez et collez le script SQL à partir de OCIGGLL_OCIGGS_SRC_USER_SEED_DATA.sql.
  
  A savoir : Vous devrez peut- être exécuter chaque instruction séparément pour que l'outil SQL parvien à exécuter les scripts.
5. Pour vérifier que les tables ont bien été créées, fermez la fenêtre SQL et rouvrez-la. Dans l'onglet Navigateur, recherchez le schéma SRC_OCIGGLL, puis sélectionnez des tables à partir des listes déroulantes correspondantes.

Tâche 1 : créer les ressources OCI GoldenGate

Créez un déploiement Oracle pour l'instance Amazon RDS pour Oracle source.
Créez un bucket Oracle Object Storage cible de déploiement Big Data.
Créez une connexion pour l'instance Amazon RDS source pour Oracle.
Créez une connexion pour le stockage Oracle Object Storage cible.
Si votre déploiement Big Data ne dispose pas d'adresse publique, créez une connexion à GoldenGate, puis affectez cette connexion au déploiement Oracle source.
Affectez la connexion Amazon RDS pour Oracle au déploiement Oracle source.
Affectez la connexion à Oracle Object Storage au déploiement Big Data cible.
Affectez la connexion GoldenGate au déploiement Oracle source.

Tâche 2 : ajouter et exécuter l'extraction

Sur la page Déploiements, sélectionnez le déploiement Amazon RDS source pour le déploiement Oracle.
Sur la page de détails du déploiement, sélectionnez Lancer la console.
Connectez-vous avec le nom utilisateur et le mot de passe de l'administrateur du déploiement source.
Ajoutez une extraction.

Tâche 3 : ajouter et exécuter le chemin de distribution

Si vous utilisez la banque d'informations d'identification GoldenGate, créez un utilisateur pour le chemin de distribution dans le déploiement Big Data de la cible, sinon passez à l'étape 3.
Dans la console de déploiement GoldenGate source, ajoutez une connexion de chemin pour l'utilisateur créé à l'étape 1.
1. Dans la console de déploiement GoldenGate source, sélectionnez Connexions de chemin dans la navigation de gauche.
2. Sélectionnez Ajouter une connexion de chemin (icône Plus), puis procédez comme suit :
  1. Dans Alias d'informations d'identification, entrez GGSNetwork.
  2. Saisissez le nom de l'utilisateur créé à l'étape 1 dans ID utilisateur.
  3. Indiquez le mot de passe de l'utilisateur à deux reprises pour vérification.
3. Sélectionnez Soumettre.
  
  La connexion par chemin apparaît dans la liste Connexions par chemin.
Dans la console de déploiement source, ajoutez un chemin de distribution avec les valeurs suivantes :
1. Sur la page Options source :
  - Dans Extraction source, sélectionnez l'extraction créée dans la tâche 2.
  - Dans Nom de la trace, saisissez un Nom à deux caractères, tel que E1
2. Sur la page Options cible :
  - Dans Hôte cible, entrez le domaine hôte du déploiement cible.
  - Dans Numéro de port, saisissez 443.
  - Dans Nom de la trace, saisissez un Nom à deux caractères, tel que E1
  - Dans Alias, entrez l'alias d'informations d'identification créé à l'étape 2.
Dans la console de déploiement Big Data de la cible cible, vérifiez le Chemin de destinataire créé consécutivements au chemin de distribution.
1. Dans la console de déploiement Big Data cible, sélectionnez Service de destinataire.
2. Consultez les détails du chemin. Ce chemin a été créé consécutivement à la création du chemin de distribution, à l'étape précédente.

Tâche 4 : ajouter et exécuter la réplication

Dans le menu de navigation de la console de déploiement Big Data cible, sélectionnez Réplications.
Sur la page Répliques, sélectionnez Ajouter une réplication (icône Plus), puis remplissez le formulaire comme suit :
1. Dans la page Replicat Information :
  1. Pour Type de réplication, sélectionnez Réplication classique.
  2. Dans Nom de processus, entrez un nom, tel que REP
2. Dans la page Replicat Options :
  1. Dans Nom de piste de réplication, saisissez un nom à deux caractères, tel que E1.
  2. Dans Cible, sélectionnez Oracle Object Storage.
3. Dans la page Parameter File, remplacez MAP *.*, TARGET *.*; par :
```
MAP SRC_OCIGGLL.*, TARGET *.*;
```
4. Sur la page Fichier de biens, configurez des propriétés de gestionnaire d'événements OCI selon vos besoins.
  
  Propriétés requises :
  - gg.eventhandler.oci.compartmentID : OCID du compartiment dans lequel réside le bucket Oracle Object Storage.
  - gg.handler.oci.fileNameMappingTemplate : génère des noms de fichier de manière dynamique à l'aide de mots-clés de modèle.
  Les propriétés que vous pouvez envisager de modifier sont par exemple les suivantes :
  - gg.handler.oci.format : sélectionnez le format de la sortie. json_row est le paramètre par défaut. Les options disponibles sont les suivantes :
    - delimitedtext
    - json
    - json_row
    - xml
    - avro_row_ocf
    - avro_op_ocf
      
      A savoir : Afin d'utiliser la propriété de formatage pour Oracle Object Storage, remplacez name par oci. Par exemple, gg.handler.name.format devient gg.handler.oci.format.
  - gg.handler.oci.inactivityRollInterval : GoldenGate crée un fichier et le garde ouvert pour écriture. Cette propriété ferme le fichier après la période d'inactivité indiquée (pas de transaction entrante), puis le charge dans Oracle Object Storage. Par défaut, elle est définie sur 5 secondes. Vous pouvez spécifier une durée en millisecondes (ms), secondes (s), minutes (m) ou heures (h). Par exemple, gg.handler.oci.inactivityRollInterval=10m.
  - gg.handler.oci.maxFileSize : le gestionnaire de processus d'écriture de fichier ouvre le fichier et le garde ouvert jusqu'à ce qu'il atteigne la taille de fichier maximale, en supposant qu'aucune modification de métadonnées n'ait lieu. Par défaut, la taille de fichier maximale est de 1 Go, mais vous pouvez la modifier à l'aide de cette propriété. Lorsque la taille est atteinte, le fichier est fermé et un nouveau fichier est généré. Par exemple, gg.handler.oci.maxFileSize=500m.
  - gg.handler.oci.rollOnShutdown : la valeur par défaut est True. Si cette propriété est définie sur True, GoldenGate ferme le fichier ouvert lorsque vous arrêtez le processus de réplication. Par défaut, le gestionnaire de processus d'écriture de fichier garde le fichier ouvert même si la réplication s'arrête et continue d'écrire dans ce fichier au redémarrage de la réplication. Par exemple, gg.handler.oci.rollOnShutdown=false.
  - gg.handler.oci.fileRollInterval : indique la durée pendant laquelle garder le fichier ouvert avant sa fermeture et le passage à un nouveau fichier. Par défaut, cette propriété est définie sur 7 minutes. Vous pouvez spécifier une durée en millisecondes (ms), secondes (s), minutes (m) ou heures (h). Par exemple, gg.handler.oci.fileRollInterval=10m.
  - gg.eventhandler.oci.bucketMappingTemplate : entrez le nom de bucket Oracle Object Storage.
5. Sélectionnez Créer et exécuter.

Tâche 5 : vérifier la réplication

Effectuez certaines mises à jour de l'instance Amazon RDS for Oracle source afin de vérifier la réplication vers Oracle Object Storage.

Connectez-vous à l'instance Amazon RDS for Oracle à partir de SQL Developer en tant qu'utilisateur SRC_OCIGGLL.

Entrez ce qui suit dans la feuille de calcul et cliquez sur Exécuter le script.

Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1000,'Houston',20,743113);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1001,'Dallas',20,822416);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1002,'San Francisco',21,157574);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1003,'Los Angeles',21,743878);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1004,'San Diego',21,840689);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1005,'Chicago',23,616472);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1006,'Memphis',23,580075);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1007,'New York City',22,124434);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1008,'Boston',22,275581);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1009,'Washington D.C.',22,688002);

Dans la console de déploiement GoldenGate OCI GoldenGate source, sélectionnez le nom de l'extraction, puis sélectionnez Statistiques. Vérifiez que SRC_OCIGGLL.SRC_CITY comporte 10 insertions.
Dans la console de déploiement Big Data OCI GoldenGate cible, sélectionnez le nom de réplication, puis cliquez sur Statistiques. Vérifiez que SRC_OCIGGLL.SRC_CITY comporte 10 insertions.