Skip to content

Commit 7b9d2ee

Browse files
mrjung72mrjung72
committed
Update document
1 parent 349b3da commit 7b9d2ee

6 files changed

Lines changed: 110 additions & 0 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,40 @@
11
# SQL2Excel Version History
22

3+
## v1.3.4 - DB Adapter Test Query & Schema Alignment (2025-11-08)
4+
5+
### ✨ New/Changed
6+
- Adapter-level connection test SQL
7+
- Added `getTestQuery()` to all DB adapters
8+
- MSSQL: `SELECT 1 as test`
9+
- MySQL/MariaDB: `SELECT 1 as test`
10+
- PostgreSQL: `SELECT 1`
11+
- SQLite: `SELECT 1`
12+
- Oracle: `SELECT 1 FROM dual`
13+
- `excel-cli.js` uses `adapter.getTestQuery()` for connection validation
14+
15+
- Sample schema alignment for cross-DB consistency (Orders)
16+
- PostgreSQL: added `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID`
17+
- MySQL: added `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID`
18+
- Purpose: match sample data columns and improve parity with MSSQL schema
19+
20+
### 🐛 Fixes
21+
- Oracle connection validation fixed during `list-dbs`/validation flows
22+
- Replaced hardcoded `SELECT 1 as test` with adapter-provided query
23+
- `excel-cli.js`: fixed broken `catch` in `loadDatabaseConfig()` and improved error message (`configFileLoadFailed`)
24+
25+
### 🔧 Code Changes
26+
- `src/database/OracleAdapter.js`: add `getTestQuery()`
27+
- `src/database/MSSQLAdapter.js`: add `getTestQuery()`
28+
- `src/database/MySQLAdapter.js`: add `getTestQuery()`
29+
- `src/database/PostgreSQLAdapter.js`: add `getTestQuery()`
30+
- `src/database/SQLiteAdapter.js`: add `getTestQuery()`
31+
- `src/excel-cli.js`: use `adapter.getTestQuery()`; fix `loadDatabaseConfig()` catch block
32+
- `resources/create_sample_tables_postgresql.sql`: add Orders columns (`SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID`)
33+
- `resources/create_sample_tables_mysql.sql`: add Orders columns (`SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID`)
34+
35+
### 📝 Notes
36+
- These changes ensure sample data (PostgreSQL) loads cleanly across DBs when schemas are applied accordingly.
37+
338
## v1.3.3 - Docs Sync & Version Bump (2025-10-31)
439

540
### ✨ New/Changed

‎CHANGELOG_KR.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,40 @@
11
# SQL2Excel 버전 히스토리
22

3+
## v1.3.4 - DB 어댑터 테스트 쿼리 도입 및 스키마 정합성 (2025-11-08)
4+
5+
### ✨ 변경 사항
6+
- 어댑터 단위 연결 테스트 SQL 도입
7+
- 모든 DB 어댑터에 `getTestQuery()` 추가
8+
- MSSQL: `SELECT 1 as test`
9+
- MySQL/MariaDB: `SELECT 1 as test`
10+
- PostgreSQL: `SELECT 1`
11+
- SQLite: `SELECT 1`
12+
- Oracle: `SELECT 1 FROM dual`
13+
- `excel-cli.js`는 연결 검증 시 어댑터의 `getTestQuery()`를 사용
14+
15+
- 샘플 스키마 정합성(Orders)
16+
- PostgreSQL: `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID` 추가
17+
- MySQL: `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID` 추가
18+
- 목적: 샘플 데이터 컬럼과 일치 및 MSSQL 스키마와의 정합성 향상
19+
20+
### 🐛 버그 수정
21+
- Oracle 연결 검증 오류 수정 (`list-dbs`/검증 플로우)
22+
- 하드코딩된 `SELECT 1 as test` → 어댑터 제공 테스트 쿼리로 대체
23+
- `excel-cli.js`: `loadDatabaseConfig()`의 깨진 `catch` 블록 수정 및 오류 메시지 개선(`configFileLoadFailed`)
24+
25+
### 🔧 코드 변경
26+
- `src/database/OracleAdapter.js`: `getTestQuery()` 추가
27+
- `src/database/MSSQLAdapter.js`: `getTestQuery()` 추가
28+
- `src/database/MySQLAdapter.js`: `getTestQuery()` 추가
29+
- `src/database/PostgreSQLAdapter.js`: `getTestQuery()` 추가
30+
- `src/database/SQLiteAdapter.js`: `getTestQuery()` 추가
31+
- `src/excel-cli.js`: 어댑터의 테스트 쿼리 사용; `loadDatabaseConfig()` catch 블록 수정
32+
- `resources/create_sample_tables_postgresql.sql`: Orders 컬럼 추가 (`SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID`)
33+
- `resources/create_sample_tables_mysql.sql`: Orders 컬럼 추가 (`SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID`)
34+
35+
### 📝 비고
36+
- 본 변경으로 샘플 데이터(PostgreSQL)가 각 DB 스키마 적용 시 원활히 적재되도록 정합성이 개선되었습니다.
37+
338
## v1.3.3 - 문서 동기화 및 버전 올림 (2025-10-31)
439

