# 列出可用的事务日志备份
<a name="USER.SQLServer.AddlFeat.TransactionLogAccess.Listing"></a>

在 RDS for SQL Server 中，配置为使用完整恢复模式并将数据库实例备份保留期设置为一天或多天的数据库实例备份会自动启用事务日志备份。通过启用访问事务日志备份，您可以将多达七天的这些事务日志备份复制到 Amazon S3 桶中。

启用访问事务日志备份后，就可以开始使用它来列出和复制可用的事务日志备份文件。

**列出事务日志备份**

要列出可用于单个数据库的所有事务日志备份，请调用 `rds_fn_list_tlog_backup_metadata` 函数。调用函数时可以使用 `ORDER BY` 或 `WHERE` 子句。

**Example 列出和筛选可用的事务日志备份文件**  

```
SELECT * from msdb.dbo.rds_fn_list_tlog_backup_metadata('mydatabasename');
SELECT * from msdb.dbo.rds_fn_list_tlog_backup_metadata('mydatabasename') WHERE rds_backup_seq_id = 3507;
SELECT * from msdb.dbo.rds_fn_list_tlog_backup_metadata('mydatabasename') WHERE backup_file_time_utc > '2022-09-15 20:44:01' ORDER BY backup_file_time_utc DESC;
```

![来自 rds_fn_list_tlog_backup_metadata 的输出。](https://docs.aws.amazon.com/zh_cn/AmazonRDS/latest/UserGuide/images/sql_accesstransactionlogs_func.png)


`rds_fn_list_tlog_backup_metadata` 函数返回以下输出：



| 列名称 | 数据类型 | 说明 | 
| --- | --- | --- | 
| `db_name` | sysname | 为列出其事务日志备份而提供的数据库名称。 | 
| `db_id` | int | 输入参数 `db_name` 的内部数据库标识符。 | 
| `family_guid` | uniqueidentifier | 创建时原始数据库的唯一 ID。还原数据库时，该值保持不变，即使还原到不同的数据库名称也是如此。 | 
| `rds_backup_seq_id` | int | RDS 在内部用于维护每个事务日志备份文件的序列号的 ID。 | 
| `backup_file_epoch` | bigint | 生成事务备份文件的纪元时间。 | 
| `backup_file_time_utc` | datetime | `backup_file_epoch` 值的 UTC 时间转换值。 | 
| `starting_lsn` | numeric(25,0) | 事务日志备份文件的第一条或最早的日志记录的日志序列号。 | 
| `ending_lsn` | numeric(25,0) | 事务日志备份文件的上一条或下一条日志记录的日志序列号。 | 
| `is_log_chain_broken` | bit | 一个布尔值，表示当前事务日志备份文件和先前的事务日志备份文件之间的日志链是否断开。 | 
| `file_size_bytes` | bigint | 事务备份集的大小（以字节为单位）。 | 
| `Error` | varchar(4000) | 如果 `rds_fn_list_tlog_backup_metadata` 函数引发异常，则显示错误消息。如果没有异常，则为 NULL。 |