Utilisation des sauvegarde et restauration natives - Amazon Relational Database Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation des sauvegarde et restauration natives

Une fois que vous avez activé et configuré les sauvegarde et restauration natives, vous pouvez commencer à les utiliser. Tout d'abord, vous vous connectez à votre base de données Microsoft SQL Server, puis vous appelez une procédure stockée Amazon RDS pour faire le travail. Pour plus d'informations sur la connexion à votre base de données, consultez Connexion à votre instance de base de données Microsoft SQL Server.

Certaines procédures stockées nécessitent que vous fournissiez un Amazon Resource Name (ARN) à votre compartiment et votre fichier Amazon S3. Le format pour votre ARN est arn:aws:s3:::bucket_name/file_name.extension. Amazon S3 n'a pas besoin de numéro de compte ni de AWS région dans ARNs.

Si vous fournissez également une clé KMS facultative, le format de l'ARN de la clé est arn:aws:kms:region:account-id:key/key-id. Pour plus d'informations, consultez les noms des ressources Amazon (ARNs) et les espaces de noms des AWS services. Vous devez utiliser une clé KMS de chiffrement symétrique pour chiffrer vos sauvegardes. Amazon RDS ne prend pas en charge les clés KMS asymétriques. Pour plus d'informations, consultez Création de clés KMS de chiffrement symétriques dans le Guide du développeur AWS Key Management Service .

Note

Que vous utilisiez ou non une clé KMS, les tâches de sauvegarde et de restauration natives activent le chiffrement AES (Advanced Encryption Standard) 256 bits par défaut pour les fichiers téléchargés sur S3.

Pour plus d'informations sur la façon d'appeler chaque procédure stockée, veuillez consulter les rubriques suivantes :

Sauvegarde d'une base de données

Pour sauvegarder votre base de données, utilisez la procédure stockée rds_backup_database.

Note

Vous ne pouvez pas sauvegarder une base de données pendant la fenêtre de maintenance ou lorsqu'Amazon RDS prend un instantané.

Utilisation

exec msdb.dbo.rds_backup_database @source_db_name='database_name', @s3_arn_to_backup_to='arn:aws:s3:::bucket_name/file_name.extension', [@kms_master_key_arn='arn:aws:kms:region:account-id:key/key-id'], [@overwrite_s3_backup_file=0|1], [@block_size=512|1024|2048|4096|8192|16384|32768|65536], [@max_transfer_size=n], [@buffer_count=n], [@type='DIFFERENTIAL|FULL'], [@number_of_files=n];

Les paramètres suivants sont obligatoires :

  • @source_db_name – Nom de la base de données à sauvegarder.

  • @s3_arn_to_backup_to – L'ARN indique le compartiment Amazon S3 à utiliser pour la sauvegarde, ainsi que le nom du fichier de sauvegarde.

    Le fichier peut avoir n'importe quelle extension mais .bak est généralement utilisée.

