# 访问 MariaDB 二进制日志
<a name="USER_LogAccess.MariaDB.Binarylog"></a>

您可以使用 mysqlbinlog 实用工具从 MariaDB 数据库实例中以文本格式下载二进制日志。二进制日志将下载到本地计算机。有关使用 mysqlbinlog 实用工具的更多信息，请转到 MariaDB 文档中的[使用 mysqlbinlog](http://mariadb.com/kb/en/mariadb/using-mysqlbinlog/)。

 要针对 Amazon RDS 实例运行 mysqlbinlog 实用工具，请使用下列选项：
+  指定 `--read-from-remote-server` 选项。
+  `--host`：指定该实例所在的端点中的 DNS 名称。
+  `--port`：指定该实例使用的端口。
+  `--user`：指定已授予了复制从属权限的 MariaDB 用户。
+  `--password`：指定用户的密码，或忽略密码值以让实用工具将提示您输入密码。
+  `--result-file`：指定接收输出的本地文件。
+ 指定一个或多个二进制日志文件的名称。要获取可用日志的列表，请使用 SQL 命令 SHOW BINARY LOGS。

有关 mysqlbinlog 选项的更多信息，请参阅 MariaDB 文档中的 [mysqlbinlog 选项](http://mariadb.com/kb/en/mariadb/mysqlbinlog-options/)。

 以下是 示例：

对于 Linux、macOS 或 Unix：

```
mysqlbinlog \
    --read-from-remote-server \
    --host=mariadbinstance1.1234abcd.region.rds.amazonaws.com \
    --port=3306  \
    --user ReplUser \
    --password <password> \
    --result-file=/tmp/binlog.txt
```

对于 Windows：

```
mysqlbinlog ^
    --read-from-remote-server ^
    --host=mariadbinstance1.1234abcd.region.rds.amazonaws.com ^
    --port=3306  ^
    --user ReplUser ^
    --password <password> ^
    --result-file=/tmp/binlog.txt
```

 mazon RDS 通常会尽快清除二进制日志。但是，二进制日志必须仍在实例上提供以供 mysqlbinlog 访问。要指定 RDS 保留二进制日志的小时数，请使用 `mysql.rds_set_configuration` 存储过程。指定一个时间段，以便您有足够的时间来下载日志。设置保留期后，监视数据库实例的存储用量以确认保留的二进制日志不会占用太多存储空间。

以下示例将保留期设置为 1 天。

```
call mysql.rds_set_configuration('binlog retention hours', 24); 
```

要显示当前设置，请使用 `mysql.rds_show_configuration` 存储过程。

```
call mysql.rds_show_configuration; 
```