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

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

## ステップ 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 コマンドで接続をテストする](https://resources.jetbrains.com/help/img/idea/2026.3/db_test_connection_with_ping.png)

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

```
telnet <host_IP> <port_number>
```

![telnet コマンドで接続をテストする](https://resources.jetbrains.com/help/img/idea/2026.3/db_test_connection_with_telnet.png)

> **Note:**
> セキュリティ上の理由から、DBMS は通常すべての telnet 接続を切断します。 telnet コマンドを使用すると、ポートが通信用に開かれているかどうかを確認できます。

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

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

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

* データベース ：接続したいデータベースの名前。 データベース名は、データベースサーバーの設定で確認できます。または、データベース管理者に問い合わせてください。 場合によっては、データベースのコマンドラインでクエリを実行して利用可能なデータベース名を見ることができます。 例えば、MySQL では `SHOW DATABASES;` を実行できます。 ![SHOW DATABASES クエリ](https://resources.jetbrains.com/help/img/idea/2026.3/db_troubleshooting_show_databases.png)

* ユーザー : データベースでアクションを実行できる十分な権限を持つユーザーの名前です。 データベースのコマンドラインでクエリを実行して、利用可能なすべてのデータベース名を確認します。 例えば、MySQL では `SHOW GRANTS;` を実行できます。 ![SHOW GRANTS クエリ](https://resources.jetbrains.com/help/img/idea/2026.3/db_troubleshooting_show_grants.png)

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

* ポート : ホスト間の接続ポイントを識別する番号。 ホストはポート番号を使用して、接続を確立する必要があるアプリケーション、サービス、プロセスを決定します。 データベースベンダーが異なれば、データベースに異なるポートを使用します。 次のリストは、デフォルトのポート番号のリストです。 | ベンダー | デフォルトポート | | --- | --- | | Amazon Redshift | 5439 | | Apache Derby | 1527 | | Apache Cassandra Apache Cassandra | 9042 | | Apache Hive | 10000（Hive サーバー 2）または 9083 (Hive Metastore) | | Azure SQL Database | 1433 | | ClickHouse | 8123 | | Couchbase Query Service クエリ サービス | 11210 | | Exasol​​ | 8563 | | Greenplum | 5432 | | H2 | 8082 | | HSQLDB | 9001 | | IBM Db2 LUW | 50000 | | MariaDB | 3306 | | Microsoft SQL サーバー | 1433（TCP）、1434 (UDP が必要な場合があります) | | MySQL | 3306 | | Oracle​ | 1521 | | PostgreSQL | 5432 | | Snowflake | 443 | | SQLite | なし | | Sybase ASE | 5000 | | Vertica | 5433 | > **Note:** > 実際のポート番号はシステムによって異なる場合があります。 データベース管理者、サーバー設定、ホスティングプロバイダーに正しいポート番号を使用していることを確認してください。

選択したデータソースの接続設定が正しいことを確認します。 データソースの作成や変更の詳細については、 [データソースを作成する](managing-data-sources.html#create_a_data_source) および [セッション](managing-connection-sessions.html) を参照してください。

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

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

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

ドライバー   リストを開くには、   データベース   ツールウィンドウ (  `表示 | ツールウィンドウ |   データベース`  ) で、   データソースのプロパティ   アイコン ![データソースプロパティ アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) をクリックするか、 `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) を押します。

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

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

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

![ドライバーリストとドライバー設定](https://resources.jetbrains.com/help/img/idea/2026.3/db_download_driver_select_driver_version.png)

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

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

* データベース ツールウィンドウのツールバーで、 ![The Data Sources icon](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) データソース をクリックします。

* `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) を押します。

![データソースとドライバーを開くダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png)

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

3. データソースおよびドライバー   ダイアログで、   追加   アイコン（ ![追加 アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)）をクリックします。

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

5. ドライバーファイル   ペインで、   追加   アイコン（ ![追加 アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)）をクリックし、   カスタム JAR …   を選択します。

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

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

8. 変更を適用   をクリックします。

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

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/db_create_user_driver_connection.mp4)

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

既存のドライバーにライブラリを追加したり、ドライバー自体を完全に置き換えたりできます。

一部の JDBC ドライバーは、正しく動作するために、ドライバーと一緒にライブラリファイルへのパスが必要です。 ライブラリパスの詳細については、 [ユーザードライバーのライブラリパス](other-databases.html#library-paths-for-user-drivers)を参照してください。

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

* データベース ツールウィンドウのツールバーで、 ![The Data Sources icon](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) データソース をクリックします。

* `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) を押します。

![データソースとドライバーを開くダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png)

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

3. 提供されたドライバーエントリをクリックし、   削除   （ ![削除ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)）をクリックします。

変更を元に戻すには、ウィンドウの右下部分にある   変更のロールバック   アイコン（ ![ロールバック変更アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.diff.revert.svg)）をクリックします。

4. ドライバーファイル   ペインで、   追加   アイコン（ ![追加 アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)）をクリックし、   カスタム JAR …   を選択します。

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

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

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

> **Note:**
> フィールドが空の場合、または定義済みの値がドライバーに必要な値と異なる場合は、必要な値を手動で指定します。

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

8. 変更を適用   をクリックします。

> **Tip:**
> JDBC ドライバー設定の詳細については、 [ダイアログリファレンストピック](data-sources-and-drivers-dialog.html#driver)を参照してください。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/db_add_user_driver_to_connection.mp4)

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

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

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

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

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

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

### SSL

次の手順では、ほとんどのデータベースに適した SSL 構成について説明します。 一部のデータベースでは、接続を成功させるために別のアプローチを使用する必要があります。 DataGrip の資料で [Cassandra](https://www.jetbrains.com/ja-jp/help/datagrip/how-to-connect-to-cassandra-with-ssl.html) および [Heroku Postgres](https://www.jetbrains.com/ja-jp/help/datagrip/how-to-connect-to-heroku-postgres.html) の構成例を見ることができます。

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

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

* データベース ツールウィンドウのツールバーで、 ![The Data Sources icon](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) データソース をクリックします。

* `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) を押します。

![データソースとドライバーを開くダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png)

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

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

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

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

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

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

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

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

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

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

|  |  |
| --- | --- |
|    必須    |  証明書が提供されている場合、サーバーがクライアント証明書を認識していることを確認します。  |
|    CA の検証    |      * 証明書が提供されている場合、サーバーがクライアント証明書を認識していることを確認します。    * 証明書チェーンからクライアントに保存されているルート証明書までチェックして、サーバーを検証します。    |
|    完全な検証    |      * 証明書が提供されている場合、サーバーがクライアント証明書を認識していることを確認します。    * 証明書チェーンからクライアントに保存されているルート証明書までチェックして、サーバーを検証します。    * サーバーホストを検証して、サーバー証明書に保存されている名前と一致することを確認します。    |

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

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

![SSL を使用してデータベースに接続する](https://resources.jetbrains.com/help/img/idea/2026.3/db_connect_with_ssl.png)

> **Note:**
> PEM 証明書の使用をお勧めします。

> **Note:**
> 自己署名証明書や信頼されたルートエンティティ発行の証明書では、最新バージョンの JDBC ドライバー使用時にエラーが発生する場合があります。 Java キーストアが証明書チェーンを受け入れない場合、SSL 接続は失敗する可能性があります。 一時的な解決法として、JDBC ドライバーをダウングレードしてみてください（たとえば、MySQL コネクタの場合はバージョン 5.1.40 に切り替える必要があります）

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

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

* データベース ツールウィンドウのツールバーで、 ![The Data Sources icon](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) データソース をクリックします。

* `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) を押します。

![データソースとドライバーを開くダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png)

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

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

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

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

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

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

* データベース ツールウィンドウのツールバーで、 ![The Data Sources icon](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) データソース をクリックします。

* `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) を押します。

![データソースとドライバーを開くダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png)

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

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

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

### SSH

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

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

* [CLion SSH トンネルの使用](#ssh_tunnel)。IDE は、設定した SSH 構成を使用して SSH トンネルを作成します。

* [PuTTy、Pageant、ssh-client を使用して SSH トンネルを手動で作成する](#ssh_tunnel_manually)

#### CLion SSH トンネル

CLion は、設定した SSH 構成に基づいて SSH トンネルを作成できます。 SSH 構成設定にアクセスするには、 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、   ツール | SSH 構成   を選択します。

データソースに SSH トンネルを使用するには、   データソースおよびドライバー   ダイアログ ( `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) ) の   SSH/SSL   タブで   SSH トンネルを使用する   チェックボックスを選択します。

> **Note:**
> 多くの場合、   SSH/SSL   タブで SSH 構成を設定した後は、   一般   タブの設定を変更する必要はありません。CLion は SSH トンネルのローカルエンドに接続します。 例外は、SSH トンネルを手動で作成する場合です。 この場合、   一般   タブの   ホスト   にて、分離されたネットワーク上のサーバーの IP アドレスを設定する必要があります。
>
>
>
> 接続時、SSH サーバーがあるマシン上で SSH トンネルのホスト名が解決され、サーバーがデータベースへの接続を確立します。

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

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

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

* データベース ツールウィンドウのツールバーで、 ![The Data Sources icon](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) データソース をクリックします。

* `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) を押します。

![データソースとドライバーを開くダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png)

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

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

4. ![the Add SSH 構成](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)   SSH 構成を追加する   をクリックします。

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

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

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

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

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

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

* キーペア (OpenSSH または PuTTY) : キーペアで [SSH 認証(英語)](https://www.ssh.com/)を使用します。 この認証方法を適用するには、クライアントマシンに秘密鍵があり、リモートサーバーに公開鍵が必要です。 CLion は、 [OpenSSH](https://www.openssh.com/) ユーティリティで生成した秘密鍵をサポートします。 秘密鍵 が保存されているファイルへのパスを指定し、パスフレーズ (存在する場合) を対応するフィールドに入力します。 CLion にパスフレーズを記憶させるには、 パスフレーズを保存 チェックボックスを選択します。

* OpenSSH 構成および認証エージェント : [ssh-agent(英語)](https://en.wikipedia.org/wiki/Ssh-agent) や [Pageant (Windows のみ)(英語)](https://the.earth.li/~sgtatham/putty/0.70/htmldoc/Chapter9.html#pageant) など、SSH キーを管理する資格情報ヘルパーアプリケーションを使用します。 > **Tip:** > OpenSSH ssh-agent と Pageant の両方を実行している場合は、キーが含まれていない場合でも ssh-agent のみが使用されます。

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

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

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

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

![テスト接続リンク](https://resources.jetbrains.com/help/img/idea/2026.3/db_test_connection_link.png)

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

![データソースの SSH 設定](https://resources.jetbrains.com/help/img/idea/2026.3/db_ssh_configurations.png)

> **Tip:**
> SSH キーの使用方法の詳細については、 [新しい SSH 鍵を生成して ssh-agent に追加する(英語)](https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/)チュートリアルを参照してください。

##### サンプル例

SSH を使用してデータベースに接続する例については、 [SSH を使用してデータベースに接続する](connect-to-a-database-with-ssh.html)トピックを参照してください。

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

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

* データベース ツールウィンドウのツールバーで、 ![The Data Sources icon](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) データソース をクリックします。

* `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) を押します。

![データソースとドライバーを開くダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png)

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

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

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

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

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

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

2. PuTTY 構成​​   ダイアログで、  `接続 | SSH | 認証`  に移動します。

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

4. コマンドラインウィンドウで、SSH トンネルに使用するユーザー名を指定して `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) を押します。 コマンドラインウィンドウを閉じないでください。

5. データベース   ツールウィンドウで、ツールバーの   データソースのプロパティ   アイコン ![データソースプロパティアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) をクリックします。

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

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

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

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

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

![PuTTY を使用して SSH トンネルを作成する (Windows)](https://resources.jetbrains.com/help/img/idea/2026.3/db_putty_key_config.png)

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

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

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

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

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

4. （オプション）秘密鍵のパスフレーズを入力して `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) を押します。

5. データベース   ツールウィンドウで、ツールバーの   データソースのプロパティ   アイコン ![データソースプロパティアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) をクリックします。

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

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

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

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

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

![Pageant で SSH トンネルを作成する (Windows)](https://resources.jetbrains.com/help/img/idea/2026.3/db_task_area_pageant.png)

Procedure: 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. データベース   ツールウィンドウで、ツールバーの   データソースのプロパティ   アイコン ![データソースプロパティアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) をクリックします。

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

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

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

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

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

![ssh-agent を使用して SSH トンネルを作成する (macOS および Linux)](https://resources.jetbrains.com/help/img/idea/2026.3/db_ssh_agent_linux_macos.png)

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

Procedure: CLion チームに連絡

* [clion-support@jetbrains.com](mailto:clion-support@jetbrains.com) までメールでチームにご連絡ください。 問題の詳細をご記入の上、 [トラブルシューティングを迅速化できる資料](troubleshooting-materials.html)（コードサンプル、スクリーンショット、ログ、アニメーション、動画など）をアタッチしてください。

他のトラブルシューティングソースの詳細については、 [ヘルプを得る](getting-help.html) を参照してください。

## ローカルデータベース

データベースが CLion と同じマシンで実行されている場合は、次の操作を行います:

Procedure:

1. データベースサーバーがインストールされ、実行中であることを確認します。

2. データベースが TCP/IP 接続を受け入れることを確認します。

3. データソースおよびドライバー   ダイアログ ( `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) ) で:

1.   `localhost`  または  `127.0.0.1`  を   ホスト   フィールドに指定します。

2.    ポート   フィールドで指定したポートが、データベースサーバー用に設定されたポートと一致することを確認します。

3.  ユーザー名、パスワード、その他の接続設定が正しいことを確認してください。

4.  正しい [JDBC ドライバー](jdbc-drivers.html) がダウンロードされ、   ドライバー   ドロップダウンで選択されていることを確認します。

## WSL のデータソース

データベースが WSL にある場合、   データソースおよびドライバー   ダイアログ（ `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS))）を開き、   環境   フィールドが   Dev Container   に設定されていることを確認してください。

![WSL のデータソース用の Environment データソース設定](https://resources.jetbrains.com/help/img/idea/2026.3/db_data_source_in_wsl_environment_setting.png)