Les paramètres suivants sont facultatifs :

  • @kms_master_key_arn – ARN de la clé KMS de chiffrement symétrique à utiliser pour chiffrer l'élément.

    • Vous ne pouvez pas utiliser la clé de chiffrement par défaut. Si vous utilisez la clé par défaut, la base de données n'est pas sauvegardée.

    • Si vous ne spécifiez pas d'identificateur de clé KMS, le fichier de sauvegarde n'est pas chiffré. Pour plus d'informations, veuillez consulter Chiffrer des ressources Amazon RDS.

    • Lorsque vous spécifiez une clé KMS, le chiffrement côté client est utilisé.

    • Amazon RDS ne prend pas en charge les clés KMS asymétriques. Pour plus d'informations, consultez Création de clés KMS de chiffrement symétriques dans le Guide du développeur AWS Key Management Service .

  • @overwrite_s3_backup_file – Une valeur qui indique si un fichier de sauvegarde existant doit être écrasé.

    • 0 – N'écrase pas un fichier existant. Cette valeur est celle par défaut.

      Si @overwrite_s3_backup_file est défini sur 0, une erreur est retournée si le fichier existe déjà.

    • 1 – Écrase le fichier existant qui possède déjà le nom spécifié, même s'il ne s'agit pas d'un fichier de sauvegarde.

  • @type – Le type de sauvegarde.

    • DIFFERENTIAL – Crée une sauvegarde différentielle.

    • FULL – Crée une sauvegarde complète. Cette valeur est celle par défaut.

    Une sauvegarde différentielle est basée sur la dernière sauvegarde complète. Pour que les sauvegardes différentielles fonctionnent, vous ne pouvez prendre un instantané entre la dernière sauvegarde complète et la sauvegarde différentielle. Si vous souhaitez faire une sauvegarde différentielle, mais qu'il existe un instantané, alors créez une autre sauvegarde complète avant de créer la sauvegarde différentielle.

    Vous pouvez rechercher la dernière sauvegarde complète ou le dernier instantané à l'aide de l'exemple de requête SQL suivant :

    select top 1 database_name , backup_start_date , backup_finish_date from msdb.dbo.backupset where database_name='mydatabase' and type = 'D' order by backup_start_date desc;
  • @number_of_files – Nombre de fichiers dans lesquels la sauvegarde sera divisée (en morceaux). Le nombre maximum est de 10.

    • La sauvegarde en plusieurs fichiers est prise en charge pour les sauvegardes complètes et différentielles.

    • Si vous entrez la valeur 1 ou omettez le paramètre, un seul fichier de sauvegarde est créé.

    Fournissez le préfixe que les fichiers ont en commun, puis ajoutez un astérisque comme suffixe (*). L'astérisque peut se trouver n'importe où dans la file_name partie de l'ARN S3. L'astérisque est remplacé par une série de chaînes alphanumériques dans les fichiers générés, en commençant par 1-of-number_of_files.

    Par exemple, si les noms de fichiers dans l'ARN S3 ont pour modèle backup*.bak et que vous définissez @number_of_files=4, les fichiers de sauvegarde générés auront pour noms backup1-of-4.bak, backup2-of-4.bak, backup3-of-4.bak et backup4-of-4.bak.

    • Si l'un des noms de fichier existe déjà et que @overwrite_s3_backup_file a pour valeur 0, une erreur est renvoyée.

    • Les sauvegardes multifichiers ne peuvent comporter qu'un seul astérisque dans la file_name partie de l'ARN S3.

    • Les sauvegardes à fichier unique peuvent comporter un certain nombre d'astérisques dans la file_name partie de l'ARN S3. Les astérisques ne sont pas supprimés du nom de fichier généré.

  • @block_size— Taille de bloc (en octets) spécifiant la taille de bloc physique pour les opérations de sauvegarde. Les valeurs valides sont 512, 1024, 2048, 4096, 8192, 16384, 32768 et 65536

  • @max_transfer_size— La taille de transfert maximale indique la limite supérieure du volume de données (en octets) transmis par I/O opération pendant le processus de sauvegarde. Les valeurs valides sont des multiples de 65536 octets (64 Ko) jusqu'à 4194304 octets (4 Mo).

  • @buffer_count— Nombre total de I/O tampons à utiliser pour le processus de sauvegarde.

Exemples

