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을 포함해 모두 불러옵니다.