应用和主要插件内置表

介绍

这份清单用于说明应用和主要插件内置表在迁移管理、版本控制、备份还原中的常见处理方式。多数情况下，用户不需要逐表调整，按默认策略处理即可。

三类机制关注点不同：

• 迁移管理：用于跨环境发布，常见策略包括覆盖、仅结构和跳过。
• 版本控制：用于保存和恢复应用搭建过程中的关键节点。
• 备份还原：用于应用运行态的备份与恢复。

表中的“数据类型”来自内置分类。系统基础数据参与版本控制；业务运行数据不参与版本控制；运行态临时数据不备份。

内置表参考

Database

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
migrations	ORM/SQL 迁移已执行版本记录	系统基础数据	仅结构	参与	备份

Server

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
applicationPlugins	当前应用实例加载的插件清单及版本	系统基础数据	覆盖	参与	备份
applicationVersion	应用与核心版本号，用于升级与兼容判断	系统基础数据	仅结构	参与	备份

系统设置

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
systemSettings	安装级系统参数与功能开关	系统基础数据	覆盖	参与	备份

客户端

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
desktopRoutes	PC 端菜单与路由结构	系统基础数据	覆盖	参与	备份

多空间

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
spaces	多空间/工作区隔离的顶层容器	业务运行数据	仅结构	不参与	备份
spacesUsers	用户与空间的成员关系	业务运行数据	仅结构	不参与	备份

应用监管

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
apps	应用监控插件管理的应用条目	业务运行数据	仅结构	不参与	备份

主数据源

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
collectionCategories	业务集合在界面上的分组归类	系统基础数据	覆盖	参与	备份
collections	业务集合的字段、索引与元配置	系统基础数据	覆盖	参与	备份
fields	集合下各字段的类型与约束说明	系统基础数据	覆盖	参与	备份

数据源管理

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
dataSources	主库或外部数据库连接配置	系统基础数据	覆盖	参与	备份
dataSourcesCollections	外部源中的表/集合同步映射	系统基础数据	覆盖	参与	备份
dataSourcesFields	外部字段与 NocoBase 字段映射	系统基础数据	覆盖	参与	备份
dataSourcesRoles	数据源级的访问角色	系统基础数据	覆盖	参与	备份
dataSourcesRolesResources	角色可访问的集合/操作	系统基础数据	覆盖	参与	备份
dataSourcesRolesResourcesActions	允许的具体动作，如增删改查	系统基础数据	覆盖	参与	备份
dataSourcesRolesResourcesScopes	行级或筛选范围限制	系统基础数据	覆盖	参与	备份

外部数据库连接

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
databaseServers	可供连接的数据库实例登记信息	系统基础数据	覆盖	参与	备份

可视化数据建模

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
graphPositions	流程/图编辑器上节点的位置缓存	系统基础数据	覆盖	参与	备份

中国行政区字段

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
chinaRegions	省市区等地理数据字典	业务运行数据	仅结构	不参与	备份

自动编码字段

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
sequences	自增业务编号的序列表	系统基础数据	覆盖	参与	备份

UI Schema

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
uiButtonSchemasRoles	按钮权限与角色的关联	系统基础数据	覆盖	参与	备份
uiSchemaServerHooks	服务端对 UI 配置的钩子扩展点	系统基础数据	覆盖	参与	备份
uiSchemaTemplates	可复用的表单/详情布局片段	系统基础数据	覆盖	参与	备份
uiSchemaTreePath	组件树层级物化路径，加速查询	系统基础数据	覆盖	参与	备份
uiSchemas	页面与区块的 JSON 布局描述	系统基础数据	覆盖	参与	备份

UI 模板

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
flowModelTemplateUsages	哪些实体实例化了某流程模板	系统基础数据	覆盖	参与	备份
flowModelTemplates	可复用的流程结构模板	系统基础数据	覆盖	参与	备份