Exemple de sauvegarde différentielle
exec msdb.dbo.rds_backup_database @source_db_name='mydatabase', @s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup1.bak', @overwrite_s3_backup_file=1, @type='DIFFERENTIAL';
Exemple de sauvegarde complète avec chiffrement
exec msdb.dbo.rds_backup_database @source_db_name='mydatabase', @s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup1.bak', @kms_master_key_arn='arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE', @overwrite_s3_backup_file=1, @type='FULL';
Exemple de sauvegarde sur plusieurs fichiers
exec msdb.dbo.rds_backup_database @source_db_name='mydatabase', @s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak', @number_of_files=4;
Exemple de sauvegarde différentielle sur plusieurs fichiers
exec msdb.dbo.rds_backup_database @source_db_name='mydatabase', @s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak', @type='DIFFERENTIAL', @number_of_files=4;
Exemple de sauvegarde sur plusieurs fichiers avec chiffrement
exec msdb.dbo.rds_backup_database @source_db_name='mydatabase', @s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak', @kms_master_key_arn='arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE', @number_of_files=4;
Exemple de sauvegarde sur plusieurs fichiers avec écrasement S3
exec msdb.dbo.rds_backup_database @source_db_name='mydatabase', @s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak', @overwrite_s3_backup_file=1, @number_of_files=4;
Exemple de sauvegarde avec taille de bloc
exec msdb.dbo.rds_backup_database @source_db_name='mydatabase', @s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak', @block_size=512;
Exemple de sauvegarde multifichiers avec et @max_transfer_size@buffer_count
exec msdb.dbo.rds_backup_database @source_db_name='mydatabase', @s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak', @number_of_files=4, @max_transfer_size=4194304, @buffer_count=10;
Exemple de sauvegarde en un seul fichier avec le paramètre @number_of_files

Cet exemple génère un fichier de sauvegarde nommé backup*.bak.

exec msdb.dbo.rds_backup_database @source_db_name='mydatabase', @s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak', @number_of_files=1;

Restauration d'une base de données

Pour restaurer votre base de données, appelez la procédure stockée rds_restore_database. Amazon RDS crée un instantané initial de la base de données après la fin de la tâche de restauration et l'ouverture de la base de données.

Utilisation

exec msdb.dbo.rds_restore_database @restore_db_name='database_name', @s3_arn_to_restore_from='arn:aws:s3:::bucket_name/file_name.extension', @with_norecovery=0|1, [@kms_master_key_arn='arn:aws:kms:region:account-id:key/key-id'], [@block_size=512|1024|2048|4096|8192|16384|32768|65536], [@max_transfer_size=n], [@buffer_count=n], [@type='DIFFERENTIAL|FULL'];

Les paramètres suivants sont obligatoires :

  • @restore_db_name – Nom de la base de données à restaurer. Les noms de base de données sont uniques. Vous ne pouvez pas restaurer une base de données qui porte le même nom qu'une base de données existante.

  • @s3_arn_to_restore_from – L'ARN indique le préfixe Amazon S3 et les noms des fichiers de sauvegarde utilisés pour restaurer la base de données.

    • Pour une seule sauvegarde de fichier, fournissez la totalité du nom du fichier.

    • Pour une sauvegarde comportant plusieurs fichiers, fournissez le préfixe que les fichiers ont en commun, puis ajoutez un astérisque comme suffixe (*).

    • Si @s3_arn_to_restore_from est vide, le message d'erreur suivant est renvoyé : Le préfixe de l'ARN S3 ne peut pas être vide.

Le paramètre suivant est obligatoire pour les différentes restaurations, mais facultatifs pour les restaurations complètes :

  • @with_norecovery – La clause de restauration à utiliser pour l'opération de restauration.

    • Définissez le paramètre sur 0 pour restaurer avec RECOVERY (RESTAURATION). Dans ce cas, la base de données est en ligne après la restauration.

    • Définissez le paramètre sur 1 pour restaurer avec NORECOVERY (SANS RESTAURATION). Dans ce cas, la base de données reste à l'état RESTORING (EN COURS DE RESTAURATION) après la fin de la tâche de restauration. Grâce à cette approche, vous pouvez procéder à des restaurations différentielles ultérieurement.

    • Pour les restaurations DIFFÉRENTIELLES, spécifiez 0 ou 1.

    • Pour les restaurations FULL, cette valeur par défaut est 0.

