IntelliJ IDEA 2025.3 ヘルプ

永続化ツールウィンドウ

プロジェクトに JPA または Spring Data 依存関係がある場合は、永続化ツールウィンドウを使用できます。プロジェクトの依存関係に基づいて、以下の要素が表示されます。

  • JPA : JPA 項目 (構成ファイル、永続性ユニット、管理対象エンティティ (永続クラスとフィールド)、Spring リポジトリ、JPA コンバーター) を表示および管理します。

  • Spring Data JDBC : JDBC マップされたエンティティ、属性、リレーション、リポジトリを表示し、マッピングコンテキストを構成します

  • Spring Data モンゴ DB : MongoDB @Document クラスを表示します。

  • Liquibase: Liquibase の変更ログを表示し、新しい変更ログを作成し、Liquibase の更新を実行します。

The Persistence tool window

永続ビューでエンティティを開く

  1. ガターで、エンティティアイコン The Entity icon をクリックします。特定のフィールドに移動する場合は、その横にある対応するアイコン (The attribute iconThe reference icon など) をクリックします。

  2. 永続化ビューで選択を選択します。

Select in Persistence View

または、エンティティのソースコードにキャレットを置き、永続化ツールウィンドウで をクリックします。

エンティティ定義に移動する

永続化ツールウィンドウのエンティティからエディターの対応するソースコード定義に移動するには、次のいずれかを実行します。

  • フィールドをダブルクリックします。

  • フィールドまたはクラスを選択して、F4 を押します。

  • フィールドまたはクラスを右クリックして、ソースに移動を選択します。

永続ユニットを手動で作成する

ほとんどの場合、IntelliJ IDEA は @Entity アノテーションに基づいて JPA エンティティを自動的に検出します。そうでない場合は、手動で永続ユニットを作成し、必要なエンティティを追加してデータベースにマッピングすることができます。追加されたエンティティは永続化ツールウィンドウに表示され、そこからエディターでソースコード定義に移動できます。

  1. 永続化ツールウィンドウで、JPA を右クリックします。

  2. 新規 | 永続化単位を選択します。

  3. 開いた永続性ユニットの編集ウィンドウで、マッピングコンテキストを構成します。コンテキストに名前を付け、データベース接続を選択し、JPA エンティティ をクリックして、マップするクラスを追加します。

Mapping Context

JDBC マッピングコンテキストを手動で作成する

ほとんどの場合、IntelliJ IDEA は @Table アノテーションまたはその JDBC リポジトリに基づいて JDBC エンティティを自動的に検出します。そうでない場合は、必要な JDBC エンティティを追加し、データベースにマッピングするためのマッピングコンテキストを手動で作成できます。追加されたエンティティは永続化ツールウィンドウに表示され、そこからエディターでソースコード定義に移動できます。

  1. 永続化ツールウィンドウで、Spring Data JDBC を右クリックします。

  2. 新規 | マッピングコンテキストを選択します。

  3. 開いたマッピングコンテキストの編集ウィンドウで、マッピングコンテキストを構成します。コンテキストに名前を付け、データベース接続を選択し、JDBC エンティティ をクリックして、マップするクラスを追加します。

Mapping Context

実体関連ダイアグラムを表示する (ERD)

  • 管理対象エンティティを右クリックして、ER ダイアグラムを選択します。

永続性ユニットをデータソースに関連付ける

  1. モジュール、永続性ユニット、エンティティを右クリックして、データソースの割り当てを選択します。

  2. 関連する永続ユニットに必要なデータソースを選択し、OK をクリックします。

この関連付けにより、IntelliJ IDEA は、対応するデータソースに対してデータベーステーブルを参照するソースコードを検証します。また、コンソールは適切なデータベース接続設定を使用するため、手動で指定する必要はありません。

永続性ユニットを命名戦略に関連付ける

  1. モジュール、永続性ユニット、エンティティを右クリックして、命名戦略の割り当てを選択します。

  2. 関連する永続性ユニットに必要な命名戦略を選択し、OK をクリックします。

