PyCharm 2020.1ヘルプ

データベースの接続の構成

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

データベース接続を閉じる場合は、データソースを選択し、ツールバーの切断ボタン the Disconnect button をクリックします。または、データソースを選択して Ctrl+F2を押します。

Close a database connection

パスワード保存のオプション

パスワードを保存するために次のオプションを選択できます。

  • なし : データベースとの接続を確立するたびにパスワードが求められます。

  • 再起動するまで : パスワードは現在のPyCharm実行に対してのみ保存されます。PyCharmを終了して再度開く場合は、パスワードをもう一度入力する必要があります。

  • セッション用 : パスワードは、データベースとの現在の接続セッションの間だけ保存されます(データベースから切断するまで)。 切断アイコン(the Disconnect icon)または Ctrl+F2を押すと、接続を終了できます。

  • 永遠に : パスワードはPyCharmストレージに保存されます。次回PyCharmを開くときにパスワードを入力する必要はありません。

Options for password storage

JDBC ドライバー

JDBCドライバーを既存の接続に追加する

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

  2. データ・ソースおよびドライバーダイアログで、ドライバを変更するデータソースを選択し、データソース設定でドライバーリンクをクリックします。

  3. 提供されたドライバーエントリをクリックし、除去the Remove button)をクリックします。

    変更を元に戻すには、ウィンドウの右上部分にあるリセットをクリックします。または、追加ボタン(the Add button)をクリックして提供ドライバー | <データベース名> | <driver_version>を選択する

  4. ドライバー・ファイルペインで、追加アイコン(The Add icon)をクリックし、カスタムJARを選択します。

  5. JDBCドライバのJARファイルにナビゲートして選択し、OKをクリックします。

  6. クラスフィールドで、ドライバーに使用したい値を指定します。

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

ユーザードライバーにアイコンを追加する

ユーザドライバのデフォルトアイコンを変更することができます。

  1. データベースツールウィンドウ(表示 | ツール・ウィンドウ | データベース)で、データ・ソースのプロパティアイコン(The Data Source Properties icon)をクリックして、作成したドライバを選択します。ユーザードライバを作成するには、JDBCドライバーを既存の接続に追加するを参照してください。

  2. オプションタブをクリックし、その他セクションまでスクロールします。

  3. アイコンリストから、ドライバに割り当てたいアイコンを選択します。

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

Add an icon to the user driver

接続オプション

接続を維持する

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

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

  2. 変更したいデータソースを選択します。

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

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

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

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

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

  3. オプションタブで、N秒後に自動切断チェックボックスを選択します。N は、PyCharmが接続を終了するまでの秒数です。

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

接続を確立するたびに、事前定義されたクエリを実行できます。

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

  2. 変更したいデータソースを選択します。

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

    Run a predefined query as you establish a connection

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

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

  • データベースの状態を自動的に同期するには、データベースツールウィンドウ(表示 | ツール・ウィンドウ | データベース)で、データ・ソースのプロパティボタン the Data Source Properties button をクリックし、変更するデータソースを選択します。オプションタブで、自動同期チェックボックスを選択します。

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

    Refresh the database state

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

  • データ・ソースおよびドライバーダイアログ(the Data Sources and Drivers dialog)のスキーマ タブのオブジェクト・フィルターフィールドでフィルタリングオプションを指定します。

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

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

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

    <pattern> は正規表現です。アイテムを除外するには、- (マイナス)を先頭に付けます。正規表現の詳細については、Java 2プラットフォーム標準版5.0 API仕様のクラス・パターン(英語)を参照してください。

    The Object Filter field in data source options

接続モード

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

  1. ファイル | データ・ソース Shift+Enterに移動します。

  2. データ・ソースリストで、必要なデータソースを選択します。

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

  4. 読み取り専用チェックボックスを選択します。

    Enable read-only mode for a connection

シングル接続モード

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

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

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

  2. シングル接続モードを有効にするデータソースを選択します。

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

  4. シングル接続モードを選択します。

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

    Enable the single connection mode

シングルデータベースモード

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

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

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

  2. 単一接続モードを有効にするデータソースを選択します。

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

  4. シングルデータベースモードを選択します。

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

    Enable the single database mode
最終更新日: 2020年5月25日