# 元数据和自省

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

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

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

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

## 内省

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

仅支持对具有数据结构和目录的数据库进行内省。

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

您可以通过在   数据库   工具窗口中选择架构和数据库，或在   数据源和驱动程序   对话框（ `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) ）对话框中编辑数据源属性，来选择将内省并显示哪些架构和数据库。

Procedure: 选择架构和数据库以进行 Introspection

> **Note:**
> 根据数据库的大小，Introspection 和加载元数据可能会占用大量时间和磁盘空间。

* 在   数据库   工具窗口中：

1.

要打开   数据库   工具窗口，请从主菜单中选择  `视图 | 工具窗口 |   数据库` 。 或者，按 `⌘ 1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `⌘ 1` (XWin), `⌘ 1` (GNOME), `⌘ 1` (KDE), `⌘ 1` (Emacs), `⌘ 1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+3` (Visual Studio), `⌘ ⌃ 3` (Visual Studio (macOS)), `⌘ 1` (NetBeans), `⌘ 1` (Eclipse), `⌘ 1` (Eclipse (macOS))。

2.

在   数据库   工具窗口中，点击数据源、数据库或架构名称旁边的   第 N 个，共 M 个   按钮。

![在 Database 工具窗口中选择架构或数据库](https://resources.jetbrains.com/help/img/idea/2026.3/select_schemas_or_databases_to_show.png)

3.

在架构选择弹出窗口中，选择数据库或架构并按下 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

* 在   数据源和驱动程序   对话框中：

1.

要打开对话框，请在   数据库   工具窗口中右键点击数据源，然后选择 ![属性图标](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg)   Properties  。 或者，点击工具栏上的 ![设置按钮](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources_dark.svg)   数据源属性},{   图标。

2.

在   数据源和驱动程序   对话框的   架构   选项卡中，选择数据库或架构。

![在数据源属性中选择架构或数据库](https://resources.jetbrains.com/help/img/idea/2026.3/db_schemas_or_databases_to_show_in_properties.png)

请注意，   对象筛选器   字段仅定义哪些对象在   数据库   工具窗口中可见，并不会影响内省作用域。

3.

应用更改并关闭对话框。

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

![为已 Introspection 和未 Introspection 的架构解析数据库对象](https://resources.jetbrains.com/help/img/idea/2026.3/introspection_objects_resolve.png)

1.  尚未 Introspection 的  `MySQL`  数据源。

2.   `PostgreSQL`  数据源中唯一已 Introspection 的  `访客`  数据库。 该数据库包含四个架构，仅  `public`  架构已完成 Introspection。

3.  查询控制台 中的数据库对象解析：已内省的  `访客`  架构解析成功，尚未内省的  `tests`  架构解析失败。

> **Tip:**
> 对于查询控制台s，数据库对象解析也取决于所选的解析模式。 有关 查询控制台 解析模式的更多信息，请参阅 [运行查询](run-a-query.html#resolve_modes) 主题。

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

Procedure: 加载不同模式的数据库对象源

1. 要选择加载数据库对象源的架构，请打开   数据源和驱动程序   对话框（ `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) ）并选择一个数据源。

2. 在   选项   选项卡中，导航到   加载来源于   设置并选择模式类别。

3. 应用更改并关闭对话框。

![选择加载数据库对象源的模式类别](https://resources.jetbrains.com/help/img/idea/2026.3/db_introspection_settings_load_sources_for.png)

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

## 自省类型

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

完全自省
: 会刷新在   数据库   工具窗口（ [架构选择器](database-tool-window.html#show_more_schemas)）或   数据源和驱动程序   对话框（   架构   [选项卡](data-sources-and-drivers-dialog.html#schemasAndTablesTab)）中选择用于内省的架构和数据库。

增量自省
: 仅刷新上次内省运行后在数据库中发生更改的数据库对象。

片段自省
: * 调用 刷新 操作时，仅刷新在 数据库 工具窗口中选定的数据库对象。 ![调用刷新操作时，将刷新在数据库工具窗口中选定的数据库对象](https://resources.jetbrains.com/help/img/idea/2026.3/introspection_fragment_introspection.png)
:
: * 在 查询控制台 中运行语句时，会应用 智能刷新 机制。 IntelliJ IDEA 会分析此语句可能会修改哪些对象，并且仅刷新这一特定对象设置。 [Video](https://resources.jetbrains.com/help/img/idea/2026.3/introspection_smart_refresh.mp4)

对于部分受支持的数据库，可以按  内省级别  执行内省。

按级别内省
: 内省级别定义为数据库对象检索的详细信息量：
:
:
:
: * 级别 1：仅加载数据库对象名称。
:
: * 级别 2：加载除数据库对象源代码之外的所有内容。
:
: * 级别 3：加载所有内容。
:
:
:
: 有关自省级别的更多信息，请参阅 [内省级别](introspection-levels.html) 主题。
:
:
:
: ![数据库工具窗口中的内省级别](https://resources.jetbrains.com/help/img/idea/2026.3/introspection_levels.png)

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

|  数据库  |  增量自省  |  片段自省  |  内省级别  |
| --- | --- | --- | --- |
|  [Amazon Redshift](amazon-redshift.html)  |  是  |  是  |  是  |
|  [Azure SQL 数据库](azure-sql-database.html)  |  是  |  是  |  -  |
|  [Greenplum](greenplum.html)  |  是  |  -  |  -  |
|  [MariaDB](mariadb.html)  |  是  |  是  |  是  |
|  [Microsoft SQL 服务器](microsoft-sql-server.html)  |  是  |  是  |  是  |
|  [MySQL](mysql.html)  |  是  |  是  |  是  |
|  [甲骨文](oracle.html)  |  是  |  是  |  是  |
|  [PostgreSQL](postgresql.html)  |  是  |  是  |  是  |