一.简介
Flowable 默认一共生成了 79 张数据表,了解这些数据表,有助于我们更好的理解 Flowable 中的各种 API。
接下来我们就对这 79 张表进行一个简单的分类整理。
- ACT_APP_*(5)
- ACT_CMMN_*(12)
- ACT_CO_*(3)
- ACT_DMN_*(6)
- ACT_EVT_*(1)
- ACT_FO_*(6)
- ACT_GE_*(2)
- ACT_HI_*(10)
- ACT_ID_*(9)
- ACT_PROCDEF_*(1)
- ACT_RE_*(3)
- ACT_RU_*(13)
- FLW_CHANNEL_*(1)
- FLW_EV_*(2)
- FLW_EVENT_*(3)
- FLW_RU_*(2)
- 是通配符,后面的数字表示这种类型的表有多少个。
大致看一下,其实还是有很多规律的。最明显的规律就表名通过两个 _ 隔开成了三部分,接下来就以此,一部分一部分来讲。
二.表名前缀
表的前缀,分了两种:
- ACT_
- FLW_
具体来说,与 Flowable 开源代码库相关的数据库表名以 ACT_ 开头。特定于 Flowable Work 或 Engage 的数据库表以 FLW_ 前缀开头。
三.表名中间部分
紧跟着 ACT_ 或者 FLW_ 后面的内容,基本上也都是简称,例如:
- APP 表示这都是跟应用程序相关的表。
- CMMN 表示这都是跟 CMMN 协议相关的表。
- CO(CONTENT)表示这都是跟内容引擎相关的表。
- DMN 表示这都是跟 DMN 协议相关的表。
- EVT(EVENT)表示这都是跟事件相关的表。
- FO(FORM)表示这都是跟表单相关的表。
- GE(GENERAL)表示这都是通用表,适用于各种用例的。
- HI(HISTORY)这些是包含历史数据的表。当从运行时表中删除数据时,历史表仍然包含这些已完成实例的所有信息。
- ID(IDENTITY)表示这都是跟用户身份认证相关的表。
- PROCDEF(PROCESSDEFINE) 表示这都是跟记录流程定义相关的表。
- RE(REPOSITORY)表示这都是跟流程的定义、流程的资源等等包含了静态信息相关的表。
- RU(RUNTIME)代表运行时,这些是包含尚未完成的流程、案例等的运行时数据的运行时表。Flowable 仅在执行期间存储运行时数据,并在实例结束后删除记录,这使运行时表保持小而快。
- CHANNEL 表示这都是跟泳道相关的表。
- EV 表示这个是跟 FLW_ 搭配的,在这里似乎并没有一个明确的含义,相关的表也都是跟 Liquibase 相关的表。
- EVENT 表示这都是跟事件相关的表。
表名是由三部分构成的,我们现在已经分析了前两部分了,接下来我们来看第三部分。
三.表名后缀
表名的后缀,有一些是通用的后缀名词,例如:
- DATABASECHANGELOG:
表名中包含这个单词的,表示这个表是 Liquibase 执行的记录,Liquibase 是一个数据库脚本管理的工具。包含 DATABASECHANGELOG 后缀的表一共是 6 张。 - DATABASECHANGELOGLOCK:
表名中包含这个单词的,表示这个表记录 Liquibase 执行锁的,用以确保一次只运行一个 Liquibase 实例,包含 DATABASECHANGELOGLOCK 后缀的表也是 6 张。
这两个加起来就 12 张表了,一共 79 张,现在还剩 67 张,我们来详细看下。
在后面的介绍中,凡是涉及到 DATABASECHANGELOG 和 DATABASECHANGELOGLOCK 的表,就直接省略了。
3.1 ACT_APP_*
3.2 ACT_CMMN_*
3.3 ACT_DMN_*
前三点看前一篇文章,这边就不会赘叙。
3.4 ACT_RU_*
以 ACT_RU_ 开头的表都是和流程引擎运行时信息相关的一些表。涉及到的表一共有 13 张,截图如下:
ACT_RU_ACTINST
流程实例中的每个活动在此表中都有一行来指示活动的当前状态。
- ACT_RU_JOB
- ACT_RU_TIMER_JOB
- ACT_RU_SUSPENDED_JOB
- ACT_RU_EXTERNAL_JOB
- ACT_RU_HISTORY_JOB
- ACT_RU_DEADLETTER_JOB
Flowable 引擎使用作业表来实现异步逻辑、计时器或历史处理。这些表存储每个作业所需的数据。
ACT_RU_ENTITYLINK
此表存储有关实例的父子关系的信息。例如,如果流程实例启动子案例实例,则此关系存储在此表中。这样可以轻松查询关系。
ACT_RU_EVENT_SUBSCR
当流程定义使用事件(信号/消息/等或启动/中间/边界)时,引擎将对该表的引用存储在该表中。这简化了查询哪些实例正在等待某种类型的事件。
ACT_RU_EXECUTION
存储流程实例和指向流程实例当前状态的指针(称为执行)。
ACT_RU_IDENTITYLINK
此表存储有关用户或组的数据及其与(流程/案例/等)实例相关的角色。该表也被其他需要身份链接的引擎使用。
ACT_RU_TASK
此表包含正在运行的实例的每个未完成用户任务的条目。然后在查询用户的任务列表时使用此表。CMMN 引擎也使用此表。
ACT_RU_VARIABLE
此表存储与实例相关的变量。CMMN 引擎也使用此表。
3.5 ACT_HI_*
以 ACT_HI_* 开头的表包含正在运行和已完成的实例的历史数据,这些表的名称遵循其运行时对应的名称,这里一共涉及到 10 张表,截图如下:
ACT_HI_ACTINST
历史活动信息。这里记录流程流转过的所有节点,与 ACT_HI_TASKINST 不同的是, ACT_HI_TASKINST 只记录 Task 内容。
ACT_HI_ATTACHMENT
历史附件表。
ACT_HI_COMMENT
流程的历史评论表。
ACT_HI_DETAIL
历史详情表:流程中产生的变量详细,包括控制流程流转的变量,业务表单中填写的流程需要用到的变量等。
ACT_HI_ENTITYLINK
历史参与的人员表。
ACT_HI_IDENTITYLINK
任务参与者数据表,主要存储历史节点参与者的信息,可能是 Group 也可能是 User。
ACT_HI_PROCINST
保存每一个历史流程,创建时就生成,一条流程实例对应一个记录。
ACT_HI_TASKINST
记录每一个历史节点,一个 Task 对应一个记录。
ACT_HI_TSK_LOG
每一次执行可能会带上数据,存在这里。
ACT_HI_VARINST
流程历史变量表。
3.6 ACT_ID_*
以 ACT_ID_* 开头的都是和用户身份相关的表,一共是有 9 张表,截图如下:
ACT_ID_BYTEARRAY
这是用户组的部署内容。
ACT_ID_GROUP
这是用户组的表。
ACT_ID_INFO
这是所有的用户的信息,账号密码。
ACT_ID_MEMBERSHIP
用户和用户组的关联表。
ACT_ID_PRIV
权限表。
ACT_ID_PRIV_MAPPING
用户、用户组以及权限之间的关联表。
ACT_ID_PROPERTY
用户的变量表。
ACT_ID_TOKEN
用户访问记录表。
ACT_ID_USER
用户表。
3.7 ACT_FO_FORM_*
以 ACT_FO_FORM_ 开头的表存储表单引擎和围绕表单模型和这些表单的实例数据。
ACT_FO_FORM_DEFINITION
表单定义表。
ACT_FO_FORM_DEPLOYMENT
表单部署表。
ACT_FO_FORM_INSTANCE
表单实例表。
ACT_FO_FORM_RESOURCE
表单源数据表。
3.8 ACT_GE_*
以 ACT_GE_ 开头的表表示一些通用信息表,涉及到的表一共是两个,截图如下:
ACT_GE_BYTEARRAY
存储每个流程的部署记录,bytes_ 字段中保存流程的具体内容。
ACT_GE_PROPERTY
存储 Flowable 自身的一些变量,主要是版本号。
3.9 ACT_RE_*
以 ACT_RE_ 开头的表表示这些表都是跟流程的定义、流程的资源等等包含了静态信息相关的表。
ACT_RE_DEPLOYMENT
流程部署记录,每次服务重启会部署一次,这里会新增一条记录。
ACT_RE_MODEL
创建模型时,额外定义的一些模型相关信息,存在这张表,默认不保存。
ACT_RE_PROCDEF
记录流程的变更,流程每变更一次存一条记录,version_ 字段加 1。
3.10 FLW_EVENT_*
FLW_EVENT_DEFINITION
已部署事件定义的元数据。
FLW_EVENT_DEPLOYMENT
已部署事件部署元数据。
FLW_EVENT_RESOURCE
事件所需资源。
3.11 其他表
还剩一些规则不太明显的表,如下:
FLW_RU_BATCHFLW_RU_BATCH_PART
这两个是批量迁移流程时使用。
ACT_PROCDEF_INFO
流程定义信息,对流程的说明。
ACT_CO_CONTENT_ITEM
每项内容在此表中都有个条目。
ACT_EVT_LOG
Flowable 引入了事件日志机制,默认会在数据库中创建 ACT_EVT_LOG 表保存事件日志,如果不使用事件日志,则可以删除这个表。
FLW_CHANNEL_DEFINITION
泳池管道定义表。