# クエリを実行する

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

> **TL;DR**
> SQL コードを実行するには、 `Ctrl+Enter` (Windows), `⌘ ⏎` (macOS), `⌘ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ ⏎` (macOS System Shortcuts), `Ctrl+Enter` (XWin), `Ctrl+Enter` (GNOME), `Ctrl+Enter` (KDE), `Ctrl+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `⌘ ⏎` (Xcode), `Ctrl+Enter` (Visual Studio), `⌘ ⏎` (Visual Studio (macOS)), `Ctrl+Enter` (ReSharper), `⌘ ⏎` (ReSharper (macOS)), `Ctrl+Enter` (QtCreator), `Ctrl+Enter` (QtCreator (macOS)), `Ctrl+Enter` (NetBeans), `Ctrl+Enter` (Eclipse), `⌘ ⏎` (Eclipse (macOS)) を押します
>
>
>
> 実行中のステートメントをキャンセルするには、 `Ctrl+F2` (Windows), `⌘ F2` (macOS), `⌘ F2` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ .` (macOS System Shortcuts), `Ctrl+F2` (XWin), `Ctrl+F2` (GNOME), `Ctrl+2` (KDE), `Ctrl+F2` (Emacs), `Ctrl+F2` (Sublime Text), `Ctrl+F2` (Sublime Text (macOS)), `⌘ .` (Xcode), `Shift+F5` (Visual Studio), `⇧ F5` (Visual Studio (macOS)), `Shift+F5` (ReSharper), `⇧ F5` (ReSharper (macOS)), `Shift+F5` (QtCreator), `⌘ ⇧ Y` (QtCreator (macOS)), `Shift+F5` (NetBeans), `Ctrl+F2` (Eclipse), `⌘ F2` (Eclipse (macOS)) を押します

Procedure: データベースツールおよび SQL プラグインを有効化

この機能は、CLion にデフォルトでバンドルされ有効化されている データベースツールおよび SQL プラグインに依存しています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

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  プラグインを見つけて   有効化   をクリックします。

クエリは、ショートカット、ツールバーボタン、コンテキストメニュー、実行/デバッグ構成を使用して実行できます。 You can do this from [クエリコンソールs](query-consoles.html), [scratch files](scratches.html), and [user files](working-with-user-files.html).

[Video](https://www.youtube.com/v/-MFoSwcPkb4)

> **Tip:**
> A  クエリコンソール  does not differ from other SQL files like user files and scratches. 唯一の違いは、クエリコンソール はすでにデータソースに接続されているため、コードを入力してすぐに実行できることです。 クエリコンソール は、ターミナルと同じように使用できます。 入力して `Ctrl+Enter` (Windows), `⌘ ⏎` (macOS), `⌘ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ ⏎` (macOS System Shortcuts), `Ctrl+Enter` (XWin), `Ctrl+Enter` (GNOME), `Ctrl+Enter` (KDE), `Ctrl+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `⌘ ⏎` (Xcode), `Ctrl+Enter` (Visual Studio), `⌘ ⏎` (Visual Studio (macOS)), `Ctrl+Enter` (ReSharper), `⌘ ⏎` (ReSharper (macOS)), `Ctrl+Enter` (QtCreator), `Ctrl+Enter` (QtCreator (macOS)), `Ctrl+Enter` (NetBeans), `Ctrl+Enter` (Eclipse), `⌘ ⏎` (Eclipse (macOS)) を押すと、コードが実行されます。

クエリ結果を表示する場所と方法の詳細については、 [クエリ結果](viewing-query-results.html) を参照してください。

## ステートメントとプロシージャーを実行する

Procedure: クエリコンソールでステートメントを実行する

1. データベース   ツールウィンドウで、データソースをクリックします。

2. クエリコンソール を開くには、 `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) を押してください。 クエリコンソールの操作方法について詳しくは、 [クエリコンソール](query-consoles.html)を参照してください。

3. 実行したいステートメントを入力するか貼り付けます。

