Récupération à un point de cohérence

IBM Cloud® Databases for PostgreSQL prend en charge la restauration à un instant donné (PITR) vers un point de restauration disponible au cours des 7 derniers jours. La fonctionnalité PITR restaure une sauvegarde dans un nouveau déploiement et rejoue les journaux de transactions conservés jusqu'au moment demandé.

La restauration à un instant donné (PITR) ne permet pas de rejouer les transactions lors d'une mise à niveau majeure sur place (IPMVU). Après une mise à niveau, vous pouvez effectuer une restauration à un moment antérieur au lancement de la tâche de mise à niveau, ou après la fin de la première sauvegarde du déploiement mis à niveau. Les restaurations à des moments situés entre la mise à niveau et la fin de la sauvegarde suivante ne sont pas prises en charge. Même une fois la sauvegarde terminée, certaines restaurations vers certains points peuvent être refusées par le service, tandis que d’autres peuvent être acceptées mais échouer au cours du processus de restauration.

Une fois la mise à niveau réussie, le service met automatiquement une sauvegarde en file d'attente. À partir du moment où les écritures reprennent et jusqu'à la fin de cette sauvegarde, les restaurations vers le dernier point de récupération disponible échouent également.

Après une mise à niveau ayant échoué, vérifiez la version d' PostgreSQL: SHOW server_version;. Si la commande indique la version source et que le déploiement accepte les écritures, effectuez une sauvegarde à la demande. Sinon, contactez le support. Pour plus d'informations, consultez la section Sauvegardes et restauration pour IPMVU.

L'onglet Sauvegardes et restaurations de l'interface utilisateur de votre déploiement regroupe toutes vos informations PITR ( restauration à un instant donné) sous la rubrique Restauration à un instant donné.

Si l'heure de restauration demandée est postérieure à la dernière transaction disponible, l'opération de restauration échoue et le message suivant s'affiche recovery ended before configured recovery target was reached. Si votre restauration échoue pour cette raison, sélectionnez Restaurer au dernier point disponible. Vous pouvez également choisir une date et une heure antérieures pour effectuer une restauration à un moment précis au cours des 7 derniers jours. Pendant une opération IPMVU et jusqu’à ce que la première sauvegarde du déploiement mis à niveau soit terminée, une restauration vers le dernier point disponible peut échouer.

Les informations incluses correspondent au moment le plus ancien pour une récupération à un point de cohérence. Pour découvrir le point de récupération le plus ancien via l'interface de ligne de commande, utilisez la commande cdb postgresql earliest-pitr-timestamp.

ibmcloud cdb postgresql earliest-pitr-timestamp <INSTANCE_NAME_OR_CRN>

Pour découvrir le point de récupération le plus ancien via l'API, utilisez le noeud final /deployments/{id}/point_in_time_recovery_data afin de trouver le moment de récupération à un point de cohérence le plus ancien.

{
    "point_in_time_recovery_data": {
        "earliest_point_in_time_recovery_time": "2019-09-09T23:16:00Z"
    }
}

Récupération

Les sauvegardes sont restaurées dans un nouveau déploiement. Une fois que le nouveau déploiement a terminé la mise à disposition, vos données du fichier de sauvegarde sont restaurées dans le nouveau déploiement. Les sauvegardes sont également restaurables sur les comptes, mais uniquement à l'aide de l'API et uniquement si l'utilisateur qui exécute la restauration a accès aux comptes source et de destination.

Par défaut, le nouveau déploiement est automatiquement dimensionné avec la même allocation de disque et de mémoire que le déploiement source au moment de la sauvegarde à partir de laquelle vous effectuez la restauration. Cela concerne particulièrement PITR qui risque de ne pas être de la même taille que la taille actuelle de votre déploiement. Si vous devez ajuster les ressources allouées au nouveau déploiement, utilisez les zones facultatives de l'interface utilisateur, de l'interface de ligne de commande ou de l'API pour redimensionner le nouveau déploiement. Veillez à procéder à une allocation suffisante en fonction de vos données et de votre charge de travail. Si le déploiement ne dispose pas des ressources suffisantes, la restauration échoue.

Alors que le stockage et la mémoire sont restaurés au même niveau que le déploiement source, les configurations d'instance spécifiques ne sont pas automatiquement définies pour la nouvelle instance. Dans ce cas, il peut être nécessaire de réexécuter la configuration après une restauration. Notez toutes les modifications apportées à l'instance avant de lancer la restauration (paramètres tels que shared_buffers, max_connections, deadlock_timeout, archive_timeout, et autres) afin de garantir un paramétrage correct de l'instance une fois la restauration terminée.

Il est important de ne pas supprimer le déploiement source pendant la restauration de la sauvegarde. Vous devez attendre que le nouveau déploiement soit mis à disposition et que la sauvegarde soit restaurée avant de supprimer l'ancien déploiement. La suppression d'un déploiement entraîne également la suppression de ses sauvegardes; non seulement la restauration échouera, mais vous risquez également de ne plus pouvoir récupérer la sauvegarde.

Reprise dans l'interface utilisateur

