

# Monitorar o status de uma tarefa de transferência de arquivo
<a name="Appendix.SQLServer.Options.S3-integration.using.monitortasks"></a>

Para rastrear o status da tarefa de integração do S3, chame a função `rds_fn_task_status`. Ela leva dois parâmetros. O primeiro parâmetro sempre deve ser `NULL` porque não se aplica à integração do S3. O segundo parâmetro aceita um ID de tarefa.

Para ver uma lista de todas as tarefas, defina o primeiro parâmetro como `NULL` e o segundo parâmetro como `0`, conforme mostrado no seguinte exemplo.

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

Para obter uma tarefa específica, defina o primeiro parâmetro como `NULL` e o segundo parâmetro como o ID da tarefa, conforme mostrado no exemplo a seguir.

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

A função `rds_fn_task_status` retorna as informações a seguir.


|  Parâmetro de saída  |  Descrição  | 
| --- | --- | 
|  `task_id`  |  O ID da tarefa.  | 
|  `task_type`  |  Para a integração do S3, as tarefas podem ter os seguintes tipos de tarefa: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/Appendix.SQLServer.Options.S3-integration.using.monitortasks.html)  | 
|  `database_name`  | Não aplicável a tarefas de integração do S3. | 
|  `% complete`  |  O progresso da tarefa em porcentagem.  | 
|  `duration(mins)`  |  A quantidade de tempo gasta na tarefa, em minutos.  | 
|  `lifecycle`  |  O status da tarefa. Os possíveis status são os seguintes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/Appendix.SQLServer.Options.S3-integration.using.monitortasks.html)  | 
|  `task_info`  |  Informações adicionais sobre a tarefa. Se um erro ocorrer durante o processamento, essa coluna conterá informações sobre o erro.   | 
|  `last_updated`  |  A data e hora em que o status da tarefa foi atualizado pela última vez.   | 
|  `created_at`  |  A data e hora em que a tarefa foi criada.  | 
|  `S3_object_arn`  |  O ARN do objeto do S3 baixado ou carregado.  | 
|  `overwrite_S3_backup_file`  |  Não aplicável a tarefas de integração do S3.  | 
|  `KMS_master_key_arn`  |  Não aplicável a tarefas de integração do S3.  | 
|  `filepath`  |  O caminho de arquivo na instância de banco de dados do RDS  | 
|  `overwrite_file`  |  Uma opção que indica se um arquivo existente foi substituído.  | 
|  `task_metadata`  |  Não aplicável a tarefas de integração do S3.  | 