Update document for v2.1.5

Author: mrjung72

CHANGELOG.md

@@ -1,5 +1,29 @@
 # SQL2Excel Version History
 
+## v2.1.5-beta(v1.3.5) - DynamicVar DB Routing & XML Validation Update (2025-11-15)
+
+### ✨ New/Changed
+- Dynamic variable DB routing
+  - XML `dynamicVar` supports `db` (alias of `database`) attribute
+  - Each dynamic variable is executed using the adapter for its specified DB key
+  - Fallback to default DB when not specified
+- XML validation update
+  - `queryDef` now allows `db` attribute during structure validation (for documentation/future use). Execution DB remains sheet-level `db` or global default
+
+### 🔧 Code Changes
+- `src/query-parser.js`
+  - Allow `db` attribute on `dynamicVar`; parse `database || db`
+  - Allow `db` attribute on `queryDef` in validation
+- `src/variable-processor.js`
+  - Execute dynamic variables on their own DB adapters (`dbAdapters[targetDbKey]`)
+- `src/index.js`
+  - Pass `dbAdapters` and `defaultDbKey` to dynamic variable processor
+
+### 📝 Documentation
+- README/README_KR: Added v2.1.5 highlights, dynamicVar `db`/`database` usage notes and examples
+- USER_MANUAL/USER_MANUAL_KR: Documented dynamicVar attributes and per-variable DB routing
+- CHANGELOG/CHANGELOG_KR: Added v2.1.5 entries
+
 ## v2.1.4-beta(v1.3.4) - DB Adapter Test Query & Schema Alignment (2025-11-08)
 
 ### ✨ New/Changed

CHANGELOG_KR.md

@@ -1,5 +1,29 @@
 # SQL2Excel 버전 히스토리
 
+## v2.1.5-beta(v1.3.5) - 동적 변수 DB 라우팅 & XML 검증 업데이트 (2025-11-15)
+
+### ✨ 변경 사항
+- 동적 변수 DB 라우팅
+  - XML `dynamicVar`에서 `db` 속성 지원 (`database`의 별칭)
+  - 각 동적 변수는 지정된 DB 키의 어댑터로 실행
+  - 미지정 시 전역 기본 DB로 폴백
+- XML 검증 업데이트
+  - XML 구조 검증에서 `queryDef`의 `db` 속성을 허용 (문서/향후 확장용). 실제 실행 DB는 시트의 `db` 또는 전역 기본 DB가 적용됨
+
+### 🔧 코드 변경
+- `src/query-parser.js`
+  - `dynamicVar`에 `db` 속성 허용; 파싱 시 `database || db` 처리
+  - XML 검증에서 `queryDef`의 `db` 속성 허용
+- `src/variable-processor.js`
+  - 동적 변수를 해당 DB 어댑터로 실행 (`dbAdapters[targetDbKey]`)
+- `src/index.js`
+  - 동적 변수 처리에 `dbAdapters`와 `defaultDbKey` 전달
+
+### 📝 문서
+- README/README_KR: v2.1.5 하이라이트, `dynamicVar`의 `db`/`database` 속성 사용 노트 및 예시 추가
+- USER_MANUAL/USER_MANUAL_KR: 동적 변수 속성 및 변수별 DB 라우팅 동작 문서화
+- CHANGELOG/CHANGELOG_KR: v2.1.5 항목 추가
+
 ## v2.1.4-beta(v1.3.4) - DB 어댑터 테스트 쿼리 도입 및 스키마 정합성 (2025-11-08)
 
 ### ✨ 변경 사항

README.md

@@ -2,6 +2,14 @@
 
 A Node.js-based tool for generating Excel files from SQL query results.
 
+## v2.1.5-beta(v1.3.5) Highlights
+
+- DynamicVar DB routing
+  - `dynamicVar` now supports `db` (alias of `database`) attribute in XML.
+  - Each dynamic variable executes on its specified DB adapter (falls back to default DB when omitted).
+- XML validation update
+  - `queryDef` now allows `db` attribute in XML schema validation. Note: current execution still uses sheet-level `db` or global default; `queryDef.db` is for future use/documentation.
+
 ## v2.1.4-beta(v1.3.4) Highlights
 
 - Adapter-level DB connection test queries
