# 元数据和自省

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

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

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

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

## 内省

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

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

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

您可以通过在   数据库  工具窗口中选择它们，或者在   数据源与驱动程序  对话框（ `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)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS))）中编辑数据源属性，来选择将被内省和显示的架构和数据库。

Procedure: 选择用于自省的架构和数据库

> **Note:**
> 根据数据库的大小，自省和加载元数据可能需要大量时间和磁盘空间。

* 在   数据库  工具窗口中：

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)), `⌘ 1` (Xcode), `Ctrl+Alt+3` (Visual Studio), `⌘ ⌃ 3` (Visual Studio (macOS)), `Ctrl+Alt+3` (ReSharper), `⌘ ⌃ 3` (ReSharper (macOS)), `⌘ 1` (QtCreator), `⌘ 1` (QtCreator (macOS)), `⌘ 1` (NetBeans), `⌘ 1` (Eclipse), `⌘ 1` (Eclipse (macOS))。

2.

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

![在数据库工具窗口中选择架构或数据库](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)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

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

1.

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

应用您的更改并关闭对话框。

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

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

1.  尚未自省的  `MySQL` 数据源。

2.  仅有的  `PostgreSQL` 数据源中已自省的  `guest` 数据库。 该数据库包含四个架构，只有  `public` 架构已被自省。

3.  在 查询控制台 中解析数据库对象：对于已进行内省的  `guest`  模式解析成功，而对于尚未进行内省的  `tests`  模式解析失败。

> **Tip:**
> 对于 查询控制台，数据库对象的解析还取决于所选的解析模式。 有关 查询控制台 解析模式的更多信息，请参阅 [运行查询](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)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (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)

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

## 自省类型

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

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

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

片段自省
: * 当您调用 刷新 操作时，仅刷新在 数据库 工具窗口中选择的数据库对象。 ![在 Database 工具窗口中选中的数据库对象会在调用刷新操作时被刷新](https://resources.jetbrains.com/help/img/idea/2026.3/introspection_fragment_introspection.png)
:
: * 在 查询控制台 中运行语句时，会应用 smart refresh 机制。 CLion 会分析哪些对象可能会被此语句修改，并仅刷新该特定对象集。 [Video](https://resources.jetbrains.com/help/img/idea/2026.3/introspection_smart_refresh.mp4)

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

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

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

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

