Répliquer des données à partir d'une base de données Autonomous Transaction Processing vers le service de stockage d'objets pour OCI

Avant de commencer

Pour terminer ce démarrage rapide :

Une clé d'API créée et téléchargée à partir de la page des détails de l'utilisateur
Une instance Autonomous Transaction Processing source
Votre OCID de compartiment

Configuration de l'environnement : Autonomous Transaction Processing

Si vous n'avez pas encore de base de données source configurée pour la réplication, vous pouvez suivre ces étapes pour charger un exemple de schéma à utiliser pour ce démarrage rapide. Ce démarrage rapide utilise Autonomous Transaction Processing pour la base de données source.

Pour configurer la base de données autonome source :

Téléchargez et décompressez l'exemple de schéma de base de données.
Dans la console Oracle Cloud, sélectionnez votre instance Autonomous Transaction Processing (ATP) dans la page des bases de données autonomes pour en voir les détails et accéder à Database Actions.
Déverrouillez l'utilisateur GGADMIN :
1. Cliquez sur Actions de base de données, puis sur Utilisateurs de base de données.
2. Localisez GGADMIN, puis cliquez sur le menu Actions (points de suspension) associé et sélectionnez Modifier.
3. Dans le panneau Modifier l'utilisateur, entrez le mot de passe de GGADMIN, confirmez-le, puis désélectionnez Le compte est verrouillé.
4. Cliquez sur Appliquer les modifications.
Chargez les exemples de schéma et de données-échantillons sources :
1. Dans le menu Actions de base de données, sous Développement, sélectionnez SQL.
2. Copiez et collez le script à partir de OCIGGLL_OCIGGS_SETUP_USERS_ATP.sql dans la feuille de calcul SQL.
3. Cliquez sur Exécuter le script. L'onglet Sortie du script affiche des messages de confirmation.
4. Effacer la feuille de calcul SQL, puis copier et coller le script SQL à partir de OCIGGLL_OCIGGS_SRC_USER_SEED_DATA.sql.
  
  Conseil :
  Vous devrez peut-être exécuter chaque énoncé séparément pour que l'outil SQL exécute les scripts avec succès.
5. Pour vérifier que les tables ont é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 dans les listes déroulantes correspondantes.
Activez la journalisation supplémentaire :
1. Effacez la feuille de calcul SQL.
2. Entrez l'énoncé suivant, puis cliquez sur Exécuter l'énoncé :
```
ALTER PLUGGABLE DATABASE ADD SUPPLEMENTAL LOG DATA;
```

Tâche 1 : Créer des ressources GoldenGate pour OCI

Cet exemple de démarrage rapide nécessite des déploiements et des connexions pour la source et la cible.

Créez un déploiement Oracle pour l'instance Autonomous Transaction Processing source.
Créez un déploiement du service de mégadonnées pour le seau de stockage d'objets OCI cible.
Créez une connexion pour l'instance Autonomous Transaction Processing source.
Créez une connexion pour le service de stockage d'objets pour OCI cible.
Créez une connexion à GoldenGate, puis assignez cette connexion au déploiement Oracle source.
Affectez la connexion Autonomous Transaction Processing au déploiement Oracle source.
Affectez la connexion du service de stockage d'objets pour OCI au déploiement du service de mégadonnées cible.

Tâche 2 : Ajouter Extract

Dans la page Déploiements, sélectionnez le déploiement Autonomous Transaction Processing source.
Dans la page des détails du déploiement, cliquez sur Lancer la console.
Connectez-vous avec le nom d'utilisateur et le mot de passe de l'administrateur du déploiement source.
Ajoutez des informations sur les transactions.
Ajoutez un fichier Extract.

Tâche 3 : Ajouter et exécuter Distribution Path

Si vous utilisez le magasin de données d'identification GoldenGate, créez un utilisateur pour le chemin de répartition dans le déploiement du service de mégadonnées cible, sinon passez à l'étape 3.
Dans la console de déploiement source ATP GoldenGate, ajoutez une connexion de chemin pour l'utilisateur créé à l'étape 1.
1. Dans la console de déploiement ATP GoldenGate source, cliquez sur Connexions de chemin dans la barre de navigation de gauche.
2. Cliquez sur Ajouter une connexion de chemin (icône plus), puis effectuez les opérations suivantes :
  1. Pour Alias de données d'identification, entrez GGSNetwork.
  2. Pour ID utilisateur, entrez le nom de l'utilisateur créé à l'étape 1.
  3. Entrez deux fois le mot de passe de l'utilisateur pour vérification.
3. Cliquez sur Soumettre.
  
  La connexion de chemin apparaît dans la liste Connexions de chemin.
