概览
- 查询语言
- SQL
- 驱动
- 首次使用时下载
- 连接方式
- 文件


打开账本
安装 rledger 或 Python Beancount。两者都有时优先使用 rledger,且只有 rledger 支持 BQL 和 diagnostics 中的验证输出。
通过 浏览… (Browse…) 选择账本,或从 Finder 打开 .beancount 文件:路径就是连接的全部内容,也可导入 beancount:///path/to/main.beancount URL。从 Finder 打开的应用不会继承您 shell 的 PATH,因此如果后端在 Terminal 中能运行,在这里却不能,请用 launchctl setenv TABLEPRO_RUSTLEDGER_BINARY 或 TABLEPRO_BEANCOUNT_PYTHON 指定它,然后重新启动应用。
Python 后端会运行 Beancount 附带的插件,并跳过其他 plugin 指令(它们属于第三方代码),直到您为该连接开启 运行账本插件 (Run Ledger Plugins)。跳过的插件会列在 diagnostics 中。
查询账本
交易、分录、账户、余额、价格、指令、元数据和源文件都是表:按 transaction_id 联接分录与交易,按名称联接账户。金额以记账后的形式返回,算术、成本和价格均已解析,分录成本和行内价格有各自的列。
交易、分录和若干指令表带有 source_location,例如 main.beancount:42,因此每行都能追溯到其源文件行。在查询前加上 BQL: 即可将其发送给 rledger;结果支持浏览、行数和分页,但不支持 SQL 参数。
include 指令会被跟随,具体路径和 glob 均可,所有账本文件和引用的文档都会被监控,因此下次查询无需重新连接即可读取已保存的更改。连接始终处于 Safe Mode Read-Only:INSERT、UPDATE、DELETE 和结构更改都会被拒绝。
本页介绍 Beancount 特有的内容。Safe Mode、AI 助手、MCP 服务器以及 TablePro 的其他功能请见功能页面。
其他
移动数据
将表或查询结果导出为 CSV、JSON、SQL、XLSX、Markdown、HTML 和 XML。TablePro 可作为数据库打开的其他文件包括 SQLite、DuckDB 和 Parquet。
限制
- TablePro 打开账本时,将其读取到 23 张只读 SQL 表中,不会写回账本。
- 需要在此 Mac 安装 rledger 或 Python beancount。
有错误的账本还能打开吗?
通过 rledger 可以。即使验证失败,账本仍会映射为表,每个问题都是
diagnostics中的一行,包含文件、行号、严重程度和消息。一个连接能打开多个账本吗?
一个连接对应一个账本文件,无法切换。如果主文件 include 了其他文件,它们会全部加载,glob 也包括在内。