本文へスキップ

Beancount クライアント

台帳を読み取り専用の SQL テーブルとして、または rledger 経由の BQL でクエリできます。台帳の編集はお使いのテキストエディターで行います。

概要

クエリ言語
SQL
ドライバー
初回使用時にダウンロード
接続方法
ファイル
Beancount の台帳を開いた Mac 上の TablePro。サイドバーのテーブルと BQL クエリの結果が表示されています。

台帳を開く

rledger または Python Beancount をインストールします。両方ある場合は rledger を優先します。BQL と diagnostics の検証結果に対応するのは rledger のみです。

Browse… で台帳を選ぶか、Finder から .beancount ファイルを開きます。接続情報はパスだけで、beancount:///path/to/main.beancount URL もインポートできます。Finder から起動したアプリはシェルの PATH を引き継ぎません。Terminal では動くバックエンドがここで動かない場合は、launchctl setenv TABLEPRO_RUSTLEDGER_BINARY または TABLEPRO_BEANCOUNT_PYTHON で指定して再起動してください。

Python バックエンドは Beancount 同梱のプラグインを実行しますが、第三者のコードであるその他の plugin 指令は、その接続で Run Ledger Plugins を有効にするまでスキップします。スキップしたプラグインは diagnostics に表示します。

台帳を問い合わせる

取引、仕訳、口座、残高、価格、指令、メタデータ、ソースファイルはテーブルです。仕訳と取引は transaction_id で、口座は名前で結合します。金額は算術、原価と価格を解決した記帳済みの値で届き、仕訳の原価とインライン価格は専用の列に入ります。

取引、仕訳と一部の指令テーブルは main.beancount:42 などの source_location を持つため、行から元の行番号を辿れます。クエリの前に 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 も含めてすべて取り込めます。

TablePro を入手

このページの機能はすべて無料です。