4. ツールバーの ![実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg)   実行   をクリックします。 あるいは、 `Ctrl+Enter` (Windows), `⌘ ⏎` (macOS), `⌘ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ ⏎` (macOS System Shortcuts), `Ctrl+Enter` (XWin), `Ctrl+Enter` (GNOME), `Ctrl+Enter` (KDE), `Ctrl+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `⌘ ⏎` (Xcode), `Ctrl+Enter` (Visual Studio), `⌘ ⏎` (Visual Studio (macOS)), `Ctrl+Enter` (ReSharper), `⌘ ⏎` (ReSharper (macOS)), `Ctrl+Enter` (QtCreator), `Ctrl+Enter` (QtCreator (macOS)), `Ctrl+Enter` (NetBeans), `Ctrl+Enter` (Eclipse), `⌘ ⏎` (Eclipse (macOS)) を押します。

複数のステートメントがある場合は、すべてのステートメントを実行するか、単一のステートメントを実行するかを選択します。 候補リストには、常にすべてのステートメントを実行するための項目が含まれています。

![クエリを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/db_run_query.png)

> **Tip:**
> CLion は、クエリの実行が 20 秒を超えて完了した場合に通知できます。 [この通知を有効化](notifications.html#configure_notifications_per_event_group)するには、 `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)) を押して設定を開き、   外観 & 振る舞い | 通知   を選択します。 イベントグループリストから   時間がかかったデータベースクエリ   を選択し、通知タイプを有効化します。

Procedure: 開いているファイルからステートメントを実行する

In CLion, you can open and run a file. ファイルサイズの制限は 20 MB です。 20 MB を超えるファイルを開くと、ファイルの最初の 2.5 MB のみが表示されます。 ファイルは SQL ファイルタイプに関連付けられている必要があります。 ファイルタイプの関連付けの詳細については、 [ファイルタイプの関連付け](creating-and-registering-file-types.html#configure-associations-between-filename-patterns-and-file-types)トピックを参照してください。

1. プロジェクト   ツールウィンドウ（  `表示 | ツールウィンドウ |   プロジェクト`  ）を開き、SQL ファイルをダブルクリックします。

For more information about attaching directories and files in CLion, refer to [ユーザーファイル](working-with-user-files.html).

2. 実行するステートメントをクリックします。

また、実行するコードのフラグメントを選択（ハイライト）できます。 サブクエリまたはステートメントのグループにすることができます。 CLion executes only the selection.

3. ツールバーの ![実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg)   実行   ボタンをクリックします。 あるいは、 `Ctrl+Enter` (Windows), `⌘ ⏎` (macOS), `⌘ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ ⏎` (macOS System Shortcuts), `Ctrl+Enter` (XWin), `Ctrl+Enter` (GNOME), `Ctrl+Enter` (KDE), `Ctrl+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `⌘ ⏎` (Xcode), `Ctrl+Enter` (Visual Studio), `⌘ ⏎` (Visual Studio (macOS)), `Ctrl+Enter` (ReSharper), `⌘ ⏎` (ReSharper (macOS)), `Ctrl+Enter` (QtCreator), `Ctrl+Enter` (QtCreator (macOS)), `Ctrl+Enter` (NetBeans), `Ctrl+Enter` (Eclipse), `⌘ ⏎` (Eclipse (macOS)) を押します。

クエリ実行設定をカスタマイズするには、   カスタマイズ   リンクをクリックします。 または、 `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)) を押して設定を開き、  `ツール | データベース | クエリ実行`  に移動します。 .

4. (オプション) SQL ファイルがデータソースにアタッチされていない場合は、   <データソース>   リストでアタッチするデータソースを選択します。

