Saltar al contenido

¿Usas TablePro a diario? Una licencia añade funciones de pago y financia la próxima versión. Comprar licenciaLicencia para apoyar TablePro

Consulta un libro de Beancount con SQL en Mac

Abre un archivo .beancount y consulta sus transacciones, apuntes, saldos y metadatos como tablas SQL, o envía BQL a rledger. El libro sigue siendo un archivo de texto que editas en tu propio editor.

Funciona en MacEl controlador se descarga la primera vez que eliges Beancount

Tablas proyectadas de un libro Beancount en la barra lateral y el resultado de una consulta BQL.

De un vistazo

Lenguaje de consulta
SQL
Controlador
Se descarga en el primer uso
Conectar mediante
Un archivo
iPhone y iPad
No se abre

Abre un libro

TablePro ejecuta rledger o Python Beancount para leer el libro. Si tienes que elegir, instala rledger: tiene prioridad cuando ambos están presentes, BQL solo se ejecuta mediante él y es el único que rellena la tabla diagnostics con los resultados de validación.

Elige el archivo con Examinar… en el formulario de conexión. La ruta del libro define toda la conexión, sin host, puerto, contraseña ni base de datos. Un archivo .beancount también se abre desde Finder, y se pueden importar URL beancount:///path/to/main.beancount.

Una app abierta desde Finder no hereda el PATH de tu shell. Si el backend funciona en Terminal pero no aquí, indica su ubicación con launchctl setenv TABLEPRO_RUSTLEDGER_BINARY o TABLEPRO_BEANCOUNT_PYTHON y vuelve a iniciar la app.

El backend de Python ejecuta los plugins incluidos con Beancount y omite cualquier otra directiva plugin, que es código de terceros, hasta que actives Ejecutar plugins del libro para esa conexión. Los plugins omitidos aparecen en diagnostics.

Consulta el libro

Las tablas abarcan transacciones y apuntes, cuentas, saldos y aserciones de saldo, precios y unidades de valor, todas las demás directivas, metadatos, etiquetas y enlaces, y los archivos de origen. Los apuntes se unen a las transacciones por transaction_id, y las cuentas por nombre.

Los importes llegan contabilizados, con las operaciones, los costes y los precios resueltos, y los costes de los apuntes y los precios en línea en columnas propias. Las transacciones, los apuntes y varias tablas de directivas incluyen un source_location como main.beancount:42, para volver de una fila a su línea de origen.

Antepon BQL: a una consulta para enviarla a rledger en lugar de consultar las tablas. Los resultados BQL admiten exploración, recuento de filas y paginación, pero no parámetros SQL.

Se siguen las directivas include, tanto rutas literales como patrones glob, y se supervisan todos los archivos del libro y documentos referenciados. Guarda un cambio en tu editor y la siguiente consulta lo leerá sin reconectar. La conexión siempre está en Modo seguro de Solo lectura, así que se rechazan INSERT, UPDATE, DELETE y los cambios de esquema.

Transfiere datos

Exporta una tabla o el resultado de una consulta como CSV, JSON, SQL, XLSX, Markdown, HTML y XML. Otros archivos que TablePro abre como bases de datos incluyen SQLite, DuckDB y Parquet.

iPhone y iPad

La app para iPhone y iPad no tiene un controlador de Beancount. Las conexiones de Beancount sincronizadas desde un Mac aparecen en la lista, pero no se abren.

Limitaciones

  • Al abrirse, TablePro lee el libro en 23 tablas SQL de solo lectura. No escribe nada en el libro.
  • Requiere rledger o Python beancount instalado en este Mac.

Preguntas sobre Beancount

¿Se abre un libro con errores?

Con rledger, sí. El libro se proyecta incluso si falla la validación, y cada problema es una fila de diagnostics con su archivo, línea, gravedad y mensaje.

¿Puede una conexión abrir varios libros?

Cada conexión corresponde a un archivo de libro, sin posibilidad de alternar. Un archivo principal que incluya los demás los incorpora todos, también mediante patrones glob.

Consigue TablePro

La app para Mac se descarga y usa gratis. Un plan Starter o Equipo añade funciones opcionales.
Descargar para Mac

Requiere macOS 13 Ventura o posterior