PyCharm 2026.1 Help

クエリファイル

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

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

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

  2. インストール済み タブを開き、 データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

概要

クエリファイルsは、IDE のデータソース用に作成し、IDE プロジェクトに保存できる SQL ファイルと JS ファイルです。 クエリファイル s では、SQL ステートメントを記述、実行、保存できます。 クエリファイル を 現在のプロジェクトディレクトリに保存するように選択した場合、そのファイルはプロジェクトコンテキストに含まれます。 また、たとえばタスクで一般的な SQL ステートメントの保存場所としてファイルが必要な場合など、クエリファイルを任意のデータソースから切り離すこともできます。

クエリファイル

クエリファイル s 内のクエリ結果の操作について詳しくは、 クエリ結果 を参照してください。

ツールバーのデータソースドロップダウンで、 クエリファイル を別のデータソースに関連付けることができます。

ロケーション

クエリファイル を 作成するときにロケーションを指定できます。 クエリファイル が 現在のプロジェクトディレクトリまたはプロジェクトにアタッチされたディレクトリに保存されている場合は、 Project ツールウィンドウ(Alt+1 )で確認できます。

ツールウィンドウでクエリファイル

新しい クエリファイル を別の場所に保存するには、クエリファイル を作成する際にディレクトリを指定します。 既存の クエリファイル を別のディレクトリに移動することもできます。

コードエディター

コードエディターは、 解決モードやコーディング支援機能を活用して SQL ステートメントを作成し、関連するデータソースに対して実行する場所です。

コードエディターコントロールでコードエディターのツールバーコントロールを見つけます。 エディターの基本でエディターの詳細を参照してください。

SQL ステートメントの実行

ステートメントを実行すると、 サービス ツールウィンドウが開きます。 サービス ツールウィンドウには、利用可能な接続セッション、 出力 タブ、 結果 タブが表示されます。 ツールウィンドウの詳細については、 サービスツールウィンドウ トピックを参照してください。

  • 実行されたステートメントがデータ (SELECT など) を取得する場合、結果は修飾されたテーブル名のタイトルを持つ 結果 タブに表示されます。 結果タブのカスタムタイトルの作成の詳細については、「結果のあるタブにカスタムタイトルを使用する 」を参照してください。

  • 実行されたステートメントがデータを取得しない場合、結果が「出力 」タブに表示されます。

    サービスツールウィンドウのアクティブな結果タブを備えたクエリコンソール
    1. コードエディターのツールバー

    2. サービス ツールウィンドウ。

    3. 出力および 結果タブ。 結果 タブがアクティブです。

    4. 結果タブのツールバー

    サービスツールウィンドウのアクティブな出力タブを備えたクエリコンソール
    1. コードエディターのツールバー

    2. サービス ツールウィンドウ。

    3. 出力および 結果タブ。 出力 タブがアクティブです。

    4. 出力タブの右側のツールバー

クエリファイルを作成する

クエリファイル を作成するには、 データベース ツールウィンドウで次のいずれかのアクションを使用します。

  • データソースを選択し、メインメニューから File | New | クエリファイル を選択してください。

  • データソースを右クリックし、 New | クエリファイル を選択します。

  • データソースを選択し、 Alt+Insert を押して、 クエリファイル を選択します。

クエリファイルを開く

  • Project ツールウィンドウ(Alt+1 )で、開きたい クエリファイル に移動し、ダブルクリックします。

  • データベース ツールウィンドウでデータソースノードを展開し、次に クエリファイル フォルダーを展開して開きたい クエリファイル をダブルクリックします。

クエリコンソールを開く

クエリファイルの名前を変更する

クエリファイル の名前を変更するには、次のいずれかを実行します:

  • クエリファイル タブを右クリックして、 Rename File を選択します。

  • Project ツールウィンドウ(Alt+1 )で:

    1. ファイルの場所へ移動してください。 デフォルトでは、ファイルツリーの最上位にあります。

    2. ファイルを右クリックして、 名前を変更 (Shift+F6) を選択します。

  • データベース ツールウィンドウで:

    1. データソースノードと クエリファイル フォルダーを展開します。

    2. クエリファイル を右クリックして、 名前を変更Shift+F6 )を選択します。

クエリファイルの名前を変更する

クエリファイルを削除する

  1. Project ツールウィンドウ(Alt+1 )で:

    1. 削除したい クエリファイル に移動します。

    2. クエリファイル を右クリックして、 削除 を選択します。 または、 Delete を押します。

  2. データベース ツールウィンドウで:

    1. データソースノードを展開し、次に クエリファイル フォルダーを展開します。

    2. クエリファイル を右クリックして、 削除Delete )を選択します。

クエリコンソールの名前を変更する

クエリファイルにデータソースを添付する

クエリファイル にデータソースを添付するには、次の手順を実行します:

  • コードエディターで:

    1. クエリファイル のツールバーでデータソースドロップダウンをクリックします。

    2. すべて サブメニューに移動し、クエリファイル を関連付けるデータソースを選択します。

  • データベース ツールウィンドウで:

    1. クエリファイル に移動して選択してください。

    2. クエリファイル を右クリックして、 データソースのアタッチ を選択します。

    3. クエリファイル を関連付けるデータソースを選択してください。

PyCharm は選択したデータソースと クエリファイル を自動的に関連付けます。 関連付け後、クエリファイル の名前はそのままで、データソースが Project ツールウィンドウ内で クエリファイル 名の近くに表示されます。

クエリファイル参照

クエリファイル のコンテキストメニューやツールバーボタンについては、 コードエディターのヒントとリファレンス トピックを参照してください。

コードエディターについて詳しくは、 エディターの基本 を参照してください。

2026 年 6 月 1 日