SQL ファイルをデータソースに添付する方法の詳細については、「 [データソースの添付](run-sql-files.html#data_source_attachment)」を参照してください。

5. ステートメント   ウィンドウで、 `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)) を押して、選択したステートメントを実行します。 他のエントリを切り替えて、別のステートメントのセットを実行できます。 実行しようとしているステートメントは、クエリエディターでハイライトされます。

> **Tip:**
> ステートメント   ウィンドウで、   カスタマイズ   をクリックして、チューザーを表示するか、常にキャレットでステートメントを実行するかを定義できます。

スクリプトファイルを実行する別の例については、「 [youtube.com の次のビデオ(英語)](https://www.youtube.com/watch?v=U5SOD-eeK50&t=1913s)」を参照してください。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/run-individual-statements.mp4)

Procedure: ストアドプロシージャを実行する

ストアドプロシージャとは、名前が割り当てられた SQL 文のセットです。 PostgreSQL、Microsoft SQL サーバー、Oracle​、MySQL でストアドプロシージャを実行できます。

1. 実行するストアド関数を右クリックし、   関数の実行   を選択します。

2. ルーチンの実行   ウィンドウで、必要なすべてのパラメーター値を入力し、   OK   をクリックします。

必要に応じて、   実行元   チェックボックスを選択し、保存された関数を実行するファイルまたはコンソールを選択します。

![ストアドプロシージャを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/run_stored_functions.png)

Procedure: SELECT ステートメントを実行し、結果をファイルに保存する

1. (オプション) ファイルがデータソースに接続されていない場合は、ツールバーのデータソースのリストからデータソースを選択します。 次に、   セッション   リストから接続セッションを選択します。

接続セッションの詳細については、 [セッション](managing-connection-sessions.html) を参照してください。

2. `SELECT`  ステートメントを右クリックします。

3. ファイルへ実行   を選択して、出力フォーマットを選択してください。

4. データのエクスポート​   ダイアログで、使用するエクストラクターとその他の設定を指定します。

データのエクスポート​   ダイアログの詳細については、 [データのエクスポート](export-data.html#export-data-from-the-database-tool-window)トピックを参照してください。

![SELECT ステートメントの結果をファイルに保存する](https://resources.jetbrains.com/help/img/idea/2026.3/db_execute_to_file.png)

Procedure: クロスデータベースクエリを実行する

CLion では、事前にデータをコピーしなくても、異なるデータベース間のデータをクエリして結果を直接表示できます。

1. データベース   ツールウィンドウのツールバーで、 ![追加アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg)   追加   をクリックし、 ![ワークスペースのデータソースアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.database.icons.datagrip.svg)   ワークスペースのデータソース   を選択します。

CLion は   ワークスペース   データソースを作成し、そのデフォルトの クエリコンソール を自動的に開きます。

2. クエリコンソール で、  `SELECT ... FROM`  クエリを記述します。 `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `⌃ Space` (Xcode), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (ReSharper), `⌃ Space` (ReSharper (macOS)), `Ctrl+Space` (QtCreator), `⌃ Space` (QtCreator (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS)) コード補完を使用して、データソースとデータベースオブジェクトを選択します。

たとえば、   PostgreSQL   と   MySQL   データソースのデータを結合します:

```SQL
SELECT c.first_name, c.last_name, p.amount
FROM #PostgreSQL.guest.public.customer c
         JOIN #MySQL.sakila.payment p
              ON c.customer_id = p.customer_id;

```

特殊な構文の詳細については、 [構文](cross-database-queries.html#syntax) を参照してください。

3. ツールバーの ![実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg)   実行   をクリックします。 あるいは、 `Ctrl+Enter` (Windows), `⌘ ⏎` (macOS), `⌘ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ ⏎` (macOS System Shortcuts), `Ctrl+Enter` (XWin), `Ctrl+Enter` (GNOME), `Ctrl+Enter` (KDE), `Ctrl+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `⌘ ⏎` (Xcode), `Ctrl+Enter` (Visual Studio), `⌘ ⏎` (Visual Studio (macOS)), `Ctrl+Enter` (ReSharper), `⌘ ⏎` (ReSharper (macOS)), `Ctrl+Enter` (QtCreator), `Ctrl+Enter` (QtCreator (macOS)), `Ctrl+Enter` (NetBeans), `Ctrl+Enter` (Eclipse), `⌘ ⏎` (Eclipse (macOS)) を押します。

中間ノードと構文の詳細については、 [データベース横断クエリ](cross-database-queries.html) トピックを参照してください。

![PostgreSQL と MySQL データソースのデータを結合するクロスデータベースクエリの例](https://resources.jetbrains.com/help/img/idea/2026.3/cross_database_query_join.png)

Procedure: クエリ実行設定を表示する

* Open a クエリコンソール and click ![データベース設定を開くアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.settings.svg)   クエリ実行設定を開く   on its toolbar.

## ステートメント実行のキャンセル

Procedure:

* 実行中のステートメントをキャンセルするには、ツールバーの ![実行中ステートメントのキャンセルアイコン。](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stop.svg)   実行中のステートメントをキャンセル   をクリックします。

または、ガターの進行状況インジケーターにマウスを移動し、進行状況アイコンを置き換える ![実行中ステートメントのキャンセルアイコン。](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stop.svg)   実行中のステートメントをキャンセル   をクリックします。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/db_cancel_running_statements.mp4)

> **Note:**
> データベース   ツールウィンドウのツールバーにある ![非アクティブ化アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.killDataSourceProcess.svg)   非アクティブにする   をクリックすると、CLion でのクエリは停止しますが、クエリはデータベース内で実行を継続します。

If you click the ![実行中ステートメントのキャンセルアイコン。](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stop.svg)   実行中のステートメントをキャンセル   button two times, CLion displays a warning where you can terminate the remote process or wait a bit longer. この警告は、同時に実行されている一部のプロセスに対して非アクティブ化を行うと危険になる可能性があるため、安全を確保するために表示されます。

また、IDE はキャンセル操作が 10 秒間アイドル状態になると警告を表示します。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/db_cancel_running_statements_warning.mp4)

## 接続をキャンセルする

リクエストの実行だけでなく、接続の作成も中断できます。 This is especially relevant for the very first query in the クエリコンソール, which also creates a connection.

接続を作成するプロセスを停止できます。 これを行うには、接続の作成中にツールバーの ![実行中ステートメントのキャンセルアイコン。](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stop.svg)   実行中のステートメントをキャンセル   をクリックします。 接続が停止され、   接続がキャンセルされました   メッセージが表示されます。

## 解決モード

SQL スクリプトを実行し、データベースオブジェクトの使用箇所をリンクとして扱い、正しいコード補完を提供するには、CLion がコード内のデータベースオブジェクトを特定のコンテキストに解決する必要があります。 デフォルトでは、IDE はデータベースオブジェクトの解決先の開始点として、次のいずれかを使用します: [&lt;スキーマ&gt;](null) セレクター、またはデフォルトデータベース (上記のいずれも設定されていない場合)。

コードが単一のスクリプトであるか、関連のない複数の SQL ステートメントを含むかに応じて、データベースオブジェクトを適切に解決するために次のいずれかの解決モードを選択します:

* プレイグラウンド : クエリコンソールs のデフォルトモード。 すべてのデータベースオブジェクトは同じコンテキストに解決されます。 コードが、単一のスクリプトとして実行されることを意図していない、互いに関連のない SQL ステートメントのセットである場合は、このモードを使用します。

* スクリプト : ローカル SQL ファイルのデフォルトモード。 `USE` SQL ステートメント（PostgreSQL の場合は `SET search_path TO` ）は、データベースオブジェクトが解決されるデフォルトのコンテキストをオーバーライドします。 コードを単一のスクリプトとして実行する場合は、このモードを使用します。 > **Note:** > デフォルトでは、<schema> セレクターはローカル SQL ファイルでは使用できません。 <schema> セレクターを表示するには、SQL ファイルにセッションをアタッチします。 これを行うには、 <セッション> ボタン ( `<セッション>` ) をクリックしてセッションを選択します。 または、 プロジェクト ツールウィンドウでファイルを右クリックし、 セッションの切り替え を選択します。

次のビデオでは、  `public`  スキーマが クエリコンソール のデフォルトとして選択されています。 スキーマには  `actor`  テーブルが含まれていますが、  `information_schema`  スキーマには含まれていません。 解決モードが   プレイグラウンド   の場合、すべてのステートメントは無関係であるとみなされ、データベースオブジェクトは両方の  `SELECT`  ステートメントでデフォルトのスキーマに解決されます。

解決モードが   スクリプト   に変更されると、2 番目の  `SELECT`  ステートメントは  `SET search_path TO information_schema`  ステートメントに関連しているとみなされます。  `actor`  テーブルはそのステートメントでは解決されなくなりました。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/resolve_modes_example.mp4)

## ユーザーパラメーター

データベースベンダーによっては、疑問符  `?`  は SQL ステートメントでパラメーターとして扱われます。 他の文字やそれらのシーケンスをパラメーターとしてどの場所で扱うかを、   ツール | データベース | クエリ実行 | ユーザーパラメーター   設定ページ `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)) で指定できます。

