应用和主要插件内置表

介绍

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

三类机制关注点不同:

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

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

内置表参考

Database

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

Server

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

系统设置

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

客户端

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

多空间

数据表说明数据类型迁移管理默认策略版本控制备份还原
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用户与各认证方式的绑定关系业务运行数据仅结构不参与备份

双因素认证

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

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数字员工档案:昵称、技能、模型与知识库等配置系统基础数据覆盖参与备份
aiSettingsAI 基础设置系统基础数据覆盖参与备份
rolesAiEmployeesAI 员工角色关系系统基础数据覆盖参与备份
llmServices对接的 LLM 供应商与模型端点配置系统基础数据覆盖参与备份
aiContextDatasources为 AI 员工配置可查询的业务集合、字段与过滤条件业务运行数据仅结构不参与备份
aiConversations单次会话与话题、消息线索等对话上下文业务运行数据仅结构不参与备份
aiFilesAI 插件产生的上传文件与存储引用业务运行数据仅结构不参与备份
aiMessages对话中的用户与助手消息内容业务运行数据仅结构不参与备份
aiToolMessagesFunction / 工具调用的请求与返回记录业务运行数据仅结构不参与备份
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流程或全局可用的变量定义与默认值系统基础数据覆盖参与备份

用户自定义表

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

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

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