Les paramètres suivants sont facultatifs :

  • @kms_master_key_arn – Clé KMS à utiliser pour déchiffrer le fichier si vous avez chiffré le fichier de sauvegarde.

    Lorsque vous spécifiez une clé KMS, le chiffrement côté client est utilisé.

  • @type – Le type de restauration. Les types valides sont DIFFERENTIAL et FULL. La valeur par défaut est FULL.

  • @block_size— Taille de bloc (en octets) spécifiant la taille de bloc physique pour les opérations de sauvegarde. Les valeurs valides sont 512, 1024, 2048, 4096, 8192, 16384, 32768 et 65536

  • @max_transfer_size— La taille de transfert maximale indique la limite supérieure du volume de données (en octets) transmis par I/O opération pendant le processus de sauvegarde. Les valeurs valides sont des multiples de 65536 octets (64 Ko) jusqu'à 4194304 octets (4 Mo).

  • @buffer_count— Nombre total de I/O tampons à utiliser pour le processus de sauvegarde.

Note

Pour les restaurations différentielles, la base de données doit se trouver en état RESTORING (EN COURS DE RESTAURATION) ou une tâche de restauration doit déjà exister avec NORECOVERY (SANS RESTAURATION).

Vous ne pouvez pas restaurer ultérieurement des sauvegardes différentielles tant que la base de données est en ligne.

Vous ne pouvez pas envoyer de tâche de restauration pour une base de données qui possède déjà une tâche de restauration en attente avec RECOVERY (RESTAURATION).

Les restaurations complètes avec NORECOVERY ne sont pas prises en charge sur les instances multi-AZ ou les instances avec des répliques en lecture.

Les restaurations différentielles ne sont prises en charge dans aucune configuration de déploiement multi-AZ.

Toutes les restaurations natives ne sont pas prises en charge sur les instances dotées de répliques de lecture, y compris les répliques de lecture entre régions.

Pour les configurations prises en charge, la restauration d'une base de données sur une instance multi-AZ avec des répliques de lecture est similaire à la restauration d'une base de données sur une instance multi-AZ. Vous n'avez pas besoin d'effectuer d'actions supplémentaires pour restaurer une base de données sur un réplica.

Exemples

Exemple de restauration d'un seul fichier
exec msdb.dbo.rds_restore_database @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak';
Exemple de restauration de plusieurs fichiers

Pour éviter les erreurs lors de la restauration de plusieurs fichiers, assurez-vous que tous les fichiers de sauvegarde ont le même préfixe et qu'aucun autre fichier n'utilise ce préfixe.

exec msdb.dbo.rds_restore_database @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup*';
Exemple de restauration de base de données complète avec RECOVERY (RESTAURATION)

Les trois exemples suivants exécutent la même tâche de restauration complète avec RECOVERY (RESTAURATION).

exec msdb.dbo.rds_restore_database @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak';
exec msdb.dbo.rds_restore_database @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak', [@type='DIFFERENTIAL|FULL'];
exec msdb.dbo.rds_restore_database @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak', @type='FULL', @with_norecovery=0;
Exemple de restauration de base de données complète avec chiffrement
exec msdb.dbo.rds_restore_database @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak', @kms_master_key_arn='arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE';
Exemple de restauration avec taille de bloc
exec msdb.dbo.rds_restore_database @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak', @block_size=512;
Exemple de restauration multifichiers avec @max_transfer_size et @buffer_count
exec msdb.dbo.rds_restore_database @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup*', @max_transfer_size=4194304, @buffer_count=10;
Exemple de restauration de base de données complète avec NORECOVERY (SANS RESTAURATION)
exec msdb.dbo.rds_restore_database @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak', @type='FULL', @with_norecovery=1;
Exemple de restauration différentielle avec NORECOVERY (SANS RESTAURATION)
exec msdb.dbo.rds_restore_database @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak', @type='DIFFERENTIAL', @with_norecovery=1;
Exemple de restauration différentielle avec RECOVERY (RESTAURATION).
exec msdb.dbo.rds_restore_database @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak', @type='DIFFERENTIAL', @with_norecovery=0;

Restauration d'un journal

Pour restaurer votre journal, appelez la procédure stockée rds_restore_log.

Utilisation

