PyCharm 2024.3 ヘルプ

セッション

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

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

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

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

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

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

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

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

The Services tool window

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

  1. データソース。

  2. 切断されたセッション。

  3. 接続されたセッション。

  4. セッションクライアント。

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

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

新規セッション

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

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

  • クエリコンソールを開き、データエディターでデータベースオブジェクトのデータを表示するか、SQL ファイルをデータソースに添付します。

    その結果、サービスツールウィンドウのデータソースノードに、新しいセッションノードがその下にクライアントノードとともに表示されます。

    1. クエリコンソールの場合、データベースとの対話を必要とするアクションを実行すると、セッションが接続されます。例: クエリを実行すると。

    2. テーブルの場合、PyCharm ではデータベースからテーブルデータを要求し、それを受信し、データエディターで表示するにはアクティブな接続が必要であるため、セッションは自動的に接続されます。

    3. SQL ファイルの場合、セッションは自動的に接続されます。データソースデータベースまたはスキーマのいずれかに対してクエリを実行するには、<スキーマ> リストで選択して、ファイルを添付する必要があります。

  • データベースとの対話を必要とするアクションを実行します。例: 実行構成を使用してストアドプロシージャを実行したり、スクリプトを実行したりします。

    その結果、新しく接続されたセッションノードがサービスツールウィンドウのデータソースノードに表示されます。

セッションの管理

セッションの切り替え

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

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

Switch sessions for an SQL file in the Services tool window

1 回のセッションで作業する

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

単一セッションで作業するには、次の手順を実行して単一セッションモードを有効にします。

  1. データソースおよびドライバーダイアログ (Shift+Enter) を開き、データソースを選択します。

  2. ダイアログの右側のペインで、オプションタブを開きます。

  3. 接続設定セクションで、単一セッションモードチェックボックスを選択します。

  4. 変更を適用するには、OK をクリックします。

  5. (オプション) 変更の適用ダイアログが表示されたら、続行する方法を選択します。

    the Apply Changes dialog
    • いいえ : 接続されたセッションはそのまま残ります。

    • はい : 接続されているすべてのセッションを切断します。

  6. クエリを実行します。

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

Queries from multiple SQL files run in a sigle session

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

アクション

説明

セッションの名前を変更する

サービスツールウィンドウで、セッションを右クリックしてセッション名の変更を選択します。

Rename a connection session

セッションまたはデータソースを別のタブに移動する

サービスツールウィンドウで、セッションまたはデータソースを右クリックして新規タブで開くを選択します。この操作を元に戻すには、区切られたタブを閉じます。

Move a session or a data source to a separate tab

セッションを閉じる

サービスツールウィンドウで、セッションを右クリックしてセッションを閉じるを選択します。

セッションはセッションクライアントから切り離され、リストからも消えます。

すべてのセッションを閉じます

サービスツールウィンドウで、データソースを右クリックしてすべてのセッションを閉じるを選択します。

Close all connection sessions

サービスツールウィンドウのリファレンス

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

Database services in the Services tool window

関連ページ:

接続の構成

データベースツールと SQL プラグインを有効にするこの機能は、PyCharm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。データソースを作成すると、PyCharm は自動的にデータベースに...

データエディターとビューアー

データベースツールと SQL プラグインを有効にするこの機能は、PyCharm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。概要:データエディターとビューアー、またはデータエディターは、デ...

サービスツールウィンドウ

サービスツールウィンドウを使用すると、実行 / デバッグ構成、データベースセッション、Docker 接続など、ソフトウェア開発中に役立つさまざまなサービスを管理できます。プラグイン開発者は、IntelliJ プラットフォーム API を通じて他のサービスを追加できます。メインツールバーには、すべてのサービスタイプに共通の次のボタンとメニューが含まれています。すべて展開リスト内のすべての項目を展開します。すべて折りたたむリスト内のすべての項目を折りたたみます。グループ化サービスのリストを整理する方...

クエリコンソール

データベースツールと SQL プラグインを有効にするこの機能は、PyCharm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。概要:クエリまたはデータベースコンソールは、データソースにアタッ...

クエリを実行する

データベースツールと SQL プラグインを有効にするこの機能は、PyCharm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。ショートカット、ツールバーボタンとアイコン、コンテキストメニュー、...

実行 / デバッグ構成

PyCharm は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。さまざまな起動プロパティを使用して、PyCharm がスクリプトを実行するために使用するさまざまな方法を定義できます。例: 異なる Python インタープリターを使用して同じコードを実行し、さまざまな環境変数のセットを提供し、代替ファイルから入力値を取得できます。実行 / デバッグ構成には...