@godspideai/ cognate- store- postgres (英语)
PostgreSQL 上用于Cognate应用的持久,交易事件存储. 多个进程 安全地写入同一个数据库:位置命令等于承诺命令,发件箱主张是原子 整个工人, 和投影折叠序列 通过检查站.
何时使用此软件包 : 需要多个运行过程(或主机)的应用程序
权威存储或数据库,您可以备份、监视和操作普通的 PostgreSQL
用于工具。 使用
@godspeedai/cognate-store-sqlite
用于零依赖性单进程文件,或
@godspeedai/cognate-store-memory
测试。 三个都一样 @godspeedai/cognate-events 商店合同,所以一个应用程序
可以用一行切换商店.
安装
bun add @godspeedai/cognate-store-postgres
要求数 阿宝 * 1.4.0和一个PostgreSQL服务器(PostgreSQL 14或更新;
PostgreSQL 18是测试矩阵运行的内容. 驱动程序 : postgres
(纯JavaScript,无原生建筑).
快开始
import { openPostgresStore } from "@godspeedai/cognate-store-postgres";
const handle = await openPostgresStore({
url: "postgres://postgres:[email protected]:5432/postgres",
schema: "myapp", // tables live in one schema; create one per app or per test
});
const store = handle.store; // a DurableStore — pass to createRuntime or use directly
await store.commit({
appends: [{ streamId: "case-1", expectedVersion: 0, events: [{ /* NewEvent */ }] }],
});
await handle.close();
多进程行为
- 每一个附加事件的承诺 都会在一个位置对接的行上有一个短锁 所以存储 职位分配完全按照各流程的承付顺序进行;记录写作、发包索偿、, 而投影折叠不排在它的后面.
onCommitted听众立即接受当地承诺,其他进程通过LISTEN编号 :NOTIFY加上基于光标的对事件日志的追赶( 带有小的民意调查安全性) 因此,丢失的通知只会延误交货;它永远不会跳过它.claimOutbox用途FOR UPDATE SKIP LOCKED: 并行工人声称工作脱节,没有 等着.- 投影检查点由一排锁加比和相接监视 所以有两名跑者 同样的投影 从来没有重复应用一个批.
说明和限制
- 表格生活在
schema名称( 默认)cognate如果计划不到位,则建立计划 计划迁移的版本和序列跨越各个进程. - Durable 遵循 PostgreSQL 的默认值(
synchronous_commit=on, (中文(简体) ),fsync=on);商店确实 不放松他们. erasePayload将有效载荷删除并保留墓碑信封,作为仓库合同 要求。 PostgreSQL MVCC 将被删除的字节保留在已死的Tuple和WAL中,直到自发真空和 WAL 回收; 运行VACUUM <schema>.payloads(或just db-vacuum当操作员需要 物理页面迅速恢复。 检查站过后WAL区段循环使用max_wal_size这样 在同一时间表上删除了 WAL 时代的字节——将备份和存档 WAL 视为保留 根据你的保留政策,删除内容.- 排序比较( 记录 ID, 投影密钥) 使用字节顺序( )
COLLATE "C",匹配 其他商店的密码点排序.
相关软件包
@godspeedai/cognate——伞形SDK.@godspeedai/cognate-events- 那个 存储合同、事件信封和错误类型.@godspeedai/cognate-runtime-bun- 代理运行时间;通过store: { store }。 。 。 .@godspeedai/cognate-store-sqlite, (中文(简体) ),@godspeedai/cognate-store-memory。 。 。 .
许可证
阿帕奇 - 2.0