}){kind=logo}
\n```\n\n링크의 경우에도 동일한 방법이 적용됩니다. [Evidence base paths 문서](https://docs.evidence.dev/deployment/configuration/base-paths#custom-components)를 참조하세요."}},{"@type":"Question","name":"Evidence DuckDB 소스가 첫 번째 행에 NULL 값이 포함된 경우 'Error: Unsupported object type: null' 오류를 반환하는 이유는 무엇인가요?","acceptedAnswer":{"@type":"Answer","text":"이 오류는 Evidence의 DuckDB 커넥터가 소스 쿼리에 대해 DESCRIBE 쿼리를 실행하여 컬럼 유형을 결정하려고 시도하기 때문에 발생합니다. DESCRIBE가 실패하면(예: 임시 테이블, CTE 또는 복잡한 쿼리에서), JavaScript의 typeof를 사용하여 첫 번째 행에서 유형을 추론하는 폴백(fallback)이 실행됩니다. 첫 번째 행에 NULL이 포함된 경우, typeof는 NULL에 대해 'object'를 반환하여 오류가 발생합니다. 해결 방법: 첫 번째 행에 NULL이 아닌 값이 있도록 보장합니다(ORDER BY column IS NOT NULL DESC로 행 재정렬, 또는 COALESCE를 사용하여 NULL을 플레이스홀더로 대체한 후 Evidence에서 처리). 영구적인 수정은 DuckDB의 네이티브 구문 설명을 사용하여 컬럼 유형을 가져오는 방식으로, Evidence 저장소에서 추적되고 있습니다. Evidence를 업그레이드하면 수정 버전이 출시된 후 이 문제가 해결될 수 있습니다."}}]}]}Evidence
오픈소스 BI 도구로, SQL+Markdown으로 보고서를 작성하여 드래그 앤 드롭 방식의 보고서를 대체합니다.
스마트 다운로드
프로젝트 홈페이지 방문
아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요
코드로 BI 리포트 작성, SQL로 데이터 조회, Markdown으로 레이아웃, 웹사이트 생성.
주요 기능
- Markdown에서 SQL 쿼리를 직접 작성하고 실행하면 차트와 테이블이 자동으로 생성
- PostgreSQL, MySQL, Snowflake, BigQuery 등 다양한 데이터 소스 지원
- 템플릿 기반 페이지: 하나의 Markdown 템플릿으로 여러 페이지의 보고서 생성 가능(예: 고객별, 날짜별)
- 조건부 로직 및 반복문: 보고서에서 if/else, for 반복문을 사용하여 표시 내용 제어
- 순수 정적 웹사이트 출력: 자체 호스팅 가능, 서버 측 런타임 불필요
할 수 없는 것
- •SQL과 Markdown에 익숙해야 하므로 코드 경험이 전혀 없는 사용자에게는 적합하지 않습니다. 현재 제공되는 차트 유형이 적어 고급 시각화는 직접 커스터마이징해야 하며, 복잡한 데이터 클렌징은 리포트 레이어에서 처리하기에 적합하지 않습니다.
사용 사례
- 데이터 팀이 내부 대시보드 또는 주간 보고서를 빠르게 제작하고 Git으로 버전 관리
- 분석가가 비즈니스 부서를 위한 인터랙티브 판매 및 운영 보고서 생성
- 오픈소스 프로젝트 문서에 동적 데이터 예제 임베딩 (예: GitHub Stars 추이)
- Tableau/Power BI의 간단한 보고서를 대체하여 비용 절감
Evidence는 오픈 소스 코드 기반 비즈니스 인텔리전스(BI) 도구로, SQL과 Markdown으로 기존의 드래그 앤 드롭 방식 리포팅 도구를 대체합니다. Markdown 파일에 SQL 쿼리를 삽입하고 PostgreSQL, MySQL, BigQuery 등의 데이터 소스에 연결하면 차트, 테이블, 동적 페이지를 자동으로 생성할 수 있습니다. 최종 결과물은 바로 배포할 수 있는 정적 웹사이트입니다(Netlify, Vercel 등 지원). 코드에 익숙한 데이터 팀에 적합하며, 리포트 버전 관리와 재현이 가능하고 유료 BI 도구가 필요하지 않습니다. SQL과 Markdown을 작성할 줄 알아야 하지만 쉽게 시작할 수 있습니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
1단계: VS Code를 설치하고 「Evidence」 확장을 검색하여 설치하세요
2단계: F1을 눌러 명령 팔레트를 열고 「Evidence: New Evidence Project」를 입력하여 새 프로젝트를 생성하세요
3단계: 프로젝트에서 .md 파일을 생성하고 SQL 코드 블록으로 쿼리를 작성하면, 저장 후 브라우저에서 보고서를 미리 볼 수 있습니다
- 1단계: VS Code를 설치하고 「Evidence」 확장을 검색하여 설치하세요
- 2단계: F1을 눌러 명령 팔레트를 열고 「Evidence: New Evidence Project」를 입력하여 새 프로젝트를 생성하세요
- 3단계: 프로젝트에서 .md 파일을 생성하고 SQL 코드 블록으로 쿼리를 작성하면, 저장 후 브라우저에서 보고서를 미리 볼 수 있습니다
체크섬 없음
이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다
SHA256 체크섬
체크섬 없음
GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
VS Code 확장 관리에서 Evidence 확장을 제거한 다음 프로젝트 폴더를 삭제하면 됩니다.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
5 FAQs