PyCharm 2024.3 ヘルプ

接続の構成

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

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

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

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

データソースを作成すると、PyCharm は自動的にデータベースに接続してデータベースオブジェクトを受信します。その後、接続が閉じられます。データベースと対話するデータソースの名前は、データベースツールウィンドウに小さな緑色の円で表示されます。

データベース接続を閉じる場合は、データソースを選択し、ツールバーの非アクティブにするボタン (the Deactivate button) をクリックします。あるいは、データソースを選択して Ctrl+F2 を押します。

Close a database connection

接続オプション

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

  1. データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。

    • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン The Data Source Properties icon をクリックします。

    • Shift+Enter を押します。

  2. 変更するデータソースを選択してオプションタブをクリックします。

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

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

    Select a time zone in the Time zone field

接続を維持する

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

  1. データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。

    • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン The Data Source Properties icon をクリックします。

    • Shift+Enter を押します。

  2. データソースタブで、変更するデータソースを選択します。

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

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

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

  1. データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。

    • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン The Data Source Properties icon をクリックします。

    • Shift+Enter を押します。

  2. データソースタブで、変更するデータソースを選択します。

  3. オプションタブで、次の時間が経過したら自動切断: チェックボックスを選択し、PyCharm が接続を終了するまでの秒数を入力します。

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

  1. データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。

    • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン The Data Source Properties icon をクリックします。

    • Shift+Enter を押します。

  2. データソースタブで、変更するデータソースを選択します。

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

    Run a predefined query as you establish a connection

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

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

  1. データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。

    • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン The Data Source Properties icon をクリックします。

    • Shift+Enter を押します。

  2. データソースタブで、変更するデータソースを選択します。

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

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

    Refresh the database state

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

  1. データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。

    • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン The Data Source Properties icon をクリックします。

    • Shift+Enter を押します。

  2. データソースタブで、変更するデータソースを選択します。

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

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

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

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

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

    The Object Filter field in data source options

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

  1. データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。

    • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン The Data Source Properties icon をクリックします。

    • Shift+Enter を押します。

  2. データソースタブで、変更するデータソースを選択します。

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

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

    • * : すべてのデータベースまたはスキーマ *: の後にスキーマをリストすることができます。

    次の例を考えてみましょう。

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

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

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

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

接続モード

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

  1. データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。

    • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン The Data Source Properties icon をクリックします。

    • Shift+Enter を押します。

  2. データソースタブで、変更するデータソースを選択します。

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

    Enable read-only mode for a connection

単一セッションモード

シングルセッションモードは、データソースとすべてのコンソールが 1 つの同じ接続を使用することを意味します。このモードでは、データベースツリー内の一時オブジェクトを表示したり、異なるクエリコンソールで同じトランザクションを使用したりできます。クエリコンソールの詳細については、「クエリコンソール」を参照してください。

シングルセッションモードを適用する場合は、開いている既存の接続をすべて閉じる必要があります。接続を開いた場合、PyCharm は通知を表示します。選択したデータソースに対して開いている接続を閉じるには、はいをクリックします。変更されたすべてのデータソースに対して開いている接続を閉じるには、すべてはいをクリックします。

  1. データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。

    • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン The Data Source Properties icon をクリックします。

    • Shift+Enter を押します。

  2. データソースタブで、変更するデータソースを選択します。

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

  4. 適用をクリックします。

    Enable the single session mode

単一データベースモード

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

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

  1. データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。

    • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン The Data Source Properties icon をクリックします。

    • Shift+Enter を押します。

  2. データソースタブで、変更するデータソースを選択します。

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

  4. 適用をクリックします。

    Enable the single database mode

トランザクションモード

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

How changes are committed to a database

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

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

  • Tx: 手動モードでは、変更はデータベースへのトランザクションに保存されます。送信とコミット (the Submit and Commit button) を押すと、トランザクションがデータベースにコミットされます。トランザクションをコミットすると、送信とコミットアイコン (the Submit and Commit button) が無効になります (グレー表示されます)。これは、すべてのトランザクションがコミットされたことを意味します。

コミットモードが Tx: 自動に設定されている場合、値、行、または列の変更はそれぞれ暗黙的にコミットされ、ロールバックできません。Tx: 自動コミットモードでは、送信とコミット (The Submit and Commit button) ボタンとロールバック (The Rollback button) ボタンは無効になり、非表示になります。

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

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

Change the transaction level

データソースのデフォルトのトランザクションモードを選択する

  1. データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。

    • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン The Data Source Properties icon をクリックします。

    • Shift+Enter を押します。

  2. 作成されたデータソースのリストで、変更するデータソースをクリックします。

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

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

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

    Default transaction mode for a data source

変更を自動的に送信する

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

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

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

  3. OK をクリックします。

    Submit changes immediately
セッション SSH と SSL の構成

関連ページ：

データソース

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

クエリコンソール

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

セッション

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

SSH と SSL の構成

データベースへの接続をより安全にするために、一部のサービスでは SSH または SSL の使用が必要です。SSL：次の手順では、ほとんどのデータベースに適した SSL 構成について説明します。一部のデータベースでは、接続を成功させるために別のアプローチを使用する必要があります。DataGrip の資料で Cassandra および Heroku Postgres の構成例を見ることができます。SSL を使用してデータベースに接続するデータソースのプロパティを開きます。次のいずれかのオプションを使用して、...