元数据和自省

元数据包含有关数据库对象、结构、数据库对象源代码等的信息。 IntelliJ IDEA 使用这些信息在数据库工具窗口中显示对象，显示其 DDL，在补全时提供建议，以及用于其他编码辅助、导航和搜索功能。

在 IntelliJ IDEA 中，有两种获取数据库元数据的方法：迷你目录和自省。

迷你目录

通过系统架构的迷你目录，系统架构的元数据已预先自省并随 IDE 一起提供。它们允许在无需自省系统架构且不需要连接数据库的情况下编写使用系统元数据的脚本。

自省

自省是加载数据库元数据的过程。当您执行内省时，会检查数据源中的结构信息，以检测表、列、例程及其他具有其特性（属性）的数据库对象。

自省仅支持具有数据结构和目录的数据库。

默认情况下，仅对选择在数据库工具窗口中显示的架构和数据库进行 Introspection。

您可以通过在数据库工具窗口中选择它们，或在数据源和驱动程序对话框（Shift+Enter ）中编辑数据源属性来选择将被内省和显示的架构和数据库。

在数据库工具窗口中：
1. 要打开数据库工具窗口，请从主菜单中选择视图 | 工具窗口 | 数据库。或者，按 ⌘ 1。
2. 在数据库工具窗口中，点击数据源、数据库或架构名称旁边的第 N 个，共 M 个按钮。
3. 在架构选择弹出窗口中，选择数据库或架构并按下 Enter。
在数据源和驱动程序对话框中：
1. 要打开对话框，请在数据库工具窗口中右键点击数据源，然后选择 Properties。或者，点击工具栏上的数据源属性},{ 图标。
2. 在数据源和驱动程序对话框的架构选项卡中，选择数据库或架构。
  请注意，对象筛选器字段仅定义哪些对象在数据库工具窗口中可见，并不影响自省作用域。
3. 应用更改并关闭对话框。

一旦必要的数据库和架构完成 Introspection，IDE 就可以在您的脚本中将数据库对象解析到正确的上下文。以下示例演示了已 Introspection 和未 Introspection 架构的数据库对象解析。

尚未 Introspection 的 MySQL 数据源。
PostgreSQL 数据源中唯一已 Introspection 的 guest 数据库。该数据库包含四个架构，仅 public 架构已完成 Introspection。
在查询控制台中的数据库对象解析：对已内省的 guest 架构成功，对未内省的 tests 架构失败。

对于每个数据源，您还可以选择加载数据库对象源代码的架构类别。

如果处理所有对象，数据库用户可能会遇到较长的 Introspection 时间，而这通常不是日常工作和代码辅助所必需的。为了减少内省对象的数量，IntelliJ IDEA 为部分支持的数据库实现了额外的自省类型以及三个自省级别。

自省类型定义了在内省期间刷新哪些数据库对象。某些数据库允许将自省作用域缩小到特定对象。在 IntelliJ IDEA 中，根据您的数据库，可用以下自省类型：完全自省、片段自省和增量自省。

完全自省

在数据库工具窗口（架构选择器）或数据源和驱动程序对话框（架构选项卡）中为内省选择的架构和数据库将被刷新。

增量自省

仅刷新在上一次内省运行后数据库中更改的数据库对象。

片段自省

对于部分支持的数据库，自省可以通过自省级别执行。

按级别自省

自省级别定义了检索数据库对象的详细程度：

有关自省级别的更多信息，请参阅内省级别主题。

如果某个数据库不支持特定的内省类型，IntelliJ IDEA 将执行完整内省。以下数据库支持特定类型的自省和自省级别：

2026年 3月 24日