WebStorm 2025.3 ヘルプ

メタデータとイントロスペクション

メタデータには、データベースオブジェクト、その構造、データベースオブジェクトのソースコードなどに関する情報が含まれます。WebStorm はこの情報を使用して、データベースツールウィンドウにオブジェクトを表示し、DDL を表示し、補完時に候補を表示し、その他のコーディング支援、ナビゲーション、検索機能を提供します。

WebStorm では、データベースのメタデータを取得する方法が 2 つあります。ミニカタログとイントロスペクションです

ミニカタログ

システムスキーマのミニカタログを使用すると、システムスキーマのメタデータが事前にイントロスペクトされ、IDE 自体に提供されます。これにより、システムスキーマをイントロスペクトする前に、データベースに接続することなく、システムメタデータを使用するスクリプトを作成できます。

イントロスペクション

イントロスペクションとは、データベースのメタデータを読み込むプロセスです。イントロスペクションを実行すると、データソース内の構造情報がインスペクションされ、テーブル、列、ルーチン、その他のデータベースオブジェクトとその属性が検出されます。

イントロスペクションは、データ構造とカタログを持つデータベースでのみサポートされます。

デフォルトでは、データベースツールウィンドウに表示するように選択されたスキーマとデータベースのみがイントロスペクトされます。

データベースツールウィンドウで選択するか、データソースおよびドライバーダイアログ (Shift+Enter) ダイアログでデータソースプロパティを編集することで、どのスキーマとデータベースをイントロスペクトして表示するかを選択できます。

イントロスペクションのスキーマとデータベースを選択する

  • データベースツールウィンドウの場合:

    1. データベースツールウィンドウを開くには、メインメニューから「表示」→「ツールウィンドウ」→「データベース」を選択します。または、⌘ 1 を押します。

    2. データベースツールウィンドウで、データソース、データベース、スキーマ名の横にある N/M ボタンをクリックします。

      Select schemas or databases in Database tool window
    3. スキーマ選択ポップアップウィンドウで、データベースまたはスキーマを選択し、Enter を押します。

  • データソースおよびドライバーダイアログの場合:

    1. ダイアログを開くには、データベースツールウィンドウでデータソースを右クリックし、the Properties icon Properties を選択します。または、ツールバーの the Settings button データソースのプロパティアイコンをクリックします。

    2. データソースおよびドライバーダイアログのスキーマタブで、データベースまたはスキーマを選択します。

      Select schemas or databases in data source properties

      オブジェクトフィルターフィールドは、データベースツールウィンドウに表示されるオブジェクトのみを定義し、イントロスペクションスコープには影響しないことに注意してください。

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

必要なデータベースとスキーマがイントロスペクトされると、IDE はスクリプト内のデータベースオブジェクトを適切なコンテキストに解決できるようになります。以下の例は、イントロスペクトされたスキーマとイントロスペクトされていないスキーマのデータベースオブジェクトの解決方法を示しています。

Database objects resolve for the introspected and not introspected schemas
  1. イントロスペクトされていない MySQL データソース。

  2. PostgreSQL データソースのうち、唯一イントロスペクトされた guest データベース。このデータベースには 4 つのスキーマが含まれており、public スキーマのみがイントロスペクトされています。

  3. クエリコンソールでのデータベースオブジェクトの解決: イントロスペクトされた guest スキーマの場合は成功し、イントロスペクトされていない tests スキーマの場合は失敗しました。

データソースごとに、データベースオブジェクトのソースコードがロードされるスキーマのカテゴリを選択することもできます。

異なるスキーマのデータベースオブジェクトのソースをロードする

  1. データベースオブジェクトのソースがロードされるスキーマを選択するには、データソースおよびドライバーダイアログ (Shift+Enter) を開き、データソースを選択します。

  2. オプションタブで、ソースのロード設定に移動し、スキーマのカテゴリを選択します。

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

Select the category of schemas that database object sources are loaded for

すべてのオブジェクトが処理されている場合、データベースユーザーはイントロスペクションに長い時間がかかることがありますが、日常業務やコーディング支援では通常、イントロスペクションは必要ありません。イントロスペクションされるオブジェクトの数を減らすため、WebStorm では追加のイントロスペクションタイプと、サポート対象の一部のデータベースに対して 3 つのイントロスペクションレベルが実装されています。

