PyCharm 2019.1ヘルプ

データベース接続の設定

パスワードを記憶する

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

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

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

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

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

データベース接続を閉じる

PyCharmは自動的にデータベースに接続します。データベース接続が開いているデータソースの名前は、データベースツールウィンドウに太字で表示されます。

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

Close a database connection

データソースに色を割り当てる

本番データベースとテストデータベースを区別しやすくするために、データソースに色を割り当てることができます。

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

  2. 色を割り当てるデータソースを選択します。

  3. 色を選択してくださいアイコン(The Choose color icon)をクリックし、色を選択します。

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

Assign a color to a data source

JDBCドライバの使用

JDBCドライバを使用してデータベースへの接続を作成します

データソースのリストでデータベースベンダーの名前が見つからない場合は、データベース管理システム(DBMS)用のJDBCドライバをダウンロードし、PyCharmで接続を作成します。JDBCドライバを使用すると、DBMSに接続して作業を開始できます。

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

  2. データ・ソースおよびドライバーダイアログで、追加アイコン(The Add icon)をクリックし、ドライバーおよびデータ・ソースを選択します。

  3. ユーザドライバリンクをクリックします。

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

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

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

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

  8. 作成されたデータソース接続に戻ります。

  9. データベース接続の詳細を指定してください。あるいは、URLフィールドにJDBC URLを貼り付けます。

    空のパスワードを設定するには、パスワードフィールドを右クリックして空にするを選択します。

  10. データソースへの接続が正常に行われるようにするには、接続のテストをクリックします。

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

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

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

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

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

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

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

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

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

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

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

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

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

Add an icon to the user driver

接続オプションの設定

単一接続モードを有効にする

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

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

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

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

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

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

Enable the single connection mode

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

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

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

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

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

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

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

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

Enable the single database mode

接続を維持します

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

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

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

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

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

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

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

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

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

セッションのタイムゾーンを設定する

データベースとの対話を開始すると、データベースセッションが始まります。このセッションが動作するタイムゾーンを割り当てることができます。

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

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

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

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

Select a time zone in the Time zone field

接続を確立しながら、事前定義済みのSQLクエリを実行します。

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

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

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

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

Run a predefined SQL query as you establish a connection

SSHとSSLの設定

SSLでデータベースに接続する

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

  2. 接続設定を変更するデータソースプロファイルを選択します。

  3. SSH/SSLタブをクリックし、SSL を使用するチェックボックスを選択します。

  4. CA ファイルフィールドで、CA証明書ファイル( ca.pemなど)に移動します。

  5. クライアント証明書ファイルフィールドで、クライアント証明書ファイル( client-cert.pemなど)に移動します。

  6. クライアント・キー・ファイルフィールドで、クライアント鍵ファイル( client-key.pemなど)にナビゲートします。

  7. データソースへの接続が正常に行われるようにするには、接続のテストをクリックします。

Connect to a database with SSL

SSHでデータベースに接続する

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

  2. 接続設定を変更するデータソースプロファイルを選択します。

  3. SSH/SSLタブをクリックし、SSH トンネルを使用するチェックボックスを選択します。

  4. プロキシー・ホストプロキシー・ユーザープロキシー・パスワード、およびポートフィールドには、接続の詳細を指定します。

  5. 認証タイプリストから認証方法を選択します。

    • パスワード : パスワードでホストにアクセスします。パスワードを指定し、パスワードの保存チェックボックスを選択してパスワードをPyCharmに保存します。

    • キー・ペア (OpenSSH または PuTTY) : 鍵ペアと一緒にSSH認証(英語)を使用します。この認証方法を適用するには、クライアントマシンにプライベートキー、リモートサーバーにパブリックキーが必要です。PyCharmは、OpenSSH(英語)ユーティリティで生成された秘密鍵をサポートしています。

      秘密鍵が格納されているファイルへのパスを指定し、対応するフィールドにパスフレーズ(存在する場合)を入力します。PyCharmにパスフレーズを記憶させるには、パスフレーズを保存チェックボックスを選択します。

    • OpenSSHの設定と認証エージェント : 認証情報ヘルパーアプリケーションによって管理されているSSH鍵を使用します(例えば、Windowsの場合はPageant(英語)、MacおよびLinuxの場合はssh-agent(英語))。

  6. データソースへの接続が正常に行われるようにするには、接続のテストをクリックします。

SSH and SSL settings of a data source
最終更新日: 2019年5月17日