

# 监控文件传输任务的状态
<a name="Appendix.SQLServer.Options.S3-integration.using.monitortasks"></a>

要跟踪 S3 集成任务的状态，请调用 `rds_fn_task_status` 函数。它获取两个参数。第一个参数应该始终为 `NULL`，因为它不适用于 S3 集成。第二个参数接受任务 ID。

要查看所有任务的列表，请将第一个参数设置为 `NULL`，将第二个参数设置为 `0`，如以下示例所示。

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

要获取特定任务，请将第一个参数设置为 `NULL`，将第二个参数设置为任务 ID，如以下示例所示。

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

`rds_fn_task_status` 函数将返回以下信息。


|  输出参数  |  描述  | 
| --- | --- | 
| `task_id` | 任务的 ID。 | 
| `task_type` | 对于 S3 集成，任务可以具有以下任务类型：[See the AWS documentation website for more details](http://docs.amazonaws.cn/AmazonRDS/latest/UserGuide/Appendix.SQLServer.Options.S3-integration.using.monitortasks.html) | 
| `database_name` | 不适用于 S3 集成任务。 | 
| `% complete` | 用百分比表示的任务进度。 | 
| `duration(mins)` | 在任务上花费的时间 (以分钟为单位)。 | 
| `lifecycle` | 任务的状态。有以下可能状态：[See the AWS documentation website for more details](http://docs.amazonaws.cn/AmazonRDS/latest/UserGuide/Appendix.SQLServer.Options.S3-integration.using.monitortasks.html) | 
| `task_info` | 有关任务的其他信息。如果在处理过程中发生错误，则此列包含有关错误的信息。 | 
| `last_updated` | 上次更新任务状态的日期和时间。 | 
| `created_at` | 任务的创建日期和时间。 | 
| `S3_object_arn` | 从中下载或上传到其中的 S3 对象的 ARN。 | 
| `overwrite_S3_backup_file` | 不适用于 S3 集成任务。 | 
| `KMS_master_key_arn` | 不适用于 S3 集成任务。 | 
| `filepath` | RDS 数据库实例上的文件路径。 | 
| `overwrite_file` | 指示是否覆盖现有文件的选项。 | 
| `task_metadata` | 不适用于 S3 集成任务。 | 