セッション
データベースツールおよび SQL プラグインを有効にする
この機能は PyCharm にデフォルトでバンドルされ有効になっている データベースツールおよび SQL プラグインに依存しています。 関連機能が利用できない場合は、プラグインが無効になっていないことを確認してください。
Ctrl+Alt+S を押して設定を開き、 を選択します。
インストール済み タブを開き、 データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。
PyCharm では、データベースへの接続は特別なラッパー、 セッションで確立されます。 各セッションは単一接続のラッパーであり、接続情報（例：アクティブ状態、トランザクション制御モード、その他の設定）を保存します。
セッション内では、必要に応じて定義された 設定に従って接続を開いたり閉じたりできます。
セッションには クライアント （セッションが保持する接続を使用してクエリが送信されるファイル）が存在する場合があります。 データエディターはセッションのクライアントになることもできます。
サービス ツールウィンドウでは、データソース、セッション、セッションクライアントを表示できます。 セッションアイコンの隅にある緑色の点は、接続されたセッションを示します。
上の図では、 サービス ツールウィンドウに次のノードが表示されています。
データソース。
切断されたセッション。
接続されたセッション。
セッションクライアント。
セッション管理オプションとツールバーコントロールの詳細については、 サービスツールウィンドウトピックを参照してください。
PyCharm を閉じて再度開くと、すべてのセッションが サービス ツールウィンドウで利用可能になりますが、空になります。
新規セッション
新しいセッションを作成する方法に応じて、自動的に接続されるか、特定のアクションの後に接続されます。 セッションのアイコンの隅にある緑色の点は、接続ステータスを示します。
次のいずれかを実行して、新しいセッションを作成できます：
クエリコンソール を開き、データエディターでデータベースオブジェクトのデータを閲覧する、または SQL ファイルをデータソースに添付します。
その結果、 サービス ツールウィンドウのデータソースノードに、新しいセッションノードがその下にクライアントノードとともに表示されます。
クエリコンソール の場合、データベース操作が必要なアクションを実行すると、セッションが接続されます。 例: クエリを実行すると。
テーブルの場合、PyCharm でデータベースからテーブルデータを要求し、受信し、データエディターで表示するためにはアクティブな接続が必要なので、セッションは自動的に接続されます。
SQL ファイルの場合、セッションは自動的に接続されます。 データソースデータベースまたはスキーマのいずれかに対してクエリを実行するには、 <schema>； リストで選択して、ファイルを添付する必要があります。
データベースとの対話を必要とするアクションを実行します。 例: 実行構成を使用して ストアドプロシージャを実行したり 、スクリプトを実行したりします。
その結果、新しく接続されたセッションノードが サービス ツールウィンドウのデータソースノードに表示されます。
セッションの管理
PyCharm はクライアント接続をセッション間で分散する 3 種類のモードを提供しています： 1 つの共有セッション、 2 つのセッション: 共有とイントロスペクション 、および 専用セッション。
単一のセッションが、イントロスペクションを含む複数のクライアント間で共有されます。 共有セッションは
デフォルトです。例えば、新しいクエリごとに MFA 承認が必要な場合はこのモードを使用します。
IDE は 2 つのセッションを使用します。1 つはイントロスペクション用、もう 1 つは他のすべてのクライアントで共有される
デフォルトセッションです。1 つの共有セッション モードを使いながら、イントロスペクションを別のセッションで維持したい場合はこのモードに切り替えてください。 この方法で、イントロスペクションに時間がかかっても他のクライアントをブロックしません。
データベースイントロスペクションセッションは、データソースノードの下にある サービス ツールウィンドウで
introspectionと表示されます。
introspectionセッションの表示を有効化するには、 Ctrl+Alt+S を押して IDE 設定を開き、 に移動し、 サービスツールウィンドウに内部セッションを表示する を選択します。- 専用セッション
新しいクライアントごとに個別のセッションが作成されます。
データベースイントロスペクションセッションは、データソースノードの下にある サービス ツールウィンドウで
1と表示されます。
1セッションの表示を有効化するには、 Ctrl+Alt+S を押して IDE 設定を開き、 に移動し、 サービスツールウィンドウに内部セッションを表示する を選択します。
セッションモードを変更する
クライアントがセッションをどのように使うかを制御するには、次の操作を行います：
データソースおよびドライバー ダイアログ (Shift+Enter) を開き、データソースを選択します。
ダイアログの右側のペインで、 オプション タブを開きます。
接続 設定セクションで、 セッションコントロール ドロップダウンからモードを選択します。
変更を適用するには、 OK をクリックします。
(オプション) 変更を適用 ダイアログが表示されたら、続行する方法を選択します。
いいえ: 接続されたセッションはそのまま残ります。
はい: 接続されているすべてのセッションを切断します。
セッションの切り替え
クエリや SQL ファイルを別のセッションで実行する必要がある場合は、セッションを別のものに切り替えることができます。
セッションを切り替えるには、 サービス ツールウィンドウで、セッションを切り替えるファイルを右クリックし、 セッションの切り替え作業を行う をクリックして、ファイルをアタッチするセッションを選択します。
コンテキストメニューを使用して、セッションの操作に関する基本的なアクション、すなわちトランザクションモードの変更、セッションで実行中のステートメントのキャンセル、クライアントのセッションまたはデータソースの切り替えを実行できます。 また、 セッションを別のタブに移動することも サービス ツールウィンドウで可能です。
- Tx モード
トランザクションモードを設定します。
- セッションの切り替え作業を行う
クライアントを他のセッションに割り当てます。
- データソースの切り替え
クライアントを他のデータソースに割り当てます。
- 新規タブで開く
セッションまたはデータソースを別のタブに移動します。
- 削除
セッションを削除します。
- ソースに移動
セッションのクライアントにフォーカスを移動します。
セッションを別のタブに移動する
セッションを右クリックし、 新規タブで開く を選択します。
すべてのセッション
別タブ
サービスツールウィンドウのリファレンス
ツールウィンドウのコントロールとタブの詳細については、 「サービスツールウィンドウ」のトピックを参照してください。
