PyCharm 2026.3 Help

接続の構成

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

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

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

  2. データベースツールおよび SQL プラグインを見つけて、 有効化 をクリックします。噛み砕いて教えて。

データソースを作成すると、PyCharm は自動的にデータベースへ接続し、デフォルトまたは選択したスキーマを 調査します。

接続オプション

接続のタイムゾーンを設定する

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. 変更するデータソースを選択して オプション タブをクリックします。

  3. タイムゾーン フィールドに使用するタイムゾーンの入力を開始します。

  4. 設定を適用して OK をクリックします。

    タイムゾーンフィールドでタイムゾーンを選択する

接続を維持する

指定した期間の経過後にキープアライブクエリを実行することで、データベースへの接続を維持することができます。 サポートされていないデータベースのドライバ設定でカスタムクエリを定義できます。

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. データソース タブで、変更するデータソースを選択します。

  3. オプション タブで、 キープアライブクエリの実行間隔 チェックボックスを選択し、PyCharm が再度キープアライブクエリを実行するまでの秒数を入力します。

指定された期間内にデータベースから切断する

PyCharm が接続を終了するまでの期間を秒数で指定できます。

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. データソース タブで、変更するデータソースを選択します。

  3. オプション タブで、 自動切断するまでの時間 チェックボックスを選択し、PyCharm が接続を終了するまでの秒数を入力してください。

接続を確立するときに実行する事前定義クエリを設定する

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. データソース タブで、変更するデータソースを選択します。

  3. オプション タブの スタートアップスクリプト フィールドで、データベースへの接続で実行する予定のクエリを指定します。

    接続を確立するときに事前定義されたクエリを実行する

データベースの状態をリフレッシュする

誰かがリモートデータベースのデータまたはビューを変更した場合、データベースのローカルビューは実際の状態とは異なる可能性があります。

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. データソース タブで、変更するデータソースを選択します。

  3. オプション タブで、 自動同期 チェックボックスを選択します。

    自動同期 チェックボックスがオフの場合、ツールバーの 再読み込み アイコン (リフレッシュボタン) をクリックするか、 Ctrl+F5 を押した場合にのみ、 データベース ツールウィンドウ内のデータソースのビューがデータベースの実際の状態と同期されます。

    データベースの状態をリフレッシュする

オブジェクトフィルターでオブジェクトをフィルター処理する

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. データソース タブで、変更するデータソースを選択します。

  3. スキーマ タブで、 オブジェクトフィルター フィールドにフィルタリングオプションを入力します。

    オブジェクトフィルター フィールドの式を作成するときは、次のパターンを使用してください。

    <type>:[-]<pattern> 、ここ

    • <type> は、集計、照合、イベント、fdw、ftable、mview、演算子、パッケージ、ロール、ルーチン、シーケンス、シノニム、表、ユーザー、ビュー、vtable のいずれかです。

    • <pattern> は正規表現です。 項目を除外するには、先頭に - (マイナス) を付けます。 正規表現の詳細については、JavaTM 2 Platform Standard Edition 5.0 API 仕様の クラスパターン(英語)を参照してください。

    データソースオプションのオブジェクトフィルターフィールド

データベースとスキーマをフィルタリングする

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. データソース タブで、変更するデータソースを選択します。

  3. スキーマ タブで、 スキーマパターン フィールドにフィルタリングオプションを入力します。

    • @: 現在のデータベースまたはスキーマ

    • * :すべてのデータベースまたはスキーマ。 *: の後にスキーマを一覧表示できます。

    次の例を参照してください:

    • *:*: すべてのデータベース内のすべてのスキーマ

    • @:*: 現在のデータベースからのすべてのスキーマ

    • @:@: 現在のスキーマのみ

    • *:dbo|@:@|db1:s1,s2,s3: すべてのデータベースの dbo スキーマ、現在のスキーマ、 db1 データベースのスキーマ s1,s2,s3

接続モード

接続の読み取り専用モードを有効にする

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. データソース タブで、変更するデータソースを選択します。

  3. オプション タブで、 読み取り専用 チェックボックスを選択します。

    接続の読み取り専用モードを有効にする

単一データベースモード

データソースに接続すると、PyCharm はそのデータソースが持つすべてのデータベースを取得して表示できます。 ただし、場合によっては(たとえば、PgBouncer の特定の設定を使用して)、特定のデータベースでのみ操作できるか、許可されています。 単一データベースモード が有効になっていると、データベースツリービューには接続設定で指定したデータベースのみが表示され、データソースから取得されたすべてのデータベースは表示されません。

