WebStorm 2025.2 Help

在 Database 工具窗口中找不到数据库对象

如果您在 schema 层级下看不到对象、找不到对象的更改、遇到表损坏或其他可视化问题,请收集诊断信息并尝试故障排除步骤来解决问题。

收集诊断信息

为了分析内省并诊断可能的问题,WebStorm 可生成三个包含以下信息的文件:

  • dataSource.txt :数据源。

  • introspector.txt :用于从数据库加载元数据的模块。

  • model.xml :数据库模型的一部分。

当内省功能运行异常时,此信息将很有帮助。

  1. 右键点击某个数据源并导航至 诊断|生成 Introspector 诊断文件

  2. WebStorm 将生成包含内省诊断信息的三个文件。

    带有指向内省诊断文件链接的通知消息

    点击 已收集的诊断信息 通知消息中的链接以跳转至生成文件所在目录。

文件浏览器窗口中的内省诊断文件

以下截图展示了这三个文件的示例输出。

  • dataSource.txt

    dataSource.txt 文件示例
  • introspector.txt

    introspector.txt 文件示例
  • model.xml

    model.xml 文件示例

执行故障排除步骤

步骤 1。 刷新数据库状态

如果有人更改了远程数据库的数据或视图,则本地数据库视图可能与数据库的实际状态不一致。

  • 要自动同步数据库状态,请在 数据库 工具窗口(视图(V)| 工具窗口| 数据库 )中,点击 数据源属性 按钮 “数据源属性”按钮 并选择要更改的数据源。 在 选项 选项卡中,选中 自动同步 复选框。

    如果取消选中 自动同步 复选框,则仅当点击 刷新 图标 “刷新”图标 或按下 Ctrl+F5 时, 数据库 工具窗口(视图(V)| 工具窗口| 数据库 )中的数据源视图才会与数据库的实际状态同步。

    刷新数据库状态

步骤 2。 确认已选择所需的 schema

创建数据源时,不会选择任何 schema。 您需要选择计划使用的 schema。

要选择 schema,请执行以下任一操作:

  • 数据库 工具窗口中,右键点击一个数据源并导航至 工具| 管理显示的架构…。 选择或取消选择您希望显示或隐藏的 schema 的复选框。 按下 Enter

  • 单击数据源名称旁的 第 N 项,共 M 项 链接。 在“数据库与架构选择”窗口中,选中或取消选中要显示或隐藏的架构的复选框。 按 Enter

    显示和隐藏 schema 与数据库

默认架构默认数据库 是连接到数据源时当前使用的架构或数据库。 当前架构是在会话中处于活动状态的架构。 您可以使用 SET CURRENT_SCHEMA 更改当前架构。 默认架构取决于数据库设置和在 JDBC URL 中配置的数据源设置。

您可以在数据源的连接设置中更改该默认值。 要更改默认值,请在 数据库 工具窗口中单击 数据源属性 图标 “数据源属性”图标视图(V)| 工具窗口| 数据库)。 在数据源列表中,选择您的数据源。 在 数据库 字段中,输入您希望用作默认值的架构或数据库的名称。

步骤 3。 确认树形过滤器已关闭

如果某种对象类型的条目在视图中被过滤,它们将在 数据库 工具窗口中被隐藏。

为确保数据库对象未在视图中被过滤,请执行以下操作:

  1. 数据库 工具窗口的工具栏中,单击 “视图选项”图标视图选项

  2. 选择 “过滤器”图标筛选器

  3. 导航到数据库对象类型,并确保相关复选框已勾选。

筛选器图标角上的绿色圆点表示筛选器已启用,部分对象已被筛选。

除视图与表外,所有内容均被过滤

在 Database 工具窗口中仅选择视图与表进行查看

没有对象被过滤

在 Database 工具窗口中选择查看所有项

步骤 4。 强制刷新 schema 信息

强制刷新 操作会清除缓存中的数据源信息,并重新加载。

  • 数据库 工具窗口中,右键单击某个数据源并选择 诊断| 强制刷新

    强制刷新 schema 信息

步骤 5。 清除并同步 schema 缓存

切换为基于 JDBC 的 introspector

请将此操作视为临时解决方案。 如果在 数据库 工具窗口中无法看到对象,您可能遇到了 Bug。 收集故障排除资料将其发送给我们的支持团队

临时启用使用 JDBC 元数据的内省

  1. 通过以下任一方式打开数据源属性:

    • 数据库 工具窗口的工具栏上,单击 “数据源”图标数据源

    • Shift+Enter

    打开“数据源和驱动程序”对话框
  2. 数据源 选项卡中,选择要修改的数据源。

  3. 打开 高级 选项卡。

  4. 专家选项 列表中,选中 使用JDBC 元数据内省(M) 复选框。

  5. 同步视图(请参阅 第 1 步。 同步数据库状态)。

最后修改日期: 2025年 9月 26日