表结构编辑器
表结构编辑器把单表元数据和变更草稿放在持久化标签页中。DBX 会根据数据库 capability 只开放能够可靠生成的操作,并在保存前展示最终 DDL。
打开方式
- 右键表选择查看结构或编辑结构
- 从字段节点直接打开并定位对应字段
- 从索引节点直接打开并定位对应索引
- 从数据表格的表信息区域打开结构标签
- 从对象浏览器或 DDL 入口打开同一张表
编辑器会保留当前标签、滚动位置、列宽和本地字段顺序,便于在结构与数据之间切换。
结构标签
| 标签 | 主要内容 |
|---|---|
| 字段 | 名称、类型、长度/精度、可空、默认值、主键、自增、字符集、排序规则、注释 |
| 索引 | 名称、字段、类型、唯一、包含列、过滤条件、注释和重建入口 |
| 外键 | 本地字段、目标表/字段、ON DELETE、ON UPDATE |
| 触发器 | 触发器元数据、源码和数据库支持的创建/修改/删除 |
| DDL | 当前表定义或驱动生成的结构 SQL |
数据库未提供某类元数据时,对应标签会隐藏、只读或显示能力说明。
字段编辑
根据数据库能力,可以:
- 新增字段,或插入到当前选中字段之后
- 删除、重命名和修改字段
- 修改类型、长度、精度、Scale 和数据库专属长度单位
- 修改
NULL、默认值、主键、自增、字符集、排序规则和注释 - 使用常见默认值快捷选项
- 拖拽字段调整顺序
列重排有两种语义:
- MySQL 等支持物理列顺序的数据库会生成真正的顺序变更 DDL
- 部分数据库只在 DBX 中保存本地显示顺序,不修改数据库物理结构
创建新表时,可以使用设置中的预设字段快速加入常见主键、时间戳或审计字段。
修改 OceanBase Oracle 已有主键
OceanBase Oracle 的已有主键可从约束卡片编辑或删除。当前支持普通表上已启用、已验证且不可延迟的主键,支撑索引须为有效、可见、非分区的普通唯一索引,列序与主键一致且未被其他约束共享。
- 在已有主键的约束卡片选择编辑,选择目标列并用上移、下移调整复合主键列序;删除整个主键时选择删除。
- 将其他表结构修改分开保存,然后预览本次主键 SQL。DBX 检查最新定义、支撑索引、外键引用,以及目标列中的空值和重复键值。存在引用(包括禁用的外键)、元数据不完整或不支持的状态时,预检拒绝执行。
- 核对预览中的表、主键名称和列序后保存。执行前会再次核对定义;定义已变化时,刷新后重新预览。
- 查看执行结果并核对刷新后的表结构。发生失败或结果未知时,先检查数据库状态,不要直接重复执行。
如果旧主键已删除且读回确认当前没有主键,结果明细会提供人工恢复 SQL 候选。执行前须重新核对数据、名称及索引;DBX 不会自动执行恢复。该 SQL 只恢复原主键的逻辑定义,不恢复表空间、压缩或存储等物理属性。
修改原生 Oracle 已有主键
原生 Oracle 使用相同的约束卡片、列序调整、预览及保存入口。普通表主键替换会保留原有启用、验证、可延迟及初始延迟状态;未验证约束还保留 RELY 语义,不会自动启用或验证。目标列仍需通过非空及唯一检查。外部表、IOT 和临时表不在此入口的支持范围内。
索引列顺序可以与约束顺序不同,但必须具有相同列集合。有效、可见、非分区的普通非唯一索引也可作为支撑索引;可延迟主键使用非唯一索引。禁用主键没有关联索引时,界面明确显示这一状态,不会猜测或删除同名独立索引,重建时也不创建索引。恢复候选保留原约束状态;禁用约束不会因恢复而自动启用。
保存前选择保留原索引或删除原索引,默认保留。保留唯一索引后,旧列组合的唯一性限制仍生效;例如从单列改为复合主键,并不会自动解除原单列的唯一性。选择删除会丢失旧索引的物理属性,预览会列出确切索引。目标列集合变化时使用新索引名称,避免与保留的索引重名。
DBX 阻止已知引用,数据库还会拒绝未可见或并发新增的引用;不会使用级联删除。两条 DDL 独立提交,部分失败需要核对主键和索引的实际状态。人工恢复只有在旧索引定义完整一致时才推荐复用;同名索引已变化或状态未知时,候选保持注释状态,须人工核实后处理。原生 Oracle 实库验收尚未完成,不能将 OceanBase 验证结果视为原生 Oracle 验证。
索引、外键与触发器
索引能力按数据库方言开放,例如:
- 创建、删除或重建索引
- 普通、唯一和数据库专属索引类型
- PostgreSQL / SQL Server 等支持的包含列或过滤条件
- 索引注释(数据库支持时)
- 自动生成新索引名称,并允许修改
原生 Oracle 与 OceanBase Oracle 均在已有表与新表入口中提供外键创建、编辑和删除。编辑已有外键前,DBX 会读取并核对原定义;定义不完整或不可读时,卡片保持只读。
复合外键按行保存本地列与引用列的配对顺序。移动一行会同时移动两侧列。ON DELETE 支持 NO ACTION、CASCADE 和 SET NULL;Oracle 外键不显示 ON UPDATE。两种数据库都可设置启用、验证和 RELY 状态;可延迟状态仅在原生 Oracle 中提供。
已有表的外键变更需要单独保存,不能与字段、主键、索引、触发器、分区、表注释或手写 DDL 草稿混合。新表可以在同一创建计划中包含字段、主键和外键,包括自引用外键。保存前,DBX 会重新检查源定义、父键、权限和适用的数据条件;必要元数据不可读或验证数据不通过时,不会先删除原外键。单条新增操作所需权限仍由数据库最终判定。
外键 DDL 按语句逐条提交。新表的 CREATE 成功而后续外键失败时,表和已成功步骤会保留,DBX 会停止剩余步骤,不自动删除表、重试或回滚。已有外键重建也可能在失败后缺少原外键。重试前先刷新并检查实际定义;结果明细可能提供需要人工复核的恢复 SQL。
其他数据库的外键编辑能力依赖对应方言实现。触发器编辑依赖数据库源码读取和安全 DDL 生成能力;不支持直接修改时仍可以查看源码或复制 DDL。
Oracle 系触发器的完整源码
在触发器标签选中对象后,复杂定义可使用「编辑完整源码」进入现有源码弹窗,不需要把 compound、CALL、WHEN 或其他复杂子句改写成简单表单。只有正文或读取不完整时,先保留修正候选并补齐权威定义,再保存。该流程的状态和恢复方法见 对象浏览器。
源码弹窗只更新对应的触发器,不清除字段、索引、约束或其他触发器草稿。若同一触发器已有结构化草稿,或写入结果未知,先只读核实,再明确选择是否放弃该触发器的结构化草稿;其他结构草稿保留。
保存结构时,继续遵守编辑器原有的组合限制;要求分开保存的索引、主键、约束或已有表外键不能与触发器混合提交。允许的组合按预览顺序逐条执行和读回。触发器重命名可能先删除旧对象再创建新对象;后步失败时旧对象可能已经不存在。DBX 会停止剩余步骤,保留完整草稿与逐步结果,核实后只为必要的剩余修改重新预览,不自动回滚或重放。
DDL 预览
编辑不会立即写入数据库。保存前,DBX 会根据当前方言生成并高亮:
ALTER TABLE ... ADD/DROP/RENAME/MODIFY COLUMN- 默认值、
NULL、主键和注释变更 CREATE INDEX、DROP INDEX、重建索引- 外键和触发器相关 DDL
- SQLite 等需要重建表时的迁移步骤
可以复制完整 DDL,在代码仓库中审查或交给迁移工具执行。
NULL、修改主键、重排物理字段和重建表都可能锁表或丢失数据。生产环境先检查执行计划、锁影响、备份和回滚方案。保存流程
读取最新结构
打开编辑器后确认字段、索引、外键和触发器已经加载完成。其他客户端刚修改过表时先刷新。
创建本地草稿
新增、修改、删除或重排对象。删除操作会以待删除状态显示,尚未执行。
审查 DDL
检查对象限定名、字段类型、默认值、约束、索引和每条语句顺序。
执行并刷新
确认后执行。生产范围会再次进入生产写入确认;成功后重新读取表结构。
方言与能力差异
| 方言/数据库 | 典型行为 |
|---|---|
| MySQL / MariaDB 兼容 | 字段属性、物理重排、主键、索引、外键和注释覆盖较完整 |
| PostgreSQL / Gauss 系兼容 | 字段类型/默认值/可空/注释、索引包含列/过滤、外键等按方言生成 |
| SQLite | 部分复杂字段变更通过安全的表重建策略实现 |
| DuckDB | 支持常见字段与索引操作,但能力不同于 SQLite |
| SQL Server | 支持字段和索引变更,部分默认约束、包含列和过滤索引使用专属语法 |
| Oracle / 达梦等 | 使用 Oracle 风格字段、注释和索引 DDL;整数长度等无意义选项会禁用 |
| ClickHouse / Manticore / InfluxDB 等 | 只开放对应实现已验证的子集 |
| JDBC/Agent | 根据识别出的方言映射;无法可靠识别时保持只读 |
不要根据“能连接”推断“所有 DDL 都能编辑”。当前范围以 数据库支持 和编辑器实际控件为准。
OceanBase Oracle 表结构克隆
侧栏和对象浏览器中的「克隆表结构」及结构粘贴使用同一复制范围:列类型及参数、BYTE/CHAR 长度单位、默认值、可空性、主键列序、普通索引和表列注释。FLOAT(p) 的二进制精度与 NUMBER(*,s)、负 scale 会保留。OceanBase 的内置类型推荐基于 4.2.5.7 的建列验证;其他版本仍可手动输入类型,已有字段类型不会被推荐列表替换。
执行前的确认框展示目标、SQL、复制项和排除项。外键、CHECK/UNIQUE 约束、触发器、特殊索引和分区定义不复制;UNIQUE 约束的支撑索引也排除,独立普通唯一索引可以复制。含虚拟列或临时表属性的源表会被拒绝。普通目标名按大写处理;显式双引号名称保留大小写,例如 orders_copy 创建 ORDERS_COPY,"OrdersCopy" 创建 OrdersCopy。
DDL 逐条提交,遇到首个错误即停止,不自动回滚或删除目标。失败详情分别列出已确认成功、数据库拒绝或结果未知,以及尚未执行的步骤。重试前,按详情中的 schema 和表名刷新并核对目标结构;通信中断不能证明建表失败。原生 Oracle 的克隆范围保持独立,不受上述 OceanBase 排除规则限制。
并发与恢复
- 编辑草稿基于打开时读取的元数据,不会自动合并其他客户端的结构变更
- 执行失败后,数据库可能已经成功执行前面的部分语句
- SQLite 重建和多语句 DDL 的原子性取决于数据库和驱动
- F5 或工具栏「刷新结构」会重新读取结构,未保存草稿可能需要先确认放弃
- 只读连接会阻止保存;生产连接每次写入都需要明确确认