WebStorm 2025.1 ヘルプ

PostgreSQL

始める前に

このトピックでは、WebStorm の PostgreSQL データベースへの接続用のデータソースを作成し、テスト接続を実行する一般的な手順について説明します。必要な接続詳細がすでに用意されており、データベースが稼働していることを前提としています。

たとえば、マシン上でデータベースを実行し、そのデータベースに接続する場合は、まず対応する DBMS ソフトウェアをマシンにインストールする必要があります。

DBMS ソフトウェアの詳細については、公式ドキュメントを参照してください。

PostgreSQL データベースに接続する

データベースに接続するには、接続の詳細を保存するデータソースを作成します。

  1. 作成したいデータソースを選択します。以下のいずれかの方法で選択できます。

    • メインメニューで、ファイル | 新規 | データソースに移動し、PostgreSQL を選択します。

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

    Create a new data source
  2. データソースおよびドライバーダイアログの右ペインの一般タブで、ドライバーと接続タイプを指定します。

    1. 接続に別のドライバーが必要でない限り、ドライバーリストではデフォルトのドライバーオプションのままにしておきます。

    2. 接続タイプリストから、接続の詳細に応じて接続タイプを選択します。

      • デフォルト : ホストポートデータベースURL を使用して接続します。

      • URL のみ : URL のみを使用して接続します。

      URL のみ 接続タイプの場合、入力した JDBC URL がそのまま使用され、データベース資格情報も含まれています。

      他の接続タイプの場合、JDBC URL は接続の詳細に分割されます。個別に指定して自動生成された URL を使用することも、対応するフィールドに URL を直接入力することもできます。

    General tab of the Data Sources and Drivers dialog
  3. 接続設定領域の下部に「不足しているドライバーファイルをダウンロード」リンクがあるかどうかを確認します。このリンクをクリックして、データベースと対話するために必要なドライバーをダウンロードします。直接ダウンロードリンクについては、JetBrains JDBC ドライバーページを参照してください。

    The Download missing driver files link

    ダウンロードされた JDBC ドライバーの場所は WebStorm 構成ディレクトリです。

    提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。ドライバーを使用したデータベースへの接続の詳細については、「既存の接続にユーザードライバーを追加する」を参照してください。

    不足しているドライバーファイルをダウンロードリンクがない場合は、必要なドライバーがすでに存在します。

  4. データベース接続の詳細を指定します。あるいは、JDBC URL を URL フィールドに貼り付けます。

    1. ホストフィールドに、サーバーのアドレスを入力します。

    2. ポートフィールドに、PostgreSQL のポートを入力します。デフォルトのポートは 5432 です。

    3. 認証ドロップダウンから、接続の認証に使用する認証方法を選択します。以下のオプションから選択できます。

      • pgpass: pgpass ファイルを使用します。このファイルはユーザーのホームディレクトリに保存できます。パスワードファイルとその場所の詳細については、postgresql.org のパスワードファイル(英語)を参照してください。

      • ユーザーパスワード : ログインとパスワードを使用。

      • 認証なし : 認証は必要ありません。

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

      パスワードを使用しない場合は、パスワードフィールドを空のままにします。

      一度入力したパスワードを削除するには、「パスワード」フィールドを右クリックし、「空にする」を選択します。

      the Set Empty context menu action
    5. データベースフィールドに、接続するデータベース名を入力します。

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

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

      • フォーマット: jdbc:postgresql://<host_address>:<port_number>/<database_name>

      • サンプル: jdbc:postgresql://127.0.0.1:5432/myDatabase

      URL 形式の詳細については、「PostgreSQL の公式ドキュメント(英語)」を参照してください。

    Database connection details
    1. 認証ドロップダウンから、接続の認証に使用する認証方法を選択します。以下のオプションから選択できます。

      • ユーザーパスワード : ログインとパスワードを使用。

      • 認証なし : 認証は必要ありません。

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

      パスワードを使用しない場合は、パスワードフィールドを空のままにします。

      一度入力したパスワードを削除するには、「パスワード」フィールドを右クリックし、「空にする」を選択します。

      the Set Empty context menu action
    3. URL フィールドでは、WebStorm は他の接続設定の値を使用して JDBC URL を自動的に生成します。

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

      URL 形式の詳細については、「PostgreSQL の公式ドキュメント(英語)」を参照してください。

    Database connection details

    一般およびデータソースおよびドライバーダイアログ (Shift+Enter) の他のタブの接続設定とプロパティに関する参考情報については、接続設定と DBMS 固有のプロパティを参照してください。

  5. 提供された詳細情報を使用してデータベース接続を確立できることを確認してください。これを行うには、接続詳細セクションの下部にある接続のテストリンクをクリックしてください。

    Test Connection link

    接続の問題が発生した場合は、データベースに接続できませんページを参照してください。

  6. (オプション) デフォルトでは、デフォルトのデータベースとスキーマのみがイントロスペクトされ、使用可能になります。他のデータベースやスキーマも操作したい場合は、「スキーマ」タブで、イントロスペクション用に選択します。

    Schemas tab of the Data Sources and Drivers dialog
  7. OK をクリックして、データソースを作成します。

  8. データベースツールウィンドウで新しいデータソースを見つけます。

    • データベースツールウィンドウの詳細については、対応するリファレンストピックを参照してください。

    • WebStorm でのデータベースオブジェクトの操作の詳細については、「データベースオブジェクト」を参照してください。

    • クエリを作成して実行するには、データソースをクリックして F4 を押し、既定のクエリコンソールを開きます。

    • データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックしてデータエディターとビューアーを開きます。

