# メタデータとイントロスペクション

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/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.

データベース   ツールウィンドウで、データソース、データベース、スキーマ名の横にある   N/M   ボタンをクリックします。

![データベースツールウィンドウでスキーマまたはデータベースを選択する](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.

ダイアログを開くには、   データベース   ツールウィンドウでデータソースを右クリックし、 ![the Properties icon](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg)   プロパティ   を選択します。 または、ツールバーの ![the Settings button](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`  データベース。 このデータベースには 4 つのスキーマが含まれており、  `public`  スキーマのみがイントロスペクトされています。

3.  クエリコンソール でのデータベースオブジェクトの解決: イントロスペクトされた  `guest`  スキーマの場合は成功し、イントロスペクトされていない  `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)), `⌘ 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)) でイントロスペクション用に選択されたスキーマとデータベースがリフレッシュされます。

増分イントロスペクション
: 前回のイントロスペクション実行後にデータベース内で変更されたデータベースオブジェクトのみがリフレッシュされます。

フラグメントイントロスペクション
: * リフレッシュ アクションを呼び出すと、 データベース ツールウィンドウで選択されたデータベースオブジェクトのみがリフレッシュされます。 ![データベースツールウィンドウで選択されたデータベースオブジェクトは、リフレッシュアクションを呼び出すとリフレッシュされます。](https://resources.jetbrains.com/help/img/idea/2026.3/introspection_fragment_introspection.png)
:
: * クエリコンソール でステートメントを実行すると、 スマートリフレッシュ 機構が適用されます。 CLion は、このステートメントによって変更される可能性のあるオブジェクトを分析し、その特定のオブジェクトのみをリフレッシュします。 [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)

データベースで特定のイントロスペクションタイプがサポートされていない場合、CLion はフルイントロスペクションを実行します。 以下のデータベースでは、特定のイントロスペクションタイプとイントロスペクションレベルがサポートされています。

|  データベース  |  増分イントロスペクション  |  フラグメントイントロスペクション  |  イントロスペクションレベル  |
| --- | --- | --- | --- |
|  [Amazon Redshift](amazon-redshift.html)  |  はい  |  はい  |  はい  |
|  [Azure SQL Database](azure-sql-database.html)  |  はい  |  はい  |  -  |
|  [Greenplum](greenplum.html)  |  はい  |  -  |  -  |
|  [MariaDB](mariadb.html)  |  はい  |  はい  |  はい  |
|  [Microsoft SQL サーバー](microsoft-sql-server.html)  |  はい  |  はい  |  はい  |
|  [MySQL](mysql.html)  |  はい  |  はい  |  はい  |
|  [Oracle​](oracle.html)  |  はい  |  はい  |  はい  |
|  [PostgreSQL](postgresql.html)  |  はい  |  はい  |  はい  |