540
### ✨ 변경 사항

‎README.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,16 @@
22

33
A Node.js-based tool for generating Excel files from SQL query results.
44

5+
## v1.3.4 Highlights
6+
7+
- Adapter-level DB connection test queries
8+
- Added `getTestQuery()` to all DB adapters
9+
- MSSQL: `SELECT 1 as test`, MySQL/MariaDB: `SELECT 1 as test`, PostgreSQL: `SELECT 1`, SQLite: `SELECT 1`, Oracle: `SELECT 1 FROM dual`
10+
- `excel-cli.js` now uses the adapter’s test query for connection validation (fixes Oracle validation)
11+
- Sample schema alignment (Orders)
12+
- PostgreSQL/MySQL: added `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID`
13+
- Aligns with sample data and improves parity with MSSQL schema
14+
515
## v1.3.3 Highlights
616

717
- Documentation synchronization (KR/EN) and minor updates

‎README_KR.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,16 @@
22

33
SQL 쿼리 결과를 엑셀 파일로 생성하는 Node.js 기반 도구입니다.
44

5+
## v1.3.4 하이라이트
6+
7+
- 어댑터별 DB 연결 테스트 쿼리 도입
8+
- 모든 DB 어댑터에 `getTestQuery()` 추가
9+
- MSSQL/MySQL/MariaDB: `SELECT 1 as test`, PostgreSQL/SQLite: `SELECT 1`, Oracle: `SELECT 1 FROM dual`
10+
- `excel-cli.js`가 어댑터의 테스트 쿼리를 사용하여 연결 검증 수행 (Oracle 검증 이슈 해결)
11+
- 샘플 스키마 정합성(Orders)
12+
- PostgreSQL/MySQL: `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID` 추가
13+
- 샘플 데이터와 컬럼 일치, MSSQL 스키마와의 정합성 향상
14+
515
## v1.3.3 하이라이트
616

717
- 문서 동기화(KR/EN) 및 소규모 정리

‎USER_MANUAL.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,16 @@
1919

2020
SQL2Excel is a powerful Node.js-based tool for generating Excel files from SQL query results with advanced styling, template support, and standalone executable distribution.
2121

22+
### What's New (v1.3.4)
23+
24+
- Adapter-level DB connection test queries
25+
- Added `getTestQuery()` to all DB adapters
26+
- MSSQL: `SELECT 1 as test`, MySQL/MariaDB: `SELECT 1 as test`, PostgreSQL: `SELECT 1`, SQLite: `SELECT 1`, Oracle: `SELECT 1 FROM dual`
27+
- `excel-cli.js` now uses the adapter’s test query for connection validation (fixes Oracle validation)
28+
- Sample schema alignment (Orders)
29+
- PostgreSQL/MySQL: added `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID`
30+
- Aligns with sample data and improves parity with MSSQL schema
31+
2232
### What's New (v1.3.3)
2333

2434
- Added `exceptColumns` sheet option (XML/JSON) to exclude specific columns from outputs

‎USER_MANUAL_KR.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,16 @@
1919

2020
SQL2Excel은 고급 스타일링, 템플릿 지원, 독립 실행 파일 배포 기능을 갖춘 SQL 쿼리 결과로 엑셀 파일을 생성하는 강력한 Node.js 기반 도구입니다.
2121

22+
### v1.3.4 주요 변경
23+
24+
- 어댑터별 DB 연결 테스트 쿼리 도입
25+
- 모든 DB 어댑터에 `getTestQuery()` 추가
26+
- MSSQL: `SELECT 1 as test`, MySQL/MariaDB: `SELECT 1 as test`, PostgreSQL: `SELECT 1`, SQLite: `SELECT 1`, Oracle: `SELECT 1 FROM dual`
27+
- `excel-cli.js`가 어댑터의 테스트 쿼리를 사용하여 연결 검증 수행 (Oracle 검증 이슈 해결)
28+
- 샘플 스키마 정합성(Orders)
29+
- PostgreSQL/MySQL: `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID` 추가
30+
- 샘플 데이터와 컬럼 일치, MSSQL 스키마와의 정합성 향상
31+
2232
### v1.3.3 주요 변경
2333

2434
- 시트에서 특정 컬럼 제외를 위한 `exceptColumns` 속성 추가 (XML/JSON)

0 commit comments

Comments
 (0)