MySQL 外壳 8.0  / 第 12 章 MySQL Shell 日志记录和调试  /  12.5 记录 AdminAPI 操作

12.5 记录 AdminAPI 操作

笔记

在 MySQL Shell 8.0.30 中已弃用。对于 MySQL Shell 8.0.30 及更高版本中的 SQL 日志记录,请参阅 第 12.4 节,“MySQL Shell SQL 日志记录”

从 MySQL Shell 8.0.18 开始,您可以将在 AdminAPI 操作过程中执行的 SQL 语句作为 MySQL Shell 日志记录信息的一部分。默认情况下,MySQL Shell 不记录这些语句,只记录操作期间返回的消息。为这些语句激活日志记录可以让您观察 SQL 执行方面的操作进度,这有助于对任何错误进行问题诊断。

当您从 AdminAPI 操作激活 SQL 语句的日志记录时,语句将作为信息性消息写入 MySQL Shell 应用程序日志文件,前提是日志记录级别设置为 5(这是 MySQL Shell 日志记录级别的默认值)或更高。如果使用日志记录级别指定了其他可查看位置,则语句也会发送到那里。如果 verbose 选项设置为 1 或更高,这些语句也会作为详细输出发送到控制台。SQL 语句中包含的任何密码都被屏蔽以用于记录和显示,并且不会被记录或显示。

由 AdminAPI 沙箱操作(dba.deploySandboxInstance()dba.startSandboxInstance()dba.stopSandboxInstance()dba.killSandboxInstance()dba.deleteSandboxInstance())执行的 SQL 语句始终从日志记录和详细输出中排除,即使您已为常规 AdminAPI 操作激活日志记录。

要记录 AdminAPI 操作执行的 SQL 语句,请选择以下选项之一:

该选项的可用设置如下:

0

不要记录 AdminAPI 操作执行的 SQL 语句。如果未在命令行或配置文件中设置该选项,则此设置是默认行为,如果您只是临时需要,可以设置为在使用后停用此类日志记录。

1个

记录由 AdminAPI 操作执行的 SQL 语句,但 沙箱操作执行 的SELECT语句、 语句和语句除外。SHOW

2个

完整记录常规 AdminAPI 操作执行的 SQL 语句,包括 SELECTSHOW语句,但不记录沙箱操作执行的语句。

如果您指定没有值的选项,这在启动 MySQL Shell ( ) 时允许用于命令行选项,--dba-log-sql但不允许使用其他设置选项的方法,则使用设置 1。