数据库结构
当前 schema 版本为 12。PostgreSQL 全新安装的权威最小脚本位于:
text
scripts/postgresql/init.sql脚本下载、校验和执行方式见部署说明。
已有数据库通过方言对应的增量脚本迁移。核心兼容版本保持 12;1.2.1 的 additive feature migration 为 v21.sql:
text
stores/jdbc/src/main/resources/com/firefly/store/jdbc/schema/migrations/h2/v21.sql
stores/jdbc/src/main/resources/com/firefly/store/jdbc/schema/migrations/postgresql/v21.sql
stores/jdbc/src/main/resources/com/firefly/store/jdbc/schema/migrations/mysql/v21.sql表职责
| 表 | 职责 |
|---|---|
firefly_schema_version | 记录已安装的 schema 版本 |
firefly_cluster_metadata | 保存 scheduler shard 数等集群不变量 |
firefly_node | Server 节点、角色、注册时间、心跳和在线状态 |
firefly_shard_lease | Scheduler 分片所有权、租约和 fencing token |
firefly_executor | 可持久化的逻辑执行器定义 |
firefly_job_group | 任务组、默认执行器绑定、元数据和启停状态 |
firefly_job | 任务定义、调度游标、分发策略和持久化 shard id |
firefly_execution | 一次执行 attempt 的父记录和聚合状态 |
firefly_execution_target | 单播、广播或分片产生的目标子执行 |
firefly_dispatch_outbox | 可靠派发队列、角色路由、ACK 超时和重试状态 |
firefly_executor_instance_location | Executor 实例所在 Gateway 和 session fencing |
firefly_audit_log | Admin 变更审计 |
firefly_job_history | 任务创建、启停和删除历史 |
firefly_user | Admin 账号、PBKDF2 密码摘要、角色、首次改密状态和版本 |
firefly_integration_key | Integration Key 的 PBKDF2 摘要和轮换版本 |
firefly_tenant_policy | 版本化租户权重、启停状态和五类资源上限 |
firefly_tenant_usage | 权威并发、CPU、内存、backlog 和触发窗口用量 |
firefly_tenant_reservation | 幂等准入 reservation 与恢复租约 |
firefly_dispatch_fairness_state | 持久化租户虚拟完成时间与全局公平时钟 |
firefly_tenant_capacity_sample | 五分钟容量桶、版本范围、资源峰值、触顶与拒绝计数 |
firefly_tenant_capacity_flush | source/bucket flush 幂等键 |
初始化模式
开发和本地部署可以使用:
properties
firefly.jdbc.schema.mode=initialize-if-empty生产环境由外部迁移系统管理时可以使用:
properties
firefly.jdbc.schema.mode=validateinitialize-if-empty 会检查当前状态并按顺序执行缺失的核心与 feature migration。validate 只检查,不修改数据库。完成外部迁移后,firefly_schema_version 必须包含核心版本 12,并安装 v20 租户治理表和 v21 容量样本表。v21 只新增表,允许 1.2.0 与 1.2.1 滚动共存。