llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

クエリを実行する

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

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

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。

  2. データベースツールおよび SQL プラグインを見つけて 有効化 をクリックします。

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

クエリ結果を表示する場所と方法の詳細については、 クエリ結果 を参照してください。

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

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

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

  2. クエリコンソール を開くには、 F4 を押してください。 クエリコンソールの操作方法について詳しくは、 クエリコンソール を参照してください。

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

  4. ツールバーの 実行ボタン実行 をクリックします。 あるいは、 Ctrl+Enter を押します。

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

クエリを実行する

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

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

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

    For more information about attaching directories and files in CLion, refer to ユーザーファイル.

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

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

  3. ツールバーの 実行ボタン実行 ボタンをクリックします。 あるいは、 Ctrl+Enter を押します。

    クエリ実行設定をカスタマイズするには、 カスタマイズ リンクをクリックします。 または、 Ctrl+Alt+S を押して設定を開き、 ツール | データベース | クエリ実行 に移動します。 .

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

    SQL ファイルをデータソースに添付する方法の詳細については、「データソースの添付 」を参照してください。

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

    スクリプトファイルを実行する別の例については、「youtube.com の次のビデオ(英語) 」を参照してください。

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

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

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

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

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

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

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

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

    接続セッションの詳細については、 セッション を参照してください。

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

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

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

    データのエクスポート​ ダイアログの詳細については、 データのエクスポートトピックを参照してください。

SELECT ステートメントの結果をファイルに保存する

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

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

  1. データベース ツールウィンドウのツールバーで、 追加アイコン追加 をクリックし、 ワークスペースのデータソースアイコンワークスペースのデータソース を選択します。

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

  2. クエリコンソール で、 SELECT ... FROM クエリを記述します。 Ctrl+Space コード補完を使用して、データソースとデータベースオブジェクトを選択します。

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

    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;

    特殊な構文の詳細については、 構文 を参照してください。

  3. ツールバーの 実行ボタン実行 をクリックします。 あるいは、 Ctrl+Enter を押します。

中間ノードと構文の詳細については、 データベース横断クエリ トピックを参照してください。

PostgreSQL と MySQL データソースのデータを結合するクロスデータベースクエリの例

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

  • Open a クエリコンソール and click データベース設定を開くアイコンクエリ実行設定を開く on its toolbar.

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

  • 実行中のステートメントをキャンセルするには、ツールバーの 実行中ステートメントのキャンセルアイコン。実行中のステートメントをキャンセル をクリックします。

    または、ガターの進行状況インジケーターにマウスを移動し、進行状況アイコンを置き換える 実行中ステートメントのキャンセルアイコン。実行中のステートメントをキャンセル をクリックします。

If you click the 実行中ステートメントのキャンセルアイコン。実行中のステートメントをキャンセル button two times, CLion displays a warning where you can terminate the remote process or wait a bit longer. この警告は、同時に実行されている一部のプロセスに対して非アクティブ化を行うと危険になる可能性があるため、安全を確保するために表示されます。

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

接続をキャンセルする

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

接続を作成するプロセスを停止できます。 これを行うには、接続の作成中にツールバーの 実行中ステートメントのキャンセルアイコン。実行中のステートメントをキャンセル をクリックします。 接続が停止され、 接続がキャンセルされました メッセージが表示されます。

解決モード

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

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

  • プレイグラウンド: クエリコンソールs のデフォルトモード。 すべてのデータベースオブジェクトは同じコンテキストに解決されます。

    コードが、単一のスクリプトとして実行されることを意図していない、互いに関連のない SQL ステートメントのセットである場合は、このモードを使用します。

  • スクリプト: ローカル SQL ファイルのデフォルトモード。 USE SQL ステートメント(PostgreSQL の場合は SET search_path TO )は、データベースオブジェクトが解決されるデフォルトのコンテキストをオーバーライドします。

    コードを単一のスクリプトとして実行する場合は、このモードを使用します。

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

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

ユーザーパラメーター

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

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

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

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

  • パラメーター化されたステートメントを実行するには、ツールバーの 実行ボタン実行 をクリックし、二列目に値を入力します。 または、 パラメーター ダイアログを開くには、 パラメーターの表示ボタンパラメーターの表示 をクリックします。

    パラメーター化された文を実行する

命名行動

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

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

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

SELECT * FROM my_table WHERE a = ?x OR b = ?x;
  • \?\w+: 位置指定ユーザーパラメーターパターン。 ?x パラメーターは 2 つの異なるユーザーパラメーターとみなされます。 パラメーターの順序に応じて値が要求されます。

    一般的なユーザーパラメーターを使用してステートメントを実行する
  • \?(\w+): 名前付きユーザーパラメーターのパターン。 ?x は両方とも同じユーザーパラメーターと見なされ、 x がパラメーターの名前です。

    名前付きユーザーパラメーターを使用したステートメントの実行

パラメーターパターンの詳細については、 ユーザーパラメーターのリファレンストピックを参照してください。

サンプル例

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

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

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

INSERT INTO actor (actor_id, first_name, last_name, last_update) VALUES (?, '01.02.2023 13:34');
値の配列をパラメーターとして使用する

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

パラメーターパターン

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

次の例では、 %{2}(\w+_\d+) パターンを ツール | データベース | クエリ実行 | ユーザーパラメーター 設定ページ Ctrl+Alt+S で設定する必要があります:

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 設定のパラメーターパターンの例ダイアログ

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

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

  • SQL ステートメント内のテーブル構造をプレビューするには、テーブルを選択して Ctrl+Q を押します。

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

この機能の詳細については、 クイックドキュメント を参照してください。

エディタータブでテーブル構造をプレビューする

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

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

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

  • クエリ履歴 ダイアログを開くには、ツールバーの クエリ履歴の閲覧 ボタン (クエリ履歴の閲覧ボタン) をクリックするか、 Ctrl+Alt+E を押します。

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

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

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

    • 履歴からレコードを削除するには、レコードを選択して Delete を押します。

    実行されたクエリの履歴を表示する

結果の表示

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

クエリ結果の表示の詳細については、 クエリ結果 を参照してください。

サービスツールウィンドウのタブ内の SELECT ステートメントの結果
2026 年 11 月 6 日