PyCharm 2026.1 Help

DDL データソース

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

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

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

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

DDL データソースは、データ定義言語ステートメント (DDL ステートメント) を含む SQL ファイルに基づくデータベース構造の仮想ビューです。 エディターでは、このようなファイルに定義されているすべてのテーブル、列、その他のオブジェクトを参照できます。 ダイアグラム表もサポートされています。

DDL データソースを使用すると、データベースのバージョン管理を維持できます。 SQL ファイルを VCS システムに保存し、データベース構造が更新されるたびに再生成します。

作成された DDL データソースは、 データベース ツールウィンドウ (表示 | ツールウィンドウ | データベース) で使用できるようになります。 Project ツールウィンドウ (表示 | ツールウィンドウ | Project) でステートメントを使用して SQL ファイルを作成および管理できます。

データベースツールウィンドウの DDL データソースと、プロジェクトツールウィンドウのステートメントを含む SQL ファイル

PyCharm で、既存のデータソースをダンプしたり、既存の SQL ファイルを使用して DDL データソースを作成できます:

  • 既存のデータソースを DDL データソースにダンプすると、この DDL データソースの SQL ファイルが入ったフォルダーが データベース ツールウィンドウに自動的に接続されます。

    選択したデータソースにすでに DDL データソースがある場合は、DDL ファイルを既存の DDL データソースにダンプするか、新しく作成するかを選択できます。

  • 既存の SQL ファイルを使用して DDL データソースを作成するには、SQL ファイルが含まれるディレクトリをプロジェクトに追加し、 Project ツールウィンドウから データベース ツールウィンドウにドラッグします。

ファイルスコープを使用して、DDL データソースのソースとして使用されるファイルとフォルダーをフィルター処理します。 DLL ファイルを既存の DDL データソースにダンプすると、除外されたファイルは無視されます。

DDL データソースを作成する

既存のデータソースを DDL データソースにダンプする

  1. データベース ツールウィンドウで、DDL データソースにダンプするデータソースを右クリックし、 Import/Export | Dump to DDL Data Source を選択します。

    DDL データソースのコード設定を構成するには、 DDL 生成設定の構成を参照してください。

  2. データソースおよびドライバー ダイアログで、DDL データソースを選択し、 Add directories or DDL files をクリックします。

  3. ファイルブラウザーで、データソースの DDL ファイルを保存するディレクトリに移動し、 オープン をクリックします。

  4. OK をクリックしてください。

既存のファイルから DDL データソースを作成する

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. データソース タブの データソースおよびドライバー ダイアログ左ペインで、 追加 アイコン(追加アイコン )をクリックし、 DDL データソース を選択します。

    「データソースの追加」ボタン
  3. ソース​​ア ペインで、 追加 ボタン(追加ボタン )をクリックします。

  4. ファイルブラウザーで、SQL ファイルまたは DDL ステートメントを含むファイルに移動し、 オープン をクリックします。

  5. ダイアレクト リンクをクリックして、追加の SQL ファイルに使用するダイアレクトを選択します。

  6. 設定を適用して OK をクリックします。

    既存の SQL ファイルから DDL データソースを作成する

DDL データソースの操作

スコープを使用してファイルとフォルダーをフィルター処理する

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. ソース​​ア ペインで、 追加 ボタン(追加ボタン )をクリックします。

  3. スコープを使用してファイルやフォルダーを追加・フィルター処理するには、次のいずれかのオプションを選択します:

    • 既存のスコープを使用するには、メニューからスコープを選択します。

    • 現在の DDL データソース専用のファイルのグループを作成するには、 Anonymous Scope を選択します。 このスコープは特に保存されません。

    • 既存のスコープを編集するか、新しいスコープを作成するには、 Edit Scopes… をクリックします。 スコープの詳細については、「スコープとファイルの色 」を参照してください。

  4. 設定を適用して OK をクリックします。

    スコープを使用してファイルとフォルダーをフィルター処理する

自動同期 が選択されている場合、対応するファイルへの変更により、DDL データソースが自動的にリフレッシュされます。 この動作を無効にするには、チェックボックスをオフにします。

データソース内の参照オブジェクト