exec msdb.dbo.rds_restore_log @restore_db_name='database_name', @s3_arn_to_restore_from='arn:aws:s3:::bucket_name/log_file_name.extension', [@kms_master_key_arn='arn:aws:kms:region:account-id:key/key-id'], [@with_norecovery=0|1], [@stopat='datetime'], [@block_size=512|1024|2048|4096|8192|16384|32768|65536], [@max_transfer_size=n], [@buffer_count=n];

Les paramètres suivants sont obligatoires :

  • @restore_db_name – Le nom de la base de données dont vous souhaitez restaurer le journal.

  • @s3_arn_to_restore_from – L'ARN indique le préfixe Amazon S3 et le nom du fichier journal utilisé pour restaurer le journal. Le fichier peut avoir n'importe quelle extension mais .trn est généralement utilisée.

    Si @s3_arn_to_restore_from est vide, le message d'erreur suivant est renvoyé : Le préfixe de l'ARN S3 ne peut pas être vide.

Les paramètres suivants sont facultatifs :

  • @kms_master_key_arn – Clé KMS à utiliser pour déchiffrer le journal si vous avez chiffré le journal.

  • @with_norecovery – La clause de restauration à utiliser pour l'opération de restauration. La valeur par défaut est 1.

    • Définissez le paramètre sur 0 pour restaurer avec RECOVERY (RESTAURATION). Dans ce cas, la base de données est en ligne après la restauration. Vous ne pouvez pas restaurer ultérieurement des sauvegardes de journaux tant que la base de données est en ligne.

    • Définissez le paramètre sur 1 pour restaurer avec NORECOVERY (SANS RESTAURATION). Dans ce cas, la base de données reste à l'état RESTORING (EN COURS DE RESTAURATION) après la fin de la tâche de restauration. Grâce à cette approche, vous pouvez procéder à des restaurations de journaux ultérieurement.

  • @stopat – Une valeur qui spécifie que la base de données est restaurée dans son état à la date et l'heure spécifiées (au format datetime). Seul les enregistrements de journaux de transaction écrits avant la date et l'heure spécifiées sont appliqués à la base de données.

    Si ce paramètre n'est pas spécifié (il est NULL), le journal complet est restauré.

  • @block_size— Taille de bloc (en octets) spécifiant la taille de bloc physique pour les opérations de sauvegarde. Les valeurs valides sont 512, 1024, 2048, 4096, 8192, 16384, 32768 et 65536

  • @max_transfer_size— La taille de transfert maximale indique la limite supérieure du volume de données (en octets) transmis par I/O opération pendant le processus de sauvegarde. Les valeurs valides sont des multiples de 65536 octets (64 Ko) jusqu'à 4194304 octets (4 Mo).

  • @buffer_count— Nombre total de I/O tampons à utiliser pour le processus de sauvegarde.

Note

Pour les restaurations de journaux, la base de données doit se trouver en état de restauration ou une tâche de restauration doit déjà exister avec NORECOVERY (SANS RESTAURATION).

Vous ne pouvez pas restaurer de sauvegardes de journaux tant que la base de données est en ligne.

Vous ne pouvez pas envoyer de tâche de restauration de journaux sur une base de données qui possède déjà une tâche de restauration en attente avec RECOVERY (RESTAURATION).

Les restaurations de journaux ne sont pas prises en charge sur les instances multi-AZ.

Exemples

Exemple de restaurations de journaux
exec msdb.dbo.rds_restore_log @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn';
Exemple de restaurations de journaux avec chiffrement
exec msdb.dbo.rds_restore_log @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn', @kms_master_key_arn='arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE';
Exemple de restaurations de journaux avec NORECOVERY (SANS RESTAURATION)

Les trois exemples suivants exécutent la même tâche de restauration de journaux avec NORECOVERY (SANS RESTAURATION).

