返回资讯中心
外部精选
软件工程
#开发者实时流

Mason 发布 Postgres 只读副本替代方案,分析查询速度提升 10-50 倍

来源标题:Show HN: A Postgres read-replica, but 10-50x faster for analytical queries

Mason 推出可直接替换 Postgres 只读副本的工具,分析查询速度比原副本快 10-50 倍,SQL 语句与查询结果保持一致。该工具通过 Postgres 协议读取源库,支持表同步与状态查看,官方称查询耗时从分钟级降至秒级。安装需 Node 22.13 以上,并提供了演示数据库和命令行工具方便上手。

Hacker News 最新tagspace2026/11/16 · 昨天30 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

给你的 Postgres 只读副本做个直接替换。同样的 SQL,同样的结果。从几分钟缩短到几秒。

npm i -g @mason-data/cli # 需要 Node 22.13+(运行 mason doctor 检查这台机器)
mkdir mason-demo && cd mason-demo
mason init demo && mason start # 为你启动一个演示商店数据库:无需安装其他东西
mason add order_items # 添加第四张表,这样你能看到它的同步开始
mason ui # 在浏览器中打开 Mason:正在同步的表、用户和查询
mason destroy # 删除已同步的数据和演示数据库

演示商店有四张表:customers、products、orders 和 order_items。每隔几秒就有一笔新订单进来。演示每隔 5 秒轮询一次(sync: poll 5s),所以 mason status 会显示 Mason 跟得上进度。Mason 读取演示数据库的方式和读取你的数据库完全一样:通过 Postgres 协议。演示里还有一张生成表 daily_orders。在大多数机器上,npm install 之后不会下载任何东西(见 cli/README.md)。

设置项目

Mason 项目就是你应用的文件夹。在应用文件夹里运行这些命令:

cd your-app
# Mason 从 .env.local、.env 或 shell 中读取 MASON_DATABASE_URL,然后读取 DATABASE_URL。
mason init # 创建 mason/sources/<database>.yml(提交它)和 .mason/(本地目录,已加入 gitignore)
mason tables # 列出你数据库中的表,以及它们的行数和键
mason add orders customers # 把表添加到 sources 文件
mason start # 在后台启动 Mason 并开始首次同步
mason wait # 等到每一张添加的表都同步完成

把 MASON_DATABASE_URL 设成另一个数据库,就可以同步与你的应用不同的数据库。mason init - < db-url.txt 从文件读取 URL 并写入 .env,不会留在 shell 历史里。mason init 还会写入 mason/roles.yml(访问控制)和 mason/mason.yml(Mason 版本)。提交 mason/ 里的所有内容。

sources 文件列出 Mason 同步的表。mason add 和 mason remove 会替你编辑它,并保留你的注释。

# mason/sources/app.yml:这个项目同步来源的数据库。提交这个文件。URL 不会存储在其中。
kind: postgres
url: ${DATABASE_URL} # 来自 .env.local、.env 或 shell 的变量
sync: off # 每张表的默认值,除非某张表另有说明
tables:
  orders: # 只写名称表示 `public` schema;另一个 schema 写 `billing.invoices`
    columns: [id, customer_id, status, amount, created_at, payload]
    sync: poll 30s # 这张表每 30 秒轮询一次
  customers: {} # 同步所有列
  events:
    exclude: [raw_body] # 同步除这些之外的所有列
  sessions:
    key: [tenant_id, id] # 仅用于没有主键的表:标识一行的列

mason add orders --columns id,status,total 只同步这些列。mason add orders --sync "poll 30s" 设置这张表如何保持最新。

mason add 会略过看起来像密钥的列(password、token、api_key、……),并把它们列在 exclude: 下。用 --include 指定某一列来同步它。

Mason 运行时,mason add 和 mason remove 立即生效。你手动做的修改会在下一次 mason start 时生效。如果某个条目有错误,Mason 会指出是哪个键,并说明如何修复。你永远不需要写列类型。

文件里略过的列会一直保持略过,直到你确认它,即使你在数据库上重命名了它、它所在的表或它所在的 schema。如果手动编辑或重命名会导致这样的列再次被同步,Mason 会挂起那张表,并在 mason status 中该表的行里说明原因。运行 mason add <table> --columns … 那一行给出的命令来同步它。在以只读方式部署的项目中,已提交的文件就是你的授权,那一行会说明在那里该怎么做。

保持它们最新

Mason 会把每张表完整读取一次:首次同步。之后,每张表的 sync: 说明它如何保持最新。

你的数据库保持安全。Mason 只读:它从不写入、从不修改表,也从不要求你的数据库做排序。首次同步最多使用 3 个连接(MASON_COPY_PARALLEL)。如果中断,它会从停止的地方继续。你可以把 Mason 指向只读副本,这样它的查询就在那里运行。Mason 只在同步时连接,或在你要求时连接:mason tables、add、remove、status、wait 或 doctor,或网页打开期间。

关闭。在你运行 mason sync orders(或 --all)之前,Mason 不再读取任何数据:在生成报告前、在 cron 中,或在部署结束时。

轮询。写 sync: poll <interval>,从 1s 到 24h。你在 Postgres 上不需要做任何设置。每次轮询都会读取整张表,因为 Postgres 没有针对变更内容的索引。所以选择适合表大小的间隔:小表每隔几秒,5000 万行的表每小时。每次轮询后,Mason 至少等待轮询耗时的四倍时间,因此一张表的轮询永远不会占用你数据库超过五分之一的时间。当你的文件默认使用轮询时,mason add 会为超过 100 万行的表写入 sync: off,并说明原因。

逻辑复制。写 sync: replication。Mason 通过每个项目一个 replication slot 读取变更日志,就像 Postgres 副本一样。

如果你更改一张表的 sync:,Mason 会保留它的数据,并用一次轮询把它追上。docs/DESIGN.md 解释了每种方式如何工作,以及为什么。

用哪个命令取决于工具运行在哪里:

mason user add metabase # 能访问这台机器的工具:打印一个连接 URL(只显示一次)
mason share # 云端的工具:打印一个临时地址和登录信息(Ctrl-C 结束)

把打印出来的内容粘贴到你工具的 Postgres 连接表单里。每张已同步的表都会出现在一个名为 mason 的数据库中,作为一张表。要迁移一个读取你 Postgres 的工具,改变它的 host、port 和数据库名,或者在 sources 文件中用 database: <name> 保留名称。

用户的密码会一直有效,直到你移除该用户。mason share 用于在你可以通过免费隧道服务发送的数据上,用云端 BI 工具试用 Mason。它是加密的,但工具不会验证证书,而且大约持续一小时。网页的用户页面把它作为「临时云端登录」提供。要让仪表板持续运行,请在服务器上运行 Mason。

docs/POSTGRES-API.md 解释了工具如何连接,以及 Mason 会响应哪些 SQL。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →