Surveillance du statut d'une tâche de transfert de fichiers - 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.

Surveillance du statut d'une tâche de transfert de fichiers

Pour suivre le statut de votre tâche d'intégration S3, appelez la fonction rds_fn_task_status. Deux paramètres sont nécessaires. Le premier paramètre doit toujours être NULL car il ne s'applique pas à l'intégration S3. Le second paramètre accepte l'ID de tâche.

Pour consulter une liste de toutes les tâches, définissez le premier paramètre sur NULL et le second sur 0, comme illustré dans l'exemple suivant.

SELECT * FROM msdb.dbo.rds_fn_task_status(NULL,0);

Pour obtenir une tâche spécifique, définissez le premier paramètre sur NULL et le second sur l'ID de tâche, comme illustré dans l'exemple suivant.

SELECT * FROM msdb.dbo.rds_fn_task_status(NULL,42);

La fonction rds_fn_task_status retourne les informations suivantes.

Paramètre de sortie

Description

task_id

ID de la tâche

task_type

Pour l'intégration S3, des tâches peuvent avoir les types suivants :

  • DOWNLOAD_FROM_S3

  • UPLOAD_TO_S3

  • LIST_FILES_ON_DISK

  • DELETE_FILES_ON_DISK

database_name

 Non applicable aux tâches d'intégration S3.

% complete

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 – Après que vous avez appelé une des procédures stockées d'intégration S3, une tâche est créée et le statut est défini sur CREATED.

  • IN_PROGRESS – Après le démarrage d'une tâche, le statut est défini sur IN_PROGRESS. Le passage du statut CREATED à IN_PROGRESS peut prendre jusqu'à cinq minutes.

  • SUCCESS – Lorsqu’une tâche est terminée, le statut est défini sur SUCCESS.

  • ERROR – Si une tâche échoue, le statut est défini sur ERROR. Lisez la colonne task_info pour plus d'informations sur l'erreur.

  • CANCEL_REQUESTED – Après que vous avez appelé rds_cancel_task, le statut 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 pendant le traitement, cette colonne contient des informations sur l'erreur.

last_updated

Date et heure de la dernière mise à jour de l'état de la tâche.

created_at

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

S3_object_arn

L'ARN de l'objet S3 depuis lequel le téléchargement est effectué et vers lequel le chargement est effectué.

overwrite_S3_backup_file

Non applicable aux tâches d'intégration S3.

KMS_master_key_arn

Non applicable aux tâches d'intégration S3.

filepath

Chemin du fichier sur l'instance de base de données RDS.

overwrite_file

Option qui indique si un fichier existant a été écrasé.

task_metadata

Non applicable aux tâches d'intégration S3.