주요 기능
다중 데이터베이스 지원(v2.0.0)
여러 데이터베이스를 통합 어댑터로 지원하며 시트/변수 단위 라우팅을 유연하게 제공
- 지원: Oracle, MSSQL, MySQL, MariaDB, PostgreSQL, SQLite
- 우선순위: CLI --db > excel.db; sheet.db; dynamicVar.database|db
- 동적 변수는 자체 DB 어댑터에서 실행 가능
- 연결 테스트: node src/excel-cli.js list-dbs / sql2excel.exe list-dbs
다중 시트 Excel 생성
체계적인 보고를 위해 여러 SQL 쿼리 결과를 하나의 Excel 파일 내 별도 시트로 구성
- 시트별 독립적인 쿼리 실행
- 개별 시트 활성화/비활성화 설정
- 동적 시트명 (변수 지원)
- 쿼리별 최대 레코드 제한
템플릿 스타일 시스템
일관된 디자인과 전문적인 보고서 생성을 위한 7가지 사전 정의된 Excel 스타일 템플릿
- Default, Modern, Dark, Colorful, Minimal, Business, Premium 스타일
- 전역 및 시트별 스타일 적용
- 템플릿 스타일 커스터마이징
- CLI를 통한 스타일 목록 조회
향상된 동적 변수
고급 처리 및 키-값 쌍 지원으로 데이터베이스에서 실시간으로 값을 추출
- column_identified 및 key_value_pairs 타입
- 사전 실행 변수 처리 및 캐싱
- 변수 치환 검증을 위한 디버그 모드
- 오류 처리 및 빈 결과 대체
목차
향상된 보고서 관리 및 공유를 위한 독립적인 목차 시트 생성
- 시트별 레코드 수 표시 (템플릿 사용 가능)
- 시트별 적용된 SQL 쿼리 표시
- 시트명 길이 31자 초과 시 31자로 자름
- 목차(TOC)에 원래 시트명을 별도 컬럼으로 표시
CSV/TXT 시트별 내보내기 (v1.3.0)
CSV/TXT 시트별 파일 생성
- 출력 확장자에 따른 라우팅
- - .xlsx / .xls → 단일 엑셀 통합문서 생성
- - .csv → 시트별 CSV 파일 생성
- - 그 외 확장자 → 시트별 텍스트타입 파일 생성
- 출력 디렉토리 명명 규칙
- - <출력파일베이스> 하위에 생성
- - 예: output="d:/temp/report.csv" → d:/temp/report/
독립 실행파일
Node.js 의존성 없이 배포 가능한 버전별 독립 실행파일 생성
- 모든 의존성이 포함된 자체 완결형 실행파일
- 버전별 파일명 (sql2excel-v1.2.4.exe)
- 에셋 번들링 (템플릿, 스타일)
- Node.js 설치 불필요
파일명 변수 및 DATE 개선 (v1.3.1)
- 출력 파일명 변수 기능 강화
- - excel.output에서 ${DB_NAME} 사용 지원
- - 타임존 지정 ${DATE.TZ:...} 계속 지원
- 날짜 포맷 토큰 소문자 지원
- - yyyy, yy, dd, d, hh, h, sss 지원 추가
- 자동 타임스탬프 접미사 제거
- - 파일명에 _yyyymmddhhmmss 자동 추가 제거
비대화형 CLI 기능 신규 추가 (v1.2.10)
비대화형 CLI 기능 신규 추가
- 메뉴 없이 --mode 플래그로 직접 실행 가능
- 모드: validate, test, export, help
- Node 환경과 배포 EXE 모두 지원
글로벌 타임존 지원 (v1.2.9)
전세계 22개 타임존 지원 및 유연한 날짜/시간 포맷팅
- 22개 타임존: UTC, GMT, KST, JST, CST, EST, PST, ICT, PHT, AST 등
- 통합 변수 형식: ${DATE.UTC:format}, ${DATE.KST:format}
- 지역별 날짜 형식 (한국어, 일본어, 유럽식 등)
- 글로벌 보고서를 위한 다중 타임존 동시 표시
향상된 검증 시스템
상세한 시트명 검증 및 데이터베이스 정보 출력
- 시트 목록 전체 출력 및 개별 검증 결과 표시
- 데이터베이스 상세 정보 출력
- 시트명 자동 수정 기능 (실행 시)
- 파일 검증 시 오류 상세 리포트
- Windows용 UTF-8 인코딩 지원
기술 사양
플랫폼 및 런타임
- 플랫폼: Node.js 16.0+
- Excel 라이브러리: ExcelJS
- OS 지원: Windows, Linux, macOS
- 아키텍처: 크로스 플랫폼
설정 및 변수
- 형식: XML, JSON
- 검증: 내장 설정 검증
- 타임존: 22개 글로벌 타임존 지원
- 날짜시간 변수: 유연한 커스텀 포맷
- 동적 변수: 실시간 데이터 추출
- 입력 검증: 공백 자동 제거
데이터베이스 지원
- 지원 DB: MSSQL, MySQL, MariaDB, PostgreSQL, SQLite, Oracle
- 라우팅: 통합 문서/시트/동적 변수 단위 선택 가능
- 어댑터 동작: DB별 행 제한/함수 자동 적용 (TOP vs LIMIT 등)
- 연결 테스트: list-dbs 명령 (Node & EXE)
배포 및 배급
- 독립 실행파일: Node.js 불필요
- 다국어 패키지: 한국어 및 영어
- 릴리스 자동화: 자동화된 빌드 프로세스
- 버전 관리: 동적 버전 관리
사용 사례
비즈니스 보고
여러 데이터 소스와 전문적인 스타일링으로 포괄적인 비즈니스 보고서 생성
- 템플릿을 사용한 매출 및 수익 보고서
- 동적 변수를 활용한 고객 분석
- 다중 시트를 사용한 성과 대시보드
데이터 분석
향상된 서식을 통해 원시 데이터베이스 데이터를 분석용 구조화된 Excel 파일로 변환
- 집계 기능을 사용한 통계 분석
- 차트를 통한 트렌드 식별
- 사용자 정의 스타일을 사용한 데이터 시각화
문서화 및 참조
목차가 포함된 데이터베이스 쿼리에서 문서화 및 참조 자료 생성
- 목차가 포함된 데이터 사전
- 검증 기능이 있는 참조 테이블
- 파일 검증이 포함된 감사 보고서
자동화된 보고
예약된 실행과 동적 콘텐츠로 정기 보고서 생성 자동화
- 변수를 사용한 일일/주간 보고서
- CLI를 통한 자동 배포
- 스타일을 사용한 템플릿 기반 생성