Ein Beancount-Journal mit SQL auf Mac abfragen

TablePro führt rledger oder Python Beancount aus, um das Journal zu lesen. Wenn du eines auswählen musst, installiere rledger: Es hat Vorrang, wenn beide vorhanden sind, nur damit läuft BQL, und nur rledger füllt die Tabelle diagnostics mit Validierungsergebnissen.

Wähle die Datei mit Durchsuchen… im Verbindungsformular. Der Journalpfad ist die gesamte Verbindung, ohne Host, Port, Passwort oder Datenbank. Eine .beancount-Datei öffnet sich auch aus dem Finder, und beancount:///path/to/main.beancount-URLs lassen sich importieren.

Eine aus dem Finder geöffnete App übernimmt den PATH deiner Shell nicht. Läuft das Backend im Terminal, aber nicht hier, gib es mit launchctl setenv TABLEPRO_RUSTLEDGER_BINARY oder TABLEPRO_BEANCOUNT_PYTHON an und starte die App neu.

Das Python-Backend führt die mit Beancount gelieferten Plugins aus und überspringt jede andere plugin-Direktive, da sie Drittanbietercode ist, bis du Journal-Plugins ausführen für diese Verbindung aktivierst. Übersprungene Plugins werden in diagnostics aufgelistet.

Die Tabellen decken Transaktionen und Buchungen, Konten, Salden und Saldenprüfungen, Preise und Commodities, alle anderen Direktiven, Metadaten, Tags und Links sowie Quelldateien ab. Buchungen werden über transaction_id mit Transaktionen verknüpft, Konten über ihren Namen.

Beträge sind bereits verbucht, mit aufgelöster Arithmetik, Kosten und Preisen; Buchungskosten und Inline-Preise stehen in eigenen Spalten. Transaktionen, Buchungen und mehrere Direktivtabellen enthalten eine source_location wie main.beancount:42, sodass eine Zeile zu ihrer Quellzeile zurückführt.

Stelle einer Abfrage BQL: voran, um sie statt an die Tabellen an rledger zu senden. Durchsuchen, Zeilenzählung und Seitennavigation funktionieren für BQL-Ergebnisse; SQL-Parameter nicht.

include-Direktiven werden verfolgt, sowohl konkrete Pfade als auch Glob-Muster, und jede Journaldatei sowie jedes referenzierte Dokument wird überwacht. Speichere eine Änderung in deinem Editor, und die nächste Abfrage liest sie ohne erneutes Verbinden. Die Verbindung steht immer auf Sicherer Modus Nur lesen; INSERT, UPDATE, DELETE und Schemaänderungen werden daher abgelehnt.

Exportiere eine Tabelle oder ein Abfrageergebnis als CSV, JSON, SQL, XLSX, Markdown, HTML und XML. Zu den weiteren Dateien, die TablePro als Datenbanken öffnet, gehören SQLite, DuckDB und Parquet.

Die App für iPhone und iPad hat keinen Beancount-Treiber. Vom Mac synchronisierte Beancount-Verbindungen erscheinen in ihrer Liste, lassen sich aber nicht öffnen.