

# 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. | 