Modification document for Multi databases support feature

Author: mrjung72

README.md

@@ -50,6 +50,18 @@ A Node.js-based tool for generating Excel files from SQL query results.
 - 🔧 **Input Validation**: Automatic whitespace trimming for file path inputs
 - 🗂️ **Filename Variables**: Use `${DATE:...}`, `${DATE.TZ:...}`, and `${DB_NAME}` in `excel.output` (also supports custom `$(DB_NAME}`)
 
+## 🔗 Multi-Database Usage
+
+- **Supported drivers**: MSSQL (`mssql`), MySQL (`mysql2`), MariaDB (`mysql2`), PostgreSQL (`pg`), SQLite (`better-sqlite3`), Oracle (`oracledb`)
+- **Configuration**: `config/dbinfo.json` with per-DB keys and `type` (optional for MSSQL default)
+- **Runtime DB selection precedence**
+  - Default DB key: `--db` (CLI) > `excel.db` (XML/JSON)
+  - Sheet: `sheet.db` > Default DB
+  - Dynamic variables: `dynamicVar.database` or `dynamicVar.db` > Default DB
+- **Connection test**
+  - Dev: `npm run list-dbs`
+  - EXE: `sql2excel.exe list-dbs`
+
 ## v2.1.2-beta(v1.3.2) Highlights
 
 - Per-sheet export directory naming simplified

README_KR.md

@@ -50,6 +50,18 @@ SQL 쿼리 결과를 엑셀 파일로 생성하는 Node.js 기반 도구입니
 - 🔧 **입력 유효성 검증**: 파일 경로 입력에 대한 자동 공백 제거
 - 🗂️ **파일명 변수**: `excel.output`에서 `${DATE:...}`, `${DATE.TZ:...}`, `${DB_NAME}` 사용 가능 (커스텀 `$(DB_NAME}`도 지원)
 
+## 🔗 다중 데이터베이스 사용
+
+- **지원 드라이버**: MSSQL(`mssql`), MySQL(`mysql2`), MariaDB(`mysql2`), PostgreSQL(`pg`), SQLite(`better-sqlite3`), Oracle(`oracledb`)
+- **설정 파일**: `config/dbinfo.json`에 DB 키별 접속 정보와 `type` 지정 (MSSQL은 생략 시 기본값)
+- **런타임 DB 선택 우선순위**
+  - 기본 DB 키: `--db`(CLI) > `excel.db`(XML/JSON)
+  - 시트: `sheet.db` > 기본 DB
+  - 동적 변수: `dynamicVar.database` 또는 `dynamicVar.db` > 기본 DB
+- **연결 테스트**
+  - 개발: `npm run list-dbs`
+  - EXE: `sql2excel.exe list-dbs`
+
 ## v2.1.2-beta(v1.3.2) 하이라이트
 
 - 시트별 내보내기 디렉토리 명명 단순화

USER_MANUAL.md

@@ -122,7 +122,7 @@ npm run build
 ### 3. Database Connection Setup
 Create `config/dbinfo.json` file:
 
-#### Multi-Database Support (v1.3.0+)
+#### Multi-Database Support (v2.0.0+)
 ```json
 {
   "sampleDB": {
@@ -454,6 +454,20 @@ sql2excel.exe --mode=help
 }
 ```
 
+## 🔗 Multi-Database
+
+This tool supports multiple databases with unified adapters and flexible routing.
+
+- **Supported drivers**: MSSQL (`mssql`), MySQL (`mysql2`), MariaDB (`mysql2`), PostgreSQL (`pg`), SQLite (`better-sqlite3`), Oracle (`oracledb`)
+- **Configuration**: Define multiple DB keys in `config/dbinfo.json` with optional `type` (defaults to `mssql`) and connection fields. See examples above and in “Multi-Database Support (v2.0.0+)”.
+- **Runtime DB selection precedence (v2.1.5+)**
+  - Default DB key: CLI `--db` > `excel.db`
+  - Per sheet: `sheet.db` overrides default DB
+  - Dynamic variables: `dynamicVar.database` or `dynamicVar.db` overrides default DB
+- **Mixed-DB usage**: You can query different DBs within a single export. See “Multi-Database Support (v2.0.0+)” for XML/JSON examples.
+- **Connection test**: Validate connectivity before export with `node src/excel-cli.js list-dbs` (dev) or `sql2excel.exe list-dbs` (EXE).
+- **Adapter behavior**: Row limiting and functions are adapted per DB (e.g., MSSQL uses TOP, MySQL/MariaDB use LIMIT).
+
 ## 🎨 Template Style System
 
 SQL2Excel includes a comprehensive template style system with pre-defined Excel styling templates.
@@ -824,7 +838,7 @@ This feature works automatically - no configuration required!
 
 ## 🎨 Advanced Features
 
