DBX

表结构编辑器

表结构编辑器把单表元数据和变更草稿放在持久化标签页中。DBX 会根据数据库 capability 只开放能够可靠生成的操作,并在保存前展示最终 DDL。

打开方式

  • 右键表选择查看结构或编辑结构
  • 从字段节点直接打开并定位对应字段
  • 从索引节点直接打开并定位对应索引
  • 从数据表格的表信息区域打开结构标签
  • 从对象浏览器或 DDL 入口打开同一张表

编辑器会保留当前标签、滚动位置、列宽和本地字段顺序,便于在结构与数据之间切换。

结构标签

标签主要内容
字段名称、类型、长度/精度、可空、默认值、主键、自增、字符集、排序规则、注释
索引名称、字段、类型、唯一、包含列、过滤条件、注释和重建入口
外键本地字段、目标表/字段、ON DELETE、ON UPDATE
触发器触发器元数据、源码和数据库支持的创建/修改/删除
DDL当前表定义或驱动生成的结构 SQL

数据库未提供某类元数据时,对应标签会隐藏、只读或显示能力说明。

字段编辑

根据数据库能力,可以:

  • 新增字段,或插入到当前选中字段之后
  • 删除、重命名和修改字段
  • 修改类型、长度、精度、Scale 和数据库专属长度单位
  • 修改 NULL、默认值、主键、自增、字符集、排序规则和注释
  • 使用常见默认值快捷选项
  • 拖拽字段调整顺序

列重排有两种语义:

  • MySQL 等支持物理列顺序的数据库会生成真正的顺序变更 DDL
  • 部分数据库只在 DBX 中保存本地显示顺序,不修改数据库物理结构

创建新表时,可以使用设置中的预设字段快速加入常见主键、时间戳或审计字段。

修改 OceanBase Oracle 已有主键

OceanBase Oracle 的已有主键可从约束卡片编辑或删除。当前支持普通表上已启用、已验证且不可延迟的主键,支撑索引须为有效、可见、非分区的普通唯一索引,列序与主键一致且未被其他约束共享。

修改主键会先删除原主键及其支撑索引,再创建新主键。两条 DDL 独立提交,期间表没有主键;新增失败后也可能保持无主键状态。删除主键只执行删除步骤。
  1. 在已有主键的约束卡片选择编辑,选择目标列并用上移、下移调整复合主键列序;删除整个主键时选择删除。
  2. 将其他表结构修改分开保存,然后预览本次主键 SQL。DBX 检查最新定义、支撑索引、外键引用,以及目标列中的空值和重复键值。存在引用(包括禁用的外键)、元数据不完整或不支持的状态时,预检拒绝执行。
  3. 核对预览中的表、主键名称和列序后保存。执行前会再次核对定义;定义已变化时,刷新后重新预览。
  4. 查看执行结果并核对刷新后的表结构。发生失败或结果未知时,先检查数据库状态,不要直接重复执行。

如果旧主键已删除且读回确认当前没有主键,结果明细会提供人工恢复 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 或工具栏「刷新结构」会重新读取结构,未保存草稿可能需要先确认放弃
  • 只读连接会阻止保存;生产连接每次写入都需要明确确认

使用建议