Pour lancer un PITR, entrez l'heure à laquelle vous souhaitez procéder à la restauration en temps universel coordonné. Si vous souhaitez effectuer la restauration au point de cohérence disponible le plus récent, sélectionnez cette option. En cliquant sur le bouton Restaurer, la nouvelle interface utilisateur de provisionnement s'affiche dans un onglet avec les options de restauration. Saisissez les détails du service, allouez des ressources et définissez la version de la base de données, le cryptage et le point de terminaison pour votre nouveau déploiement. Cliquez sur Récupération ponctuelle pour lancer le processus.

Si vous utilisez Key Protect et disposez d'une clé, vous devez utiliser l'interface de ligne de commande (CLI) pour la récupérer; une commande est fournie à cet effet pour vous faciliter la tâche.

Reprise dans l'interface de ligne de commande

Le contrôleur de ressources prend en charge la mise à disposition des déploiements de base de données, et la mise à disposition et la restauration sont la responsabilité de l'interface de ligne de commande du contrôleur de ressources. Utilisez la commande resource service-instance-create.

Pour la récupération à un point de cohérence, utilisez les paramètres point_in_time_recovery_time et point_in_time_recovery_deployment_id. point_in_time_recovery_deployment_id est l'ID du déploiement source et point_in_time_recovery_time est l'horodatage en temps universel coordonné à restaurer. Pour restaurer le dernier point de cohérence disponible, utilisez "point_in_time_recovery_time":" ".

ibmcloud resource service-instance-create <databases-for-postgresql> <INSTANCE_NAME> <REGION> -p '{"point_in_time_recovery_deployment_id":"DEPLOYMENT_ID", "point_in_time_recovery_time":"TIMESTAMP", "version":" "}'

Une commande préformatée pour une sauvegarde ou une récupération à un point de cohérence spécifique est disponible dans la vue détaillée de la sauvegarde.

Lors de la restauration via l'interface de ligne de commande, des paramètres facultatifs sont disponibles. Utilisez-les pour personnaliser des ressources ou utilisez une clé Key Protect pour le chiffrement BYOK sur le nouveau déploiement.

ibmcloud resource service-instance-create <databases-for-postgresql> <INSTANCE_NAME> standard <REGION> <--service-endpoints SERVICE_ENDPOINTS_TYPE> -p
'{"point_in_time_recovery_deployment_id":"DEPLOYMENT_ID", "point_in_time_recovery_time":"TIMESTAMP","key_protect_key":"KEY_PROTECT_KEY_CRN", "members_disk_allocation_mb":"DESIRED_DISK_IN_MB", "members_memory_allocation_mb":"DESIRED_MEMORY_IN_MB", "members_cpu_allocation_count":"NUMBER_OF_CORES", "version":" "}'

Reprise dans l'API

Le contrôleur de ressources prend en charge la mise à disposition des déploiements de base de données, et la mise à disposition et la restauration sont la responsabilité de l'API du contrôleur de ressources. Vous devez effectuer les étapes nécessaires à l'utilisation de l'API du contrôleur de ressources avant de pouvoir l'utiliser pour effectuer une restauration à partir d'une sauvegarde.

Une fois que vous possédez toutes les informations, la demande POST est envoyée au noeud final /resource_instances.

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "<INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<RESOURCE_GROUP>",
    "resource_plan_id": "<SERVICE_ID>",
    "parameters": {
      "point_in_time_recovery_time": "<TIMESTAMP>",
      "point_in_time_recovery_deployment_id": "<DEPLOYMENT_ID>"
    }
  }'

Les paramètres name, target, resource_group et resource_plan_id sont tous obligatoires. target est la région où vous souhaitez situer le nouveau déploiement, qui peut être une région différente du déploiement source. Les restaurations inter-régions sont prises en charge, à l'exception de la restauration d'une sauvegarde eu-de dans une autre région.

Pour la récupération à un point de cohérence, utilisez les paramètres point_in_time_recovery_time et point_in_time_recovery_deployment_id. point_in_time_recovery_deployment_id est l'ID du déploiement source et point_in_time_recovery_time est l'horodatage en temps universel coordonné à restaurer. Pour restaurer le dernier point de cohérence disponible, utilisez "point_in_time_recovery_time":" ".

Transmettez ces paramètres dans l'objet parameters du corps de la requête. Pour personnaliser l'allocation des ressources ou utiliser une clé Key Protect, ajoutez les paramètres appropriés au même objet : key_protect_key, members_disk_allocation_mb, members_memory_allocation_mb, et members_cpu_allocation_count.

Vérification de la récupération à un point de cohérence

Pour vérifier l'heure de récupération correcte, consultez les journaux de la base de données. L'examen des journaux de base de données nécessite que l'intégration de la consignation soit configurée sur votre déploiement.

Lorsque vous effectuez une récupération, vos données sont restaurées à partir de la sauvegarde incrémentielle la plus récente. Toutes les transactions en attente du journal WAL sont utilisées pour la restauration de votre base de données jusqu'au moment de la récupération. Une fois la restauration terminée et les transactions exécutées, les journaux affichent un message similaire à celui-ci :

LOG:  last completed transaction was at log time 2019-09-03 19:40:48.997696+00

La restauration n'apparaît pas dans les journaux si votre déploiement dispose d'une sauvegarde complète récente et qu'aucune activité postérieure à cette sauvegarde ne doit être restaurée. Dans ce cas, la restauration aboutit généralement tout de même, mais les journaux ne contiennent aucune entrée indiquant l'heure exacte à laquelle la base de données a été restaurée.