Flow engine

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
flowModelTreePath	流程模型树形结构的物化路径，加速查询	系统基础数据	覆盖	参与	备份
flowModels	新版流程编排的模型定义（节点与连线）	系统基础数据	覆盖	参与	备份
flowSql	流程中执行的 SQL 片段或脚本登记	系统基础数据	覆盖	参与	备份

区块模板

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
blockTemplateLinks	页面与区块模板之间的引用关系	系统基础数据	覆盖	参与	备份
blockTemplates	可复用的界面区块片段定义	系统基础数据	覆盖	参与	备份

iframe 区块

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
iframeHtml	嵌入式 iframe 所需 HTML 配置	系统基础数据	覆盖	参与	备份

移动端

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
mobileRoutes	移动应用菜单与路由	系统基础数据	覆盖	参与	备份

主题编辑器

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
themeConfig	明暗色与品牌色等界面主题	系统基础数据	覆盖	参与	备份

地图区块

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
mapConfiguration	地图控件的中心、缩放与底图等配置	系统基础数据	覆盖	参与	备份

公开表单

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
publicForms	免登录可填的外部表单配置与提交记录索引	系统基础数据	覆盖	参与	备份

模板打印

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
printingTemplates	列表或详情的打印版式模板	系统基础数据	覆盖	参与	备份

ACL

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
roles	权限集合的角色定义	系统基础数据	覆盖	参与	备份
rolesResources	角色被授权访问的资源项	系统基础数据	覆盖	参与	备份
rolesResourcesActions	在资源上允许的动作，如 view、update	系统基础数据	覆盖	参与	备份
rolesResourcesScopes	角色可见的数据过滤范围	系统基础数据	覆盖	参与	备份
rolesUsers	用户与角色的多对多绑定	业务运行数据	仅结构	不参与	备份

认证

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
authenticators	密码、第三方等登录方式的配置	系统基础数据	覆盖	参与	备份
tokenControlConfig	会话长度、刷新策略等	系统基础数据	覆盖	参与	备份
issuedTokens	登录或 API 下发的访问令牌记录	业务运行数据	仅结构	不参与	备份
tokenBlacklist	已注销或强制失效的令牌列表	业务运行数据	仅结构	不参与	备份
usersAuthenticators	用户与各认证方式的绑定关系	业务运行数据	仅结构	不参与	备份

双因素认证

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
twoFactorAuthSettings	2FA 方式与用户级开关	系统基础数据	覆盖	参与	备份

API keys

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
apiKeys	开放 API 访问用的密钥与权限范围	业务运行数据	仅结构	不参与	备份

密码策略

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
passwordPolicy	复杂度、有效期等密码安全策略	系统基础数据	覆盖	参与	备份
lockedUsers	因策略被临时锁定的账号记录	业务运行数据	仅结构	不参与	备份
userPasswordHistory	防止重复使用的最近密码摘要	业务运行数据	仅结构	不参与	备份

IP 限制

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
ipRestrictionConfig	允许或禁止访问的 IP 规则	系统基础数据	覆盖	参与	备份

用户

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
users	登录账号、资料与基础状态	业务运行数据	仅结构	不参与	备份

部门

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
departments	组织架构中的部门树	业务运行数据	覆盖	不参与	备份
departmentsRoles	部门与默认角色绑定	业务运行数据	覆盖	不参与	备份
departmentsUsers	用户所属部门关系	业务运行数据	仅结构	不参与	备份

用户数据同步

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
userDataSyncSources	外部身份源或账户体系连接配置	系统基础数据	覆盖	参与	备份
userDataSyncRecords	一次同步任务的执行记录	业务运行数据	仅结构	不参与	备份
userDataSyncRecordsResources	同步任务涉及的表或资源项	业务运行数据	仅结构	不参与	备份
userDataSyncTasks	同步任务记录	业务运行数据	仅结构	不参与	备份

