PyCharm 2019.1ヘルプ

データベースに接続できません

ステップ 1. ネットワーク設定を確認してください

データベースは、ローカル、サーバー上、またはクラウド内で機能します。サーバーデータベースとクラウドデータベースの場合は、ネットワーク接続が必要です。接続が利用可能であることを確認するには、pingコマンドとtelnetコマンドを使用します。

pingコマンドを使用すると、送信先コンピューターが送信元コンピューターからアクセス可能であることを確認できます。コマンドラインを開き、次のコマンドを入力します: " ping -a <host_IP>" -a は、アドレスをホスト名に解決するコマンドオプションです(可能な場合)。pingコマンドでホスト名を使用すると、ホスト名はIPアドレスに解決されます。例: ping -a example.comPING example.com (93.184.216.34)に解決されます。

ping -a <host_IP>
Test connection with the ping command

telnetコマンドを使用すると、リモートコンピューターへの接続をテストしてコマンドを発行できます。 telnet コマンドのパラメーターとしてポートを指定した場合は、そのポートでリモートホストへの接続をテストできます。接続が成功すると、メッセージ Connected to <host_IP>が表示されます。

telnet <host_IP> <port_number>
Test connection with the telnet command

ステップ 2. 接続プロパティーを確認してください

各データベース(MySQL、PostgreSQL、Oracle、または他のベンダー)には独自の接続設定があります。ほとんどのデータベースには接続設定が含まれています。

  • ホスト : データベースを格納しているコンピューターまたはその他のデバイスのホスト名。IPアドレス(127.0.0.1)またはドメイン名(localhost)にすることができます。

  • データベース : 接続したいデータベースの名前。データベース名は、データベースサーバーの設定で確認できます。または、データベース管理者に問い合わせることもできます。場合によっては、データベースのコマンドラインでクエリを実行して、使用可能なすべてのデータベースの名前を確認することができます。例:MySQLでは SHOW DATABASES;を実行できます。

    The SHOW DATABASES query

  • ユーザー : データベースでアクションを実行するための十分な特権を持っているユーザーの名前。データベースのコマンドラインでクエリを実行して、使用可能なすべてのデータベースの名前を確認します。例:MySQLでは SHOW GRANTS;を実行できます。

    The SHOW GRANTS query

  • パスワード : ユーザーのパスワード。

  • ポート : ホスト間の接続ポイントを識別する番号。ホストはポート番号を使用して、接続を確立する必要があるアプリケーション、サービス、またはプロセスを決定します。データベースベンダーによって、データベースには異なるポートが使用されています。次のリストは、デフォルトのポート番号のリストです。

    ベンダー

    デフォルト・ポート

    Amazon Redshift

    5439

    Apache Derby

    1527

    Apache Cassandra

    9042

    Apache Hive

    10000(Hiveサーバー2)または9083 (ハイブメタストア)

    Azure SQLデータベース

    1433

    ClickHouse

    8123

    Exasol

    8563

    Greenplum

    5432

    H2

    8082

    HSQLDB

    9001

    IBM Db2

    50000

    MariaDB

    3306

    Microsoft SQL Server

    1433(TCP)、1434 (UDPが必要な場合があります)

    MySQL

    3306

    Oracle

    1521

    PostgreSQL

    5432

    Snowflake

    443

    SQLite

    なし

    Sybase ASE

    5000

    Vertica

    5433

選択したデータベース接続の接続設定が正しいことを確認してください。データベース接続の作成または変更について詳しくは、データベースへの接続を参照してください。

ステップ 3. ドライバのバージョンを確認する

JDBCドライバを使用すると、PyCharmのデータベース管理システム(DBMS)と対話できます。各DBMSには独自のJDBCドライバが必要です。ドライバのバージョンとDBMSのバージョンが互いに互換性があることを確認してください。

PyCharmから、サポートされているすべてのベンダーのドライバをダウンロードできます。サポートされているベンダーの全リストはドライバーリスト(Ctrl+Alt+S)で確認できます。あるいは、既存のベンダーに独自のドライバーを追加するか、ドライバーリストにないベンダーの新しいドライバー項目を作成することもできます。

ドライバをダウンロードしてドライバのバージョンを選択する

