

# Listar arquivos na instância de banco de dados do RDS
<a name="Appendix.SQLServer.Options.S3-integration.using.listing-files"></a>

Para listar os arquivos disponíveis na instância de banco de dados, use a função e o procedimento armazenado. Primeiro, execute o seguinte procedimento armazenado para coletar detalhes de arquivo dos arquivos em `D:\S3\`. 

```
exec msdb.dbo.rds_gather_file_details;
```

O procedimento armazenado retorna o ID da tarefa. Assim como outras tarefas, esse procedimento armazenado é executado de forma assíncrona. Assim que o status da tarefa for `SUCCESS`, é possível usar o ID da tarefa na função `rds_fn_list_file_details` para listar os diretórios e arquivos existentes em D:\$1S3\$1, conforme mostrado a seguir.

```
SELECT * FROM msdb.dbo.rds_fn_list_file_details(TASK_ID);
```

A função `rds_fn_list_file_details` exibe uma tabela com as colunas a seguir.


| Parâmetro de saída | Descrição | 
| --- | --- | 
| filepath | Caminho absoluto do arquivo (por exemplo, D:\$1S3\$1mydata.csv) | 
| size\$1in\$1bytes | Tamanho do arquivo (em bytes) | 
| last\$1modified\$1utc | A data e a hora da última modificação em formato UTC | 
| is\$1directory | Opção que indica se o item é um diretório (true/false) | 