JetBrains Rider 2026.1 Help

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

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

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

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

ping -a <host_IP>
ping コマンドで接続をテストする

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

telnet <host_IP> <port_number>
telnet コマンドで接続をテストする

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

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

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

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

    SHOW DATABASES クエリ

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

    SHOW GRANTS クエリ

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

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

    ベンダー

    デフォルトポート

    %redshift%

    5439

    %derby%

    1527

    %cassandra%

    9042

    %hive%

    10000（Hive サーバー 2）または 9083 (Hive Metastore)

    %azure_sql%

    1433

    %clickhouse%

    8123

    %couchbase% クエリサービス

    11210

    %exasol%

    8563

    %greenplum%

    5432

    %h2%

    8082

    %hsqldb%

    9001

    %db2%

    50000

    %mariadb%

    3306

    %microsoft_sql%

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

    %mysql%

    3306

    %oracle%

    1521

    %postgresql%

    5432

    Snowflake（%snowflake%）

    443

    %sqlite%

    なし

    %sybase%

    5000

    %vertica%

    5433

選択したデータソースの接続設定が正しいことを確認します。 データソースの作成や変更の詳細については、 データソースを作成する および セッション を参照してください。

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

JDBC ドライバーを使用すると、JetBrains Rider からデータベース管理システム（DBMS）とやり取りできます。 各 DBMS には独自の JDBC ドライバが必要です。 ドライバのバージョンと DBMS のバージョンが互いに互換性があることを確認してください。

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

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

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

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

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

ドライバーリストとドライバー設定

    ユーザードライバーファイルの使用

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

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

      • Shift+Enter を押します。

      データソースとドライバーを開くダイアログ

    2. データソースおよびドライバー ダイアログで、 ドライバー タブが表示されていることを確認します。

    3. データソースおよびドライバー ダイアログで、 追加 アイコン（追加アイコン ）をクリックします。

    4. 名前 フィールドに、ドライバーの名前を入力します。

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

    6. JDBC ドライバの JAR ファイルに移動して選択し、 OK をクリックします。

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

    8. 適用(A) をクリックします。

    9. ドライバのダイアログからデータソースを作成するには、 データソースの作成 をクリックします。

    既存のデータソース用の JDBC ドライバーを構成する

    既存のドライバーにライブラリを追加することも、完全にドライバーを置き換えることもできます。

    一部の JDBC ドライバーは、正常に動作するため、ドライバーとあわせてライブラリファイルへのパスを必要とします。 ライブラリパスの詳細については、 ユーザードライバーのライブラリパス を参照してください。

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

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

      • Shift+Enter を押します。

      データソースとドライバーを開くダイアログ

    2. データソース設定で ドライバー リンクをクリックし、 ドライバーに移動 を選択します。

    3. 提供されたドライバーエントリをクリックし、 除去 （削除ボタン ）をクリックします。

      変更を元に戻すには、ウィンドウの右下部分にある 変更のロールバック アイコン（ロールバック変更アイコン ）をクリックします。

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

    5. ファイルブラウザーで、JDBC ドライバの JAR ファイルに移動して選択し、 OK をクリックします。

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

      ドライバークラスは、JDBC ドライバーのドライバー固有のメインクラスです。 使用する JDBC ドライバーの適切なドライバークラスについては、ドライバーのドキュメントを参照してください。

    7. カスタムドライバーに追加プロパティが必要な場合は、ダイアログの 拡張 タブに移動してください。 プロパティペインで、<user defined> と <value> が表示されている 名前⁠ 列と 値 列の最後の行に、追加プロパティの名前と値を入力します。

    8. 適用(A) をクリックします。

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

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

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

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

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

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

    SSL

    次の手順では、ほとんどのデータベースに適した SSL 構成について説明します。 一部のデータベースでは、接続を成功させるために別のアプローチを使用する必要があります。 DataGrip の資料で Cassandra および Heroku Postgres の構成例を見ることができます。

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

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

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

      • Shift+Enter を押します。

      データソースとドライバーを開くダイアログ

    2. データソース タブで、変更するデータソースを選択します。

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

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

    5. 証明書ファイルのフィールドを空のままにし、トラストストアを使用して、そこに含まれる証明書から必要な証明書を取得できます。 これを行うには、 トラストストアを使用する チェックボックスをオンにして、使用するトラストストアを選択します。

      • IDE: IDE によって受け入れられる証明書を使用します。 新しい承認された証明書を 設定 | 外観 & 振る舞い | システム設定 | サーバー証明書 に追加できます。

      • JAVA: JAVA トラストストア証明書を使用します。

      • System: システムトラストストア証明書を使用します。

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

    7. クライアントキーファイル(K) フィールドで、クライアント鍵ファイル（ client-key.pem など）に移動します。

    8. モード リストから検証モードを選択します。

      必須

      証明書が提供されている場合、サーバーがクライアント証明書を認識していることを確認します。

      CA の検証

      • 証明書が提供されている場合、サーバーがクライアント証明書を認識していることを確認します。

      • 証明書チェーンからクライアントに保存されているルート証明書までチェックして、サーバーを検証します。

      完全な検証

      • 証明書が提供されている場合、サーバーがクライアント証明書を認識していることを確認します。

      • 証明書チェーンからクライアントに保存されているルート証明書までチェックして、サーバーを検証します。

      • サーバーホストを検証して、サーバー証明書に保存されている名前と一致することを確認します。

      いずれかの証明書を検証できない場合、SSL 接続は失敗します。

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

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

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

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

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

      • Shift+Enter を押します。

      データソースとドライバーを開くダイアログ

    2. データソース タブで、変更するデータソースを選択します。

    3. SSH/SSL タブをクリックして、 SSL の使用(L) チェックボックスをオフにします。

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

    他のデータソースから SSL 設定をコピーする

    データソースの SSL 設定を構成した場合、別のデータソースにコピーできます。

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

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

      • Shift+Enter を押します。

      データソースとドライバーを開くダイアログ

    2. データソース タブで、変更するデータソースを選択します。

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

    4. コピー… リンクをクリックして、コピーする構成を選択します。

    SSH

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

    JetBrains Rider では、次のいずれかの方法で SSH 接続を作成できます：

    JetBrains Rider SSH トンネル

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

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

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

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

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

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

      • Shift+Enter を押します。

      データソースとドライバーを開くダイアログ

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

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

    4. 「SSH 構成を追加」SSH 構成を追加してください をクリックします。

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

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

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

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

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

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

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

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

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

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

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

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

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

      テスト接続リンク

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

    データソースの SSH 設定
    サンプル

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

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

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

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

      • Shift+Enter を押します。

      データソースとドライバーを開くダイアログ

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

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

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

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

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

    Pageant は PuTTY、PSCP、PSFTP、Plink 用の SSH 認証エージェントです。 Pageant は秘密鍵を保管し、それが実行されている限り、PuTTY や JetBrains Rider のような他のツールにロック解除された秘密鍵を提供します。 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. データソースへの接続が正常に行われるようにするには、 接続のテスト をクリックします。

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

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

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

    8. 認証タイプ リストから OpenSSH 構成および認証エージェント を選択してください。

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

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

    ssh-agent を使用して SSH トンネルを作成する (macOS および Linux)

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

    JetBrains Rider チームに連絡

    その他のトラブルシューティングリソースの詳細については、を参照してください。

    2026 年 6 月 12 日
    インジェクションされた SQL ステートメントデータベースツールウィンドウでデータベースオブジェクトが見つかりません