DataGrip 2025.2 Help

DDL 数据源

DDL data source 是一个基于包含数据定义语言语句（DDL 语句）的 SQL 文件的数据库结构的虚拟视图。 您可以在编辑器中引用这些文件中定义的所有表、列和其他对象。 还支持图表。

DDL 数据源允许您维护数据库版本控制。 请将 SQL 文件保存在 VCS 系统中，并在数据库结构更新时重新生成这些文件。

创建后，DDL 数据源可在 数据库资源管理器 （视图(V) | 工具窗口 | 数据库资源管理器 ）中使用。 您可以在 个文件 工具窗口（视图(V) | 工具窗口 | 个文件 ）中创建和管理包含语句的 SQL 文件。

数据库资源管理器中的 DDL 数据源以及文件工具窗口中的包含语句的 SQL 文件

查看以下视频，了解如何使用 DDL 数据源。

在 DataGrip 中，您可以通过转储现有数据源和使用现有 SQL 文件来创建一个 DDL 数据源：

  • 当您 将现有数据源转储为 DDL 数据源时，与此 DDL 数据源相关的 SQL 文件夹会自动附加到 数据库资源管理器。

    如果您已经有一个用于所选数据源的 DDL 数据源，您可以选择是将 DDL 文件转储到现有的 DDL 数据源，还是创建一个新的 DDL 数据源。

  • 要 使用现有 SQL 文件创建 DDL 数据源 ，请附加包含 SQL 文件的目录，并将它们从 个文件 工具窗口拖动到 数据库资源管理器。

使用 file scopes 过滤用作 DDL 数据源的文件和文件夹。 当您将 DLL 文件转储到现有的 DDL 数据源时，被排除的文件将被忽略。

创建一个 DDL 数据源

将现有数据源导出为 DDL 数据源

  1. 在 数据库资源管理器 中，右键单击您想要转储到 DDL 数据源的数据源，然后选择 导入/导出 ｜ 转储到DDL 数据源。

    若要配置 DDL 数据源的代码设置，请参阅 配置 DDL 生成设置。

  2. 在 数据源和驱动程序 对话框中，选择DDL数据源，然后点击 添加目录或DDL 文件。

  3. 在文件浏览器中，导航到将存储数据源的 DDL 文件的目录，然后点击 打开。

  4. 点击 确定。

    当您将文件转储到 DDL 数据源时，这些 SQL 文件的文件夹会自动附加到 数据库资源管理器。

从现有文件创建 DDL 数据源

  1. 通过以下任一方式打开数据源属性：

    • 请导航至 文件(F) | 数据源。

    • 在 数据库资源管理器 （⌘ 1 ）工具栏上，单击 数据源图标数据源。

    • 请按 Ctrl+Alt+Shift+S.

    打开数据源和驱动程序对话框

  2. 在 数据源 选项卡的 数据源和驱动程序 对话框左侧窗格中，点击 添加 图标（"添加"图标 ）并选择 DDL Data Source。

    添加数据源按钮

  3. 在 源 窗格中，点击 添加 按钮（"添加"按钮）。

  4. 在文件浏览器中，导航到包含 DDL 语句的 SQL 文件或文件，然后点击 打开。

  5. 点击 方言 链接，然后选择您想要用于添加的 SQL 文件的方言。

  6. 应用设置，然后点击 确定。

    从现有 SQL 文件创建 DDL 数据源

与 DDL 数据源协作

通过作用域过滤文件和文件夹

  1. 通过以下任一方式打开数据源属性：

    • 请导航至 文件(F) | 数据源。

    • 在 数据库资源管理器 （⌘ 1 ）工具栏上，单击 数据源图标数据源。

    • 请按 Ctrl+Alt+Shift+S.

    打开数据源和驱动程序对话框

  2. 在 源 窗格中，点击 添加 按钮（"添加"按钮）。

  3. 要使用范围添加和过滤文件和文件夹，请选择以下选项之一：

    • 要使用现有的范围，请从菜单中选择。

    • 要为当前 DDL 数据源创建特定文件组，请选择 匿名作用域。 此范围不会与其他范围一起存储。

    • 若要编辑现有范围或创建新范围，请点击 编辑作用域(I)…。 有关作用域的更多信息，请参阅 文件范围与文件颜色。

  4. 应用设置，然后点击 确定。

    使用范围筛选文件和文件夹

如果选中了 自动同步 ，DDL 数据源会随着对应文件的更改自动刷新。 如需禁用此行为，请取消选中复选框。

在数据源中引用对象

