PyCharm 2026.2 Help

DDL データソース

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. データベース ツールウィンドウで、DDL データソースにダンプするデータソースを右クリックし、 インポート/エクスポート|DDL データソースへダンプ を選択します。

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

  2. データソースおよびドライバー ダイアログで、DDL データソースを選択し、 ディレクトリまたは DDL ファイルを追加 をクリックします。

  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 データソース専用のファイルのグループを作成するには、 匿名スコープ を選択します。 このスコープは特に保存されません。

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

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

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

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

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

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

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

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

    • Shift+Enter を押します。

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

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

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

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

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

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

    • Shift+Enter を押します。

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

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

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

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

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

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

DDL 生成設定の構成

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

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

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

    • Shift+Enter を押します。

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

  3. 新規ファイルレイアウト タブをクリックします。

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

オプション

説明

レイアウト

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

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

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

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

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

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

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

ルートパス

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

コードスタイル

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

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

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

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

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

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

制約の配置

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

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

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

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

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

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

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

生成コードを整形

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

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

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

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