@@ -110,6 +118,10 @@ node app.js --mode=export --query=./queries/sample-queries.json
 node app.js --mode=help
 ```
 
+Notes:
+- Attributes supported on `dynamicVar`: `name`, `description`, `type`, `db`, `database` (`db` is an alias). When both are present, `database` takes precedence.
+- `queryDef` accepts `db` for validation purposes; execution DB is determined by sheet's `db` or the global default DB.
+
 #### Standalone EXE
 ```bash
 sql2excel.exe --mode=validate --xml=./queries/sample-queries.xml
@@ -391,15 +403,15 @@ The tool supports dynamic variables that can extract data at runtime and use it
 
 ```xml
 <!-- Using column_identified (default) -->
-<dynamicVar name="customerData" description="Customer information">
+<dynamicVar name="customerData" description="Customer information" db="sampleDB">
   <![CDATA[
     SELECT CustomerID, CustomerName, Region FROM Customers
   ]]>
   <!-- type omitted - defaults to column_identified -->
 </dynamicVar>
 
 <!-- Using key_value_pairs -->
-<dynamicVar name="statusMapping" description="Status mapping">
+<dynamicVar name="statusMapping" description="Status mapping" database="mariaDB">
   <![CDATA[
     SELECT StatusCode, StatusName FROM StatusCodes
   ]]>

README_KR.md

@@ -2,6 +2,14 @@
 
 SQL 쿼리 결과를 엑셀 파일로 생성하는 Node.js 기반 도구입니다.
 
+## v2.1.5-beta(v1.3.5) 하이라이트
+
+- 동적 변수 DB 라우팅
+  - XML의 `dynamicVar`에서 `db`(= `database` 별칭) 속성 지원.
+  - 각 동적 변수는 지정한 DB 어댑터에서 실행되며, 미지정 시 기본 DB 사용.
+- XML 검증 업데이트
+  - XML 스키마 검증에서 `queryDef`의 `db` 속성을 허용. 주의: 현재 실행 DB는 시트의 `db` 또는 전역 기본 DB가 사용되며, `queryDef.db`는 향후 문서/확장용.
+
 ## v2.1.4-beta(v1.3.4) 하이라이트
 
 - 어댑터별 DB 연결 테스트 쿼리 도입
@@ -110,6 +118,10 @@ node app.js --mode=export --query=./queries/sample-queries.json
 node app.js --mode=help
 ```
 
+참고:
+- `dynamicVar`에서 지원하는 속성: `name`, `description`, `type`, `db`, `database` (`db`는 별칭). 둘 다 있으면 `database`가 우선합니다.
+- `queryDef`는 검증 목적상 `db`를 허용합니다. 실제 실행 DB는 시트의 `db` 혹은 전역 기본 DB가 사용됩니다.
+
 #### 독립 실행 파일(EXE)
 ```bash
 sql2excel.exe --mode=validate --xml=./queries/sample-queries.xml
@@ -391,15 +403,15 @@ node src/excel-cli.js export --xml ./queries/sales-report.xml \
 
 ```xml
 <!-- column_identified 사용 (기본값) -->
-<dynamicVar name="customerData" description="고객 정보">
+<dynamicVar name="customerData" description="고객 정보" db="sampleDB">
   <![CDATA[
     SELECT CustomerID, CustomerName, Region FROM Customers
   ]]>
   <!-- type 생략 - column_identified가 기본값 -->
 </dynamicVar>
 
 <!-- key_value_pairs 사용 -->
-<dynamicVar name="statusMapping" description="상태 매핑">
+<dynamicVar name="statusMapping" description="상태 매핑" database="mariaDB">
   <![CDATA[
     SELECT StatusCode, StatusName FROM StatusCodes
   ]]>

USER_MANUAL.md

@@ -19,6 +19,14 @@
 
 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.
 
+### What's New (v2.1.5-beta, v1.3.5)
+
+- DynamicVar DB routing
+  - XML `dynamicVar` supports `db` (alias of `database`) attribute
+  - Each dynamic variable runs on its specified DB adapter; falls back to default DB if omitted
+- XML validation update
+  - `queryDef` accepts `db` in schema validation (execution DB is still determined by sheet `db` or global default)
+
 ### What's New (v2.1.4-beta, v1.3.4)
 
 - Adapter-level DB connection test queries
