PhpStorm 2024.3 ヘルプ

データソース

データベースツールと SQL プラグインを有効にする

この機能は、PhpStorm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、プラグインを選択します。

  2. インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

データソースは接続構成です。データベースへの接続を確立するために使用される接続の詳細のリストが保存されます。例: ホスト、ポート、データベース名、ドライバー、SSH および SSL 構成設定など。データソース設定では、イントロスペクション用のデータベースとスキーマを選択して、データベースツールウィンドウに表示したり、接続用のドライバーを変更したりすることもできます。

データソースおよびドライバーダイアログ (Ctrl+Alt+Shift+S) でデータソースを設定できます。ダイアログにアクセスするには、データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、ツールバーのデータソースのプロパティボタン (the Data Source Properties button) をクリックします。

Data source with connection details for a PostgreSQL database

作成されたデータソースのリストは、データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で確認できます。データベースへのアクティブな接続を持つデータソースには、アイコンの隅に緑色の点が表示されます。

Data sources in the Database tool window

PhpStorm では、次のデータソースを作成できます。

  • データベースのデータソース : データを含む運用データベースの接続構成。

    PhpStorm は、さまざまなデータベースベンダーに対して、完全なサポートと基本サポートを提供します。データベースベンダーの完全なサポートには、強化されたコード補完やデータベースオブジェクトの取得 (イントロスペクション) の改善などの機能が含まれます。すべてのインスペクション、クイックフィックス、その他のコーディング支援機能も利用できます。一方、基本サポートでは利用できる機能が限られています。

    サポートタイプの詳細については、その他のデータベーストピックを参照してください。

  • データ定義言語 (DDL) データソース : データ定義言語ステートメントを含む SQL ファイル (DDL データソースを参照)。

データソースを作成する

データベースに接続して作業を開始するには、接続の詳細を含むデータソースを作成し、接続先のデータベースの詳細を指定します。

データソースの表示オプションを構成する

データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、オブジェクトをグループ化したり、色を割り当てたり、フィルター処理したりできます。

データベースツールウィンドウのオブジェクトの表示をカスタマイズする

  • データソースをグループ化、有効化、並べ替えるには、データベースツールウィンドウのヘッダーにあるオプションアイコン (the Show Options menu icon) をクリックし、必要なオプションを選択します。

    データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) では、データソースのビューが即座に変更されます。

    データベースツリービューオプションの詳細については、表示オプションを参照してください。

    the Options menu items

データソースをフォルダーにグループ化する

  • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、必要なデータソースを選択し、F6 を押します。または、データソースを右クリックしてフォルダーに移動を選択します。

    • フォルダーがない場合は、新規フォルダーダイアログが表示されます。テキストフィールドに、フォルダー名を入力します。スラッシュ(/)を使用してネストを定義できます。例: QA/Quick 名は、QA フォルダー内に Quick フォルダーを作成します。

      Create a new folder to group data sources
    • データソースがグループ化されたフォルダーがある場合は、フォルダーに移動ダイアログが表示されます。新しいフォルダーを作成するには、新規フォルダーを選択します。フォルダーからデータソースを削除するには、ルートフォルダーを選択します。

      Move a data source to a folder

    また、Ctrl+CCtrl+VCtrl+X を使用して、フォルダー間でデータソースをコピー、貼り付け、切り取りすることもできます。1 つのプロジェクト内でデータソースを切り取って貼り付けると、そのデータソースは移動されます。パスワードは必要ありません。ただし、その他の場合はすべてパスワードが必要です。切り取り操作は、Ctrl+Z を使用して元に戻すことができます。

データソースに色を割り当てる

本番データベースとテストデータベースを区別しやすくするために、データソースに色を割り当てることができます。

データソースの設定ダイアログまたはコンテキストメニューを使用してこれを行うことができます。

  • 設定ダイアログ

    1. データソースおよびドライバーダイアログ (Ctrl+Alt+Shift+S) で、色を割り当てるデータソースを選択します。

    2. 名前フィールドの円をクリックして、色を選択します。

    3. 変更を適用し、ダイアログを閉じます。

    Assign a color to a data source
  • コンテキストメニュー

    1. データベースツールウィンドウで、データソースを右クリックし、ツール | 色の設定に移動します。

    2. で、割り当てる色を選択します。

    3. 変更を適用し、ダイアログを閉じます。

    Assigning a color to a data source

クエリコンソールとグリッドに色を割り当てる