Dans la console de déploiement ATP source, ajoutez un chemin de répartition avec les valeurs suivantes :
1. Dans la page Options sources :
  - Pour Processus d'extraction source, sélectionnez le processus d'extraction créé au cours de la tâche 2.
  - Pour Nom de la piste, entrez un nom à deux caractères, par exemple E1.
2. Dans la page Options cibles :
  - Pour Hôte cible, entrez le domaine hôte du déploiement cible.
  - Pour Numéro de port, entrez 443.
  - Pour Nom de la piste, entrez un nom à deux caractères, par exemple E1.
  - Pour Alias, entrez l'alias de données d'identification créé à l'étape 2.
Dans la console de déploiement du service de mégadonnées cible, vérifiez la valeur Receiver Path créée à la suite de Distribution Path.
1. Dans la console de déploiement du service de mégadonnées cible, cliquez sur Receiver Service.
2. Vérifiez les détails du chemin. Ce chemin a été créé à la suite de Distribution Path créé à l'étape précédente.

Tâche 4 : Ajouter et exécuter Replicat

Dans le menu de navigation de la console de déploiement du service de mégadonnées cible, cliquez sur Replicats.
Dans la page Replicats, cliquez sur Ajouter Replicat (icône plus), puis remplissez le formulaire comme suit :
1. Dans la page Informations sur Replicat :
  1. Pour Type Replicat, sélectionnez Classic Replicat.
  2. Pour Nom du processus, entrez un nom, par exemple REP
2. Dans la page Options Replicat :
  1. Pour Nom de la piste Replicat, entrez un nom à deux caractères, par exemple E1.
  2. Pour Cible, sélectionnez Stockage d'objets pour OCI
3. Dans la page Fichier de paramètres, remplacez MAP *.*, TARGET *.*; par :
```
MAP SRC_OCIGGLL.*, TARGET *.*;
```
4. Dans la page Fichier de propriétés, configurez les propriétés du gestionnaire d'événements OCI si nécessaire.
  Propriétés requises :
  - gg.eventhandler.oci.compartmentID : OCID du compartiment dans lequel réside le seau de stockage d'objets OCI.
  - gg.handler.oci.fileNameMappingTemplate : Génère les 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 les suivantes :
  - gg.handler.oci.format : Sélectionnez comment mettre en forme la sortie. json_row est le réglage par défaut. Les options disponibles sont les suivantes :
    
    delimitedtext
    
    json
    
    json_row
    
    xml
    
    avro_row_ocf
    
    avro_op_ocf
    
    Conseil :
    Pour utiliser la propriété de mise en forme pour le stockage d'objets OCI, 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 laisse ouvert en écriture. Cette propriété ferme le fichier après la période d'inactivité désignée (aucune transaction entrante), puis le charge dans le stockage d'objets OCI. Par défaut, la valeur est de 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 fichiers ouvre le fichier et le laisse ouvert jusqu'à ce qu'il atteigne la taille de fichier maximale, en supposant que les métadonnées ne soient pas modifiées. Par défaut, la taille de fichier maximale est de 1 Go. Vous pouvez toutefois 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". Lorsque cette option est réglée à Vrai, GoldenGate ferme le fichier ouvert lorsque vous arrêtez le processus Replicat. Par défaut, le programme de traitement de fichiers laisse le fichier ouvert même si Replicat s'arrête et continue d'écrire dans le même fichier lorsque Replicat redémarre. 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, la valeur est de 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 du seau de stockage d'objets.
5. Cliquez sur Créer et exécuter.

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

Apportez des mises à jour à l'instance Autonomous Transaction Processing source pour vérifier la réplication vers le stockage d'objets OCI.

Dans la console Oracle Cloud, ouvrez le menu de navigation, sélectionnez Oracle Database, puis Autonomous Transaction Processing.
Dans la liste des instances Autonomous Transaction Processing, sélectionnez votre instance source pour en voir les détails.
Dans la page des détails de la base de données, cliquez sur Database actions.

Note :
Vous devez être connecté automatiquement. Sinon, connectez-vous à l'aide des données d'identification de la base de données.
Dans la page d'accueil Actions de base de données, sélectionnez SQL.

Entrez les informations suivantes 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 ATP source, sélectionnez le nom du processus d'extraction, puis cliquez sur Statistiques. Vérifiez que SRC_OCIGGLL.SRC_CITY comporte 10 insertions.
Dans la console de déploiement de GoldenGate pour OCI du service de mégadonnées cible, sélectionnez le nom du processus d'extraction, puis cliquez sur Statistiques. Vérifiez que SRC_OCIGGLL.SRC_CITY comporte 10 insertions.
Dans la console Oracle Cloud, naviguez jusqu'au seau de stockage d'objets OCI et vérifiez son contenu.

Tâche 6 : Surveiller et tenir à jour les processus

En savoir plus

En savoir plus sur les détails de configuration et les formats de fichier pris en charge.