PyCharm 2026.1 Help

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

データベースにオブジェクト(テーブル、スキーマ、データベースなど)が多数存在する場合、イントロ スペクションに長時間かかることがあります。 一部のデータベースではシステムカタログの処理速度が比較的遅く、ユーザーが高速カタログにアクセスする権限を持たない場合、イントロスペクションはさらに遅くなります。

通常、日常業務やコーディング支援では、すべてのオブジェクトのソースを読み込む必要はありません。 多くの場合、データベース名さえあれば、適切なコード補完とナビゲーションを実現できます。

PyCharm は イントロスペクションレベルを使用して、データベースのサイズに応じてロードされるメタデータの量を自動的に調整します。 また、タスクに最適なレベルを手動で選択することもできます。

イントロスペクションレベルは次のデータベースでサポートされています。

  • Oracle​

  • MySQL

  • MariaDB

  • Microsoft SQL Server

  • PostgreSQL

  • Amazon Redshift​

PyCharm には次のイントロスペクションレベルがあります:

レベル

手動で設定されたレベル

継承されたレベル

説明

レベル 1

レベル 1 のアイコン

レベル 1 のアイコン

インデックス列の名前とプライベートパッケージ変数の名前を除く、サポートされているすべてのオブジェクトの名前とその署名。

列データ型は unknown としてロードされます。

レベル 2

レベル 2 アイコン

レベル 2 アイコン

データベースオブジェクトのソースコードを除くすべて。 例: このレベルでルーチンを開くと、その宣言は表示されますが、本体は表示されません。

レベル 3

レベル 3 のアイコン

レベル 3 のアイコン

すべて。

アイコンはイントロスペクションレベルを表します。ピルが多く塗りつぶされるほどレベルが高くなります。 また、色も重要です。青いアイコンはイントロスペクションレベルが直接設定されていることを、グレーは継承されていることを意味します。

PyCharm で利用可能な一部のデータベースでは、IDE は フラグメントイントロスペクションをサポートしています。 これは、単一のオブジェクトのメタデータを取得する機能です。 これは、メタデータ(通常はソースコード)が明示的に要求される状況で役立ちます。 たとえば、ビューをダブルクリックした際にイントロスペクションレベルが低い場合、PyCharm は同時にソースコードを要求します。

単一オブジェクトのソースコードをリフレッシュする

  • オブジェクトを右クリックし、 リフレッシュアイコン再読み込み を選択します。 あるいは、 Ctrl+F5 を押します。

%db_tw_full 内の単一オブジェクトのソースコードをリフレッシュする

イントロスペクションレベルのデフォルト

デフォルトでは、PyCharm は各スキーマの型とオブジェクト数に基づいて、デフォルトのイントロスペクションレベルを自動的に設定します。 各スキーマごとに、イントロスペクターはオブジェクト数をカウントし、次のしきい値を使ってイントロスペクションレベルを選択します。N はオブジェクト数です:

スキーマ

レベル 3

レベル 2

レベル 1

カレント

N <= 1000

N <= 3000

さもないと

非現行

なし

N <= 3000

さもないと

システム

なし

N <= 100

さもないと

現在のスキーマは、 セッションが接続されているスキーマです。

デフォルトを変更するには、 データソースおよびドライバー ダイアログ (Shift+Enter) を開き、 Options | Introspection | Default level に移動して、データソースのデフォルトのイントロスペクションレベルを選択します。

イントロスペクションレベルのデフォルトを変更する

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

データベース全体または特定のスキーマのいずれかにイントロスペクションレベルを設定できます。 スキーマはデータベースからイントロスペクションレベルを継承しますが、スキーマごとにレベルを個別に設定できます。

他のデータベースオブジェクトの場合、 イントロスペクションレベル コンテキストサブメニューにはオブジェクトの現在のイントロスペクションレベルが表示されます。

デフォルトでは、イントロスペクションレベルのアイコンは無効になっています。 個別に有効にすることができます: スキーマとその子(テーブル、ビュー、ルーチンなど)。

イントロスペクションレベルのアイコンを有効にする

  • データベース ツールウィンドウのツールバーで、 「オプションメニューを表示」アイコンビューオプション をクリックし、 イントロスペクションレベルのアイコン​ を選択します。

    イントロスペクションレベルアイコンが有効になっています
    イントロスペクションレベルのアイコンは無効になっています

イントロスペクションレベルを変更する

  1. データベース ツールウィンドウでオブジェクトを右クリックし、 イントロスペクションレベル メニューを選択します。

  2. イントロスペクションレベル メニューで、適用するレベルを選択します。

    子は、親に設定されたレベルを継承します。

    データソース設定で 自動同期 オプションが有効になっている場合、イントロスペクションレベルを変更するとすぐにイントロスペクションが実行されます。 このオプションの詳細については、 Auto sync in the データソースおよびドライバー dialogを参照してください。

2026 年 6 月 1 日