クエリファイル
Database Tools and SQL プラグインの有効化
この機能は、PhpStorm にデフォルトでバンドルされ有効になっている Database Tools and SQL プラグインに依存しています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。
Ctrl+Alt+S を押して設定を開き、 を選択します。
Database Tools and SQL プラグインを見つけて、 許可 をクリックします。
概要
クエリファイルは、IDE でデータソース用に作成し、IDE プロジェクトに保存できる SQL ファイルと JS ファイルです。 クエリファイルでは、SQL ステートメントを記述、実行、保存できます。 クエリファイルを 現在のプロジェクトディレクトリに保存するように選択した場合、そのファイルはプロジェクトコンテキストに含まれます。 また、たとえばタスクで一般的な SQL ステートメントの保存場所としてファイルが必要な場合など、クエリファイルを任意のデータソースから切り離すこともできます。
クエリファイル内のクエリ結果の操作の詳細については、 照会結果 を参照してください。
ツールバーのデータソースのドロップダウンメニューを使用して、 クエリファイルを別のデータソースに関連付けることができます。
ロケーション
クエリファイルを 作成する際に、その場所を指定できます。 クエリファイルが 現在のプロジェクトディレクトリまたはプロジェクトにアタッチされたディレクトリに保存されている場合は、 Project ツールウィンドウ (Alt+1) で確認できます。
新しいクエリファイルを別の場所に保存するには、クエリファイルを作成する際にディレクトリを指定します。 既存のクエリファイルを別のディレクトリに移動することもできます。
コードエディター
コードエディターは、 解決モードとコーディング支援機能を使用して SQL ステートメントを作成し、関連するデータソースに対して実行する場所です。
コードエディターコントロールでコードエディターのツールバーコントロールを見つけます。 詳細については、 エディターの基本を参照してください。
SQL ステートメントの実行
ステートメントを実行すると、 サービス ツールウィンドウが開きます。 サービス ツールウィンドウには、利用可能な接続セッション、 出力 タブ、 結果 タブが表示されます。 ツールウィンドウの詳細については、 サービスツールウィンドウ トピックを参照してください。
実行されたステートメントがデータ (
SELECTなど) を取得する場合、結果は修飾されたテーブル名のタイトルを持つ 結果 タブに表示されます。 結果タブのカスタムタイトルの作成の詳細については、「結果のあるタブにカスタムタイトルを使用する 」を参照してください。実行されたステートメントがデータを取得しない場合、結果が「出力 」タブに表示されます。
コードエディターのツールバー。
。
サービス ツールウィンドウ。
コードエディターのツールバー。
。
サービス ツールウィンドウ。
クエリファイルを作成する
クエリファイルを作成するには、 データベース ツールウィンドウで次のいずれかのアクションを使用します。
データソースを選択し、メインメニューから を選択してください。
データソースを右クリックし、 を選択します。
データソースを選択し、 Alt+Insert を押して、 クエリファイル を選択します。
クエリファイルを開く
Project ツールウィンドウ（Alt+1 ）で、開きたいクエリファイルに移動し、ダブルクリックします。
データベース ツールウィンドウで、データソースノードを展開し、次に クエリファイル フォルダーを展開して、開きたいクエリファイルをダブルクリックします。
クエリファイルの名前を変更する
クエリファイルの名前を変更するには、次のいずれかを実行します。
クエリファイルタブを右クリックし、 ファイル名の変更 を選択します。
Project ツールウィンドウ（Alt+1 ）で:
ファイルの場所へ移動してください。 デフォルトでは、ファイルツリーの最上位にあります。
ファイルを右クリックして、 名前変更 (Shift+F6) を選択します。
データベース ツールウィンドウで:
データソースノードを展開し、次に クエリファイル フォルダーを展開します。
クエリファイルを右クリックして、 名前変更 (Shift+F6) を選択します。
クエリファイルを削除する
Project ツールウィンドウ（Alt+1 ）で:
削除したいクエリファイルに移動します。
クエリファイルを右クリックして、 削除 を選択します。 または、 Delete を押します。
データベース ツールウィンドウで:
データソースノードを展開し、次に クエリファイル フォルダーを展開します。
クエリファイルを右クリックして、 削除 (Delete) を選択します。
クエリファイルにデータソースを添付する
クエリファイルにデータソースを添付するには、次の手順を実行します。
コードエディターで:
クエリファイルのツールバーで、データソースドロップダウンをクリックします。
すべて サブメニューに移動し、クエリファイルを関連付けるデータソースを選択します。
データベース ツールウィンドウで:
クエリファイルに移動して選択してください。
クエリファイルを右クリックして、 データソースのアタッチ を選択します。
クエリファイルを関連付けるデータソースを選択してください。
PhpStorm は、クエリファイルと選択したデータソースを自動的に関連付けます。 関連付け後、クエリファイル名は変更されず、 Project ツールウィンドウに表示されるデータソースはクエリファイル名と同じになります。
クエリファイル参照
クエリファイルのコンテキストメニューとツールバーボタンに関する情報は、 コードエディターのヒントとリファレンス トピックを参照してください。
エディターの基本のコードエディターについて詳しくはこちらを参照してください。