Beancount クライアント
台帳を読み取り専用の SQL テーブルとして、または rledger 経由の BQL でクエリできます。台帳の編集はお使いのテキストエディターで行います。
概要
- クエリ言語
- SQL
- ドライバー
- 初回使用時にダウンロード
- 接続方法
- ファイル


台帳を開く
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 も含めてすべて取り込めます。