イントロスペクションの種類

イントロスペクションの種類は、イントロスペクション中にリフレッシュされるデータベースオブジェクトを定義します。一部のデータベースでは、このイントロスペクションの範囲を特定のオブジェクトに絞り込むことができます。WebStorm では、データベースに応じて、フルイントロスペクションフラグメントイントロスペクション増分イントロスペクションの 3 種類のイントロスペクションが利用可能です。

完全なイントロスペクション

データベースツールウィンドウ ( スキーマセレクター ) またはデータソースおよびドライバーダイアログ ( スキーマ タブ ) でイントロスペクション用に選択されたスキーマとデータベースがリフレッシュされます。

増分イントロスペクション

前回のイントロスペクション実行後にデータベース内で変更されたデータベースオブジェクトのみがリフレッシュされます。

フラグメントイントロスペクション
  • リフレッシュアクションを呼び出すと、データベースツールウィンドウで選択されたデータベースオブジェクトのみがリフレッシュされます。

    The database objects selected in Database tool window are refreshed when you invoke the Refresh action
  • クエリコンソールでステートメントを実行すると、スマートなリフレッシュメカニズムが適用されます。WebStorm は、このステートメントによって変更される可能性のあるオブジェクトを分析し、特定のオブジェクトセットのみをリフレッシュします。

サポートされている一部のデータベースでは、イントロスペクションレベルごとにイントロスペクションを実行できます。

レベル別のイントロスペクション

イントロスペクションレベルは、データベースオブジェクトについて取得される詳細の量を定義します。

  • レベル 1: データベースオブジェクト名のみがロードされます。

  • レベル 2: データベースオブジェクトのソースコードを除くすべてがロードされます。

  • レベル 3: すべてがロードされました。

イントロスペクションレベルの詳細については、イントロスペクションレベルトピックを参照してください。

Introspection levels in Database tool window

データベースで特定のイントロスペクションタイプがサポートされていない場合、WebStorm は完全なイントロスペクションを実行します。以下のデータベースでは、特定のイントロスペクションタイプとイントロスペクションレベルがサポートされています。

データベース

増分イントロスペクション

フラグメントイントロスペクション

イントロスペクションレベル

Amazon Redshift

はい

-

はい

Azure SQL Database

はい

はい

-

Greenplum

はい

-

-

MariaDB

はい

はい

はい

Microsoft SQL Server

はい

はい

はい

MySQL

はい

はい

はい

Oracle

はい

はい

はい

PostgreSQL

はい

はい

はい

2025 年 8 月 07 日

関連ページ:

クエリを実行する

クエリは、ショートカット、ツールバーボタン、コンテキストメニュー、実行 / デバッグ構成を使用して実行できます。クエリコンソール、スクラッチファイル、ユーザーファイルから実行できます。クエリ結果を表示する場所と方法の詳細については、「照会結果」を参照してください。ステートメントとプロシージャーを実行する:クエリコンソールでステートメントを実行するコードを入力して実行するターミナルに関しては、クエリコンソールに関連付けることができます。データベースツールウィンドウで、データソースをクリックする...

イントロスペクションレベル

オブジェクト (テーブル、スキーマ、データベースなど) が多数ある場合、データベースユーザーはイントロスペクションに長い時間がかかることがあります。イントロスペクションは、オブジェクト名、列の種類、ソースコードなどのデータベースのメタデータを取得するプロセスです。WebStorm はこの情報を使用して、コーディング支援、ナビゲーション、検索を提供します。一部のデータベースでは、システムカタログが比較的遅く、ユーザーに高速カタログにアクセスする権限がない場合、イントロスペクションはさらに遅くなりま...

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

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

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

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

Amazon Redshift

公式ドキュメント Amazon Redshift の詳細については、公式ドキュメントを参照してください。Amazon Redshift JDBC ドライバーのその他のバージョンについては、公式 JDBC ドライバーのダウンロードを参照してください。始める前にこのトピックでは、WebStorm の Amazon Redshift データベースへの接続用のデータソースを作成し、テスト接続を実行する一般的な手順について説明します。必要な接続詳細がすでに用意されており、データベースが稼働していることを前提...