Beancount client
Query sổ cái dưới dạng table SQL chỉ đọc, hoặc bằng BQL qua rledger, và sửa sổ cái trong text editor của bạn.
Tóm tắt
- Ngôn ngữ query
- SQL
- Driver
- Tải về ở lần dùng đầu
- Cách kết nối
- Một file


Mở sổ cái
Cài rledger hoặc Python Beancount. rledger được ưu tiên khi có cả hai, và chỉ rledger hỗ trợ BQL và kết quả kiểm tra trong diagnostics.
Chọn sổ cái bằng Duyệt… (Browse…) hoặc mở file .beancount từ Finder: đường dẫn là toàn bộ connection, và import được URL beancount:///path/to/main.beancount. Ứng dụng mở từ Finder không kế thừa PATH của shell, nên nếu backend chạy được trong Terminal mà không chạy được ở đây, hãy chỉ tới nó bằng launchctl setenv TABLEPRO_RUSTLEDGER_BINARY hoặc TABLEPRO_BEANCOUNT_PYTHON rồi mở lại ứng dụng.
Backend Python chạy các plugin đi kèm Beancount và bỏ qua mọi chỉ thị plugin khác, vốn là mã của bên thứ ba, cho tới khi bạn bật Chạy plugin sổ cái (Run Ledger Plugins) cho connection đó. Các plugin bị bỏ qua được liệt kê trong diagnostics.
Query sổ cái
Transaction, posting, account, balance, price, directive, metadata và file nguồn đều là table: join posting với transaction qua transaction_id, và account theo tên. Số tiền đã qua bước booking, với phép tính, giá vốn (cost) và giá (price) đã được tính xong, còn giá vốn của posting và giá ghi kèm nằm ở các cột riêng.
Transaction, posting và một số table chỉ thị có cột source_location như main.beancount:42, nên mỗi dòng dẫn ngược về đúng dòng trong file. Thêm tiền tố BQL: vào query để gửi nó tới rledger; duyệt, đếm dòng và phân trang dùng được trên kết quả, còn tham số SQL thì không.
Các chỉ thị include đều được đọc theo, cả đường dẫn cụ thể lẫn glob, và mọi file sổ cái cùng tài liệu được tham chiếu đều được theo dõi, nên query kế tiếp đọc được thay đổi đã lưu mà không cần kết nối lại. Connection luôn ở mức Safe Mode Read-Only: INSERT, UPDATE, DELETE và thay đổi schema đều bị từ chối.
Trang này chỉ nói về những gì riêng của Beancount. Safe Mode, trợ lý AI, MCP server và phần còn lại của TablePro nằm ở các trang tính năng.
Ngoài ra
Di chuyển dữ liệu
Export table hoặc kết quả query ra CSV, JSON, SQL, XLSX, Markdown, HTML và XML. Các loại file khác mà TablePro mở như cơ sở dữ liệu gồm SQLite, DuckDB và Parquet.
Giới hạn
- Khi mở sổ cái, TablePro đọc nó thành 23 table SQL chỉ đọc. Không có gì được ghi ngược vào sổ cái.
- Cần cài rledger hoặc Python beancount trên máy Mac này.
Sổ cái có lỗi thì còn mở được không?
Qua rledger thì được. Sổ cái vẫn được dựng thành table ngay cả khi kiểm tra thất bại, và mỗi vấn đề là một dòng trong
diagnostics, kèm file, dòng, mức độ và thông báo.Một connection có mở được nhiều sổ cái không?
Mỗi connection là một file sổ cái, không chuyển qua lại được. Một file chính include các file còn lại sẽ đưa tất cả vào, kể cả qua glob.
Tải TablePro
Mọi tính năng trên trang này đều miễn phí.