Fork Database

Fork Database 基于源数据库在某个快照时刻的全量数据，创建一个全新的目标数据库。目标数据库包含源数据库中所有用户表及其数据，在逻辑上等价于源数据库在该快照时刻的完整副本。

Fork Database 底层基于 Fork Table 实现，对源库中的每张用户表依次执行 Fork，并保证库内所有表共享同一个快照版本，确保跨表数据的一致性。

语法

FORK DATABASE source_database TO destination_database;

参数说明

示例场景

创建库副本并进行读写

-- 创建库副本
FORK DATABASE db_src TO db_fork;

-- 目标库可查询
USE db_fork;
SELECT count(*) FROM t1;

-- 目标库可写入（写入不会影响源库 db_src）
INSERT INTO t1 VALUES (...);

整库分支与版本管理

-- 1) 基于主版本创建分支版本（数据基线为 fork 时刻快照）
FORK DATABASE db_prod TO db_prod_branch_v2;

-- 2) 在分支库上进行实验性变更
-- ... 对 db_prod_branch_v2 中的表执行 DML/业务流程 ...

-- 3a) 快速回滚：停止使用分支版本
DROP DATABASE db_prod_branch_v2;

空库 fork

CREATE DATABASE db_empty;
FORK DATABASE db_empty TO db_empty_fork;
-- 目标库 db_empty_fork 为空库，不含任何表

核心特性

权限说明

发起 Fork Database 需要同时具备：

• 源库库级 SELECT 权限（全局或源库库级权限可以满足；仅拥有源库中各表的表级 SELECT 不满足要求）
• 目标库的 CREATE 权限

Fork 只复制 schema 和数据，不复制源库上的授权。目标库按照普通新建对象判断权限。Fork 只能在当前租户内执行，不支持 sys tenant。

操作互斥

Fork Database 执行期间，源库及其中的表会与 DDL 操作互斥，例如 DROP TABLE 和 DROP DATABASE。Fork 期间，源库仍可继续进行 DML 读写。

使用限制

Fork Database 中的用户表还需满足 Fork Table 对表类型、索引类型和存储格式的相关要求，详见 Fork Table。

Fork Database 只处理用户基表，视图等其他非基表对象会被忽略。

注意事项

• Fork Database 克隆的是源库中的所有用户表及其数据。
• 目标库创建后与源库完全独立，对任一方的修改不会反映到另一方。
• 源库的 DDL 操作（如新增表、修改表结构）不会自动同步到目标库。
• Fork 操作不会影响源库的正常运行。