Kerberos 認証

Kerberos 認証を使用して PostgreSQL データベースへの接続を確立する前に、コマンドプロンプトまたはターミナルで Kerberos コマンドを実行して、認証チケットがあることを確認してください。

  • マシンにチケットキャッシュファイルがあり、useTicketCachetrue に設定されている場合は、klist コマンドを実行してください。キャッシュされたチケットの中に、あなたのチケットが含まれていることを確認してください。

  • マシン上でチケットキャッシュが有効になっていない場合は、次の手順を実行します。

    1. klist コマンドを実行し、チケットがリストされていることを確認します。

    2. 認証チケットがリストにない場合は、ユーザー名を指定して kinit コマンドを実行し、サーバー kinit <username> からチケットを取得してください。プロンプトが表示されたら、パスワードを入力してください。

Kerberos チケットの詳細については、Kerberos Web サイト(英語)を参照してください。

    Kerberos 認証用に PostgreSQL データソースを構成するには、次の手順を実行します。

    1. 次の /etc/jaas.conf 構成ファイルを作成します。

      pgjdbc { com.sun.security.auth.module.Krb5LoginModule required useTicketCache=true debug=true renewTGT=true doNotPrompt=true; };
    2. データソースおよびドライバーダイアログ (Shift+Enter) を開き、データソースを選択して、詳細設定タブに移動します。

    3. VM オプションフィールドに以下を入力します。

      -Djava.security.auth.login.config=/etc/jaas.conf

      Setting VM Options in the PostgreSQL data source properties
    4. 変更を保存してダイアログを閉じるには、OK をクリックします。

    接続設定と DBMS 固有のプロパティ

    接続設定

    一般およびデータソースおよびドライバーダイアログ (Shift+Enter) の他のタブの接続設定 ( ホストポートなど) に関する参考情報については、「データソース」を参照してください。

    DBMS 固有のプロパティ

    「スキーマ」タブ

    項目

    説明

    内部システムスキーマの表示

    pg_temp や p_toast などの内部システムスキーマを表示します。

    テンプレートデータベースの表示

    テンプレートデータベースの表示。

    関連ページ:

    データベースへの接続

    このトピックでは、WebStorm でのデータベースへの接続の仕組みの概要を説明します。機能と概念の詳細については、専用のトピックを参照してください。データソース:データベースに接続するには、WebStorm には接続の詳細 (ホスト、ポート、パスワード、SSH 構成設定など) が必要です。すべてのデータベースの接続の詳細は、専用の接続構成 (データソース) に保存されます。以下は、データソースおよびドライバーダイアログ () のデータソース設定の例です。ダイアログフィールドの詳細については、ダ...

    データソースおよびドライバーダイアログ

    データソースおよびドライバーダイアログにアクセスするには、次のいずれかのアクションを実行します。データベースツールウィンドウで、データソースのプロパティボタンをクリックします。データベースツールウィンドウで、追加ボタンをクリックし、に移動します。概要:データソースおよびドライバーダイアログでは、データソースとデータベースドライバを管理できます。左ペインのコントロールデータソースとドライバーのリストから項目を選択すると、その項目の設定がダイアログの右側に表示されます。ツールバー

    トラブルシューティング資料

    より正確で素早い回答のためにトラブルシューティング資料をアタッチすることを検討してください。ログファイル、スクリーンショット、アニメーション、ビデオ、データベースダンプなどの資料が調査に役立ちます。ログファイルを見つける:WebStorm ログを検索するをクリックします。idea.log ファイルには、IDE のパフォーマンスに関する最近のログ情報が含まれています。idea.log ファイルには、IDE パフォーマンスに関する最近のログ情報が含まれています。SQL ログの場所を変更する SQL ログ...

    IDE で使用されるディレクトリ

    デフォルトでは、WebStorm は、各 IDE インスタンスのユーザー固有のファイル(構成、キャッシュ、プラグイン、ログなど)をユーザーのホームディレクトリに保存します。ただし、必要に応じて、これらのファイルを保存する場所を変更できます。IDE ディレクトリの場所を変更するたとえば、ユーザープロファイルドライブの容量が不足している場合や低速ディスクにある場合、ホームディレクトリが暗号化されている(IDE の速度が低下している)場合、またはネットワークドライブにある場合は、デフォルトの IDE...

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

    ステップ 1. ネットワーク設定を確認する:データベースは、ローカル、サーバー、クラウドで動作できます。サーバーおよびクラウドデータベースの場合、ネットワーク接続が必要です。接続が利用可能かどうかを確認するには、ping コマンドと telnet コマンドを使用します。ping コマンドを使用すると、移行先コンピューターが移行元コンピューターから到達可能であることを確認できます。コマンドラインを開き、コマンドを入力します。は、アドレスをホスト名に解決するコマンドオプションです(可能な場合)。ping...

    データベースツールウィンドウ

    概要:データベースツールウィンドウでは、データベースと DDL データソースを操作できます。データベース内のデータ構造を表示および変更したり、その他の関連タスクを実行したりできます。使用可能なデータソースは、データソース、スキーマ、テーブルなどのツリーとして表示されます。現在データソースが定義されていない場合は、新規コマンドを使用してデータソースを作成し、データベースに接続します。データソースの詳細については、データソーストピックを参照してください。WebStorm がデータベースに接続される...