SQL パラメーターのパターンは、正規表現を使用して指定されます。

Procedure: パラメーター化されたステートメントを実行する

ステートメントにパラメーターがある場合、CLion はステートメントを実行する前にパラメーターの値を指定するよう求めます。

* パラメーター化されたステートメントを実行するには、ツールバーの ![実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg)   実行   をクリックし、二列目に値を入力します。 または、   パラメーター   ダイアログを開くには、 ![パラメーターの表示ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.viewParameters.svg)   パラメーターの表示   をクリックします。

![パラメーター化された文を実行する](https://resources.jetbrains.com/help/img/idea/2026.3/db_execute_parametrized_statement.png)

### 命名行動

CLion では、  位置指定 および  名前付き のユーザーパラメーターを使用できます。 位置指定ユーザーパラメーターの場合、各出現は順序に応じて個別に扱われます。 名前指定ユーザーパラメーターの場合、同じ名前の出現はすべて同じパラメーターとして扱われます。

名前付きパラメーターを使用するには、 `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)) を押して設定を開き、  `ツール | データベース | クエリ実行 | ユーザーパラメーター`  に移動します。   パラメーターパターン   ペインで、ユーザーパラメーターパターンに  `()`  を追加します。 IDE は  `()`  の内容をパラメーター名として扱い、スクリプト実行時に 1 つの値のみを要求します。 そうでない場合、スクリプト内で同じパラメーターが複数回使用されている場合、IDE はパラメーターの順序に応じて複数の値を要求します。

次の例を考えてみましょう。

```SQL
SELECT * FROM my_table WHERE a = ?x OR b = ?x;
```

* `\?\w+` : 位置指定ユーザーパラメーターパターン。 `?x` パラメーターは 2 つの異なるユーザーパラメーターとみなされます。 パラメーターの順序に応じて値が要求されます。 ![一般的なユーザーパラメーターを使用してステートメントを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/db_general_user_parameter.png)

* `\?(\w+)` : 名前付きユーザーパラメーターのパターン。 `?x` は両方とも同じユーザーパラメーターと見なされ、 `x` がパラメーターの名前です。 ![名前付きユーザーパラメーターを使用したステートメントの実行](https://resources.jetbrains.com/help/img/idea/2026.3/db_named_user_parameter.png)

パラメーターパターンの詳細については、 [ユーザーパラメーターのリファレンストピック](settings-tools-database-user-parameters.html#param_patterns)を参照してください。

### サンプル例

#### パラメーターとしての配列

In CLion, the replacement of a parameter with a value is straightforward. 配列を値として使用するには、対応するフィールドに配列を指定します。

次の例では、  `?`  パラメーターを  `206, 'John', 'Smith'`  値に置き換えることができます。

```SQL
INSERT INTO actor (actor_id, first_name, last_name, last_update)
VALUES (?, '01.02.2023 13:34');

```

![値の配列をパラメーターとして使用する](https://resources.jetbrains.com/help/img/idea/2026.3/db_array_as_a_parameter.png)

パラメーターの詳細については、データベースのドキュメントを参照してください。

#### パラメーターパターン

スクリプトに特定のパラメーター構文を持つパラメーターがある場合は、正規表現を使用してパターンを指定します。

次の例では、  `%{2}(\w+_\d+)`  パターンを   ツール | データベース | クエリ実行 | ユーザーパラメーター   設定ページ `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)) で設定する必要があります：

