セッション

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

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

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

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

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

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

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

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

新規セッション

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

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

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

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

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

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

単一セッションで作業するには、次の手順で単一セッションモードを有効にしてください：

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

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

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

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

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

2026 年 6 月 1 日