通常のデータソースのテーブルを参照するインデックスを DDL データソースに作成できます。 コードでは、このテーブルが正しく参照され、インデックスのあるテーブルがデータベースツリーに表示されます。

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. 拡張する DDL データソースを選択します。

  3. 追加 アイコン(追加アイコン )をクリックし、 Extend Data Source を選択して、参照するデータソースを選択します。

    データソース内の参照オブジェクト

DDL データソースの SQL ファイルのダイアレクトを設定する

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. 変更する DDL データソースをクリックします。

  3. ソース​​ア タブで、 Configure SQL Dialect アイコン(「SQL ダイアレクト設定」アイコン )をクリックします。

    DDL データソースの SQL ファイルのダイアレクトを設定する

DDL データソースでのオブジェクトの作成

  • データベース ツールウィンドウで、DDL データソースノードの項目を右クリックし、 新規 に移動します。 オブジェクトリストから、作成するオブジェクトを選択します。

    DDL データソースでのオブジェクトの作成

DDL 生成設定の構成

DDL データソース用に生成されるファイルの コード設定を構成できます。

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベース ツールウィンドウのツールバーで、 The Data Sources iconデータソース をクリックします。

    • Shift+Enter を押します。

    データソースとドライバーを開くダイアログ
  2. データソース タブで、DDL データソースを選択します。

  3. New File Layout タブをクリックします。

新しいファイルレイアウトタブの設定

オプション

説明

レイアウト

DDL ファイルの保存および生成方法を定義します。

  • スキーマごとのオブジェクトごとのファイル: オブジェクトごとに個別のファイルを生成し、スキーマ名の付いたフォルダーに配置します。

    スキーマごとのオブジェクトごとのファイル
  • スキーマおよびデータベースごとのオブジェクトごとのファイル: オブジェクトごとに個別のファイルを生成し、スキーマ名の付いたフォルダーに配置します。 スキーマ名のフォルダーをデータベース名のフォルダーに配置します。

    スキーマおよびデータベースごとのオブジェクトごとのファイル
  • オブジェクトごとのファイル: オブジェクトごとに個別のファイルを生成し、1 つのディレクトリに配置します。

    オブジェクトごとのファイル
  • 順序付きオブジェクトごとのファイル: 各オブジェクトごとに個別のファイルを生成し、ファイル名に数字の接頭辞を追加します。

    順序付きオブジェクトごとのファイル
  • スキーマおよび型別のオブジェクトごとのファイル: オブジェクトごとに個別のファイルを生成し、タイプ名の付いたフォルダーに配置します。 型名のフォルダーをスキーマ名のフォルダーに配置します。

    スキーマおよび型別のオブジェクトごとのファイル

ルートパス

DDL ファイルのロケーションディレクトリを定義します。

コードスタイル

生成された DDL ファイルにコードスタイルを適用します。

オブジェクトをスキーマ名で修飾

テーブル名にスキーマ名を追加します。 異なるスキームで同じ名前のテーブルが 2 つ以上ある場合は、テーブルを修飾できます。 このオプションには次のパラメーターがあります。

  • 自動: 異なるスキームに同じテーブル名が 3 つ以上ある場合は、自動的にテーブル名を修飾します。

  • なし: テーブル名を修飾しないでください。

  • 常に: 常にテーブル名を修飾します。

制約の配置

FOREIGN KEYUNIQUECHECK を配置する場所とその他の制約を定義します。

  • Inside column: 制約が 1 つの列に基づいている場合は、列定義に追加します。 制約が 2 つ以上の列に基づいている場合は、すべての列の後にテーブル定義に制約を配置します。

    列内に制約を配置する
  • Inside table: テーブル定義内のすべての列の後。

    テーブル内に制約を配置する
  • After table: テーブル定義の後に、 ALTER TABLE ADD CONSTRAINT を使用します。

    テーブル内に制約を配置する

データベース提供コードを再生成する

データベースによってソースコードの一部として提供されるプロパティ定義を再生成します。

生成コードを整形

生成されたコードを現在のコードスタイルプロファイルで再フォーマットします。 このオプションは、生成されたコードにのみ影響し、サーバーから直接受信したコードには影響しません。

デフォルトのスキーマ / データベース

DDL データソース内のオブジェクトのデフォルトのスキーマまたはデータベースを設定します。 DDL データソースには、名前のないデータベースとスキーマがあります。 次の表では、デフォルトのスキーマ名を設定できます。

デフォルトのスキーマ / データベース
2026 年 6 月 1 日