生成 DDL

物理模型建模完成后，用生成 DDL 输出在数据库中创建或变更库表结构的脚本。全量创建脚本用于首次落库，变更脚本用于两个版本之间的增量更新。本页只讲脚本的生成、预览和执行出口；数据类型映射见工具箱，分区、分表等对象的覆盖范围见对应功能页。

生成一次脚本

1. 打开物理模型，确认模型已保存。
2. 在顶部工具栏选择“生成 DDL 脚本”。
3. 选择生成全量创建脚本，或选择两个版本之间的变更脚本。
4. 在“对象过滤”中确定脚本包含的对象范围。
5. 在“类型过滤”中设置语句规范，例如是否生成分区分片、序列、同义词等语句。
6. 单击“产生脚本”。
7. 在预览弹窗中检查脚本内容，必要时调整过滤项后重新产生。
8. 选择导出为 .sql 文件、直连数据库执行，或连接 GitLab 上传脚本。

图示为 DDL 编辑器，注意“对象过滤”和“类型过滤”是两个独立入口，分别控制对象范围和语句规范。

图示为脚本预览弹窗，导出脚本、直连执行和 GitLab 上传都在此确认。

对象过滤与类型过滤

过滤入口	控制什么	常见用法
对象过滤	脚本包含哪些对象	只落部分表时按主题域或表名缩小范围
类型过滤	生成哪些语句及语句规范	不生成分区分片、序列、同义词等物理属性语句

类型过滤的配置可以由服务端统一下发，本地调整前先确认组织是否已规定统一规范。

脚本的执行出口

出口	说明	检查点
导出 .sql	导出为脚本文件，交由数据库管理员执行	记录导出时的过滤条件与模型版本
直连数据库执行	连接数据库后直接执行	确认目标库与账号权限，变更脚本先确认影响范围
GitLab 上传	将脚本上传至 GitLab 仓库	核对目标仓库、分支与目录

直连执行会直接改变数据库结构，执行前先完成脚本预览核对。

配置记忆与覆盖范围

DDL 编辑器中的配置属于模型属性的一部分，每次打开时会记忆上次的配置结果。因此在同一模型上再次生成脚本时，先核对上次留下的过滤设置，避免沿用无关的范围。

分区、分表、序列、同义词等物理对象是否产生语句，由其自身配置与类型过滤共同决定：分表设计生成的脚本包含所有分表的创建与变更语句，参见分表设计；表分区见表分区设计。

注意事项

• 变更脚本依赖两个版本的对比基准，生成前确认比较所依据的版本。
• 脚本只覆盖本次过滤范围内的对象，未出现在脚本中的对象不会被改动。
• 直连数据库执行前确认已选中正确的数据源，参见客户端统一数据源管理。