exec msdb.dbo.rds_restore_log @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn', @with_norecovery=1;
exec msdb.dbo.rds_restore_log @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn';
Exemple de restauration avec taille de bloc
exec msdb.dbo.rds_restore_log @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn', @block_size=512;
Exemple de restaurations de journaux avec RECOVERY (RESTAURATION)
exec msdb.dbo.rds_restore_log @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn', @with_norecovery=0;
Exemple de restaurations de journaux avec clause STOPAT
exec msdb.dbo.rds_restore_log @restore_db_name='mydatabase', @s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn', @with_norecovery=0, @stopat='2019-12-01 03:57:09';

Finalisation d'une restauration de base de données

Si la dernière tâche de restauration sur la base de données a été exécutée à l'aide de @with_norecovery=1, la base de données est désormais en état RECOVERY (RESTAURATION). Ouvrez cette base de données pour exécuter des opérations normales à l'aide de la procédure stockée rds_finish_restore.

Utilisation

exec msdb.dbo.rds_finish_restore @db_name='database_name';
Note

Pour utiliser cette approche, la base de données doit être en état RECOVERY (RESTAURATION) sans aucune tâche de restauration en attente.

La procédure rds_finish_restore n'est pas prise en charge sur les instances multi-AZ.

Pour finaliser la restauration de la base de données, utilisez l'identifiant principal. Ou utilisez l'identifiant utilisateur qui a permis de restaurer récemment la base de données ou de se connecter avec NORECOVERY (SANS RESTAURATION).

Utilisation de bases de données partiellement restaurées

Suppression d'une base de données partiellement restaurée

Pour supprimer une base de données partiellement restaurée (laissée en état RECOVERY (RESTAURATION), utilisez la procédure stockée rds_drop_database.

exec msdb.dbo.rds_drop_database @db_name='database_name';
Note

Vous ne pouvez pas envoyer de demande de base de données DROP (SUPPRIMER) pour une base de données qui possède déjà une tâche de restauration en attente ou de finalisation de restauration.

Pour supprimer la base de données, utilisez l'identifiant principal. Ou utilisez l'identifiant utilisateur qui a permis de restaurer récemment la base de données ou de se connecter avec NORECOVERY (SANS RESTAURATION).

Comportement de restauration et point-in-time de restauration des instantanés pour les bases de données partiellement restaurées

Les bases de données partiellement restaurées dans l'instance source (laissées dans l'état RESTORING) sont supprimées de l'instance cible lors de la restauration et de la point-in-time restauration des instantanés.

Annulation d'une tâche

Pour annuler une tâche de sauvegarde ou de restauration, appelez la procédure stockée rds_cancel_task.

Note

Vous ne pouvez pas annuler une tâche FINISH_RESTORE.

Utilisation

exec msdb.dbo.rds_cancel_task @task_id=ID_number;

Les paramètres suivants sont obligatoires :

  • @task_id – ID de la tâche à annuler. Vous pouvez obtenir l'ID de la tâche en appelant rds_task_status.

Suivi de l'état des tâches

Pour suivre l'état de vos tâches de sauvegarde et restauration, appelez la procédure stockée rds_task_status. Si vous ne fournissez pas de paramètre, la procédure stockée retourne l'état de toutes les tâches. Le statut des tâches est mis à jour environ toutes les deux minutes. L'historique des tâches est conservé pendant 36 jours.

Utilisation

exec msdb.dbo.rds_task_status [@db_name='database_name'], [@task_id=ID_number];

Les paramètres suivants sont facultatifs :

  • @db_name – Nom de la base de données pour laquelle afficher l'état de la tâche.

  • @task_id – ID de la tâche pour laquelle afficher l'état de tâche.

Exemples

Exemple de liste des statuts d'une tâche spécifique
exec msdb.dbo.rds_task_status @task_id=5;
Exemple de liste des statuts d'une base de données et d'une tâche spécifiques
exec msdb.dbo.rds_task_status @db_name='my_database', @task_id=5;
Exemple de liste de toutes les tâches et de leurs statuts sur une base de données spécifique
exec msdb.dbo.rds_task_status @db_name='my_database';
Exemple de liste de toutes les tâches et de leurs statuts sur l'instance actuelle
exec msdb.dbo.rds_task_status;