```SQL
SELECT title, description, release_year FROM actor
JOIN film_actor fa ON actor.actor_id = fa.actor_id
JOIN film f ON f.film_id = fa.film_id
WHERE last_name = '%%winnerpl_2';

```

![IDE 設定のパラメーターパターンの例ダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/user_parameters_pattern_example.png)

## テーブル構造のプレビュー

IDE コードエディターでは、   クイックドキュメント   機能を使用して、SQL ステートメント内のテーブルの構造をプレビューできます。

Procedure:

* SQL ステートメント内のテーブル構造をプレビューするには、テーブルを選択して `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `⌘ ⌃ ⇧ /` (Xcode), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (ReSharper), `⌃ Q` (ReSharper (macOS)), `Ctrl+Q` (QtCreator), `Ctrl+Q` (QtCreator (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS)) を押します。

表示される   クイックドキュメント   ポップアップには、テーブルに関するその他の情報とともに  `CREATE`  DDL スクリプトが含まれます。

この機能の詳細については、 [クイックドキュメント](viewing-inline-documentation.html)を参照してください。

![エディタータブでテーブル構造をプレビューする](https://resources.jetbrains.com/help/img/idea/2026.3/db_preview_table_structure_in_editor.png)

## 実行されたステートメントの履歴を表示する

Procedure: クエリ履歴を使用するダイアログ

CLion は、クエリコンソール で実行したすべてのステートメントの履歴を保存します。

* クエリ履歴   ダイアログを開くには、ツールバーの   クエリ履歴の閲覧   ボタン ( ![クエリ履歴の閲覧ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.vcs.history.svg)) をクリックするか、 `Ctrl+Alt+E` (Windows), `⌘ ⌥ E` (macOS), `⌘ ⌥ E` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ E` (macOS System Shortcuts), `Ctrl+Alt+E` (XWin), `Ctrl+Alt+E` (GNOME), `Ctrl+Alt+E` (KDE), `Ctrl+Alt+E` (Emacs), `Ctrl+Alt+E` (Sublime Text), `⌘ ⌥ E` (Sublime Text (macOS)), `⌘ ⌥ E` (Xcode), `Ctrl+Alt+E` (Visual Studio), `⌘ ⌥ E` (Visual Studio (macOS)), `Ctrl+Alt+E` (ReSharper), `⌘ ⌥ E` (ReSharper (macOS)), `Ctrl+Alt+E` (QtCreator), `⌘ ⌥ E` (QtCreator (macOS)), `Ctrl+Alt+E` (NetBeans), `Ctrl+Alt+E` (Eclipse), `⌘ ⌥ E` (Eclipse (macOS)) を押します。

