セッション

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

PhpStorm では、データベースへの接続は特別なラッパーであるセッションで確立されます。各セッションは単一接続のラッパーであり、接続の情報（アクティブかどうか、トランザクション制御モード、その他の設定など）を保存します。

セッション内では、必要に応じて定義された設定に従って接続を開いたり閉じたりできます。

セッションにはクライアント（セッションが保持する接続を使用してクエリが送信されるファイル）が存在する場合があります。データエディターはセッションのクライアントになることもできます。

サービスツールウィンドウでは、データソース、セッション、セッションクライアントを表示できます。セッションアイコンの隅にある緑色の点は、接続されたセッションを示します。

上の図では、サービスツールウィンドウに次のノードが表示されています。

セッション管理オプションとツールバーコントロールの詳細については、サービスツールウィンドウトピックを参照してください。

PhpStorm を閉じて再度開くと、すべてのセッションがサービスツールウィンドウで利用可能になりますが、空になります。

新規セッション

新しいセッションを作成する方法に応じて、自動的に接続されるか、特定のアクションの後に接続されます。セッションのアイコンの隅にある緑色の点は、接続ステータスを示します。

次のいずれかを実行して新しいセッションを作成できます：

クエリコンソールを開いてデータエディターでデータベースオブジェクトのデータを表示するか、SQL ファイルをデータソースに添付します。
その結果、サービスツールウィンドウのデータソースノードに、新しいセッションノードがその下にクライアントノードとともに表示されます。
1. クエリコンソールの場合、データベースと対話するアクションを実行すると、セッションが接続されます。例: クエリを実行すると。
2. テーブルの場合、PhpStorm ではデータベースからテーブルデータを要求し、受信してデータエディターで表示するため、セッションは自動的に接続されます。
3. SQL ファイルの場合、セッションは自動的に接続されます。データソースデータベースまたはスキーマのいずれかに対してクエリを実行するには、 <スキーマ> リストで選択して、ファイルを添付する必要があります。
データベースとの対話を必要とするアクションを実行します。例: 実行構成を使用してストアドプロシージャを実行したり、スクリプトを実行したりします。
その結果、新しく接続されたセッションノードがサービスツールウィンドウのデータソースノードに表示されます。

クエリや SQL ファイルを別のセッションで実行する必要がある場合、セッションを別のものへ切り替えることができます。

セッションを切り替えるには、サービスツールウィンドウで、セッションを切り替えるファイルを右クリックし、セッションの切り替えをクリックして、ファイルをアタッチするセッションを選択します。

複数の SQL ファイルからクエリを実行し、単一のセッションで複数のデータベースオブジェクトデータを受け取ることができます。例: 新しいクエリごとに MFA 承認が必要な場合。

単一セッションで作業するには、次の操作を行って単一セッションモードを有効化します：

データソースおよびドライバーダイアログ (Shift+Enter) を開き、データソースを選択します。
ダイアログの右側のペインで、オプションタブを開きます。
接続設定セクションで、単一セッションモードチェックボックスを選択します。
変更を適用するには、 OK をクリックします。
(オプション) 変更の適用ダイアログが表示されたら、続行する方法を選択します。
- ノー: 接続されたセッションはそのまま残ります。
- はい: 接続されているすべてのセッションを切断します。
クエリを実行します。

すべての新しいクエリはデフォルトのセッションで実行されます。

次の表には、セッションで作業するために使用できるその他の基本的なアクションが含まれています。

アクション	説明
セッションの名前を変更する	サービスツールウィンドウで、セッションを右クリックしてセッション名の変更を選択します。
セッションまたはデータソースを別のタブに移動する	サービスツールウィンドウで、セッションまたはデータソースを右クリックして新規タブで開くを選択します。この操作を元に戻すには、区切られたタブを閉じます。
セッションを閉じる	サービスツールウィンドウで、セッションを右クリックしてセッションを閉じるを選択します。セッションはセッションクライアントから切り離され、リストからも消えます。
すべてのセッションを閉じます	サービスツールウィンドウで、データソースを右クリックしてすべてのセッションを閉じるを選択します。

ツールウィンドウのコントロールとタブの詳細については、「サービスツールウィンドウ」のトピックを参照してください。

2026 年 5 月 22 日