Fork 表
Fork Table 是 seekdb 提供的一项表级能力，能够在系统自动选取的快照时刻，基于源表创建一张目标表副本。目标表与源表相互隔离，可作为独立的表对象进行后续的读写操作。本文介绍 Fork Table 的能力与典型用法。关于语句语法、参数与完整限制，请参见文末的相关文档。
在 seekdb V1.1.0 版本中，Fork Table 为实验特性，请谨慎用于生产环境。
功能简介
在开发与迭代过程中，您可能需要基于同一份数据基线并行验证不同方案，例如数据修订、特征工程、索引与元数据策略调整等。如果采用传统方式全量拷贝表数据（例如 CREATE TABLE ... AS SELECT ... 或导出导入），在大表场景下可能带来较高的时间与资源成本。
Fork Table 用于在系统自动选取的一致性快照时刻基于源表创建目标表副本。目标表在逻辑上等价于源表在该快照时刻的数据视图，可作为独立的表对象进行后续的读写操作。Fork Table 的设计目标是在保证一致性语义的前提下，尽量复用已有的数据组织与存储结构，从而降低复制开销，让创建数据分支更轻量和易用。
适用场景
- 数据版本与分支管理：围绕同一份基线数据派生多个分支版本，分别进行数据修订、特征更新或索引/元数据策略调整，并保留可追溯的版本关系。同时，Fork Table 支持快速回滚，当分支验证未达到预期时，可直接停止使用该分支并回到原始版本；当分支验证达到预期时，可将分支结果推广为新的默认版本（具体切换方式以业务与运维流程为准）。
- A/B 实验与沙箱验证：基于生产数据快照创建隔离副本，在副本上安全验证不同 Prompt 策略、AI Coding 生成逻辑或大模型推理行为，支持多方案对比，不影响线上表。
- Vibe Coding 与合成数据迭代：在 Fork 出来的副本中生成或修改数据结构和内容，快速构建合成数据集并验证其合理性。
工作机制
Fork Table 的关键语义包括：
- 快照一致性：目标表反映的是源表在 Fork 时刻的一致性快照，之后源表的变更不会影响目标表。
- 读写隔离：目标表与源表相互独立，对任一表的写入都不会影响另一方。
- 渐进可用：目标表可在 Fork 完全结束前提供访问能力；后台过程不会改变对外的一致性语义与可用性。
使用限制及注意事项
在 seekdb V1.1.0 中，Fork Table 存在以下使用限制及注意事项：
- 与 DDL 互斥：Fork 过程中通常不影响源表的日常读写，但需注意，此过程中源表和目标表与 DDL 操作互斥，直至 Fork 操作结束。建议避免在同一时间对相关表执行
CREATE/ALTER/DROP/RENAME等 DDL。 - 目标表必须不存在：若目标表已存在，系统会报错。请先删除已存在的目标表。
- 对象类型限制：不支持对部分对象进行 Fork，包括内部表、临时表、物化视图、触发器、外键和回收站中的表。
- 索引相关限制：
- 不支持语义索引、IVF 索引、空间索引。
- 不支持对包含全局索引的分区表执行 Fork。
- 不支持在 Fork 构建过程中构建索引。若需要调整索引策略，请在 Fork 完成后对目标表执行
CREATE INDEX/ALTER TABLE等操作。 - 当源表包含 HNSW 向量索引时，Fork 操作可能带来额外内存压力。建议在资源紧张的环境中先进行小规模验证，并做好监控与容量规划。
- 存储形态限制：不支持 Fork 列存表。
示例：创建表副本并验证隔离
下面示例演示 Fork Table 的基本使用流程：创建表 → Fork → 验证表对象与数据一致性 → 验证写入隔离。
-
创建源表并写入数据。
DROP TABLE IF EXISTS t1;
DROP TABLE IF EXISTS t1_fork;
CREATE TABLE t1 (
c1 INT PRIMARY KEY,
c2 INT
);
INSERT INTO t1 VALUES(1, 10); -
基于源表创建目标表副本。
FORK TABLE t1 TO t1_fork; -
验证目标表对象与数据一致性。
SHOW TABLES LIKE 't1%';
SHOW CREATE TABLE t1_fork;
SELECT COUNT(*) FROM t1;
SELECT COUNT(*) FROM t1_fork; -
验证写入隔离：写目标表不影响源表。
INSERT INTO t1_fork VALUES (2, 200);
SELECT * FROM t1_fork;
SELECT * FROM t1; -- 源表仍只有 (1, 10)
常见问题
Q1：Fork 完成后，源表的后续变更会影响目标表吗？
不会。目标表基于 Fork 时刻的一致性快照创建，源表之后发生的变更不会影响目标表。
Q2：修改目标表会影响源表吗？
不会。目标表与源表相互隔离，任一表的写入都不会影响另一方。
Q3：为什么 Fork 完全结束前目标表就可以使用？
系统会优先完成目标表对象的创建并提供访问能力；在后台数据组织过程中，系统仍保证对外提供一致的快照语义与可用性。同时，FORK TABLE 在创建阶段会尽量复用既有的数据组织与存储结构，在大表场景下通常也能保持较快的创建速度。
Q4：FORK TABLE 与传统表复制有何区别？
FORK TABLE 在满足一致性语义的前提下尽量复用已有的数据组织与存储结构，从而减少全量数据拷贝带来的时间与资源开销。