# 列出 RDS 数据库实例上的文件
<a name="Appendix.SQLServer.Options.S3-integration.using.listing-files"></a>

要列出数据库实例上可用的文件，请同时使用存储过程和函数。首先，运行以下存储过程来从 `D:\S3\` 中的文件收集文件详细信息。

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

此存储过程返回任务的 ID。像其他任务一样，此存储过程异步运行。一旦任务的状态为 `SUCCESS`，您就可以在 `rds_fn_list_file_details` 函数中使用任务 ID 来列出 D:\$1S3\$1 中的现有文件和目录，如下所示。

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

`rds_fn_list_file_details` 函数将返回具有以下列的表格。


| 输出参数 | 描述 | 
| --- | --- | 
| filepath | 文件的绝对路径（例如，D:\$1S3\$1mydata.csv） | 
| size\$1in\$1bytes | 文件大小（以字节为单位） | 
| last\$1modified\$1utc | 上次修改日期和时间（采用 UTC 格式） | 
| is\$1directory | 指示项目是否为目录的选项 (true/false) |