-### 1. Multi-Database Support (v1.3.0+)
+### 1. Multi-Database Support (v2.0.0+)
 
 SQL2Excel now supports multiple database types with a unified interface:
 
@@ -947,6 +961,13 @@ node src/excel-cli.js list-dbs
 sql2excel-v1.3.0.exe list-dbs
 ```
 
+#### Runtime DB selection precedence (v2.1.5+)
+
+- Default DB key: CLI `--db` > `excel.db`
+- Per sheet: `sheet.db` overrides default DB
+- Dynamic variables: `dynamicVar.database` or `dynamicVar.db` overrides default DB
+- Tip: Use `list-dbs` (above) to verify connections before export
+
 ### 2. Excel Styling
 
 #### Font Styling

USER_MANUAL_KR.md

@@ -121,7 +121,7 @@ npm run build
 ### 3. 데이터베이스 연결 설정
 `config/dbinfo.json` 파일을 생성하세요:
 
-#### 다중 데이터베이스 지원 (v1.3.0+)
+#### 다중 데이터베이스 지원 (v2.0.0+)
 ```json
 {
   "sampleDB": {
@@ -466,12 +466,21 @@ sql2excel.exe --mode=help
   - 내부 줄바꿈(\r/\n)은 CSV/TXT 모두 공백으로 정규화
   - 날짜 직렬화: `yyyy-MM-dd HH:mm:ss` (24시간)
 
-## 🎨 템플릿 스타일 시스템
+## 🔗 다중 데이터베이스
 
-SQL2Excel은 사전 정의된 엑셀 스타일링 템플릿을 포함한 포괄적인 템플릿 스타일 시스템을 제공합니다.
+통합 어댑터와 유연한 라우팅으로 여러 데이터베이스를 지원합니다.
 
-### 사용 가능한 템플릿 스타일
+- **지원 드라이버**: MSSQL(`mssql`), MySQL(`mysql2`), MariaDB(`mysql2`), PostgreSQL(`pg`), SQLite(`better-sqlite3`), Oracle(`oracledb`)
+- **설정**: `config/dbinfo.json`에 다수의 DB 키를 정의하고 `type`(미지정 시 `mssql`)과 접속 정보를 설정하세요. 상세 예시는 위 “다중 데이터베이스 지원 (v2.0.0+)” 섹션 참고.
+- **런타임 DB 선택 우선순위 (v2.1.5+)
+  - 기본 DB 키: CLI `--db` > `excel.db`
+  - 시트별: `sheet.db`가 기본 DB를 오버라이드
+  - 동적 변수: `dynamicVar.database` 또는 `dynamicVar.db`가 기본 DB를 오버라이드
+- **혼합 사용**: 하나의 내보내기에서 서로 다른 DB를 동시에 사용할 수 있습니다. XML/JSON 예시는 “다중 데이터베이스 지원 (v2.0.0+)” 섹션을 참고하세요.
+- **연결 테스트**: 내보내기 전 `node src/excel-cli.js list-dbs`(개발) 또는 `sql2excel.exe list-dbs`(EXE)로 확인하세요.
+- **어댑터 동작**: 행 제한과 함수가 DB별로 자동 조정됩니다 (예: MSSQL=TOP, MySQL/MariaDB=LIMIT).
 
+## 🎨 템플릿 스타일 시스템
 | 스타일 ID | 이름 | 설명 |
 |----------|------|------|
 | `default` | 기본 스타일 | 기본 엑셀 스타일 |
@@ -836,7 +845,7 @@ SQL2Excel은 생성된 각 엑셀 시트에 자동으로 생성 타임스탬프
 
 ## 🎨 고급 기능
 
-### 1. 다중 데이터베이스 지원 (v1.3.0+)
+### 1. 다중 데이터베이스 지원 (v2.0.0+)
 
 SQL2Excel은 이제 통합 인터페이스로 여러 데이터베이스 타입을 지원합니다:
 
@@ -959,6 +968,13 @@ node src/excel-cli.js list-dbs
 sql2excel-v1.3.0.exe list-dbs
 ```
 
+#### 런타임 DB 선택 우선순위 (v2.1.5+)
+
+- 기본 DB 키: CLI `--db` > `excel.db`
+- 시트별: `sheet.db`가 기본 DB를 오버라이드
+- 동적 변수: `dynamicVar.database` 또는 `dynamicVar.db`가 기본 DB를 오버라이드
+- 팁: 내보내기 전에 위 `list-dbs`로 연결 상태를 점검하세요
+
 ### 2. 엑셀 스타일링
 
 #### 글꼴 스타일링

package.json

@@ -1,6 +1,6 @@
 {
   "name": "sql2excel",
-  "version": "2.1.5-beta",
+  "version": "2.1.5",
   "description": "SQL 쿼리 결과를 엑셀 파일로 저장하는 도구 (시트별 쿼리, 변수, XML/JSON 지원)",
   "main": "app.js",
   "scripts": {