PostgreSQL、Azure SQL Database、Greenplum​、Amazon Redshift​ の場合は、この設定の使用を検討してください。

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. データソース タブで、変更するデータソースを選択します。

  3. オプション タブで、 単一データベースモード を選択します。

  4. 適用 をクリックしてください。

    シングルデータベースモードを有効にする

トランザクション制御

PyCharm では、トランザクションをデータベースへコミットする方法のいずれかを利用でき、またトランザクションの分離レベルも選択できます。

トランザクションモード

コミットによってトランザクションが終了し、他のユーザーがすべての変更を利用できるようになります。 PyCharm では、トランザクションをコミットする方法を自動と手動から選択できます。

変更がデータベースにコミットされる方法

データエディターは、行ったすべての変更を蓄積します。 送信ボタンサブミット をクリックすると、PyCharm はこれらの変更を送信し、選択したコミットモードに従って処理します:

Tx: 自動

Tx: 自動 モードでは、 Submit ボタンサブミット をクリックすると、PyCharm がすべての変更を自動的にコミットします。

Tx: 手動

Tx: 手動 モードでは、変更内容はトランザクションとしてデータベースに保存されます。 送信およびコミットボタンサブミット&コミット をクリックすると、トランザクションがデータベースにコミットされます。 トランザクションをコミットすると、 送信およびコミットボタンサブミット&コミット ボタンが無効(グレー表示)になります。 これは、すべてのトランザクションがコミットされたことを意味します。

Tx:透過

モードは クエリコンソールs でのみ切り替えられます。

Tx:透過 モードでは、PyCharm は実行したステートメントのみを送信します。 トランザクションは Tx: 手動 モードと同様に手動でコミットしますが、IDE は分離レベルの読み取り、現在の検索パスの再読み取り、またはステートメントの前後での一時セーブポイントの作成のために SQL ステートメントを自動的に発行しません。

接続を確立するとき、PyCharm は引き続き現在の検索パスを読み取り、別のパスが設定されている場合はそれを設定します。

Tx:透過 は、データソースまたはドライバーのデフォルトのトランザクションモードとして設定できません。 セッションのトランザクションモードの変更は、そのセッションにのみ適用され、データソースのデフォルトモードは変更されません。 新しいセッションは、データソースに設定されているとおりに Tx: 自動 または Tx: 手動 を使用します。

コミットモードが Tx: 自動 に設定されている場合、値、行、列の変更はすべて暗黙的にコミットされ、ロールバックすることはできません。 Tx: 自動 コミットモードでは、 送信およびコミットボタンサブミット&コミット および ロールバックボタンロールバック ボタンは無効になり、非表示になります。

コミットモードが Tx: 手動 に設定されている場合、 Submit ボタンサブミット または ロールバックボタンロールバック をクリックすることで、送信した変更を明示的に送信またはロールバックできます。 データベースに変更をコミットするには、 Commit ボタンサブミット&コミット をクリックします。

トランザクションの分離

送信 スイッチは、トランザクションの 分離レベル(英語)を選択するためにも使用できます。

利用可能なトランザクション分離レベルのリストは、DBMS によって異なります。

データソースのデフォルトのトランザクション制御設定を行います

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. 作成されたデータソースのリストで、変更するデータソースをクリックします。

  3. オプション タブをクリックします。

  4. トランザクション制御 リストから、選択したデータソースのデフォルトのトランザクションモードとトランザクション分離レベルを選択します。

    選択したトランザクション制御は、新しい クエリコンソールsおよび クエリファイル sに適用されます。

    データソースのデフォルトのトランザクションモード

データエディターでトランザクション制御設定を変更する

  1. データエディターのツールバーで、トランザクション制御のドロップダウンをクリックします。

  2. リストからトランザクションモードと分離レベルを選択してください。

トランザクションレベルを変更する

変更を自動的に送信する

デフォルトでは、 送信アイコンサブミット をクリックするか、 Ctrl+Enter を押さない限り、変更はデータベースに送信されません。 すぐに変更を送信する オプションを有効にすると、変更が自動的に送信されます。

  1. 設定 Ctrl+Alt+S で、 ツール | データベース | データエディターとビューアー に移動します。

  2. データ変更 の すぐに変更を送信する を選択してください。

  3. OK をクリックしてください。

    すぐに変更を送信する
2026 年 10 月 30 日