SuperAPI AI 工具集

pgflow

测试与质量

查看项目

更新于 10-16 04:59

技能介绍

PgFlow 是面向 Elixir/Phoenix 的 PostgreSQL/PGMQ 工作流引擎,使用 OTP worker 执行任务。资料说明其用途涵盖安装、升级、配置、运行与调试,并支持定义 flow、job、map、条件步骤、重试等。

使用前应先检查使用者已安装的 PgFlow 版本,因为未发布的源码能力可能不存在于已发布的 Hex 包中。按请求类型查阅对应参考文档:安装或引导用 references/bootstrap.md;升级现有数据库用 references/upgrading.md;创建 flow 用 references/flow.md 与 references/flows.md;创建 job 用 references/job.md 与 references/jobs.md;增改步骤用 references/step.md;条件或 fail-soft 步骤用 references/conditional-steps.md;运行时、worker、恢复与清理用 references/operations.md;类型化读取与运维操作用 references/public-api.md;配置用 references/config.md;仪表盘用 references/dashboard-setup.md;LiveView 跟踪用 references/liveview-setup.md;调试运行用 references/debug.md 与 references/public-api.md;上游/测试框架验证用 references/compatibility.md;遥测用 references/telemetry.md。

安全规则包括:逻辑 flow 标识与物理队列标识需分开处理,队列操作使用持久化的 (queue_name, message_id),默认队列路由为小写 flow slug;核心 V02/helpers V05 升级期间不得让新旧 worker 重叠,需暂停生产者、排空、停止所有写入者,在单个事务中先迁移核心再迁移 helpers,验证后部署匹配的调用方;依赖升级后不要指望已应用的 setup 迁移会重跑,应生成新的 mix pgflow.setup --upgrade 包装;升级同时迁移/恢复数据库时,PgFlow schema 正常不代表周期性调度存活,需在源端盘点 cron 状态并在目标端按规范应用配置协调主机拥有的调度;运行 mix pgflow.check_schema,worker 引导只检查运行时关键子集,就绪的 starter 仍可能有永久失败的模块;未经证明数据库契约与历史影响,不得使用运行时破坏性重编译或 mix pgflow.stamp;handler 输出必须可 JSON 编码,保留有效标量(false、0、""、数组和 nil),不要包装无效输出;handler 为至少一次语义,即使步骤后来看似被跳过,副作用也需幂等;核心支持的 LiveView 仪表盘不需要历史仪表盘 SQL 对象。

资料未提供具体收费、价格、平台支持范围或完整安装命令细节,这些内容暂未提供。