コードエディターとデータエディターのタブでは、データソースの色を使用できます。

  1. クエリコンソールとグリッドにデータソースの色を適用するには、データソースを右クリックし、ツール | 色の設定を選択します。

  2. データベースの色設定ダイアログで、コンソールエディターおよびグリッド内チェックボックスを選択します。

  3. 変更を適用し、ダイアログを閉じます。

ダイアログとオプションの詳細については、データベースの色設定ダイアログを参照してください。

Assigning a color to a data source

ダイアログの外観設定の詳細については、データベースの色設定ダイアログを参照してください。

ツールバーからオブジェクトをフィルターする

  • 必要なオブジェクトを選択するには、ツールバー the Filter icon フィルターアイコンを使用します。

    The Filter menu

データソースとデータベースオブジェクトのコメントを表示する

  • データベースとテーブルのコメントを有効にするには、データベースツールウィンドウのヘッダーにあるオプションアイコン (the Show Options menu icon) をクリックし、コメントを選択します。

    テーブルにコメントを追加するには、テーブルを選択して Ctrl+F6 を押します。コメントテキストフィールドにテーブルの説明を追加します。

    データベースにコメントを追加するには、データベース設定 Ctrl+Alt+S を開き、コメントテキストフィールドにデータベースの説明を追加します。

    Show descriptions for databases and tables

データソースのフルネームを使用する

デフォルトでは、タブのタイトルを短縮オプションは有効になっています。タブタイトルのデータソース名は 36 文字に短縮されています。

  • クエリコンソールのタブを右クリックして、タブのタイトルを短縮を選択します。

データベースツールウィンドウでノードの内容を表示する

  • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データベースオブジェクトをグループ化するノードをクリックし、F4 を押します。

    View the contents of a node

データソースを共有する

PhpStorm のデータソースは、プロジェクトとグローバルの 2 つのレベルで利用できます。プロジェクトレベルとは、このデータソースが最初に作成されたプロジェクトからのみデータソースにアクセスできることを意味します。グローバルレベルでは、他のプロジェクトでもデータソースを利用できます。デフォルトでは、プロジェクトレベルでデータソースを利用できます。

IDE 内の異なるプロジェクト間でデータソースを共有するには、データソースをグローバルレベルに移動する必要があります。

別のプロジェクトで同じデータソースを使用する必要があるが、アクセシビリティレベル (プロジェクトまたはグローバル)、ユーザー、データベース接続、スキーマ設定などの要件が異なる場合は、データソースをコピーできます。

プロジェクト間でデータソースを共有する

  1. データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティボタン (the Data Source Properties button) をクリックします。

  2. データソースおよびドライバーウィンドウで、グローバルにするアイコン(the Make Global icon)をクリックして、データソースをグローバルレベルで使用できるようにします。the Make Global icon アイコンをもう一度クリックして、レベルをプロジェクトに変更します。

    プロジェクトレベルとは、このデータソースが最初に作成されたプロジェクトからのみデータソースにアクセスできることを意味します。グローバルレベルでは、他のプロジェクトでデータソースを利用できます。デフォルトでは、データソースはプロジェクトレベルで利用できます。

    Share data sources between projects

異なる IDE インスタンス間でデータソースを共有する

データソースに関する情報を XML 形式でクリップボードにコピーできます。

結果の XML には、URL のみ接続タイプの JDBC URL 内でパスワード情報が提供されていない限り、パスワード情報は含まれません。この接続タイプの詳細については、データソースとドライバーダイアログのリファレンストピックを参照してください。

XML スニペットを(メッセンジャーまたはメールで)別の IDE に送信してインポートすることができます。

  1. データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、コピーするデータソースを選択します。

  2. Ctrl+C を押します。または、選択範囲を右クリックしてコピーペースト | データソースのコピーに移動します。

  3. 別のワークステーションで、表示 | 表示をクリックします。ツールウィンドウ | データベース

  4. データベースツールウィンドウで、新規アイコン (the New icon) をクリックし、クリップボードからインポートを選択します。あるいは、データベースツールウィンドウを右クリックしてコピーペースト | データソースの貼り付けを選択します (または Ctrl+V を押します)。

データソースを削除する

