MySQL Workbench 手册  /  配置  /  MySQL Workbench 设置和日志文件

3.3 MySQL Workbench 设置和日志文件

MySQL Workbench 会将配置、缓存和日志相关的文件和目录保存在您的系统上。这些文件保存在 MySQL Workbench 定义的分配给当前用户的目录中。下表显示了按平台划分的默认文件路径。

表 3.1 默认本地配置基本文件路径

操作系统 文件路径
Windows %AppData%\MySQL\Workbench\
macOS ~用户名/Library/Application Support/MySQL/Workbench/
Linux ~用户名/.mysql/workbench/

下表简要介绍了这些目录和文件。

表 3.2 本地 MySQL Workbench 文件和目录说明

目录或文件 说明
cache/ 一般行为按连接存储在 *.cache 文件 中,列宽存储在 *.column_widths 文件中。
log/ 日志文件包括 MySQL Workbench 启动信息,以及在 MySQL Workbench 中执行的每个连接的 SQL 操作结果。
scripts/modules/libraries/ 保存的用户脚本、模块和库,使您能够扩展 MySQL Workbench 功能。
sql_history/ 在 MySQL Workbench 中执行的查询存储在这里,并且可以从 MySQL Workbench 中访问。
sql_workspaces/ 配置详细信息(例如选项卡顺序或架构树)按连接实例存储在这里。
snippets/ 保存的 SQL 代码段存储在这里。有关其他信息,请参阅 第 8.1.5 节,“SQL 附加 - 代码段选项卡”
audit_cache/ 审计日志检查器的缓存存储。有关其他信息,请参阅 第 6.6 节,“MySQL 审计检查器界面”
connections.xml 保存的 MySQL 服务器连接信息,如 主屏幕选项卡 上所示。有关备份和还原此文件的信息,请参阅 第 9.1.1.1.7 节,“工具菜单”
server_instances.xml 存储与您的 MySQL 连接相关的 MySQL 服务器信息。
wb_options.xml 存储您配置的和默认的首选项。
wb_state.xml 存储以前的用户界面状态。如果您在使用 MySQL Workbench 用户界面时遇到问题,可以删除此文件。

cache/ 目录

cache/ 目录包含 用户 MySQL Workbench 目录 中的缓存文件。所有缓存文件都存储为 SQLite 3 数据库,并且不能在 MySQL Workbench 之外进行编辑。缓存文件的类型有:

  • *.column_widths:

    这些是在 SQL 编辑器的结果网格中调整列后的已保存列宽。字段包括 column_id(存储为 column_name::db_name::table_name)和 width(存储为字符长度的整数)。

  • *.cache:

    此信息(架构、引擎和其他全局信息)用作 SQL 编辑器自动完成功能的快速查找源,并在每次更新架构树时隐式更新。

所有 cache/ 文件名都以 MySQL 连接名称开头。例如,对于名为“Local Instance 3306”的 MySQL 连接,列宽文件名为 Local_instance_3306.column_widths

重命名或删除连接后,缓存文件仍然存在。

log/ 目录

MySQL Workbench 启动和 SQL 操作记录在 log/ 目录中。此目录位于 用户 MySQL Workbench 目录 中。

注意

要查找这些文本文件,请从 帮助 菜单中选择 显示日志文件

  • wb*.log:

    当 MySQL Workbench 启动和意外停止时,会生成调试信息。信息包括使用的路径、加载的模块和插件、系统信息等等。这些日志文件在 报告 MySQL Workbench 错误 时非常有用。

    每次 MySQL Workbench 启动时,日志文件都会轮换,即 wb.log 会重命名为 wb.1.logwb.log 会重置,之前的 wb.1.log 文件会重命名为 wb.2.log,依此类推,一直到 wb.9.log

  • sql_actions_*.log:

    所有 SQL 执行结果的日志,但不包含数据,用于调试目的。

    SQL 编辑器的 SQL 历史记录并非源于此处,因为它存储在 sql_history 目录中。

scripts/modules/Libraries/ 目录

自定义用户脚本、模块和库文件存储在 scriptsmoduleslibraries 目录中。这些用户文件可以从 Workbench 脚本外壳中的文件浏览器访问。有关用户脚本的更多信息,请参阅 第 C.5 节,“Workbench 脚本外壳”。有关用户模块的更多信息,请参阅 第 C.2 节,“模块”第 C.3 节,“插件和工具”

sql_history/ 目录

在 SQL 编辑器中执行的 SQL 语句保存在 sql_history 目录中。它们存储为每天分隔的纯文本文件(例如 2015-12-15),并且包含所有 MySQL 连接的 MySQL Workbench SQL 语句历史记录。有关其他信息,请参阅 第 8.1.7 节,“输出面板”

sql_workspaces/ 目录

工作区信息会自动按连接保存到 sql_workspaces 目录。MySQL Workbench 会为您打开的每个连接选项卡生成一个子目录,该子目录在工作会话之间持久存在。它使用连接的名称(附加一个顺序号)来表示每个连接选项卡的顺序。例如,为名为 Local instance MySQL80 的连接打开两个连接选项卡会创建两个子目录:local_instance_MySQL80-1.autosavelocal_instance_MySQL80-2.autosave。当您关闭连接选项卡时,文件扩展名将从 .autosave 更改为 .workspace

snippets/ 目录

SQL 编辑器使用的 SQL 代码段存储在 snippets 目录中。这些文件包括捆绑的代码段(例如“SQL DDL 语句”)和保存在 我的代码段 选项卡下的自定义代码段。有关其他信息,请参阅 第 8.1.5 节,“SQL 附加 - 代码段选项卡”