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	ARNL'objet S3 téléchargé depuis ou vers.
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	Le chemin du fichier sur l'RDSinstance de base de données.
overwrite_file	Option qui indique si un fichier existant a été écrasé.
task_metadata	Non applicable aux tâches d'intégration S3.