IntelliJ IDEA 2026.1 Help

コンソール

JPA コンソールを使用して、JPQL クエリを記述および実行します。 JPQL キーワード、オブジェクト、プロパティ名の便利なハイライトと補完が提供されます。

persistence.xml に、永続性ユニットが対応する JPA コンソールから JPQL クエリを実行できるようにするために必要な情報 (永続性プロバイダ、永続クラスのリスト、接続プロパティ) が含まれていることを確認します。 例: EclipseLink および MySQL の場合、次のようになります。

<persistence-unit name="NewPersistenceUnit"> <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider> <class>com.example.MyApp.models.ProductsEntity</class> ... <properties> <property name="eclipselink.jdbc.url" value="jdbc:mysql://localhost:3306/database"/> <property name="eclipselink.jdbc.driver" value="com.mysql.jdbc.Driver"/> <property name="eclipselink.jdbc.user" value="root"/> <property name="eclipselink.jdbc.password" value="root"/> </properties> </persistence-unit>

JPA コンソールを開く

以下のいずれかを行います。

  1. 永続化ツールウィンドウで、永続性ユニットまたはエンティティを右クリックし、 JPA コンソール を選択します。 または、ツールバーの The Console button をクリックするか、 Ctrl+Shift+F10 を押すこともできます。

  2. エディターから直接クエリメソッドを実行します。

JPA コンソールの入力ペインは、JPQL クエリを記述および実行できる別のタブとして開きます。

JPA コンソールツールバーには、次のボタンが含まれています。

クエリの実行

Ctrl+Enter

現在のクエリを実行します。

データベース設定を開く

設定 ダイアログ Ctrl+Alt+S の データベース | クエリ実行ページを開きます。

パラメーターの表示

パラメーター ペインを開いて、クエリで使用されているパラメーターを確認し、それらの値を設定します。

クエリ履歴の参照

Ctrl+Alt+E

このコンソールで実行したすべてのクエリを表示するコンソール履歴ダイアログを開きます。

デフォルトレイアウトの復元

レイアウトの変更後、元のツールウィンドウレイアウトを復元します。

プロパティソースを選択

プロパティのソースを選択します (永続性ユニットが persistence.xml の外部に構成されている場合に使用可能)。

プロセスの終了

Ctrl+F2

現在のコンソールセッションを終了します。

閉じる

Ctrl+Shift+F4

現在のコンソールを閉じます。

JPQL クエリを実行する

クエリを作成したら、次のいずれかを実行します。

  • Ctrl+Enter を押す。

  • ツールバーの The Execute Query button をクリックします。

パラメーターを使用してクエリを実行するときは、それらの値を入力する必要があります。 または、 The View Parameters button をクリックして パラメーター ペインを開きます。

IntelliJ IDEA は、実行したすべてのクエリを保存します。 Up を押すと、最新のものから順に、以前に実行されたコマンドが表示されます。 完全な履歴を表示するには、 The Browse Query History button をクリックします。

エディターから Spring Data クエリメソッドを実行する

IntelliJ IDEA を使用すると、エディターから直接 Spring Data リポジトリクエリメソッドを実行できます。 これにより、アプリケーションを実行せずにメソッドのクエリを検証できます。 以下を実行できます。

  • Spring Data JPA リポジトリ内の派生クエリメソッド: IntelliJ IDEA は メソッド名を解析し、そこからクエリを派生させて、JPA コンソールで実行します。

  • 実行する明示的な JPQL クエリを持つ @Query および @NamedQuery アノテーションが付けられたメソッド。

  • @NamedNativeQuery でアノテーションが付けられたメソッドと、 @Query および nativeQuery = true 属性でアノテーションが付けられたメソッド — ネイティブ SQL クエリを実行します。

  1. リポジトリのソースコードを開きます。

  2. ガターで、クエリメソッドの横にある (コンソールでクエリ実行) をクリックします。

  3. メソッドにパラメーターがある場合は、開いた パラメーター ダイアログにその値を入力し、 Enter を押して、 実行 をクリックします。

Convert Spring Data JPA method to JPQL

結果のクエリは、メソッドを実行すると自動的に開く コンソール ツールウィンドウで確認できます。 ネイティブ SQL クエリの場合、対応するデータベースセッションが サービス ツールウィンドウで開きます。 クエリの出力は、ツールウィンドウの 結果 タブに表示されます。

クエリを作成するときは、対応するクラスまたはフィールドの宣言を確認すると便利です。

  • Ctrl を押したまま、関連するオブジェクトまたはプロパティをクリックします。

  • 関連するオブジェクトまたはプロパティの名前にキャレットを置き、 Ctrl+B を押すか、メインメニューから 移動 | 宣言に移動 を選択します。

カスタム JVM オプションを使用して JPA コンソールを実行する

JPA コンソールは Java プロセスです。 必要に応じて、カスタム JVM オプションを使用して開始できます。

  1. アプリケーション 実行構成を作成する

    実行 | 実行構成の編集(E) に移動し、 追加ボタン をクリックして、 アプリケーション を選択します。

  2. 「VM オプション 」フィールドに、JVM の起動時に渡すオプションを指定します。 残りの実行構成設定は重要ではないため、指定する必要はありません。

    OK(O) をクリックして、実行構成を保存します。

  3. JPA コンソールを開くと、IntelliJ IDEA は、使用可能な実行構成を含む追加の VM および Env 構成 ポップアップを表示します。 必要な JVM オプションがあるものを選択するか、デフォルト設定で実行します。

2026 年 3 月 30 日
永続化ツールウィンドウHibernate