Répliquer des données d'Autonomous Transaction Processing vers Azure Synapse Analytics

Avant de commencer

Pour suivre ce démarrage rapide, vous devez disposer des éléments suivants :

Espace de travail Azure Synapse
Conteneur de stockage Azure associé à Azure Synapse Workspace
Azure Synapse Données d'identification incluses dans la base de données pour autoriser le groupe SQL à accéder au compte de stockage
Existence de la table cible : Les tables cibles doivent exister dans la base de données Synapse avant la réplication. Comme GoldenGate utilise l'énoncé SQL de fusion, la table cible doit être une table distribuée avec hachage.
Connexion de stockage du lac de données Azure OCI GoldenGate affectée au déploiement. S'il n'existe pas, créez une connexion de stockage du lac de données Azure et affectez-la au déploiement.

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;
```

Configuration de l'environnement : Azure Synapse

Ouvrez Azure Synapse Workspace.
Cliquez sur New (Nouveau), puis sur SQL Script.
Connectez-vous au groupe SQL et sélectionnez la base de données.
Entrez la commande suivante pour créer un chiffrement de clé principale :
```
CREATE MASTER KEY ENCRYPTION BY PASSWORD='<password>';
```
Utilisez la commande suivante pour créer des données d'identification avec étendue de base de données :
Assurez-vous de remplacer les paramètres fictifs <storage-account-name> et <storage-account-access-key> par leurs valeurs réelles.
```
CREATE DATABASE SCOPED CREDENTIAL <credential name>
WITH
IDENTITY='<storage-account-name>',
SECRET='<storage-account-access-key>';
```

Exécutez le script de création de table :

CREATE TABLE [dbo].[SRC_CUSTOMER] (
   CUSTID         NUMERIC(10) NOTNULL,
   DEAR           NUMERIC(1),
   LAST_NAME      VARCHAR(50),
   FIRST_NAME     VARCHAR(50),
   ADDRESS        VARCHAR(100),
   CITY_ID        NUMERIC(10),
   PHONE          VARCHAR(50),
   AGE            NUMERIC(3),
   SALES_PERS_ID  NUMERIC(10),
   constraint PK_SRC_CUSTOMER primarykeyNONCLUSTERED (CUSTID) NOT ENFORCED
)
WITH(DISTRIBUTION=HASH ([CUSTID]), HEAP ) GO

Vérifiez que la table dbo.SRC_Customer est créée.

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éer un déploiement du service de mégadonnées pour Azure Synapse cible.
Créer une connexion à la base de données Autonomous Transaction Processing source.
Créez une connexion à Azure Synapse Analytics.
Créez une connexion à Azure Data Lake Storage.
Affectez la connexion Autonomous Transaction Processing au déploiement Oracle source.
Affectez une connexion Azure Synapse 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 la console de déploiement du service de mégadonnées cible, cliquez sur Administrator Service, puis sur Ajouter Replicat (icône plus).
Ajoutez une valeur Replicat avec les valeurs suivantes :
1. Dans la page Informations sur Replicat, sous le type Replicat, sélectionnez Classic Replicat, entrez un nom de processus, puis cliquez sur Suivant.
2. Dans la page Replication Options :
  - Pour Nom, entrez le nom de la piste de la tâche 2.
  - Pour Domaine, sélectionnez un domaine.
  - Pour Alias, sélectionnez la connexion à Azure Synapse Analytics créée au cours de la tâche 1.
  - Pour Table de points de vérification, sélectionnez la table que vous avez créée pour le déploiement cible.
3. Dans la page Paramètres Replicat, remplacez MAP *.*, TARGET *.*; par :
```
MAP SRC_OCIGGLL.SRC_CUSTOMER, TARGET dbo.SRC_CUSTOMER;
```
4. Cliquez sur Créer et exécuter.

Vous retournez à la page Aperçu, où vous pouvez consulter les détails de Replicat.

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 Azure Data Lake.

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 Database Actions, sélectionnez SQL.
Entrez les informations suivantes dans la feuille de calcul et cliquez sur Exécuter le script.

Dans la console de déploiement d'OCI GoldenGate source, sélectionnez le nom Extract, puis cliquez sur Statistiques. Vérifiez que SRC_OCIGGLL.SRC_CUSTOMER comporte 7 insertions.

Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1001,0,'Brendt','Paul','10 Jasper Blvd.',107,'(212) 555 2146',19,10);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1002,0,'McCarthy','Robin','27 Pasadena Drive',11,'(214) 555 3075',29,11);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1003,0,'Travis','Peter','7835 Hartford Drive',12,'(510) 555 4448',34,12);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1004,0,'Larson','Joe','87 Carmel Blvd.',13,'(213) 555 5095',45,13);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1005,0,'Goldschmidt','Tony','91 Torre drive',14,'(619) 555 6529',55,20);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1006,0,'Baker','William','2890 Grant Avenue',15,'(312) 555 7040',64,21);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1007,0,'Swenson','Jack','64 Imagination Drive',19,'(202) 555 8125',74,22)

Dans la console de déploiement GoldenGate du service de mégadonnées cible, sélectionnez le nom Replicat, puis cliquez sur Statistiques. Vérifiez que SRC_OCIGGLL.SRC_CUSTOMER comporte 7 insertions.
Dans la console Azure, naviguez jusqu'à la console de l'espace de travail Azure Synapse. Exécutez Select * dans dbo.SRC_CUSTOMER et vérifiez que SRC_OCIGGLL.SRC_CUSTOMER comporte 7 insertions.