Réponse

La procédure stockée rds_task_status renvoie les colonnes suivantes.

Colonne Description

task_id

ID de la tâche

task_type

Le type de tâche dépend des paramètres d'entrée, comme suit :

  • Pour les tâches de sauvegarde :

    • BACKUP_DB – Sauvegarde de base de données complète

    • BACKUP_DB_DIFFERENTIAL – Sauvegarde de base de données différentielle

  • Pour les tâches de restauration :

    • RESTORE_DB – Restauration de base de données complète avec RECOVERY (RESTAURATION)

    • RESTORE_DB_NORECOVERY – Restauration de base de données complète avec NORECOVERY (SANS RESTAURATION)

    • RESTORE_DB_DIFFERENTIAL – Restauration de base de données différentielle avec RECOVERY (RESTAURATION)

    • RESTORE_DB_DIFFERENTIAL_NORECOVERY – Restauration de base de données différentielle avec NORECOVERY (SANS RESTAURATION)

    • RESTORE_DB_LOG – Restauration de journaux avec RECOVERY (RESTAURATION)

    • RESTORE_DB_LOG_NORECOVERY – Restauration de journaux avec NORECOVERY (SANS RESTAURATION)

  • Pour les tâches qui finalisent une restauration :

    • FINISH_RESTORE – Finalisation de restauration et ouverture de base de données

Amazon RDS crée un instantané initial de la base de données après son ouverture à la fin des tâches de restauration suivantes :

  • RESTORE_DB

  • RESTORE_DB_DIFFERENTIAL

  • RESTORE_DB_LOG

  • FINISH_RESTORE

database_name

Nom de la base de données à laquelle est associée à la tâche.

% complete

La progression de la tâche sous forme de pourcentage.

duration (mins)

Temps consacré à la tâche, en minutes.

lifecycle

État de la tâche. Les statuts possibles sont les suivants :

  • CREATED – Dès que vous appelez rds_backup_database ou rds_restore_database, une tâche est créée et l'état est défini sur CREATED.

  • IN_PROGRESS – Après le démarrage d'une tâche de sauvegarde ou de restauration, l'état est défini sur IN_PROGRESS. Cela peut prendre jusqu'à 5 minutes pour que l'état change de CREATED à IN_PROGRESS.

  • SUCCESS – Après l'achèvement d'une tâche de sauvegarde ou de restauration, l'état est défini sur SUCCESS.

  • ERROR – En cas d'échec d'une tâche de sauvegarde ou de restauration, l'état est défini sur ERROR. Lisez la colonne task_info pour plus d'informations sur l'erreur.

  • CANCEL_REQUESTED – Dès que vous appelez rds_cancel_task, l'état de la tâche est défini sur CANCEL_REQUESTED.

  • CANCELLED – Une fois une tâche annulée avec succès, l'état de la tâche est défini sur CANCELLED.

task_info

Informations supplémentaires sur la tâche.

Si une erreur se produit lors de la sauvegarde ou de la restauration d'une base de données, cette colonne contient des informations sur l'erreur. Pour obtenir une liste des erreurs possibles et des stratégies d'atténuation, consultez Résolution des problèmes.

last_updated

Date et heure de la dernière mise à jour de l'état de la tâche. Le statut est mis à jour tous les 5 pour cent de progression.

created_at

Date et heure de création de la tâche.

S3_object_arn L'ARN indique le préfixe Amazon S3 et le nom du fichier en cours de sauvegarde ou de restauration.

overwrite_s3_backup_file

Valeur du paramètre @overwrite_s3_backup_file spécifié lorsque vous appelez une tâche de sauvegarde. Pour de plus amples informations, veuillez consulter Sauvegarde d'une base de données.

KMS_master_key_arn L'ARN pour la clé KMS utilisée pour le chiffrement (pour la sauvegarde) et le déchiffrement (pour la restauration).
filepath Non applicable aux tâches de sauvegarde et de restauration natives
overwrite_file Non applicable aux tâches de sauvegarde et de restauration natives