# 仮想外部キー

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

明示的に定義された外部キーを使用したくない場合があります。 外部キーを使用しない理由としては、パフォーマンスの問題 (CRUD 操作)、データベースの特性 (ClickHouse や Apache Cassandra などのデータベースは外部キーをサポートしていません)、一時テーブルの使用 (テスト用)、個人的な理由などが考えられます。

この場合でも、データベースコードを変更せずに外部キーリレーションを作成できます。 これを行うには、  仮想外部キー を使用します。 仮想外部キーは、IDE 仮想オブジェクトです。 外部キーの代わりに、仮想キーはデータベースコードで定義されません。

次のクエリ例を検討してください:

```SQL
SELECT * FROM activity JOIN visitor ON visitor_id = visitor.id
```

`visitor_id`  がデータベースの外部キーとして定義されていないと仮定します。 この  `JOIN`  句では、  `activity`  テーブルの  `visitor_id`  フィールドと  `visitor`  テーブルの  `id`  フィールド間のこの仮想関係を引き続き使用できます。 [この関係を保存し](#create_a_virtual_foreign_key_in_query_console)て後で使用することも、正規表現を使用して設定で仮想外部キーの [ルールを構成するこ](#configure-rules-for-virtual-foreign-keys)ともできます。

![仮想外部キー](https://resources.jetbrains.com/help/img/idea/2026.3/db_implicit_foreign_key.svg)

> **Tip:**
> 別のスキーマ内のオブジェクトを指す外部キーがあり、それらのオブジェクト名が同じ場合、外部キーのナビゲーションダイアログでは修飾形式で表示されます。

仮想外部キー関係は  `external-data-<data_source_name>.xml`  に保存されます。 XML ファイルの別の名前や、このファイルを保存する別の場所を選択できます。 XML ドキュメントへのパスを変更または表示するには、 `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)) を押してデータソース設定を開き、   オプション   タブをクリックして、   仮想オブジェクトと属性   フィールドを確認します。

仮想外部キー ( ![仮想外部キー](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.virtualForeignKey.svg)) は、   データベース   ツールウィンドウにあります。

* その他のノードおよびオブジェクトアイコンのリファレンスについては、 [データベースツールウィンドウ](database-tool-window.html)トピックの [データソースとその要素](database-tool-window.html#icons-for-data-sources-and-their-elements)の章を参照してください。

* 表の列アイコンについては、 [列に可能なアイコンの組み合わせ](database-tool-window.html#possible-icon-combinations-for-columns)の章を参照してください。

* [View オプション](database-tool-window.html#view_options)メニューのツリーオブジェクト表示オプションを使用して、ツリーオブジェクトを非表示、並べ替え、フィルター処理、グループ化します。

![データベースの仮想外部キー](https://resources.jetbrains.com/help/img/idea/2026.3/database_object_virtual_foreign_key.png)

## 仮想外部キーを作成する

Modify ダイアログ内:

Procedure:

1. データベース   ツールウィンドウで、テーブルのノードまでデータソースツリーを展開します。

2. テーブルノードを右クリックし、  `新規 | 仮想外部キー`  を選択します。

3. 開いた   変更   ダイアログで、仮想外部キーの名前を   命名方法名   フィールドに入力します。

4. ターゲット テーブル   ペインで、ターゲット表の名前を指定します。

5. 列   ペインで、   追加   ボタン（ ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)）をクリックします。

6. 列名   フィールドに、子テーブルの列の名前を指定します。

7. ターゲット名   フィールドに、ターゲット表の列の名前を指定します。

8. 仮想外部キーを追加するには、   OK   をクリックします。

9. <data_source_name> の外部データを保存；   ダイアログが開いたら、  `external-data-<data_source_name>.xml`  ファイルのディレクトリを指定し、   保存   をクリックします。

> **Note:**
> 使用可能なフィールドとオプションは DBMS によって異なります。 詳細については、お使いの DBMS の公式ドキュメントを参照してください。

![「変更」で仮想外部キーを作成するダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/db_create_virtual_foreing_key_in_modify_dialog.png)

クエリコンソール内:

Procedure:

1. `ON`  句のテーブル関係をクリックし、 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) を押します。

2. テーブルのリレーションを保存   を選択します。

3. <data_source_name> の外部データを保存；   ダイアログが開いたら、  `external-data-<data_source_name>.xml`  ファイルのディレクトリを指定し、   保存   をクリックします。

> **Note:**
> 使用可能なフィールドとオプションは DBMS によって異なります。 詳細については、お使いの DBMS の公式ドキュメントを参照してください。

![テーブルのリレーションを保存](https://resources.jetbrains.com/help/img/idea/2026.3/db_store_table_relation.png)

Procedure: 仮想外部キーのルールを作成する

正規表現を使用して、CLion があるテーブルの列から別のテーブルの列を参照するためのルールを作成できます。

1. 設定を開き（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）、  `データベース | その他`  に移動します。

2. 仮想外部キー   セクションを見つけます。

3. テーブルで、   追加   ボタン ( ![追加ボタンをクリック](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)) をクリックします。

4. カラムのパターン   セルをダブルクリックし、仮想外部キーとして使用する列名に一致する正規表現を入力します。

5. ターゲットカラムのパターン   セルをダブルクリックし、置換パターンを入力します。 置換パターンは   カラムのパターン   式からの一致を使用し、正規表現として解釈されます。

確認 ...   ボタン ( ![チェックボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.gutter.run.svg)) を使用してルールを確認できます。 ルールを選択して   確認 ...   ボタンをクリックすると、   ルールデバッガー   ダイアログが開きます。 結果は   生成されたパターン   : フィールドに表示されます。   生成されたパターン   : フィールドに表示される式は、目的の   ターゲット table.column   : パターンと一致する必要があります。

![仮想外部キーのルールを作成する](https://resources.jetbrains.com/help/img/idea/2026.3/db_create_rules_for_virtual_foreign_keys.png)

Procedure: 仮想外部キーのデバッグルール

1. 設定を開き（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）、  `データベース | その他`  に移動します。

2. 仮想外部キー   セクションを見つけます。

3. ルールを選択し、   確認 ...   ボタン ( ![チェックボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.gutter.run.svg)) をクリックします。

4. ルールデバッガー   ダイアログで、次のフィールドに入力します。

* カラムのパターン :: 仮想外部キーとして使用したい列名に一致する正規表現。 例: `_id` 後置記号を使用する列を記述するには、 `(.*)_(?i)id` 正規表現を使用します。 この正規表現は、 `visitor_id` や `visitor_Id` などの列を検出し、 `visitors` を最初のキャプチャーグループ（ `$1` ）としてキャプチャーします。

* ターゲットカラムのパターン : カラムのパターン : 式のマッチ結果を使用する置換パターンで、正規表現として解釈されます。 結果は 生成されたパターン フィールドで確認できます。 なお、結果は ソース列 : フィールドに列名の例を入力した場合にのみ表示されます。 例: カラムのパターン 式からキャプチャーされたグループ ( `$1` ) を使用し、ドット ( `.` ) と `id` を追加します。 この式は、主キーとして使用できる `visitor.id` 参照を生成します。 メモ : ターゲットカラムのパターン : 置換パターンは、キャプチャーされたグループを含む正規表現パターンを パターンを生成する​ フィールドで生成するために使用されます。 例の式 ( `$1\\.(?i)id` ) のドットのように文字通りに変換されるシンボルは、二重にエスケープしてください。

* ソース列 :: 仮想外部キーとして使用したい列名の例。

* 生成されたパターン : ターゲット table.column : 名前に一致する、生成された読み取り専用の正規表現パターン。 生成されたパターン : は、 ターゲットカラムのパターン : の置換パターンによって生成された結果です。

* ターゲット table.column :: ソース列 の仮想外部キーの主キーとして使用されるテーブル名と列名の例:。

![仮想外部キーのデバッグルール](https://resources.jetbrains.com/help/img/idea/2026.3/db_rule_debugger_for_virtual_foreign_keys.png)

Procedure: コード補完で仮想外部キーを表示する

CLion can generate you a list of possible code completion suggestions for  `JOIN`  statements. コード補完リストには、  `JOIN`  ステートメントのテーブルの列と同じ名前を持つ他のテーブルの列の提案が含まれます。

たとえば、  `actor`  テーブルに次の列があるとします:  `actor_id` 、  `first_name` 、  `last_name` 、  `last_update` 。 候補リストには、他のテーブルに存在するこれらのカラム名前の補完候補が表示されます。

1. `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `エディター | 一般 | コード補完 | ポップアップ`  に移動します。

2. SQL   セクションまでスクロールし、   名前の一致に基づいて厳密でない外部キーを提案する   を選択します。

チェックボックス選択済み:

![名前の一致に基づいて非厳密な外部キーを提案する](https://resources.jetbrains.com/help/img/idea/2026.3/db_suggest_non_strict_foreign_keys_based_on_the_name_matching_on.png)

チェックボックス未選択:

![名前の一致に基づいて厳密でない外部キーを提案するはオフです](https://resources.jetbrains.com/help/img/idea/2026.3/db_suggest_non_strict_foreign_keys_based_on_the_name_matching_off.png)