次のいずれかの方法でデータソースを削除できます。

  • コンテキストメニューを使用してデータソースを削除するには、データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、削除するデータソースを右クリックし、データソースの削除を選択します。

  • データソースおよびドライバーダイアログでデータソースを削除するには、次の手順に従います。

    1. データソースのプロパティを開きます。次のいずれかのオプションを使用して、データソースのプロパティを開くことができます。

      • データベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) で、データソースのプロパティアイコン The Data Source Properties icon をクリックします。

      • Ctrl+Alt+Shift+S を押します。

    2. ダイアログの左側のペインで、削除するデータソースを選択し、ツールバーの除去アイコン () をクリックします。

  • データソースおよびドライバーダイアログのコンテキストメニューからデータソースを削除するには、ダイアログの左側のペインで、削除するデータソースを右クリックし、除去を選択します。

データソース設定の共有

settings.zip ファイルを使用して、データソース設定をエクスポートおよびインポートできます。settings.zip ファイルには、グローバルレベルで使用可能なデータソースのみが含まれています。レベルの変更の詳細については、「プロジェクトレベルをグローバルに変更する」を参照してください。

データソース設定のエクスポート

  1. ファイル | IDE 設定の管理 | 設定のエクスポートをクリックします。

  2. 設定のエクスポートウィンドウで、選択なしをクリックします。

  3. 設定のエクスポートウィンドウで、データベース: ドライバーデータベース: 設定データベース: グローバルデータソースを選択します。エクスポートリストにデータベース: グローバルデータソースを表示するには、少なくとも 1 つのグローバルデータソースが必要です。また、少なくとも 1 つのドライバーをダウンロードまたは作成していることを確認してください。そうしないと、データベース: ドライバーメニュー項目がリストに表示されません。

  4. 設定のエクスポートフィールドに、settings.zip ファイルを保存するフォルダーへのパスを入力します。

データソース設定のインポート

  1. ファイル | IDE 設定の管理 | 設定のインポートをクリックします。

  2. インポートするファイルの場所ウィンドウで、エクスポートした settings.zip ファイルを見つけてダブルクリックします。

  3. インポートするコンポーネントの選択ウィンドウで、データベース: ドライバーデータベース: 設定データベース: グローバルソースを選択します。

  4. OK をクリックします。

  5. 再起動が必要ウィンドウで、OK をクリックして IDE を再起動します。

  6. データソースおよびドライバーウィンドウを開き、データソースプロパティに必要な接続資格情報を入力します。データソースがローカルまたはネットワークドライブ上にある場合は、このデータソースへのパスが正しいことを確認してください。

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

ヒント

すべての接続をパスワードで共有する

  1. Ctrl+Alt+S を押して設定を開き、外観 & 振る舞い | システム設定 | パスワードに移動します。

  2. KeePass を使用するオプションを選択してください。

  3. データベースフィールドに、プロジェクトを保存するディレクトリ内の KDBX ファイルのパスを指定します。

  4. プロジェクトを含むフォルダー全体を別のコンピューターにコピーします。

  5. 別のコンピューターで、Ctrl+Alt+S を押して設定を開き、外観 & 振る舞い | システム設定 | パスワードに移動します。

  6. データベースフィールドに、コピーした KDBX ファイルへのパスを入力します。

  7. ファイル | オープンをクリックして、コピーされたプロジェクトファイルのあるディレクトリに移動します。

関連ページ:

基本的なサポートを備えたデータベース

データベースツールと SQL プラグインを有効にするこの機能は、PhpStorm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。データソースを作成するには、JDBC ドライバーが必要です。Ph...

DDL データソース

データベースツールと SQL プラグインを有効にするこの機能は、PhpStorm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。DDL データソースは、データ定義言語ステートメント (DDL...

Amazon Redshift

データベースツールと SQL プラグインを有効にするこの機能は、PhpStorm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。公式ドキュメント Amazon Redshift の詳細については...

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

データベースツールと SQL プラグインを有効にするこの機能は、PhpStorm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。概要:データベースツールウィンドウ (表示 | ツールウィンド...

データベースの色設定ダイアログ

データベースツールウィンドウ (表示 | ツールウィンドウ | データベース) で、任意のオブジェクト (テーブルやデータソースなど) を右クリックし、を選択します。色を選択し、その色の使用方法を指定します (Shared および再帰的にオーバーライドを参照)。表示設定セクションのチェックボックスを使用して、ユーザーインターフェースのさまざまな場所でデータベースの色を有効または無効にします。色データベースツールウィンドウで選択した要素に使用する色をクリックします。必要な色がない場合は、カスタムをクリッ...

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

データベースツールと SQL プラグインを有効にするこの機能は、PhpStorm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。データソースおよびドライバーダイアログにアクセスするには、次のい...