Chuyển đến nội dung chính

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
TablePro trên Mac đang mở một sổ cái Beancount, với các table trong sidebar và kết quả một query BQL.

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í.