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

ステップ 1. ネットワーク設定を確認する

データベースは、ローカル、サーバー、クラウドで動作できます。サーバーおよびクラウドデータベースの場合、ネットワーク接続が必要です。接続が利用可能かどうかを確認するには、ping コマンドと telnet コマンドを使用します。

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

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

ステップ 2. 接続プロパティを確認する

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

• ホスト : データベースを保存するコンピューターまたは別のデバイスのホスト名。IP アドレス 127.0.0.1 またはドメイン名 localhost を指定できます。

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

  

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

  

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

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

  ベンダー	デフォルトポート
  Amazon Redshift	5439
  Apache Derby	1527
  Apache Cassandra	9042
  Apache Hive	10000（Hive サーバー 2）または 9083 (Hive Metastore)
  Azure SQL Database	1433
  ClickHouse	8123
  Couchbase Query サービスクエリサービス	11210
  Exasol	8563
  Greenplum	5432
  H2	8082
  HSQLDB	9001
  IBM Db2 LUW	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 ドライバを使用すると、IntelliJ IDEA のデータベース管理システム（DBMS）と対話できます。各 DBMS には独自の JDBC ドライバが必要です。ドライバのバージョンと DBMS のバージョンが互いに互換性があることを確認してください。

IntelliJ IDEA からは、サポートされているすべてのベンダーのドライバーをダウンロードできます。サポートされているベンダーの完全なリストは、ドライバーリスト () で確認できます。または、既存のベンダーに独自のドライバーを追加したり、ドライバーリストにないベンダーの新しいドライバーエントリを作成したりすることもできます。

ドライバーリストを開くには、データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン をクリックするか、Shift+Enter を押します。

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

JetBrains FTP サーバーからドライバーをダウンロードするには、ドライバーリストからベンダーを選択し、バージョンのダウンロードをクリックします。 ドライバーファイルペインの <version_number> リンク。

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

ステップ 4. (Windows のみ) 一時ディレクトリのパスに非 ASCII 文字が含まれていないか確認する

現在、一時ディレクトリのパスに非 ASCII 文字を含めることはできません。非 ASCII 文字が含まれている場合は、次のいずれかの方法で問題を解決できます。

• Windows コントロールパネルを開き、Windows 10 の場合は設定 | 時間と言語 | 言語 | 管理言語設定または設定 | 時間と言語 | 言語と地域 | 管理言語設定に移動します。非 Unicode プログラム用の言語セクションで、言語をローカルの言語に変更します。

• Java が ASCII 文字のみを含む別の一時ディレクトリパスを使用するには、IDE でヘルプ | カスタム VM オプションの編集に移動し、idea.vmoptions ファイルに -Djava.io.tmpdir=<ASCII_characters_only_temp_directory_path> を追加します。

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

データベースへの接続をより安全にするために、一部のサービスでは SSH または SSL の使用が必要です。

SSH

Secure Shell または SSH は、クライアントとサーバー間の接続を暗号化するために使用されるネットワークプロトコルです。

IntelliJ IDEA では、次のいずれかの方法で SSH 接続を作成できます。

• IntelliJ IDEA SSH トンネルの使用。IDE は、設定した SSH 構成を使用して SSH トンネルを作成します。

• PuTTy、Pageant、ssh-client を使用して SSH トンネルを手動で作成する

IntelliJ IDEA SSH トンネル

IntelliJ IDEA は、設定した SSH 構成に基づいて SSH トンネルを作成できます。SSH 構成設定にアクセスするには、Ctrl+Alt+S を押して設定を開き、ツール | SSH 構成を選択します。

データソースに SSH トンネルを使用するには、データソースおよびドライバーダイアログ (Shift+Enter) の SSH/SSL タブで SSH トンネルの使用チェックボックスを選択します。

作成されたすべての SSH 接続は、プロジェクトにあるすべてのデータソース間で共有されます。プロジェクト間で接続を共有したくない場合は、SSH 接続設定でこのプロジェクトでのみ表示するチェックボックスを選択します。

SSH を使用してデータベースに接続する

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

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

   • Shift+Enter を押します。

   

2. SSH 接続を設定するデータソースを選択します。

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

4. SSH 構成を追加するをクリックします。

5. SSH 構成ダイアログで、追加ボタンをクリックします。

6. プロジェクト間で構成を共有したくない場合は、このプロジェクトでのみ表示するチェックボックスを選択します。

7. ホストフィールドとポートフィールドで、接続の詳細を指定します。

8. ユーザー名フィールドにユーザー名を入力します。

9. このチュートリアルでは、暗号化された秘密鍵ファイルと公開鍵ファイルを使用して認証を行います。認証タイプリストから認証方法を選択できます。

   • パスワード : パスワードを使用してホストにアクセスします。IntelliJ IDEA にパスワードを保存するには、「パスワードを保存」チェックボックスを選択します。

   • キーペア (OpenSSH または PuTTY) : キーペアで SSH 認証(英語)を使用します。この認証方法を適用するには、クライアントマシンに秘密鍵があり、リモートサーバーに公開鍵が必要です。IntelliJ IDEA は、OpenSSH(英語) ユーティリティで生成された秘密鍵をサポートします。

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

   • OpenSSH 構成および認証エージェント : ssh-agent(英語) や Pageant (Windows のみ)(英語) など、SSH キーを管理する資格情報ヘルパーアプリケーションを使用します。

10. テスト接続を実行するには、接続のテストをクリックします。

11. SSH 構成ダイアログで、OK をクリックして新しい SSH 構成設定を確認します。

12. データソースおよびドライバーダイアログのローカルポートフィールドで、接続の転送元のローカルポート番号を指定します。それ以外の場合、IntelliJ IDEA はポートを動的に選択します。

13. 接続詳細領域の下部にある接続のテストリンクをクリックして、データベースへのテスト接続を開始します。

    

14. OK をクリックして、データソースを作成します。

サンプル

SSH を使用してデータベースに接続する例については、SSH を使用してデータベースに接続するトピックを参照してください。

データベースへの SSH 接続を無効にする

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

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

   • Shift+Enter を押します。

   

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

3. SSH/SSL タブをクリックして、SSH トンネルの使用チェックボックスをオフにします。

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

SSH トンネルを手動で作成する

PuTTY を使用して SSH トンネルを作成する (Windows)

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

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

3. 認証用秘密鍵ファイルフィールドで、秘密鍵ファイルへのパスを指定し、オープンをクリックします。

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

5. データベースツールウィンドウで、ツールバーのデータソースのプロパティアイコン をクリックします。

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

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

8. 認証タイプリストから、OpenSSH 構成および認証エージェントを選択します。

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

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

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

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

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

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

3. 秘密鍵ファイルを選択ダイアログで、秘密鍵ファイル（PPK ファイル）に移動し、オープンをクリックします。

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

5. データベースツールウィンドウで、ツールバーのデータソースのプロパティアイコン をクリックします。

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

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

8. 認証タイプリストから、OpenSSH 構成および認証エージェントを選択します。

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

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

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. データベースツールウィンドウで、ツールバーのデータソースのプロパティアイコン をクリックします。

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

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

8. 認証タイプリストから、OpenSSH 構成および認証エージェントを選択します。

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

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

ステップ 6. まだサポートが必要な場合はご連絡ください

他のトラブルシューティングソースの詳細については、「サポートと支援」を参照してください。