工作流

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
flow_nodes	工作流节点	系统基础数据	覆盖	参与	备份
workflows	自动化流程图、触发器与节点配置	系统基础数据	覆盖	参与	备份
jobs	工作流执行过程中，每个节点的执行结果	业务运行数据	仅结构	不参与	备份
executions	一次工作流运行的状态、输入输出与日志索引	业务运行数据	仅结构	不参与	备份
userWorkflowTasks	各个用户不同类型待办的统计数量	业务运行数据	仅结构	不参与	备份
workflowCategories	工作流在界面上的分组	业务运行数据	覆盖	不参与	备份
workflowCategoryRelations	工作流与分类的多对多关系	业务运行数据	覆盖	不参与	备份
workflowStats	运行次数、成功率等汇总指标	业务运行数据	仅结构	不参与	备份
workflowTasks	各类自动化节点的任务执行记录	业务运行数据	仅结构	不参与	备份
workflowVersionStats	按版本的执行与性能统计	业务运行数据	仅结构	不参与	备份

工作流审批

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
approvalAudienceUsers	审批受众与具体用户的关联	业务运行数据	仅结构	不参与	备份
approvalAudiences	按角色或用户分组的审批通知/参与范围	业务运行数据	仅结构	不参与	备份
approvalExecutions	一次审批流的运行状态与当前节点	业务运行数据	仅结构	不参与	备份
approvalMsgTpls	审批通知、待办等消息模板内容	业务运行数据	覆盖	不参与	备份
approvalRecords	个人视角的审批任务与处理结果	业务运行数据	仅结构	不参与	备份
approvals	审批流模板与步骤配置	业务运行数据	仅结构	不参与	备份

工作流人工节点

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
workflowManualTasks	需要人工处理的手工节点任务	业务运行数据	仅结构	不参与	备份

工作流抄送

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
workflowCcTasks	仅抄送、不需办理的待阅事项	业务运行数据	仅结构	不参与	备份

通知管理

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
notificationChannels	站内信、邮件等投递渠道配置	系统基础数据	覆盖	参与	备份
notificationSendLogs	每条通知的投递状态与失败原因	业务运行数据	仅结构	不参与	备份

站内信

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
notificationInAppMessages	用户收到的应用内消息	业务运行数据	仅结构	不参与	备份

验证

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
verifiers	谁可以发起或完成核验的配置	系统基础数据	覆盖	参与	备份
otpRecords	短信/邮件 OTP 的发放与校验记录	业务运行数据	仅结构	不参与	备份
usersVerifiers	用户与核验渠道或实体的绑定	业务运行数据	仅结构	不参与	备份

邮件管理

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
mailGeneralSettings	全局邮件行为与默认值	系统基础数据	覆盖	参与	备份
mailSettings	邮件插件级开关与参数	系统基础数据	覆盖	参与	备份
mailAccounts	发信邮箱账号与 SMTP 配置	业务运行数据	覆盖	不参与	备份
mailMassMessages	群发任务与收件批次	业务运行数据	仅结构	不参与	备份
mailMessageLabels	邮件分类标签定义	业务运行数据	仅结构	不参与	备份
mailMessageNotes	单封邮件的内部备注	业务运行数据	仅结构	不参与	备份
mailMessages	已同步或发送的邮件内容索引	业务运行数据	仅结构	不参与	备份
mailTemplates	通知类邮件的 HTML/文本模板	业务运行数据	仅结构	不参与	备份
mailmessagelabelsMailmessages	邮件与多对多标签的中间关系	业务运行数据	仅结构	不参与	备份
mailmessagelabelsMailmessagesRel	邮件标签关联的辅助字段或扩展表	业务运行数据	仅结构	不参与	备份

