概覽
- 查詢語言
- SQL
- 驅動程式
- 首次使用時下載
- 連線方式
- 檔案


開啟帳本
安裝 rledger 或 Python Beancount。兩者都存在時優先使用 rledger,且只有 rledger 支援 BQL 和 diagnostics 中的驗證輸出。
以 瀏覽… (Browse…) 選擇帳本,或從 Finder 開啟 .beancount 檔案:路徑就是整個連線,也可匯入 beancount:///path/to/main.beancount URL。從 Finder 開啟的 App 不會繼承 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。