クエリ履歴   ダイアログでは、次の操作を実行できます。

* 情報をフィルターするには、検索クエリを入力してください。

* To paste the query from the クエリ履歴 dialog to the クエリコンソール, double-click the query in the left pane of the クエリ履歴 dialog.

* 履歴からレコードを削除するには、レコードを選択して `Delete` (Windows), `⌦` (macOS), `⌦` (IntelliJ IDEA Classic (macOS)), `⌦` (macOS System Shortcuts), `Delete` (XWin), `Delete` (GNOME), `Delete` (KDE), `Delete` (Emacs), `Delete` (Sublime Text), `⌦` (Sublime Text (macOS)), `⌫` (Xcode), `Delete` (Visual Studio), `⌦` (Visual Studio (macOS)), `Delete` (ReSharper), `⌦` (ReSharper (macOS)), `Delete` (QtCreator), `⌦` (QtCreator (macOS)), `Delete` (NetBeans), `Delete` (Eclipse), `⌦` (Eclipse (macOS)) を押します。

![実行されたクエリの履歴を表示する](https://resources.jetbrains.com/help/img/idea/2026.3/db_show_history.png)

## 結果の表示

通常、クエリを実行すると、結果は表形式で返されます。 CLion は結果を  データエディター で表示します。 デフォルトでは、各ステートメントごとに、結果を含むデータエディターが   サービス   ツールウィンドウの個別のタブに表示されます。

クエリ結果の表示の詳細については、 [クエリ結果](viewing-query-results.html)を参照してください。

![サービスツールウィンドウのタブ内の SELECT ステートメントの結果](https://resources.jetbrains.com/help/img/idea/2026.3/db_open_new_tab_for_each_new_query.png)

## See also

### 関連

[クエリコンソール](query-consoles.html) [ユーザーファイル](working-with-user-files.html)

### リファレンス

[クエリコンソール](query-consoles.html#reference) [Data editor and viewer](data-editor-and-viewer.html#reference) [クエリ結果](viewing-query-results.html)