您可以在 DDL 数据源中创建一个索引，该索引用于引用常规数据源中的表。 在您的代码中，此表将被正确引用，并且带有索引的表将出现在数据库树中。

  1. 通过以下任一方式打开数据源属性：

    • 请导航至 文件(F) | 数据源。

    • 在 数据库资源管理器 （⌘ 1 ）工具栏上，单击 数据源图标数据源。

    • 请按 Ctrl+Alt+Shift+S.

    打开数据源和驱动程序对话框

  2. 选择您想要扩展的 DDL 数据源。

  3. 点击 添加 图标("添加"图标 )，选择 扩展数据源 并选择您要引用的数据源。

    在数据源中引用对象

为 DDL 数据源中的 SQL 文件设置方言

  1. 通过以下任一方式打开数据源属性：

    • 请导航至 文件(F) | 数据源。

    • 在 数据库资源管理器 （⌘ 1 ）工具栏上，单击 数据源图标数据源。

    • 请按 Ctrl+Alt+Shift+S.

    打开数据源和驱动程序对话框

  2. 点击要修改的 DDL 数据源。

  3. 在 来源 选项卡上，点击 配置SQL 方言 图标（配置 SQL Dialect 图标）。

    为 DDL 数据源中的 SQL 文件设置方言

在 DDL 数据源中创建对象

  • 在 数据库资源管理器 中，右键单击 DDL 数据源节点下的某个项目，然后导航到 新建。 在对象列表中，选择您要创建的对象。

    在 DDL 数据源中创建对象

  • 在 数据库资源管理器 （视图(V) | 工具窗口(T) | 个文件 ）中右键单击 DDL 数据源的目录并选择 新建(N) ｜ SQL 文件。 在创建的 SQL 文件中输入 CREATE 语句。

    在 DDL 数据源中创建对象

配置 DDL 生成设置

您可以为 DDL 数据源生成的文件配置 code settings。

  1. 通过以下任一方式打开数据源属性：

    • 请导航至 文件(F) | 数据源。

    • 在 数据库资源管理器 （⌘ 1 ）工具栏上，单击 数据源图标数据源。

    • 请按 Ctrl+Alt+Shift+S.

    打开数据源和驱动程序对话框

  2. 在 数据源 选项卡上，选择 DDL 数据源。

  3. 点击 新建文件布局 选项卡。

    配置 DDL 生成设置

新文件布局选项卡的设置

选项

描述

布局

定义存储和生成 DDL 文件的方式。

  • 按架构每对象文件 ：为每个对象生成单独的文件，并将它们放在带模式名称的文件夹中。

    按架构每对象文件

  • 按架构和数据库为每个对象创建文件 ：为每个对象生成单独的文件，并将它们放在带模式名称的文件夹中。 将包含架构名称的文件夹放置在包含数据库名称的文件夹中。

    按架构和数据库为每个对象创建文件

  • 每个对象一个文件 ：为每个对象生成单独的文件并将它们放在一个目录中。

    每个对象一个文件

  • 按顺序为每个对象创建文件 ：为每个对象生成单独的文件，并在文件名中添加数字前缀。

    按顺序为每个对象创建文件

  • 按架构和类型分对象存储文件 ：为每个对象生成单独的文件，并将它们放置在带有类型名称的文件夹中。 将类型名称的文件夹放在架构名称的文件夹中。

    按架构和类型分对象存储文件

根路径

定义 DDL 文件的目录位置。

代码样式

将代码风格应用于生成的 DDL 文件。

使用架构名称限定对象

向表名添加架构名。 当您在不同的方案中有两个或更多的同名表时，您可以限定一个表。 此选项具有以下参数：

  • 自动 ：如果在不同的 schema 中有两个以上相同的表名，将自动限定表名。

  • 从不 ：从不限定表名称。

  • 始终 ：始终限定表名。

施加约束

定义了 FOREIGN KEY、 UNIQUE、 CHECK 和其他约束的位置。

  • 列内部 ：将其添加到列定义中，当约束基于单列时。 当约束基于两个或更多列时，请在所有列之后将约束放入表定义中。

    将约束放入列中

  • 表内部 ：添加到表定义中，放在所有列之后。

    将约束放置在表中

  • 表后 ：在表定义之后，使用 ALTER TABLE ADD CONSTRAINT。

    将约束放置在表中

重新生成数据库提供的代码

重新生成数据库作为源代码的一部分提供的属性定义。

重新设置生成的代码的格式

将生成的代码重新格式化为当前代码风格配置文件。 此选项仅影响生成的代码，并不影响直接从服务器接收到的代码。

默认架构/数据库

为 DDL 数据源中的对象设置默认架构或数据库。 DDL 数据源有未命名的数据库和模式。 下表允许您设置默认模式名称。

默认模式／数据库
最后修改日期： 2025年 9月 26日
VerticaDDL 映射