JetBrains FTPサーバーからドライバーをダウンロードするには、ドライバー リストからベンダーを選択し、ドライバー・ファイルペインのverをダウンロードします: <version_number>リンクをクリックしてください。

ドライバのバージョンを変更するには、ドライバー・ファイルペインのver: <version_number>リンクをクリックして、必要なドライバのバージョンを選択します。

The Drivers list and driver settings

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. 適用をクリックします。

ステップ 4. SSHまたはSSLとの接続が必要かどうかを確認します

データベースへの接続をより安全にするために、サービスによってはSSHまたはSSLを使用する必要があります。一部のサービスでは、SSLまたはSSHトンネルを使用するために特定のJDBCオプションを適用する必要があります。(たとえば、Heroku Postgres接続しようとしたとき)。

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

PuTTYでSSHトンネルを作成する (Windows)

  1. 最新バージョンのPuTTY SSH and Telnetクライアントをダウンロードして実行します(https://www.putty.org/(英語)からクライアントをダウンロードします)。

  2. PuTTYの設定ダイアログで、接続 | SSH | 認証に移動します。

  3. 認証用秘密鍵ファイル」フィールドで、秘密鍵ファイルへのパスを指定して「 開く」をクリックします。

  4. コマンドラインウィンドウで、SSHトンネルに使用するユーザー名を指定して Enterを押します。コマンドラインウィンドウを閉じないでください。

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

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

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

  8. 認証タイプリストから、OpenSSHの設定と認証エージェントを選択します。

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

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

Create the SSH tunnel with PuTTY (Windows)

PageantでSSHトンネルを作る (Windows)

PageantはPuTTY、PSCP、PSFTP、およびPlink用のSSH認証エージェントです。Pageantはあなたの秘密鍵を保管し、それが実行されている限り、PuTTYまたはPyCharmのような他のツールにロック解除された秘密鍵を提供します。WindowsのタスクバーにPageantのアイコンがあります。

  1. Pageantの最新バージョンをダウンロードしてください(https://www.putty.org/(英語)からクライアントをダウンロードしてください)。

  2. Windowsのタスクバーで、Pageantアイコンを右クリックしてKey の追加を選択します。

  3. 秘密鍵ファイルを選択ダイアログで、秘密鍵ファイル(PPKファイル)に移動して「開く」をクリックします。

  4. (オプション)秘密鍵のパスフレーズを入力して Enterを押します。

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

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

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

  8. 認証タイプリストから、OpenSSHの設定と認証エージェントを選択します。

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

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

Create the SSH tunnel with Pageant (Windows)

ssh-agentを使ってSSHトンネルを作成します (macOSとLinux)

コマンドラインでssh-agentのすべてのコマンドを実行します。

  1. ssh-agentが実行されていることを確認してください。

    ssh-agent

  2. 自分の鍵をエージェントに追加します(次の例では、鍵パスは ~/.ssh/id_rsaです)。

    ssh-add ~/.ssh/id_rsa

  3. (オプション)macOSでは、ssh-add コマンドに -K オプションを追加して、キーチェーンにパスフレーズを保存できます。macOS Sierra以降では、~/.ssh/ で次のテキストを使用して config ファイルを作成する必要があります。

    Host * UseKeychain yes AddKeysToAgent yes IdentityFile ~/.ssh/id_rsa

    .ssh ディレクトリーに他の秘密鍵がある場合は、各鍵に IdentityFile 行を追加してください。例:2番目の鍵の名前が id_ed25519 の場合は、2番目の秘密鍵の追加行として IdentityFile ~/.ssh/id_ed25519 を追加します。

  4. 追加されたすべてのキーを一覧表示します。

    ssh-add -L

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

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

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

  8. 認証タイプリストから、OpenSSHの設定と認証エージェントを選択します。

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

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

Create the SSH tunnel with the ssh-agent (macOS and Linux)

ステップ 5. それでも助けが必要な場合は連絡してください

PyCharmチームに連絡

pycharm-support@jetbrains.comで私たちのチームに書きます。問題を説明し、問題解決のスピードアップを可能にするすべての資料を添付します(スクリーンショット、ログ、アニメーション、ビデオ、その他の資料)。

他のトラブルシューティング情報源の詳細については、PyCharmのトラブルシューティングを参照してください。

最終更新日: 2019年5月17日