AI

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
aiEmployees	数字员工档案：昵称、技能、模型与知识库等配置	系统基础数据	覆盖	参与	备份
aiSettings	AI 基础设置	系统基础数据	覆盖	参与	备份
rolesAiEmployees	AI 员工角色关系	系统基础数据	覆盖	参与	备份
llmServices	对接的 LLM 供应商与模型端点配置	系统基础数据	覆盖	参与	备份
aiContextDatasources	为 AI 员工配置可查询的业务集合、字段与过滤条件	业务运行数据	仅结构	不参与	备份
aiConversations	单次会话与话题、消息线索等对话上下文	业务运行数据	仅结构	不参与	备份
aiFiles	AI 插件产生的上传文件与存储引用	业务运行数据	仅结构	不参与	备份
aiMessages	对话中的用户与助手消息内容	业务运行数据	仅结构	不参与	备份
aiToolMessages	Function / 工具调用的请求与返回记录	业务运行数据	仅结构	不参与	备份
usersAiEmployees	用户自定义提示词与AI 员工的关系表	业务运行数据	仅结构	不参与	备份
lcCheckpointBlobs	大模型对话检查点的二进制块	运行态临时数据	仅结构	不参与	不备份
lcCheckpointWrites	检查点增量写入记录	运行态临时数据	仅结构	不参与	不备份
lcCheckpoints	可恢复对话的 LangGraph 检查点元信息	运行态临时数据	仅结构	不参与	不备份

AI 知识库

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
aiKnowledgeBaseDocs	已入库的文档切片与索引元数据	业务运行数据	仅结构	不参与	备份
aiKnowledgeBase	知识库类型、外部 ID 与基础信息	业务运行数据	仅结构	不参与	备份
aiVectorDatabases	向量数据库服务与连接配置	业务运行数据	仅结构	不参与	备份
aiVectorStoreConfig	向量数据库连接和文本嵌入模型关联关系	业务运行数据	仅结构	不参与	备份

环境变量

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
environmentVariables	部署相关的键值，如密钥占位名	系统基础数据	仅结构	参与	备份

迁移管理

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
migrationRules	迁移管理器中的规则与作用范围配置	系统基础数据	仅结构	参与	备份

备份管理

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
backupSettings	自动备份策略与保留策略	业务运行数据	覆盖	不参与	备份

审计日志

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
auditTrails	谁在何时对哪些资源做了操作的追踪	业务运行数据	仅结构	不参与	备份

异步任务

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
asyncTasks	长时间任务的队列、状态与结果	业务运行数据	仅结构	不参与	备份

记录历史

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
recordHistoryCollections	启用字段留痕的集合登记	系统基础数据	覆盖	参与	备份
recordHistoryFields	需要记录历史的字段列表	系统基础数据	覆盖	参与	备份
recordHistoryTemplate	历史记录在界面上的展示模板	系统基础数据	覆盖	参与	备份
recordFieldHistories	某字段历次修改的值与时间线	业务运行数据	仅结构	不参与	备份
recordFieldSnapshots	某时间点字段值的快照存证	业务运行数据	仅结构	不参与	备份
recordHistories	整条记录的版本化变更记录	业务运行数据	仅结构	不参与	备份

文件管理

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
storages	本地、S3、OSS 等存储桶配置	系统基础数据	覆盖	参与	备份
attachments	业务记录关联的文件附件元数据	业务运行数据	仅结构	不参与	备份

本地化

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
localizationTexts	待翻译的键与默认文案	系统基础数据	覆盖	参与	备份
localizationTranslations	各语言实际翻译内容	系统基础数据	覆盖	参与	备份

本地化测试

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
localeTester	本地化调试或测试用词条	业务运行数据	仅结构	不参与	备份

自定义请求

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
customRequests	自定义 HTTP 请求动作与 URL、方法配置	系统基础数据	覆盖	参与	备份
customRequestsRoles	哪些角色可调用哪些自定义请求	系统基础数据	覆盖	参与	备份

自定义变量

数据表	说明	数据类型	迁移管理默认策略	版本控制	备份还原
customVariables	流程或全局可用的变量定义与默认值	系统基础数据	覆盖	参与	备份

用户自定义表

用户自定义表默认按业务数据处理。多数情况下，只需要迁移表结构，选择仅结构。

如果用户自定义表用于承载业务配置、分类、模板、规则等元数据，并且这些记录应随发布从开发环境同步到预发布或生产环境，可以根据业务场景选择覆盖。

如果用户自定义表保存的是客户、订单、工单、审批记录、消息、日志等运行数据，应避免覆盖生产环境中的记录。