Consulte um livro-razão Beancount com SQL em Mac

TablePro executa rledger ou Python Beancount para ler o livro-razão. Se estiver escolhendo, instale rledger: ele tem prioridade quando ambos estão presentes, somente ele executa BQL e somente ele preenche a tabela diagnostics com os resultados da validação.

Escolha o arquivo com Browse… no formulário de conexão. O caminho do livro-razão define toda a conexão, sem host, porta, senha ou banco de dados. Um arquivo .beancount também abre pelo Finder, e URLs beancount:///path/to/main.beancount podem ser importadas.

Um app aberto pelo Finder não herda o PATH do seu shell. Se o backend funciona no Terminal, mas não aqui, indique-o com launchctl setenv TABLEPRO_RUSTLEDGER_BINARY ou TABLEPRO_BEANCOUNT_PYTHON e reinicie o app.

O backend Python executa os plugins que acompanham Beancount e ignora qualquer outra diretiva plugin, que contém código de terceiros, até você ativar Run Ledger Plugins para essa conexão. Os plugins ignorados são listados em diagnostics.

As tabelas abrangem transações e lançamentos, contas, saldos e verificações de saldo, preços e commodities, todas as outras diretivas, metadados, tags e links, e os arquivos de origem. Os lançamentos se unem às transações por transaction_id, e as contas pelo nome.

Os valores chegam contabilizados, com operações aritméticas, custos e preços resolvidos, e os custos dos lançamentos e preços inline em colunas próprias. Transações, lançamentos e várias tabelas de diretivas contêm uma source_location, como main.beancount:42, permitindo chegar à linha de origem a partir de uma linha de dados.

Comece uma consulta com BQL: para enviá-la ao rledger em vez de consultar as tabelas. Navegação, contagem de linhas e paginação funcionam nos resultados BQL; parâmetros SQL não.

As diretivas include são seguidas, tanto com caminhos literais quanto com globs, e todos os arquivos do livro-razão e documentos referenciados são monitorados. Salve uma alteração no editor e a próxima consulta a lerá sem reconectar. A conexão está sempre no nível Read-Only do Safe Mode, portanto INSERT, UPDATE, DELETE e alterações de esquema são recusados.

Exporte uma tabela ou o resultado de uma consulta como CSV, JSON, SQL, XLSX, Markdown, HTML e XML. Outros arquivos que TablePro abre como bancos de dados incluem SQLite, DuckDB e Parquet.

O app para iPhone e iPad não tem um driver de Beancount. As conexões Beancount sincronizadas de um Mac aparecem na lista, mas não abrem.