Ajout d'une table à un ensemble de réplication

Vous pouvez ajouter ou supprimer des tables d'un ensemble de réplication existant et modifier le nom de l'ensemble.

Avant de commencer

Cette tâche est effectuée sur l'hôte du cluster pour la source de réplication. Veillez à collecter les informations suivantes avant d'exécuter l'appel API:

  • Jeton d'autorisation de base de la source sur l'hôte du cluster.1
  • Nom d'hôte de la base de données source de réplication.
  • Numéro de port externe de la base de données source de réplication.2
  • Le nom de l'ensemble de réplication (rsName)3
  • Nom du groupe de cohérence (cgName)
  • Le nom de l'abonnement (subName)4
Vous avez besoin de ces informations pour exécuter les appels d'API REST de réplication nécessaires.
1 Vous devez créer un jeton d'autorisation de base pour exécuter une demande cURL . Pour créer votre jeton, exécutez la commande suivante:
echo <source_db_username>:<source_db_password>| base64
2 Vous pouvez extraire le numéro de port externe de la base de données source de réplication en exécutant la commande suivante:
oc get svc | grep <db2_instance_id> | grep db2u-engn-svc | grep 50001 | sed 's/.*50001://' | sed 's/\/TCP.*//')
3 Vous pouvez trouver le nom de l'ensemble de réplication (rsName) et le nom du groupe de cohérence (cgName) en exécutant la commande suivante:
curl --insecure -X GET --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Basic <your_authorization_token>' 
'https://<source_hostname>:<source_rest_port>/dr/v1/replicationset'
4 Lorsque vous avez les valeurs rsName et cgName , vous pouvez les utiliser pour rechercher le nom de l'abonnement (subName) en exécutant la commande suivante:
curl --insecure -X GET --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Basic <your_authorization_token>' 
'https://<source_hostname>:<source_rest_port>/dr/v1/<replication_set_name>/<consistency_group_name>'

A propos de cette tâche

L'ensemble de réplication est identifié par les noms de l'ensemble de réplication et des groupes de cohérence. L'ajout de tables ne modifie en rien la réplication pour les tables qui sont déjà dans l'ensemble.
Remarque: Si vous spécifiez true pour skipLoad, le chargement initial de la nouvelle table n'est pas chargé sur la cible initialement.

Procédure

  1. Ajoutez une table à un ensemble de réplication existant:
    curl --insecure -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Basic <your_authorization_token>' -d '{ "sourceHost": "<source_host_name>", "sourceDatabase": "BLUDB", "sourcePort": <source_rest_port>, "targetHost": "<target_host_name>", "targetDatabase": "BLUDB", "targetPort": <target_rest_port>, "tables": [ { "sourceSchema": "<source_table_schema>, "sourceTable": "<source_table_name>", "skipLoad": false } ], }' 'https://dr-<source_hostname>:<source_rest_port>/dr/v1/replicationset/<replication_set_name>/<consistency_group_name>/table'
    Cet appel API renvoie un numéro de travail (id).
    {
  "id": <job_number>,
  "url": "https://<source_hostname>:<source_rest_external_port>/dr/v1/target/progress/<job_number>"
}
  2. Incluez le numéro de travail dans l'appel d'API suivant pour vérifier la progression de la création de l'ensemble de réplication:
    curl --insecure -X GET --header 'Accept: application/json' --header 'Authorization: Basic <your_authorization_token>' 
'https://<source_hostname>:<source_rest_port>/dr/v1/replicationset/progress/<job_number>'

Résultats

Lorsqu'une table est ajoutée à un ensemble de réplication avec executionState=COMPLETED et overallJobResult=PASS dans la réponse, la table ajoutée est prête à être répliquée. Jusqu'à ce que ces valeurs soient renvoyées, examinez le code d'erreur, le message et la résolution dans la réponse.
Codes de statut HTTP Motif Modèle de réponse
202 Ajout de table démarré La demande de l'utilisateur renvoie une réponse indiquant que l'appel de l'API a abouti (exemple de valeur):
{
  "id": 9,
  "url": "https://dr-source1.ibm.com:31023/dr/v1/replicationset/progress/9
}

Sample value from replication set status retrieved:
{
   "id": 9,
  "url": "https://dr-source1.ibm.com:31023/dr/v1/replicationset/progress/9",
  "executionState": "COMPLETED",
  "overallJobResult": "PASS",
  "jobStatusList": [
    {
      "jobKey": "addTableCg",
      "jobDescription": "Add table(s) to consistency group for replication set.",
      "execState": "COMPLETED",
      "jobResult": "PASS",
      "values": [],
      "errors": []
    }
  ]
}
200 La vérification du statut de l'API a abouti La demande de l'utilisateur renvoie un travail (id) et URL au début de l'appel API (valeur échantillon) :

{
  "id": 9,
  "url": "https://dr-source1.ibm.com:31023/dr/v1/replicationset/progress/9
}
4xx Erreur de demande du client La demande de l'utilisateur n'a pas été satisfaite en raison d'une syntaxe de demande syntaxiquement incorrecte ou d'autres problèmes client:
{
  "errorCode": "string",
  "errorMessage": "string",
  "errorResolution": "string"
}
5xx Erreur de serveur La demande de l'utilisateur est apparue valide, mais n'a pas été satisfaite en raison d'un problème avec le serveur:
{
  "errorCode": "string",
  "errorMessage": "string",
  "errorResolution": "string"
}

Exemple

L'exemple suivant illustre la syntaxe de commande permettant d'ajouter une table à un ensemble de réplication. Voir l'étape 1:
curl --insecure -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Basic ZHNhZG06MDNRVWlMczFhcmoxb3ky' -d '{ "sourceHost": "dr-source1.ibm.com", "sourceDatabase": "BLUDB", "sourcePort": 32621, "targetHost": "dr-target2.ibm.com", "targetDatabase": "BLUDB", "targetPort": 30138, "tables": [ { "sourceSchema": "DRADMIN1", "sourceTable": "T5R", "skipLoad": false }, { "sourceSchema": "DRADMIN2", "sourceTable": "T5C", "skipLoad": false } ] }' 'https://dr-source1.ibm.com:31023/dr/v1/replicationset/DEMOREPLSET1/DEMORE0001/table'
L'exemple suivant illustre la syntaxe de commande permettant de vérifier le statut de la création de l'ensemble de réplication à l'aide du numéro de travail généré, 9. Voir l'étape 2:
curl --insecure -X GET --header 'Accept: application/json' --header 'Authorization: Basic ZHNhZG06MDNRVWlMczFhcmoxb3ky' 'https://dr-source1.ibm.com:30674/dr/v1/replicationset/progress/5'

Etape suivante

Suppression d'une ou plusieurs tables d'un ensemble de réplication