@@ -527,15 +535,15 @@ The tool supports advanced dynamic variables that can extract data at runtime an
 #### XML Configuration
 ```xml
 <dynamicVars>
-  <!-- Using column_identified (default) -->
-  <dynamicVar name="customerData" description="Customer information">
+  <!-- Using column_identified (default) on specific DB -->
+  <dynamicVar name="customerData" description="Customer information" db="sampleDB">
     <![CDATA[
       SELECT CustomerID, CustomerName, Region FROM Customers
     ]]>
   </dynamicVar>
 
-  <!-- Using key_value_pairs -->
-  <dynamicVar name="productPrices" type="key_value_pairs" description="Product prices">
+  <!-- Using key_value_pairs on a different DB -->
+  <dynamicVar name="productPrices" type="key_value_pairs" description="Product prices" database="mariaDB">
     <![CDATA[
       SELECT ProductID, UnitPrice FROM Products WHERE Discontinued = 0
     ]]>
@@ -559,6 +567,10 @@ WHERE CustomerID IN (${customerData.CustomerID})
 4. **Performance**: Variables are executed once and cached for the entire export
 5. **Debug Mode**: Enable with `DEBUG_VARIABLES=true` for detailed variable substitution
 
+Notes:
+- Supported `dynamicVar` attributes: `name`, `description`, `type`, `db`, `database` (`db` is an alias). If both are present, `database` takes precedence.
+- `queryDef` accepts `db` in XML validation only; runtime execution DB is selected from the sheet's `db` or the global default DB.
+
 ## 🕒 Custom Date/Time Variables
 
 SQL2Excel provides a powerful custom date variable system that allows you to display current date and time in any format you want. These variables can be used in queries, file names, and any text content.

USER_MANUAL_KR.md

@@ -19,6 +19,14 @@
 
 SQL2Excel은 고급 스타일링, 템플릿 지원, 독립 실행 파일 배포 기능을 갖춘 SQL 쿼리 결과로 엑셀 파일을 생성하는 강력한 Node.js 기반 도구입니다.
 
+### v2.1.5-beta(v1.3.5) 주요 변경
+
+- 동적 변수 DB 라우팅
+  - XML `dynamicVar`에서 `db` 속성 지원 (`database`의 별칭)
+  - 각 동적 변수는 지정된 DB 어댑터에서 실행, 미지정 시 전역 기본 DB 사용
+- XML 검증 업데이트
+  - XML 스키마 검증에서 `queryDef`의 `db` 속성 허용 (실행 DB는 여전히 시트 `db` 또는 전역 기본 DB로 결정)
+
 ### v2.1.4-beta(v1.3.4) 주요 변경
 
 - 어댑터별 DB 연결 테스트 쿼리 도입
@@ -539,15 +547,15 @@ node src/excel-cli.js export --xml queries.xml --style modern
 #### XML 구성
 ```xml
 <dynamicVars>
-  <!-- column_identified 사용 (기본값) -->
-  <dynamicVar name="customerData" description="고객 정보">
+  <!-- column_identified 사용 (기본값), 특정 DB에서 실행 -->
+  <dynamicVar name="customerData" description="고객 정보" db="sampleDB">
     <![CDATA[
       SELECT CustomerID, CustomerName, Region FROM Customers
     ]]>
   </dynamicVar>
 
-  <!-- key_value_pairs 사용 -->
-  <dynamicVar name="productPrices" type="key_value_pairs" description="제품 가격">
+  <!-- key_value_pairs 사용, 다른 DB에서 실행 -->
+  <dynamicVar name="productPrices" type="key_value_pairs" description="제품 가격" database="mariaDB">
     <![CDATA[
       SELECT ProductID, UnitPrice FROM Products WHERE Discontinued = 0
     ]]>
@@ -571,6 +579,10 @@ WHERE CustomerID IN (${customerData.CustomerID})
 4. **성능**: 변수는 한 번 실행되고 전체 내보내기에 대해 캐시됩니다
 5. **디버그 모드**: 자세한 변수 치환을 위해 `DEBUG_VARIABLES=true`로 활성화
 
+참고:
+- `dynamicVar`에서 지원하는 속성: `name`, `description`, `type`, `db`, `database` (`db`는 별칭). 둘 다 있으면 `database`가 우선합니다.
+- `queryDef`는 XML 검증에서 `db` 속성을 허용합니다. 실행 시점의 DB는 시트의 `db` 또는 전역 기본 DB로 결정됩니다.
+
 ## 🕒 커스텀 날짜/시간 변수
 
 SQL2Excel은 원하는 형식으로 현재 날짜와 시간을 표시할 수 있는 강력한 커스텀 날짜 변수 시스템을 제공합니다. 이러한 변수는 쿼리, 파일 이름 및 모든 텍스트 콘텐츠에서 사용할 수 있습니다.

package.json

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