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

このトピックでは、SSH トンネルと踏み台サーバー（jump server または bastion host とも呼ばれます）を介して、分離されたネットワークで実行されているデータベースに接続する方法の例を示します。

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

クラウドデータベース

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

データベースツールウィンドウで、ツールバーの新規をクリックし、データソース | MySQL に移動します。
SSH/SSL タブをクリックし、 SSH トンネルの使用(H) チェックボックスを選択します。
SSH 構成を追加してくださいをクリックします。
SSH 構成ダイアログで、次の操作を実行して新しい構成を追加します。
1. 追加ボタンをクリックします。
2. ホストおよびポートフィールドで、移動ホストの接続詳細を指定します。例: my-jump-host.amazonaws.com、 22
3. ユーザー名(U) フィールドにユーザー名を入力します。
4. このチュートリアルでは、暗号化された秘密鍵ファイルと公開鍵ファイルを使用して認証を行います。認証タイプ(Y) リストからキーペアを選択してください。
5. 秘密鍵ファイルを提供するには、秘密鍵ファイルフィールドで参照をクリックし、ファイルを選択します。
  この認証タイプでは、公開鍵ファイルが提供され、移動ホストに保存されていることを確認してください。
6. パスフレーズフィールドにパスフレーズを指定します。
7. 接続のテストをクリックして、移動ホストへのテスト接続を実行します。
8. SSH 構成ダイアログで、 OK をクリックして新しい SSH 構成設定を確認します。
データソースおよびドライバーダイアログの一般タブで、データベース接続の詳細を指定します。
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
接続詳細領域の下部にある接続のテストリンクをクリックして、データベースへのテスト接続を開始します。
OK をクリックして、データソースを作成します。

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

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

データベースツールウィンドウで、ツールバーの新規をクリックし、データソース | PostgreSQL に移動します。
SSH/SSL タブをクリックし、 SSH トンネルの使用(H) チェックボックスを選択します。
SSH 構成を追加してくださいをクリックします。
SSH 構成ダイアログで、次の操作を実行して新しい構成を追加します。
1. 追加ボタンをクリックします。
2. ホストおよびポートフィールドで、Docker コンテナーで実行されている移動ホストの接続詳細を指定します。例: localhost および 2222
3. ユーザー名(U) フィールドにユーザー名を入力します。
4. このチュートリアルでは、暗号化された秘密鍵ファイルと公開鍵ファイルを使用して認証を行います。認証タイプ(Y) リストからキーペアを選択してください。
5. 秘密鍵ファイルを提供するには、秘密鍵ファイルフィールドで参照をクリックし、ファイルを選択します。
  この認証タイプでは、公開鍵ファイルが提供され、移動ホストに保存されていることを確認してください。
6. パスフレーズフィールドにパスフレーズを指定します。
7. 接続のテストをクリックして、移動ホストへのテスト接続を実行します。
8. SSH 構成ダイアログで、 OK をクリックして新しい SSH 構成設定を確認します。
データソースおよびドライバーダイアログの一般タブで、データベース接続の詳細を指定します。
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。
接続詳細領域の下部にある接続のテストリンクをクリックして、データベースへのテスト接続を開始します。
OK をクリックして、データソースを作成します。

2026 年 3 月 30 日