JPQL クエリを実行する

  • 永続性ユニットまたはエンティティを右クリックしてコンソールを選択するか、ツールバー Ctrl+Shift+F10The Console button をクリックします。

これにより、JPQL クエリを記述して実行できるコンソールが開きます。

データベースからエンティティを生成する

IntelliJ IDEA を使用すると、既存のデータベーススキーマに基づいて JPA エンティティクラスと属性を作成できます。この機能は、IntelliJ IDEA Ultimate にバンドルされているリバースエンジニアリングプラグインに依存します。

データベースから JPA エンティティを生成する

  1. データベース接続が確立されていない場合は、接続を作成します

  2. 永続化ツールウィンドウで、JPA ノードを展開し、要素を右クリックして、新規 | DB からの JPA エンティティを選択します。

    または、データベースツールウィンドウでデータベース接続を右クリックし、DB から JPA エンティティを作成するを選択します。

  3. マップするデータベース接続、テーブル、属性を選択します。詳細については、DB ウィザードからのエンティティを参照してください。

IDE が開いている間、データベースは他のクライアントによって変更される可能性があります。データベースから最新のデータを取得するには、DB からのエンティティウィンドウまたはデータベースツールウィンドウのいずれかで をクリックします。

データベースから属性を生成する

データベーステーブルに基づいて既存のクラスの属性を生成することもできます。

  1. データベース接続が確立されていない場合は、接続を作成します

  2. 永続化ツールウィンドウで、JPA ノードを展開し、エンティティを右クリックして新規 | DB からの JPA エンティティを選択します。

    または、データベースツールウィンドウでデータベース接続を右クリックし、DB から JPA 属性を作成するを選択します。

  3. データベース接続、テーブルまたはビュー、マップする列を選択します。属性の移行フローは、DB ウィザードからのエンティティセクションで説明されているものと同じです。

    Entity attributes from DB dialog
2026 年 2 月 11 日

関連ページ:

JPA Buddy

JPA Buddy は、開発者が Hibernate、EclipseLink、Spring Data JPA、Flyway、Liquibase、Lombok、MapStruct、その他の関連テクノロジーを Java と Kotlin の両方で効率的に使用できる IntelliJ IDEA プラグインです。このプラグインは、JPA を使用した開発への参入障壁を下げ、開発者の生産性を向上させ、コードがベストプラクティスに従っていることを確認します。JPA Buddy は以下を提供します。JPA を操作...

データソース

データベースツールと SQL プラグインを有効にするこの機能は、IntelliJ IDEA にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。データソースは接続構成です。データベースへの接続を確立...

コンソール

JPA コンソールを使用して、JPQL クエリを記述および実行します。JPQL キーワード、オブジェクト、プロパティ名の便利なハイライトと補完が提供されます。persistence.xml に、永続性ユニットが対応する JPA コンソールから JPQL クエリを実行できるようにするために必要な情報 (永続性プロバイダ、永続クラスのリスト、接続プロパティ) が含まれていることを確認します。例: EclipseLink および MySQL の場合、次のようになります。<persistence-u...

リバースエンジニアリング

リバースエンジニアリングは、データベーススキーマに基づいて JPA エンティティクラスをスキャフォールディングするプロセスです。データベースから JPA エンティティを生成するデータベース接続が確立されていない場合は、接続を作成します。データベースツールウィンドウで、JPA ノードを展開し、データベースまたは特定のテーブルを右クリックして、を選択します。マップするデータベース接続、テーブル、属性を選択します。詳細については、DB ウィザードからのエンティティを参照してください。IDE が開いている...

Jakarta Persistence (JPA)

以前は JavaPersistence API として知られていた Jakarta Persistence(JPA) は、Java エンタープライズアプリケーションでリレーショナルデータを管理するための Java 仕様です。Jakarta EE を有効にする: 永続性 (JPA) プラグインこの機能は、デフォルトで IntelliJ IDEA にバンドルされて有効になっている Jakarta EE: 永続化 (JPA) プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にし...