データベースに接続できません
ステップ 1. ネットワーク設定を確認してください
データベースは、ローカル、サーバー、クラウドで機能します。サーバーおよびクラウドデータベースの場合、ネットワーク接続が必要です。接続が使用可能であることを確認するには、ping および telnet コマンドを使用します。
ping コマンドを使用すると、移行先コンピューターが移行元コンピューターから到達可能であることを確認できます。コマンドラインを開き、コマンド ping -a <host_IP>
を入力します。-a
は、アドレスをホスト名に解決するコマンドオプションです(可能な場合)。ping コマンドでホスト名を使用すると、ホスト名は IP アドレスに解決されます。例: ping -a example.com
は PING example.com (93.184.216.34)
に解決されます。
![ping コマンドで接続をテストする Test connection with the ping command](https://resources.jetbrains.com/help/img/idea/2024.1/db_test_connection_with_ping.png)
telnet コマンドを使用して、リモートコンピューターへの接続をテストし、コマンドを発行できます。telnet
コマンドのパラメーターとしてポートを指定すると、指定されたポートでリモートホストへの接続をテストできます。接続が成功すると、メッセージ Connected to <host_IP>
が表示されます。
![telnet コマンドで接続をテストする Test connection with the telnet command](https://resources.jetbrains.com/help/img/idea/2024.1/db_test_connection_with_telnet.png)
ステップ 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 クエリクエリサービス
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 ドライバを使用すると、GoLand のデータベース管理システム(DBMS)と対話できます。各 DBMS には独自の JDBC ドライバが必要です。ドライバのバージョンと DBMS のバージョンが互いに互換性があることを確認してください。
GoLand から、サポートされているすべてのベンダーのドライバーをダウンロードできます。サポートされているベンダーの完全なリストは、ドライバーリストで確認できます。または、独自のドライバーを既存のベンダーに追加するか、ドライバーリストにないベンダーの新しいドライバーエントリを作成できます。
ドライバーリストを開くには、データベースツールウィンドウ ( ) で、データソースのプロパティアイコン をクリックするか、Shift+Enter を押します。
ドライバをダウンロードしてドライバのバージョンを選択する
JetBrains FTP サーバーからドライバーをダウンロードするには、ドライバーリストからベンダーを選択し、バージョンのダウンロードをクリックします。 ドライバーファイルペインの <version_number> リンク。
ドライバのバージョンを変更するには、ドライバーファイルペインの ver。<version_number> リンクをクリックして、必要なドライバのバージョンを選択します。
![ドライバーリストとドライバー設定 The Driver list and driver settings](https://resources.jetbrains.com/help/img/idea/2024.1/db_download_driver_select_driver_version.png)
ユーザードライバーファイルの使用
データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。
データベースツールウィンドウ ( ) で、データソースのプロパティアイコン
をクリックします。
Shift+Enter を押します。
データソースおよびドライバーダイアログで、ドライバータブが表示されていることを確認します。
データソースおよびドライバーダイアログで、追加アイコン(
)をクリックします。
名前フィールドに、ドライバーの名前を入力します。
ドライバーファイルペインで、追加アイコン(
)をクリックし、カスタム JAR を選択します。
JDBC ドライバの JAR ファイルに移動して選択し、OK をクリックします。
クラスフィールドで、ドライバーに使用したい値を指定します。
適用をクリックします。
ドライバのダイアログからデータソースを作成するには、データソースの作成をクリックします。
既存のデータソース用の JDBC ドライバーを構成する
既存のドライバーにライブラリを追加することも、ドライバーを完全に置き換えることもできます。
一部の JDBC ドライバーでは、正常に動作するために、ドライバーとともにライブラリファイルへのパスが必要です。ライブラリパスの詳細については、ユーザードライバーのライブラリパスを参照してください。
データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。
データベースツールウィンドウ ( ) で、データソースのプロパティアイコン
をクリックします。
Shift+Enter を押します。
データソース設定でドライバーリンクをクリックし、ドライバーに移動を選択します。
提供されたドライバーエントリをクリックし、除去(
)をクリックします。
変更を元に戻すには、ウィンドウの右下部分にある変更のロールバックアイコン(
)をクリックします。
ドライバーファイルペインで、追加アイコン(
)をクリックし、カスタム JAR を選択します。
ファイルブラウザーで、JDBC ドライバの JAR ファイルに移動して選択し、OK をクリックします。
クラスフィールドで、ドライバーに使用したい値を指定します。
ドライバークラスは、JDBC ドライバーのドライバー固有のメインクラスです。使用する JDBC ドライバーの適切なドライバークラスについては、ドライバーのドキュメントを参照してください。
適用をクリックします。
ステップ 4. SSH または SSL との接続が必要かどうかを確認する
データベースへの接続をより安全にするために、一部のサービスでは SSH または SSL の使用が必要です。
SSL
次の手順では、ほとんどのデータベースに適した SSL 構成について説明します。一部のデータベースでは、接続を成功させるために別のアプローチを使用する必要があります。DataGrip の資料で Cassandra および Heroku Postgres の構成例を見ることができます。
SSL を使用してデータベースに接続する
データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。
データベースツールウィンドウ ( ) で、データソースのプロパティアイコン
をクリックします。
Shift+Enter を押します。
データソースタブで、変更するデータソースを選択します。
SSH/SSL タブをクリックし、SSL の使用チェックボックスを選択します。
CA ファイルフィールドで、CA 証明書ファイル(mssql.pem など)に移動します。
証明書ファイルのフィールドを空のままにし、トラストストアを使用して、そこに含まれる証明書から必要な証明書を取得できます。これを行うには、トラストストアを使用するチェックボックスをオンにして、使用するトラストストアを選択します。
IDE : IDE によって受け入れられる証明書を使用します。新しい承認された証明書を に追加できます。
JAVA : JAVA トラストストア証明書を使用します。
システム : システムトラストストア証明書を使用します。
クライアント証明書ファイルフィールドで、クライアント証明書ファイル(client-cert.pem など)に移動します。
クライアントキーファイルフィールドで、クライアント鍵ファイル(client-key.pem など)に移動します。
モードリストから検証モードを選択します。
必要とする
証明書が提供されている場合、サーバーがクライアント証明書を認識していることを確認します。
CA の検証
証明書が提供されている場合、サーバーがクライアント証明書を認識していることを確認します。
証明書チェーンからクライアントに保存されているルート証明書までチェックして、サーバーを検証します。
完全な検証
証明書が提供されている場合、サーバーがクライアント証明書を認識していることを確認します。
証明書チェーンからクライアントに保存されているルート証明書までチェックして、サーバーを検証します。
サーバーホストを検証して、サーバー証明書に保存されている名前と一致することを確認します。
いずれかの証明書を検証できない場合、SSL 接続は失敗します。
データソースへの接続が正常に行われるようにするには、接続のテストをクリックします。
データベースへの SSL 接続を無効にする
データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。
データベースツールウィンドウ ( ) で、データソースのプロパティアイコン
をクリックします。
Shift+Enter を押します。
データソースタブで、変更するデータソースを選択します。
SSH/SSL タブをクリックして、SSL の使用チェックボックスをオフにします。
適用をクリックします。
他のデータソースから SSL 設定をコピーする
1 つのデータソースに SSL 設定を構成した場合、別のデータソースにコピーできます。
データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。
データベースツールウィンドウ ( ) で、データソースのプロパティアイコン
をクリックします。
Shift+Enter を押します。
データソースタブで、変更するデータソースを選択します。
SSH/SSL タブをクリックし、SSL の使用チェックボックスを選択します。
コピーリンクをクリックして、コピーする構成を選択します。
SSH
Secure Shell または SSH は、クライアントとサーバー間の接続を暗号化するために使用されるネットワークプロトコルです。
GoLand では、次のいずれかの方法で SSH 接続を作成できます。
GoLand SSH トンネルの使用。IDE は、設定した SSH 構成を使用して SSH トンネルを作成します。
GoLand SSH トンネル
GoLand は、設定した SSH 構成に基づいて SSH トンネルを作成できます。SSH 構成設定にアクセスするには、Ctrl+Alt+S を押して設定を開き、ツール | SSH 構成を選択します。
データソースに SSH トンネルを使用するには、データソースおよびドライバーダイアログ (Shift+Enter) の SSH/SSL タブで SSH トンネルの使用チェックボックスを選択します。
作成されたすべての SSH 接続は、プロジェクトにあるすべてのデータソース間で共有されます。プロジェクト間で接続を共有したくない場合は、SSH 接続設定でこのプロジェクトでのみ表示するチェックボックスを選択します。
SSH を使用してデータベースに接続する
データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。
データベースツールウィンドウ ( ) で、データソースのプロパティアイコン
をクリックします。
Shift+Enter を押します。
接続設定を変更するデータソースプロファイルを選択します。
SSH/SSL タブをクリックし、SSH トンネルの使用チェックボックスを選択します。
SSH 構成を追加してくださいボタン(
)をクリックしてください。
SSH ダイアログで、追加ボタンをクリックします。
プロジェクト間で構成を共有したくない場合は、このプロジェクトでのみ表示するチェックボックスを選択します。
ホスト、ユーザー名、ポートフィールドで、接続の詳細を指定します。
認証タイプリストから、認証方法を選択できます。
パスワード : パスワードを使用してホストにアクセスします。GoLand にパスワードを保存するには、「パスワードを保存」チェックボックスを選択します。
キーペア (OpenSSH または PuTTY) : キーペアで SSH 認証(英語)を使用します。この認証方法を適用するには、クライアントマシンに秘密キーがあり、リモートサーバーに公開キーが必要です。GoLand は、OpenSSH(英語) ユーティリティで生成された秘密キーをサポートします。
秘密キーが保存されているファイルへのパスを指定し、パスフレーズ (存在する場合) を対応するフィールドに入力します。GoLand にパスフレーズを記憶させるには、「パスフレーズを保存」チェックボックスを選択します。
OpenSSH 構成および認証エージェント : ssh-agent(英語) などの SSH キーを管理する資格情報ヘルパーアプリケーションを使用します。
「OK」をクリックして、新しい SSH 構成設定を確認します。
データソースおよびドライバーダイアログのローカルポートフィールドで、接続の転送元のローカルポート番号を指定します。それ以外の場合、GoLand はポートを動的に選択します。
![データソースの SSH 設定 SSH settings of a data source](https://resources.jetbrains.com/help/img/idea/2024.1/db_ssh_configurations.png)
データベースへの SSH 接続を無効にする
データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。
データベースツールウィンドウ ( ) で、データソースのプロパティアイコン
をクリックします。
Shift+Enter を押します。
接続設定を変更するデータソースプロファイルを選択します。
SSH/SSL タブをクリックして、SSH トンネルの使用チェックボックスをオフにします。
適用をクリックします。
SSH トンネルを手動で作成する
PuTTY を使用して SSH トンネルを作成する (Windows)
最新バージョンの PuTTY SSH and Telnet クライアントをダウンロードして実行します(https://www.putty.org/(英語) からクライアントをダウンロードします)。
PuTTY の設定ダイアログで、 に移動します。
認証用秘密鍵ファイルフィールドで、秘密鍵ファイルへのパスを指定し、開くをクリックします。
コマンドラインウィンドウで、SSH トンネルに使用するユーザー名を指定して Enter を押します。コマンドラインウィンドウを閉じないでください。
データベースツールウィンドウ ( ) で、ツールバーのデータソースのプロパティアイコン
をクリックします。
接続設定を変更するデータソースプロファイルを選択します。
SSH/SSL タブをクリックし、SSH トンネルの使用チェックボックスを選択します。
認証タイプリストから、OpenSSH 構成および認証エージェントを選択します。
プロキシホスト、プロキシユーザー、ポートフィールドに、接続詳細を指定します。
データソースへの接続が正常に行われるようにするには、接続のテストをクリックします。
![PuTTY を使用して SSH トンネルを作成する (Windows) Create the SSH tunnel with PuTTY (Windows)](https://resources.jetbrains.com/help/img/idea/2024.1/db_putty_key_config.png)
Pageant で SSH トンネルを作成する (Windows)
Pageant は PuTTY、PSCP、PSFTP、Plink 用の SSH 認証エージェントです。Pageant はあなたの秘密鍵を保管し、それが実行されている限り、PuTTY または GoLand のような他のツールにロック解除された秘密鍵を提供します。Windows のタスクバーに Pageant のアイコンがあります。
Pageant の最新バージョンをダウンロードしてください(https://www.putty.org/(英語) からクライアントをダウンロードしてください)。
Windows のタスクバーで、Pageant アイコンを右クリックして Key の追加を選択します。
秘密鍵ファイルを選択ダイアログで、秘密鍵ファイル(PPK ファイル)に移動し、開くをクリックします。
(オプション)秘密鍵のパスフレーズを入力して Enter を押します。
データベースツールウィンドウ ( ) で、ツールバーのデータソースのプロパティアイコン
をクリックします。
接続設定を変更するデータソースプロファイルを選択します。
SSH/SSL タブをクリックし、SSH トンネルの使用チェックボックスを選択します。
認証タイプリストから、OpenSSH 構成および認証エージェントを選択します。
プロキシホスト、プロキシユーザー、ポートフィールドに、接続詳細を指定します。
データソースへの接続が正常に行われるようにするには、接続のテストをクリックします。
![Pageant で SSH トンネルを作成する (Windows) Create the SSH tunnel with Pageant (Windows)](https://resources.jetbrains.com/help/img/idea/2024.1/db_task_area_pageant.png)
ssh-agent を使用して SSH トンネルを作成する (macOS と Linux)
コマンドラインで ssh-agent のすべてのコマンドを実行します。
ssh-agent が実行されていることを確認してください。
ssh-agent自分の鍵をエージェントに追加します(次の例では、鍵パスは ~/.ssh/id_rsa です)。
ssh-add ~/.ssh/id_rsa(オプション)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
を追加します。追加されたすべてのキーを一覧表示します。
ssh-add -Lデータベースツールウィンドウ ( ) で、ツールバーのデータソースのプロパティアイコン
をクリックします。
接続設定を変更するデータソースプロファイルを選択します。
SSH/SSL タブをクリックし、SSH トンネルの使用チェックボックスを選択します。
認証タイプリストから、OpenSSH 構成および認証エージェントを選択します。
プロキシホスト、プロキシユーザー、ポートフィールドに、接続詳細を指定します。
データソースへの接続が正常に行われるようにするには、接続のテストをクリックします。
![ssh-agent を使用して SSH トンネルを作成する (macOS と Linux) Create the SSH tunnel with the ssh-agent (macOS and Linux)](https://resources.jetbrains.com/help/img/idea/2024.1/db_ssh_agent_linux_macos.png)
ステップ 5. それでも助けが必要な場合は私たちに書いてください
GoLand チームに連絡
goland-support@jetbrains.com のチームにメールしてください。問題を説明し、トラブルシューティングをスピードアップできる利用可能なすべての資料(コードサンプル、スクリーンショット、ログ、アニメーション、ビデオ、その他の資料)をアタッチします。
他のトラブルシューティングソースの詳細については、トラブルシューティング資料を参照してください。
関連ページ:
![](https://resources.jetbrains.com/help/img/idea/2024.1/db_connection_details_postgresql_default.png)
データソース
データベースツールと SQL プラグインを有効にするこの機能は、GoLand にバンドルされており、デフォルトで有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。データソースは接続構成です。データベースへの接続を確立するた...
![](https://resources.jetbrains.com/help/img/idea/2024.1/db_services_tool_window_db.png)
セッション
データベースツールと SQL プラグインを有効にするこの機能は、GoLand にバンドルされており、デフォルトで有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。GoLand では、データベースへの接続は特別なラッパー (...
![](https://resources.jetbrains.com/help/img/idea/2024.1/db_drivers_with_complete_and_basic_support.png)
基本サポート付きデータベース
データベースツールと SQL プラグインを有効にするこの機能は、GoLand にバンドルされており、デフォルトで有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。データソースを作成するには、JDBC ドライバーが必要です。...
![](https://resources.jetbrains.com/help/img/idea/2024.1/db_create_new_data_source.png)
SSL を使用した Apache Cassandra データソースを作成する
ステップ 1. Apache Cassandra 接続を作成する:データベースに接続するには、接続の詳細を保存するデータソースを作成します。これは、次のいずれかの方法で実行できます。メインメニューで、に移動し、Apache Cassandra を選択します。データベースエクスプローラー (表示 | ツールウィンドウ | データベースエクスプローラー) で、ツールバーの新規アイコン () をクリックします。データソースに移動し、Apache Cassandra を選択します。、接続設定領域の下部に「不足...
![](https://resources.jetbrains.com/help/img/idea/2024.1/go_product_version_macos.png)
サポートと支援
GoLand のサポートが必要ですか? YouTrack、ディスカッションフォーラム、Twitter で回答を探すか、メールで GoLand チームに連絡してください。情報を探す場所:情報源 YouTrack: JetBrains 追跡システム、JetBrains コミュニティフォーラム: 新しいことを学び、JetBrains 製品についてのあなたの知識を共有することができるオンラインコミュニティ。JetBrains ナレッジベース: JetBrains サポートチームによって収集および公開されてい...
![](https://resources.jetbrains.com/help/img/idea/2024.1/sql_injected_html_editor.png)
挿入された SQL ステートメント
データベースツールと SQL プラグインを有効にするこの機能は、GoLand にバンドルされており、デフォルトで有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。一時的に言語をインジェクションする言語を挿入する文字列リテラ...