IntelliJ IDEA 2025.3 ヘルプ

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

このトピックでは、SSH トンネルと移動ホスト (移動サーバーまたは要塞ホストとも呼ばれます) を介して、分離されたネットワークで実行されているデータベースに接続する方法の例を示します。

IntelliJ IDEA で SSH を使用する方法の詳細については、SSH と SSL のトピックを参照してください。

クラウドデータベース

次の例を考えてみましょう。MySQL データベースはクラウド上でリモート実行されており、接続は中継ホストを介して確立する必要があります。暗号化された秘密鍵ファイルを使用して認証する必要があります。データソースを作成し、データベースへのテスト接続を実行するには、以下の手順を実行します。

  1. データベースツールウィンドウで、ツールバーの the New icon 新規をクリックし、データソース | MySQL に移動します。

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

  3. the Add SSH configuration SSH 構成を追加するをクリックします。

  4. SSH 構成ダイアログで、次の操作を実行して新しい構成を追加します。

    1. 追加ボタンをクリックしてください。

    2. ホストおよびポートフィールドで、移動ホストの接続詳細を指定します。例: my-jump-host.amazonaws.com22

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

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

    5. 秘密鍵ファイルを提供するには、秘密鍵ファイルフィールドで the Browse icon 参照をクリックし、ファイルを選択します。

    6. パスフレーズフィールドにパスフレーズを指定します。

    7. 接続のテストをクリックして、移動ホストへのテスト接続を実行します。

      SSH configuration and successful test connection to the jump host
    8. SSH 構成ダイアログで、OK をクリックして新しい SSH 構成設定を確認します。

  5. データソースおよびドライバーダイアログの一般タブで、データベース接続の詳細を指定します。

    1. ホストおよびポートフィールドで、データベースサーバーのアドレスとポート番号を指定します。例: mysql-ssh.my-account.my-region.amazonaws.com および 3306

    2. 認証ドロップダウンから、ユーザーパスワードを選択します。

    3. ユーザーフィールドとパスワードフィールドにユーザー資格情報を入力します。

    4. データベースフィールドに、接続先のデータベース名を入力します。この例では、testdb です。

    5. URL フィールドでは、IntelliJ IDEA は他の接続設定の値を使用して JDBC URL を自動的に生成します。

      特定の追加設定を含む JDBC URL を使用する必要がある場合は、それを URL フィールドに貼り付けます。

      例: jdbc:mysql://my-endpoint.amazonaws.com:3306/testdb

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

    Test Connection link
  7. OK をクリックして、データソースを作成します。

Connection settings of the MySQL [Cloud, SSH] data source

Docker コンテナー内のデータベース

この例では、PostgreSQL データベースは Docker コンテナーで実行されており、直接アクセスできません。接続は、別の Docker コンテナーで実行されている移動ホストを介して確立する必要があります。暗号化された秘密鍵ファイルを使用して認証する必要があります。データソースを作成し、データベースへのテスト接続を実行するには、以下の手順を実行してください。

  1. データベースツールウィンドウで、ツールバーの the New icon 新規をクリックし、データソース | PostgreSQL に移動します。

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

  3. the Add SSH configuration SSH 構成を追加するをクリックします。

  4. SSH 構成ダイアログで、次の操作を実行して新しい構成を追加します。

    1. 追加ボタンをクリックしてください。

    2. ホストおよびポートフィールドで、Docker コンテナーで実行されている移動ホストの接続詳細を指定します。例: localhost および 2222

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

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

    5. 秘密鍵ファイルを提供するには、秘密鍵ファイルフィールドで the Browse icon 参照をクリックし、ファイルを選択します。

    6. パスフレーズフィールドにパスフレーズを指定します。

    7. 接続のテストをクリックして、移動ホストへのテスト接続を実行します。

      SSH configuration and successful test connection to the jump host
    8. SSH 構成ダイアログで、OK をクリックして新しい SSH 構成設定を確認します。

  5. データソースおよびドライバーダイアログの一般タブで、データベース接続の詳細を指定します。

    1. ホストおよびポートフィールドで、データベースサーバーのアドレスとポート番号を指定します。例: 172.19.0.3 および 5432

    2. 認証ドロップダウンから、ユーザーパスワードを選択します。

    3. ユーザーフィールドとパスワードフィールドにユーザー資格情報を入力します。

    4. データベースフィールドに、接続先のデータベース名を入力します。この例では、guest です。

    5. URL フィールドでは、IntelliJ IDEA は他の接続設定の値を使用して JDBC URL を自動的に生成します。

      特定の追加設定を含む JDBC URL を使用する必要がある場合は、それを URL フィールドに貼り付けます。

      例: jdbc:postgresql://172.19.0.3:5432/guest

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

    Test Connection link
  7. OK をクリックして、データソースを作成します。

Connection settings of the MySQL [Cloud, SSH] data source
2025 年 12 月 11 日