クエリを実行する

Database Tools and SQL プラグインを有効化

この機能は、JetBrains Rider にデフォルトでバンドルされ有効化されている Database Tools and SQL プラグインに依存しています。関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

Ctrl+Alt+S を押して設定を開き、プラグインを選択します。
インストール済みタブを開き、 Database Tools and SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

クエリは、ショートカット、ツールバーボタン、コンテキストメニュー、実行／デバッグ構成を利用して実行できます。クエリコンソールs、スクラッチファイル、ユーザーファイルから実行できます。

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

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

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

コードを入力して実行するターミナルに関しては、クエリコンソールに関連付けることができます。

データベースツールウィンドウで、データソースをクリックします。
F4 を押してクエリコンソールを開きます。クエリコンソールの操作方法の詳細については、クエリコンソールを参照してください。
実行したいステートメントを入力するか貼り付けます。
ツールバーの実行(X) をクリックします。または、 Ctrl+Enter を押します。
複数のステートメントがある場合は、すべてのステートメントを実行するか、単一のステートメントを実行するかを選択します。候補リストには、常にすべてのステートメントを実行するための項目が含まれています。

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

JetBrains Rider では、ファイルを開いて実行できます。ファイルサイズの制限は 20 MB です。 20 MB を超えるファイルを開くと、ファイルの最初の 2.5 MB のみが表示されます。ファイルは SQL ファイルタイプに関連付けられている必要があります。ファイルタイプの関連付けの詳細については、ファイルタイプの関連付けトピックを参照してください。

エクスプローラーツールウィンドウ (表示(V) | ツールウィンドウ | エクスプローラー) を開き、SQL ファイルをダブルクリックします。
JetBrains Rider でのディレクトリとファイルのアタッチの詳細については、ユーザーファイルを参照してください。
実行したいステートメントをクリックします。
また、実行するコードのフラグメントを選択（ハイライト）できます。サブクエリまたはステートメントのグループにすることができます。 JetBrains Rider は選択のみを実行します。
ツールバーの実行(X) ボタン（）をクリックします。または、 Ctrl+Enter を押します。
クエリ実行設定をカスタマイズするには、カスタマイズリンクをクリックしてください。または、 Ctrl+Alt+S を押して設定を開き、 %database_path% クエリ実行に移動します。。
(オプション) SQL ファイルがデータソースにアタッチされていない場合は、 <データソース> リストでアタッチするデータソースを選択します。
SQL ファイルをデータソースに添付する方法の詳細については、データソースの添付を参照してください。
ステートメントウィンドウで、 Enter を押して、選択したステートメントを実行します。他のエントリを切り替えて、別のステートメントのセットを実行できます。実行しようとしているステートメントは、クエリエディターでハイライトされます。
ステートメントウィンドウで、カスタマイズをクリックして、チューザーを表示するか、常にキャレットでステートメントを実行するかを定義できます。
スクリプトファイルを実行する別の例については、「youtube.com の次のビデオ(英語) 」を参照してください。

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

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

実行するストアド関数を右クリックし、関数の実行を選択します。
ルーチンの実行ウィンドウで、必要なすべてのパラメーター値を入力し、 OK をクリックします。
必要に応じて、実行元チェックボックスを選択し、保存された関数を実行するファイルまたはコンソールを選択します。

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

(オプション) ファイルがデータソースに接続されていない場合は、ツールバーのデータソースのリストからデータソースを選択します。次に、セッションリストから接続セッションを選択します。
接続セッションの詳細については、セッションを参照してください。
SELECT ステートメントを右クリックします。
ファイルへ実行を選択して、出力フォーマットを選択してください。
データのエクスポートダイアログで、使用するエクストラクターとその他の設定を指定します。
データのエクスポートダイアログの詳細については、データのエクスポートトピックを参照してください。

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

クエリコンソールを開き、ツールバーのクエリ実行設定を開くをクリックします。

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

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

実行中ステートメントのキャンセルボタンを 2 回クリックすると、JetBrains Rider はリモートプロセスを終了するか、少し待つかを選べる警告を表示します。この警告は、同時に実行されている一部のプロセスに対して非アクティブ化を行うと危険になる可能性があるため、安全を確保するために表示されます。

また、IDE はアイドルキャンセルの 10 秒後に警告を表示します。

接続をキャンセルする

リクエストの実行だけでなく、接続の作成も中断できます。これは、クエリコンソールで最初のクエリ（接続も作成されます）の場合に特に重要です。

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

解決モード

SQL スクリプトを実行し、データベースオブジェクトの使用をリンクとして扱い、正しいコード補完を提供するには、JetBrains Rider がコード内のデータベースオブジェクトをあるコンテキストに解決する必要があります。デフォルトでは、IDE はデータベースオブジェクトの解決開始点として次のいずれかを使用します： <schema> セレクター、またはデフォルトデータベース（どちらも設定されていない場合）。

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

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

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

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

ユーザーパラメーター

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

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

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

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

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

命名行動

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

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

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

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

\?\w+: 位置指定ユーザーパラメーターパターン。 ?x パラメーターは 2 つの異なるユーザーパラメーターとみなされます。パラメーターの順序に応じて値が要求されます。
\?(\w+) ：名前指定ユーザーパラメーターパターン。 ?x は両方とも同じユーザーパラメーターと見なされ、 x がパラメーターの名前です。

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

サンプル

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

JetBrains Rider では、パラメーターを値に置き換えるのは簡単です。配列を値として使用するには、対応するフィールドに配列を指定します。

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

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

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

パラメーターパターン

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

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

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

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

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

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

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

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

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

クエリ履歴ダイアログを開くには、ツールバーのクエリ履歴の参照ボタン () をクリックするか、 Ctrl+Alt+E を押します。
クエリ履歴ダイアログでは、次の操作を実行できます。
- 情報をフィルターするには、検索クエリを入力してください。
- クエリ履歴ダイアログからクエリコンソールにクエリを貼り付けるには、クエリ履歴ダイアログの左ペインでクエリをダブルクリックしてください。
- 履歴からレコードを削除するには、レコードを選択して Delete を押します。

結果の表示

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

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

2026 年 6 月 12 日