diff --git a/CHANGELOG.md b/CHANGELOG.md index 4353022..afaa8bf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,65 @@ # SQL2Excel Version History -## v1.3.3 - Docs Sync & Version Bump (2025-10-31) +## v2.1.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 - DB Adapter Test Query & Schema Alignment (2025-11-08) + +### โœจ New/Changed +- Adapter-level connection test SQL + - Added `getTestQuery()` to all DB adapters + - MSSQL: `SELECT 1 as test` + - MySQL/MariaDB: `SELECT 1 as test` + - PostgreSQL: `SELECT 1` + - SQLite: `SELECT 1` + - Oracle: `SELECT 1 FROM dual` + - `excel-cli.js` uses `adapter.getTestQuery()` for connection validation + +- Sample schema alignment for cross-DB consistency (Orders) + - PostgreSQL: added `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID` + - MySQL: added `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID` + - Purpose: match sample data columns and improve parity with MSSQL schema + +### ๐Ÿ› Fixes +- Oracle connection validation fixed during `list-dbs`/validation flows + - Replaced hardcoded `SELECT 1 as test` with adapter-provided query +- `excel-cli.js`: fixed broken `catch` in `loadDatabaseConfig()` and improved error message (`configFileLoadFailed`) + +### ๐Ÿ”ง Code Changes +- `src/database/OracleAdapter.js`: add `getTestQuery()` +- `src/database/MSSQLAdapter.js`: add `getTestQuery()` +- `src/database/MySQLAdapter.js`: add `getTestQuery()` +- `src/database/PostgreSQLAdapter.js`: add `getTestQuery()` +- `src/database/SQLiteAdapter.js`: add `getTestQuery()` +- `src/excel-cli.js`: use `adapter.getTestQuery()`; fix `loadDatabaseConfig()` catch block +- `resources/create_sample_tables_postgresql.sql`: add Orders columns (`SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID`) +- `resources/create_sample_tables_mysql.sql`: add Orders columns (`SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID`) + +### ๐Ÿ“ Notes +- These changes ensure sample data (PostgreSQL) loads cleanly across DBs when schemas are applied accordingly. + +## v2.1.4(v1.3.3) - Docs Sync & Version Bump (2025-10-31) ### โœจ New/Changed - Added `exceptColumns` attribute to exclude specific columns from sheet output @@ -18,7 +77,7 @@ ### ๐Ÿ“ Documentation - README/README_KR, USER_MANUAL/USER_MANUAL_KR, CHANGELOG/CHANGELOG_KR updated accordingly -## v1.3.2 - CSV/TXT Formatting & Directory Naming (2025-10-31) +## v2.1.2(v1.3.2) - CSV/TXT Formatting & Directory Naming (2025-10-31) ### โœจ New/Changed - Per-sheet export directory naming simplified @@ -43,7 +102,7 @@ - USER_MANUAL/USER_MANUAL_KR: Updated per-sheet export section to reflect new directory naming and formatting rules - CHANGELOG/CHANGELOG_KR: Added v1.3.2 entry -## v1.3.1 - Filename Variables and DATE Fixes (2025-10-30) +## v2.1.1-beta (v1.3.1) - Filename Variables and DATE Fixes (2025-10-30) ### โœจ New/Changed - Output filename variable enhancements @@ -66,7 +125,7 @@ - USER_MANUAL/USER_MANUAL_KR: Documented filename variables (`DB_NAME`, DATE), lowercase tokens, and local-time behavior - CHANGELOG/CHANGELOG_KR: Added v1.3.1 entry -## v1.3.0 - Per-sheet Export for CSV/TXT and Routing Rules (2025-10-29) +## v2.1.0-beta (v1.3.0) - Per-sheet Export for CSV/TXT and Routing Rules (2025-10-29) ### โœจ New/Changed - Export routing based on output extension @@ -93,7 +152,7 @@ - USER_MANUAL/USER_MANUAL_KR: Added section describing routing, directory/filename rules, and defaults - CHANGELOG/CHANGELOG_KR: Added v1.3.0 entry -## v1.2.11 - TOC Original Name & Sheet Name Length Warning (2025-10-29) +## v2.0.2-beta (v1.2.11) - TOC Original Name & Sheet Name Length Warning (2025-10-29) ### โœจ New/Changed - Sheet name length > 31 characters is now treated as a warning during validation (no failure) @@ -111,7 +170,7 @@ - README/README_KR: Updated highlights to v1.2.11, described changes - CHANGELOG: Added v1.2.11 entry -## v1.2.10 - Non-interactive CLI & Docs (2025-10-29) +## v2.0.1-beta (v1.2.10) - Non-interactive CLI & Docs (2025-10-29) ### โœจ New Features @@ -124,6 +183,95 @@ - README.md / README_KR.md: Added "Non-interactive CLI" usage and examples - Updated highlights to v1.2.10 +## v2.0.0-beta - Multi-Database Support (2025-10-22) + +### โœจ New Features +- **Multi-Database Support**: Support for multiple database types beyond MSSQL + - **Supported Databases**: MSSQL, MySQL, MariaDB + - **Unified Interface**: Consistent API across all database types + - **Database Factory Pattern**: Automatic adapter selection based on database type + - **Backward Compatibility**: Existing MSSQL configurations work without changes + +### ๐Ÿ”ง Configuration +```json +{ + "sampleDB": { + "type": "mssql", // Optional, defaults to "mssql" if not specified + "server": "localhost", + "port": 1433, + "database": "SampleDB", + "user": "sa", + "password": "password" + }, + "mysqlDB": { + "type": "mysql", // New: MySQL support + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password" + }, + "mariaDB": { + "type": "mariadb", // New: MariaDB support + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password" + } +} +``` + +### ๐Ÿ“ฆ Technical Changes +- **New Architecture**: + - `src/database/DatabaseFactory.js`: Factory for creating database adapters + - `src/database/MSSQLAdapter.js`: MSSQL implementation (refactored from mssql-helper.js) + - `src/database/MySQLAdapter.js`: MySQL/MariaDB implementation + +- **Updated Files**: + - `src/index.js`: Uses DatabaseFactory instead of direct MSSQLHelper + - `src/variable-processor.js`: Database-agnostic implementation + - `package.json`: Added `mysql2` dependency + +### ๐Ÿ”„ Database-Specific Features +- **MSSQL**: + - Uses `TOP N` for row limiting + - Supports `GETDATE()` function + +- **MySQL/MariaDB**: + - Uses `LIMIT N` for row limiting + - Converts `GETDATE()` to `NOW()` automatically + - Connection pooling with automatic reconnection + +### ๐Ÿ’ก Usage Examples +```xml + + + + SELECT * FROM users + + + + SELECT * FROM orders + + + + SELECT * FROM products + + +``` + +### โš ๏ธ Notes +- **Type Field**: The `type` field in database configuration is optional. If omitted, defaults to `mssql` for backward compatibility. +- **Port Numbers**: Default ports are used if not specified (MSSQL: 1433, MySQL/MariaDB: 3306) +- **Connection Pooling**: All database types use connection pooling for optimal performance + +### ๐Ÿ“š Dependencies +- Added: `mysql2@^3.6.0` - MySQL/MariaDB driver with promise support +- Maintained: `mssql@^10.0.0` - Microsoft SQL Server driver + +--- + ## v1.2.9 - Global Timezone System & Local Time Support (2025-10-21) ### โœจ New Features diff --git a/CHANGELOG_KR.md b/CHANGELOG_KR.md index f151491..1a932ce 100644 --- a/CHANGELOG_KR.md +++ b/CHANGELOG_KR.md @@ -1,6 +1,65 @@ # SQL2Excel ๋ฒ„์ „ ํžˆ์Šคํ† ๋ฆฌ -## v1.3.3 - ๋ฌธ์„œ ๋™๊ธฐํ™” ๋ฐ ๋ฒ„์ „ ์˜ฌ๋ฆผ (2025-10-31) +## v2.1.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 - DB ์–ด๋Œ‘ํ„ฐ ํ…Œ์ŠคํŠธ ์ฟผ๋ฆฌ ๋„์ž… ๋ฐ ์Šคํ‚ค๋งˆ ์ •ํ•ฉ์„ฑ (2025-11-08) + +### โœจ ๋ณ€๊ฒฝ ์‚ฌํ•ญ +- ์–ด๋Œ‘ํ„ฐ ๋‹จ์œ„ ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ SQL ๋„์ž… + - ๋ชจ๋“  DB ์–ด๋Œ‘ํ„ฐ์— `getTestQuery()` ์ถ”๊ฐ€ + - MSSQL: `SELECT 1 as test` + - MySQL/MariaDB: `SELECT 1 as test` + - PostgreSQL: `SELECT 1` + - SQLite: `SELECT 1` + - Oracle: `SELECT 1 FROM dual` + - `excel-cli.js`๋Š” ์—ฐ๊ฒฐ ๊ฒ€์ฆ ์‹œ ์–ด๋Œ‘ํ„ฐ์˜ `getTestQuery()`๋ฅผ ์‚ฌ์šฉ + +- ์ƒ˜ํ”Œ ์Šคํ‚ค๋งˆ ์ •ํ•ฉ์„ฑ(Orders) + - PostgreSQL: `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID` ์ถ”๊ฐ€ + - MySQL: `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID` ์ถ”๊ฐ€ + - ๋ชฉ์ : ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ปฌ๋Ÿผ๊ณผ ์ผ์น˜ ๋ฐ MSSQL ์Šคํ‚ค๋งˆ์™€์˜ ์ •ํ•ฉ์„ฑ ํ–ฅ์ƒ + +### ๐Ÿ› ๋ฒ„๊ทธ ์ˆ˜์ • +- Oracle ์—ฐ๊ฒฐ ๊ฒ€์ฆ ์˜ค๋ฅ˜ ์ˆ˜์ • (`list-dbs`/๊ฒ€์ฆ ํ”Œ๋กœ์šฐ) + - ํ•˜๋“œ์ฝ”๋”ฉ๋œ `SELECT 1 as test` โ†’ ์–ด๋Œ‘ํ„ฐ ์ œ๊ณต ํ…Œ์ŠคํŠธ ์ฟผ๋ฆฌ๋กœ ๋Œ€์ฒด +- `excel-cli.js`: `loadDatabaseConfig()`์˜ ๊นจ์ง„ `catch` ๋ธ”๋ก ์ˆ˜์ • ๋ฐ ์˜ค๋ฅ˜ ๋ฉ”์‹œ์ง€ ๊ฐœ์„ (`configFileLoadFailed`) + +### ๐Ÿ”ง ์ฝ”๋“œ ๋ณ€๊ฒฝ +- `src/database/OracleAdapter.js`: `getTestQuery()` ์ถ”๊ฐ€ +- `src/database/MSSQLAdapter.js`: `getTestQuery()` ์ถ”๊ฐ€ +- `src/database/MySQLAdapter.js`: `getTestQuery()` ์ถ”๊ฐ€ +- `src/database/PostgreSQLAdapter.js`: `getTestQuery()` ์ถ”๊ฐ€ +- `src/database/SQLiteAdapter.js`: `getTestQuery()` ์ถ”๊ฐ€ +- `src/excel-cli.js`: ์–ด๋Œ‘ํ„ฐ์˜ ํ…Œ์ŠคํŠธ ์ฟผ๋ฆฌ ์‚ฌ์šฉ; `loadDatabaseConfig()` catch ๋ธ”๋ก ์ˆ˜์ • +- `resources/create_sample_tables_postgresql.sql`: Orders ์ปฌ๋Ÿผ ์ถ”๊ฐ€ (`SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID`) +- `resources/create_sample_tables_mysql.sql`: Orders ์ปฌ๋Ÿผ ์ถ”๊ฐ€ (`SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID`) + +### ๐Ÿ“ ๋น„๊ณ  +- ๋ณธ ๋ณ€๊ฒฝ์œผ๋กœ ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ(PostgreSQL)๊ฐ€ ๊ฐ DB ์Šคํ‚ค๋งˆ ์ ์šฉ ์‹œ ์›ํ™œํžˆ ์ ์žฌ๋˜๋„๋ก ์ •ํ•ฉ์„ฑ์ด ๊ฐœ์„ ๋˜์—ˆ์Šต๋‹ˆ๋‹ค. + +## v2.1.3-beta (v1.3.3) - ๋ฌธ์„œ ๋™๊ธฐํ™” ๋ฐ ๋ฒ„์ „ ์˜ฌ๋ฆผ (2025-10-31) ### โœจ ๋ณ€๊ฒฝ ์‚ฌํ•ญ - ์‹œํŠธ์—์„œ ํŠน์ • ์ปฌ๋Ÿผ์„ ๊ฒฐ๊ณผ์—์„œ ์ œ์™ธํ•˜๋Š” `exceptColumns` ์†์„ฑ ์ถ”๊ฐ€ @@ -23,7 +82,7 @@ - KR/EN ๋ฌธ์„œ(README, USER_MANUAL, CHANGELOG) ๋™๊ธฐํ™” - ํŒจํ‚ค์ง€ ๋ฒ„์ „์„ 1.3.3์œผ๋กœ ์—…๋ฐ์ดํŠธ -## v1.3.1 - ํŒŒ์ผ๋ช… ๋ณ€์ˆ˜ ๋ฐ DATE ๊ฐœ์„  (2025-10-30) +## v2.1.1-beta (v1.3.1) - ํŒŒ์ผ๋ช… ๋ณ€์ˆ˜ ๋ฐ DATE ๊ฐœ์„  (2025-10-30) ### โœจ ๋ณ€๊ฒฝ ์‚ฌํ•ญ - ์ถœ๋ ฅ ํŒŒ์ผ๋ช… ๋ณ€์ˆ˜ ๊ธฐ๋Šฅ ๊ฐ•ํ™” @@ -46,7 +105,7 @@ - USER_MANUAL/USER_MANUAL_KR: ํŒŒ์ผ๋ช… ๋ณ€์ˆ˜(`DB_NAME`, DATE), ์†Œ๋ฌธ์ž ํ† ํฐ, ๋กœ์ปฌ ์‹œ๊ฐ„ ๋™์ž‘ ์„ค๋ช… ์ถ”๊ฐ€ - CHANGELOG/CHANGELOG_KR: v1.3.1 ํ•ญ๋ชฉ ์ถ”๊ฐ€ -## v1.3.0 - CSV/TXT ์‹œํŠธ๋ณ„ ๋‚ด๋ณด๋‚ด๊ธฐ ๋ฐ ๋ผ์šฐํŒ… ๊ทœ์น™ (2025-10-29) +## v2.1.0-beta (v1.3.0) - CSV/TXT ์‹œํŠธ๋ณ„ ๋‚ด๋ณด๋‚ด๊ธฐ ๋ฐ ๋ผ์šฐํŒ… ๊ทœ์น™ (2025-10-29) ### โœจ ๋ณ€๊ฒฝ ์‚ฌํ•ญ - ์ถœ๋ ฅ ํ™•์žฅ์ž์— ๋”ฐ๋ฅธ ๋ผ์šฐํŒ… @@ -73,7 +132,7 @@ - USER_MANUAL/USER_MANUAL_KR: ๋ผ์šฐํŒ…, ๋””๋ ‰ํ† ๋ฆฌ/ํŒŒ์ผ๋ช… ๊ทœ์น™, ๊ธฐ๋ณธ๊ฐ’ ์„น์…˜ ์ถ”๊ฐ€ - CHANGELOG/CHANGELOG_KR: v1.3.0 ํ•ญ๋ชฉ ์ถ”๊ฐ€ -## v1.2.11 - TOC ์›๋ณธ ์‹œํŠธ๋ช… ์ปฌ๋Ÿผ ๋ฐ ์‹œํŠธ๋ช… ๊ธธ์ด ๊ฒฝ๊ณ  (2025-10-29) +## v2.0.2-beta (v1.2.11) - TOC ์›๋ณธ ์‹œํŠธ๋ช… ์ปฌ๋Ÿผ ๋ฐ ์‹œํŠธ๋ช… ๊ธธ์ด ๊ฒฝ๊ณ  (2025-10-29) ### โœจ ๋ณ€๊ฒฝ ์‚ฌํ•ญ - ์‹œํŠธ๋ช… ๊ธธ์ด 31์ž ์ดˆ๊ณผ ์‹œ ์ด์ œ ๊ฒ€์ฆ์—์„œ ์˜ค๋ฅ˜๊ฐ€ ์•„๋‹Œ ๊ฒฝ๊ณ ๋กœ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค. @@ -91,7 +150,7 @@ - README/README_KR: v1.2.11 ํ•˜์ด๋ผ์ดํŠธ ๋ฐ ๋ณ€๊ฒฝ์  ๋ฐ˜์˜ - CHANGELOG/CHANGELOG_KR: v1.2.11 ํ•ญ๋ชฉ ์ถ”๊ฐ€ -## v1.2.10 - ๋น„๋Œ€ํ™”์‹ CLI ๋ฐ ๋ฌธ์„œ ์—…๋ฐ์ดํŠธ (2025-10-29) +## v2.0.1-beta (v1.2.10) - ๋น„๋Œ€ํ™”์‹ CLI ๋ฐ ๋ฌธ์„œ ์—…๋ฐ์ดํŠธ (2025-10-29) ### โœจ ์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ @@ -102,7 +161,96 @@ ### ๐Ÿ“ ๋ฌธ์„œ - README.md / README_KR.md: "๋น„๋Œ€ํ™”์‹ CLI" ์‚ฌ์šฉ๋ฒ•๊ณผ ์˜ˆ์‹œ ์ถ”๊ฐ€ -- ํ•˜์ด๋ผ์ดํŠธ๋ฅผ v1.3.0์œผ๋กœ ์—…๋ฐ์ดํŠธ + + +## v2.0.0-beta - ๋‹ค์ค‘ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ง€์› (2025-10-22) + +### โœจ ์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ +- **๋‹ค์ค‘ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ง€์›**: MSSQL ์™ธ ๋‹ค์–‘ํ•œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… ์ง€์› + - **์ง€์› ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค**: MSSQL, MySQL, MariaDB + - **ํ†ตํ•ฉ ์ธํ„ฐํŽ˜์ด์Šค**: ๋ชจ๋“  ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž…์— ๋Œ€ํ•œ ์ผ๊ด€๋œ API + - **๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํŒฉํ† ๋ฆฌ ํŒจํ„ด**: ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž…์— ๋”ฐ๋ผ ์ž๋™์œผ๋กœ ์ ์ ˆํ•œ ์–ด๋Œ‘ํ„ฐ ์„ ํƒ + - **ํ•˜์œ„ ํ˜ธํ™˜์„ฑ**: ๊ธฐ์กด MSSQL ์„ค์ •์€ ๋ณ€๊ฒฝ ์—†์ด ๊ทธ๋Œ€๋กœ ์ž‘๋™ + +### ๐Ÿ”ง ์„ค์ • +```json +{ + "sampleDB": { + "type": "mssql", // ์„ ํƒ์‚ฌํ•ญ, ์ง€์ •ํ•˜์ง€ ์•Š์œผ๋ฉด "mssql" ๊ธฐ๋ณธ๊ฐ’ ์‚ฌ์šฉ + "server": "localhost", + "port": 1433, + "database": "SampleDB", + "user": "sa", + "password": "password" + }, + "mysqlDB": { + "type": "mysql", // ์‹ ๊ทœ: MySQL ์ง€์› + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password" + }, + "mariaDB": { + "type": "mariadb", // ์‹ ๊ทœ: MariaDB ์ง€์› + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password" + } +} +``` + +### ๐Ÿ“ฆ ๊ธฐ์ˆ ์  ๋ณ€๊ฒฝ์‚ฌํ•ญ +- **์ƒˆ๋กœ์šด ์•„ํ‚คํ…์ฒ˜**: + - `src/database/DatabaseFactory.js`: ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์–ด๋Œ‘ํ„ฐ ์ƒ์„ฑ ํŒฉํ† ๋ฆฌ + - `src/database/MSSQLAdapter.js`: MSSQL ๊ตฌํ˜„ (mssql-helper.js์—์„œ ๋ฆฌํŒฉํ† ๋ง) + - `src/database/MySQLAdapter.js`: MySQL/MariaDB ๊ตฌํ˜„ + +- **์—…๋ฐ์ดํŠธ๋œ ํŒŒ์ผ**: + - `src/index.js`: MSSQLHelper ๋Œ€์‹  DatabaseFactory ์‚ฌ์šฉ + - `src/variable-processor.js`: ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๋…๋ฆฝ์ ์ธ ๊ตฌํ˜„ + - `package.json`: `mysql2` ์˜์กด์„ฑ ์ถ”๊ฐ€ + +### ๐Ÿ”„ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค๋ณ„ ํŠน์ง• +- **MSSQL**: + - ํ–‰ ์ œํ•œ์— `TOP N` ์‚ฌ์šฉ + - `GETDATE()` ํ•จ์ˆ˜ ์ง€์› + +- **MySQL/MariaDB**: + - ํ–‰ ์ œํ•œ์— `LIMIT N` ์‚ฌ์šฉ + - `GETDATE()`๋ฅผ `NOW()`๋กœ ์ž๋™ ๋ณ€ํ™˜ + - ์ž๋™ ์žฌ์—ฐ๊ฒฐ ๊ธฐ๋Šฅ์ด ์žˆ๋Š” ์—ฐ๊ฒฐ ํ’€๋ง + +### ๐Ÿ’ก ์‚ฌ์šฉ ์˜ˆ์‹œ +```xml + + + + SELECT * FROM users + + + + SELECT * FROM orders + + + + SELECT * FROM products + + +``` + +### โš ๏ธ ์ฐธ๊ณ ์‚ฌํ•ญ +- **Type ํ•„๋“œ**: ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์„ค์ •์˜ `type` ํ•„๋“œ๋Š” ์„ ํƒ์‚ฌํ•ญ์ž…๋‹ˆ๋‹ค. ์ƒ๋žตํ•˜๋ฉด ํ•˜์œ„ ํ˜ธํ™˜์„ฑ์„ ์œ„ํ•ด `mssql`์„ ๊ธฐ๋ณธ๊ฐ’์œผ๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. +- **ํฌํŠธ ๋ฒˆํ˜ธ**: ์ง€์ •ํ•˜์ง€ ์•Š์œผ๋ฉด ๊ธฐ๋ณธ ํฌํŠธ๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค (MSSQL: 1433, MySQL/MariaDB: 3306) +- **์—ฐ๊ฒฐ ํ’€๋ง**: ๋ชจ๋“  ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž…์€ ์ตœ์ ์˜ ์„ฑ๋Šฅ์„ ์œ„ํ•ด ์—ฐ๊ฒฐ ํ’€๋ง์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค + +### ๐Ÿ“š ์˜์กด์„ฑ +- ์ถ”๊ฐ€: `mysql2@^3.6.0` - Promise ์ง€์›์ด ํฌํ•จ๋œ MySQL/MariaDB ๋“œ๋ผ์ด๋ฒ„ +- ์œ ์ง€: `mssql@^10.0.0` - Microsoft SQL Server ๋“œ๋ผ์ด๋ฒ„ + +--- ## v1.2.9 - ๊ธ€๋กœ๋ฒŒ ํƒ€์ž„์กด ์‹œ์Šคํ…œ ๋ฐ ๋กœ์ปฌ ์‹œ๊ฐ„ ์ง€์› (2025-10-21) diff --git a/README.md b/README.md index 30029d9..2c40aea 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,25 @@ A Node.js-based tool for generating Excel files from SQL query results. -## v1.3.3 Highlights +## v2.1.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 Highlights + +- Adapter-level DB connection test queries + - Added `getTestQuery()` to all DB adapters + - MSSQL: `SELECT 1 as test`, MySQL/MariaDB: `SELECT 1 as test`, PostgreSQL: `SELECT 1`, SQLite: `SELECT 1`, Oracle: `SELECT 1 FROM dual` + - `excel-cli.js` now uses the adapterโ€™s test query for connection validation (fixes Oracle validation) +- Sample schema alignment (Orders) + - PostgreSQL/MySQL: added `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID` + - Aligns with sample data and improves parity with MSSQL schema + +## v2.1.3-beta (v1.3.3) Highlights - Documentation synchronization (KR/EN) and minor updates - Package version updated to 1.3.3 @@ -11,6 +29,7 @@ A Node.js-based tool for generating Excel files from SQL query results. - ๐Ÿ“Š **Multi-Sheet Support**: Save multiple SQL query results in separate sheets within one Excel file - ๐ŸŽจ **Template Style System**: Pre-defined Excel styling templates for consistent design with 7 built-in styles - ๐Ÿ”— **Multiple DB Connections**: Use different database connections for each sheet +- ๐Ÿ—„๏ธ **Multi-Database Support (v2.0.0-beta+)**: Support for MSSQL, MySQL, and MariaDB with unified interface - ๐Ÿ“ **Variable System**: Use variables in queries for dynamic query generation - ๐Ÿ”„ **Enhanced Dynamic Variables**: Extract values from database in real-time with advanced processing - ๐Ÿ”„ **Query Reuse**: Define common queries and reuse them across multiple sheets @@ -31,7 +50,19 @@ 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}`) -## v1.3.2 Highlights +## ๐Ÿ”— 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(v1.3.2) Highlights - Per-sheet export directory naming simplified - Directory is now `` (extension suffix removed) @@ -43,7 +74,7 @@ A Node.js-based tool for generating Excel files from SQL query results. - Record separators remain CRLF; headers included - Date values are serialized as `yyyy-MM-dd HH:mm:ss` (24-hour) in CSV/TXT and SQL literals -## v1.3.1 Highlights +## v2.1.1-beta (v1.3.1) Highlights - Filename variables in output path - Support `${DB_NAME}` (current DB key), custom syntax `$(DB_NAME}` normalized automatically @@ -51,7 +82,7 @@ A Node.js-based tool for generating Excel files from SQL query results. - Lowercase date tokens supported: `yyyy, yy, dd, d, hh, h, sss` - Removed auto `_yyyymmddhhmmss` suffix; control naming via DATE variables -## v1.3.0 Highlights +## v2.1.0-beta (v1.3.0) Highlights - **Per-sheet export routing by extension** - `.xlsx` / `.xls` โ†’ Generate a single Excel workbook (existing behavior) @@ -99,6 +130,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 @@ -115,12 +150,12 @@ sql2excel.exe --mode=help #### For Development/Source Code Usage - Node.js 16.0 or higher -- SQL Server 2012 or higher +- Database Server (MSSQL 2012+, MySQL 5.7+, or MariaDB 10.2+) - Appropriate database permissions #### For Standalone Executable Usage - Windows 10 or higher (64-bit) -- SQL Server 2012 or higher +- Database Server (MSSQL 2012+, MySQL 5.7+, or MariaDB 10.2+) - Appropriate database permissions - **No Node.js installation required** @@ -147,33 +182,47 @@ npm run build Create `config/dbinfo.json` file: ```json { - "dbs": { - "sampleDB": { - "server": "localhost", - "port": 1433, - "database": "SampleDB", - "user": "sa", - "password": "yourpassword", - "options": { - "encrypt": false, - "trustServerCertificate": true - } - }, - "erpDB": { - "server": "erp-server.com", - "port": 1433, - "database": "ERP_Database", - "user": "erp_user", - "password": "erp_password", - "options": { - "encrypt": true, - "trustServerCertificate": false - } + "sampleDB": { + "type": "mssql", + "server": "localhost", + "port": 1433, + "database": "SampleDB", + "user": "sa", + "password": "yourpassword", + "options": { + "encrypt": false, + "trustServerCertificate": true + } + }, + "mysqlDB": { + "type": "mysql", + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password", + "options": { + "connectionTimeout": 30000 + } + }, + "mariaDB": { + "type": "mariadb", + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password", + "options": { + "connectionTimeout": 30000 } } } ``` +**Note:** +- `type` field is optional. If not specified, defaults to `mssql` for backward compatibility. +- Supported types: `mssql`, `mysql`, `mariadb` + ## ๐Ÿš€ Basic Usage ### Language Settings @@ -366,7 +415,7 @@ The tool supports dynamic variables that can extract data at runtime and use it ```xml - + @@ -374,7 +423,7 @@ The tool supports dynamic variables that can extract data at runtime and use it - + diff --git a/README_KR.md b/README_KR.md index 3227b09..16528b2 100644 --- a/README_KR.md +++ b/README_KR.md @@ -2,7 +2,25 @@ SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ์—‘์…€ ํŒŒ์ผ๋กœ ์ƒ์„ฑํ•˜๋Š” Node.js ๊ธฐ๋ฐ˜ ๋„๊ตฌ์ž…๋‹ˆ๋‹ค. -## v1.3.3 ํ•˜์ด๋ผ์ดํŠธ +## v2.1.5 ํ•˜์ด๋ผ์ดํŠธ + +- ๋™์  ๋ณ€์ˆ˜ DB ๋ผ์šฐํŒ… + - XML์˜ `dynamicVar`์—์„œ `db`(= `database` ๋ณ„์นญ) ์†์„ฑ ์ง€์›. + - ๊ฐ ๋™์  ๋ณ€์ˆ˜๋Š” ์ง€์ •ํ•œ DB ์–ด๋Œ‘ํ„ฐ์—์„œ ์‹คํ–‰๋˜๋ฉฐ, ๋ฏธ์ง€์ • ์‹œ ๊ธฐ๋ณธ DB ์‚ฌ์šฉ. +- XML ๊ฒ€์ฆ ์—…๋ฐ์ดํŠธ + - XML ์Šคํ‚ค๋งˆ ๊ฒ€์ฆ์—์„œ `queryDef`์˜ `db` ์†์„ฑ์„ ํ—ˆ์šฉ. ์ฃผ์˜: ํ˜„์žฌ ์‹คํ–‰ DB๋Š” ์‹œํŠธ์˜ `db` ๋˜๋Š” ์ „์—ญ ๊ธฐ๋ณธ DB๊ฐ€ ์‚ฌ์šฉ๋˜๋ฉฐ, `queryDef.db`๋Š” ํ–ฅํ›„ ๋ฌธ์„œ/ํ™•์žฅ์šฉ. + +## v2.1.4 ํ•˜์ด๋ผ์ดํŠธ + +- ์–ด๋Œ‘ํ„ฐ๋ณ„ DB ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ ์ฟผ๋ฆฌ ๋„์ž… + - ๋ชจ๋“  DB ์–ด๋Œ‘ํ„ฐ์— `getTestQuery()` ์ถ”๊ฐ€ + - MSSQL/MySQL/MariaDB: `SELECT 1 as test`, PostgreSQL/SQLite: `SELECT 1`, Oracle: `SELECT 1 FROM dual` + - `excel-cli.js`๊ฐ€ ์–ด๋Œ‘ํ„ฐ์˜ ํ…Œ์ŠคํŠธ ์ฟผ๋ฆฌ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์—ฐ๊ฒฐ ๊ฒ€์ฆ ์ˆ˜ํ–‰ (Oracle ๊ฒ€์ฆ ์ด์Šˆ ํ•ด๊ฒฐ) +- ์ƒ˜ํ”Œ ์Šคํ‚ค๋งˆ ์ •ํ•ฉ์„ฑ(Orders) + - PostgreSQL/MySQL: `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID` ์ถ”๊ฐ€ + - ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ์™€ ์ปฌ๋Ÿผ ์ผ์น˜, MSSQL ์Šคํ‚ค๋งˆ์™€์˜ ์ •ํ•ฉ์„ฑ ํ–ฅ์ƒ + +## v2.1.3-beta (v1.3.3) ํ•˜์ด๋ผ์ดํŠธ - ๋ฌธ์„œ ๋™๊ธฐํ™”(KR/EN) ๋ฐ ์†Œ๊ทœ๋ชจ ์ •๋ฆฌ - ํŒจํ‚ค์ง€ ๋ฒ„์ „์„ 1.3.3์œผ๋กœ ์—…๋ฐ์ดํŠธ @@ -11,6 +29,7 @@ SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ์—‘์…€ ํŒŒ์ผ๋กœ ์ƒ์„ฑํ•˜๋Š” Node.js ๊ธฐ๋ฐ˜ ๋„๊ตฌ์ž…๋‹ˆ - ๐Ÿ“Š **๋‹ค์ค‘ ์‹œํŠธ ์ง€์›**: ํ•˜๋‚˜์˜ ์—‘์…€ ํŒŒ์ผ ๋‚ด์—์„œ ์—ฌ๋Ÿฌ SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ๋ณ„๋„์˜ ์‹œํŠธ์— ์ €์žฅ - ๐ŸŽจ **ํ…œํ”Œ๋ฆฟ ์Šคํƒ€์ผ ์‹œ์Šคํ…œ**: ์ผ๊ด€๋œ ๋””์ž์ธ์„ ์œ„ํ•œ ์‚ฌ์ „ ์ •์˜๋œ ์—‘์…€ ์Šคํƒ€์ผ๋ง ํ…œํ”Œ๋ฆฟ (7๊ฐ€์ง€ ๋‚ด์žฅ ์Šคํƒ€์ผ) - ๐Ÿ”— **๋‹ค์ค‘ DB ์—ฐ๊ฒฐ**: ๊ฐ ์‹œํŠธ๋งˆ๋‹ค ๋‹ค๋ฅธ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์‚ฌ์šฉ ๊ฐ€๋Šฅ +- ๐Ÿ—„๏ธ **๋‹ค์ค‘ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ง€์› (v2.0.0-beta+)**: MSSQL, MySQL, MariaDB๋ฅผ ํ†ตํ•ฉ ์ธํ„ฐํŽ˜์ด์Šค๋กœ ์ง€์› - ๐Ÿ“ **๋ณ€์ˆ˜ ์‹œ์Šคํ…œ**: ๋™์  ์ฟผ๋ฆฌ ์ƒ์„ฑ์„ ์œ„ํ•œ ๋ณ€์ˆ˜ ์‚ฌ์šฉ - ๐Ÿ”„ **ํ–ฅ์ƒ๋œ ๋™์  ๋ณ€์ˆ˜**: ์‹ค์‹œ๊ฐ„์œผ๋กœ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์—์„œ ๊ฐ’์„ ์ถ”์ถœํ•˜์—ฌ ๊ณ ๊ธ‰ ์ฒ˜๋ฆฌ - ๐Ÿ”„ **์ฟผ๋ฆฌ ์žฌ์‚ฌ์šฉ**: ๊ณตํ†ต ์ฟผ๋ฆฌ๋ฅผ ์ •์˜ํ•˜๊ณ  ์—ฌ๋Ÿฌ ์‹œํŠธ์—์„œ ์žฌ์‚ฌ์šฉ @@ -31,7 +50,19 @@ SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ์—‘์…€ ํŒŒ์ผ๋กœ ์ƒ์„ฑํ•˜๋Š” Node.js ๊ธฐ๋ฐ˜ ๋„๊ตฌ์ž…๋‹ˆ - ๐Ÿ”ง **์ž…๋ ฅ ์œ ํšจ์„ฑ ๊ฒ€์ฆ**: ํŒŒ์ผ ๊ฒฝ๋กœ ์ž…๋ ฅ์— ๋Œ€ํ•œ ์ž๋™ ๊ณต๋ฐฑ ์ œ๊ฑฐ - ๐Ÿ—‚๏ธ **ํŒŒ์ผ๋ช… ๋ณ€์ˆ˜**: `excel.output`์—์„œ `${DATE:...}`, `${DATE.TZ:...}`, `${DB_NAME}` ์‚ฌ์šฉ ๊ฐ€๋Šฅ (์ปค์Šคํ…€ `$(DB_NAME}`๋„ ์ง€์›) -## v1.3.2 ํ•˜์ด๋ผ์ดํŠธ +## ๐Ÿ”— ๋‹ค์ค‘ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์‚ฌ์šฉ + +- **์ง€์› ๋“œ๋ผ์ด๋ฒ„**: 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(v1.3.2) ํ•˜์ด๋ผ์ดํŠธ - ์‹œํŠธ๋ณ„ ๋‚ด๋ณด๋‚ด๊ธฐ ๋””๋ ‰ํ† ๋ฆฌ ๋ช…๋ช… ๋‹จ์ˆœํ™” - ๋””๋ ‰ํ† ๋ฆฌ๋Š” ์ด์ œ `<์ถœ๋ ฅํŒŒ์ผ๋ฒ ์ด์Šค>` (ํ™•์žฅ์ž ์ ‘๋ฏธ์‚ฌ ์ œ๊ฑฐ) @@ -43,7 +74,7 @@ SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ์—‘์…€ ํŒŒ์ผ๋กœ ์ƒ์„ฑํ•˜๋Š” Node.js ๊ธฐ๋ฐ˜ ๋„๊ตฌ์ž…๋‹ˆ - ๋ ˆ์ฝ”๋“œ ๊ตฌ๋ถ„ ๊ฐœํ–‰์€ CRLF ์œ ์ง€, ํ—ค๋” ํฌํ•จ - ๋‚ ์งœ ๊ฐ’์€ CSV/TXT ๋ฐ SQL ๋ฆฌํ„ฐ๋Ÿด์—์„œ `yyyy-MM-dd HH:mm:ss`(24์‹œ๊ฐ„) ํ˜•์‹์œผ๋กœ ์ง๋ ฌํ™” -## v1.3.1 ํ•˜์ด๋ผ์ดํŠธ +## v2.1.1-beta (v1.3.1) ํ•˜์ด๋ผ์ดํŠธ - ์ถœ๋ ฅ ๊ฒฝ๋กœ์—์„œ ํŒŒ์ผ๋ช… ๋ณ€์ˆ˜ ์ง€์› ๊ฐ•ํ™” - `${DB_NAME}` ์ง€์› (ํ˜„์žฌ ๊ธฐ๋ณธ DB ํ‚ค). ์ปค์Šคํ…€ ๋ฌธ๋ฒ• `$(DB_NAME}`๋Š” ์ž๋™์œผ๋กœ `${DB_NAME}`๋กœ ์ •๊ทœํ™” @@ -51,7 +82,7 @@ SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ์—‘์…€ ํŒŒ์ผ๋กœ ์ƒ์„ฑํ•˜๋Š” Node.js ๊ธฐ๋ฐ˜ ๋„๊ตฌ์ž…๋‹ˆ - ์†Œ๋ฌธ์ž ๋‚ ์งœ ํ† ํฐ ์ง€์›: `yyyy, yy, dd, d, hh, h, sss` - ์ž๋™ `_yyyymmddhhmmss` ์ ‘๋ฏธ์‚ฌ ์ œ๊ฑฐ โ†’ DATE ๋ณ€์ˆ˜๋กœ ์ง์ ‘ ์ œ์–ด -## v1.3.0 ํ•˜์ด๋ผ์ดํŠธ +## v2.1.0-beta (v1.3.0) ํ•˜์ด๋ผ์ดํŠธ - **ํ™•์žฅ์ž ๊ธฐ๋ฐ˜ ์‹œํŠธ๋ณ„ ๋‚ด๋ณด๋‚ด๊ธฐ ๋ผ์šฐํŒ…** - `.xlsx` / `.xls` โ†’ ๋‹จ์ผ ์—‘์…€ ํ†ตํ•ฉ๋ฌธ์„œ ์ƒ์„ฑ (๊ธฐ์กด ๋™์ž‘) @@ -99,6 +130,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 @@ -115,12 +150,12 @@ sql2excel.exe --mode=help #### ๊ฐœ๋ฐœ/์†Œ์Šค ์ฝ”๋“œ ์‚ฌ์šฉ ์‹œ - Node.js 16.0 ์ด์ƒ -- SQL Server 2012 ์ด์ƒ +- ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์„œ๋ฒ„ (MSSQL 2012+, MySQL 5.7+, ๋˜๋Š” MariaDB 10.2+) - ์ ์ ˆํ•œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๊ถŒํ•œ #### ๋…๋ฆฝ ์‹คํ–‰ ํŒŒ์ผ ์‚ฌ์šฉ ์‹œ - Windows 10 ์ด์ƒ (64๋น„ํŠธ) -- SQL Server 2012 ์ด์ƒ +- ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์„œ๋ฒ„ (MSSQL 2012+, MySQL 5.7+, ๋˜๋Š” MariaDB 10.2+) - ์ ์ ˆํ•œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๊ถŒํ•œ - **Node.js ์„ค์น˜ ๋ถˆํ•„์š”** @@ -147,33 +182,47 @@ npm run build `config/dbinfo.json` ํŒŒ์ผ์„ ์ƒ์„ฑํ•˜์„ธ์š”: ```json { - "dbs": { - "sampleDB": { - "server": "localhost", - "port": 1433, - "database": "SampleDB", - "user": "sa", - "password": "yourpassword", - "options": { - "encrypt": false, - "trustServerCertificate": true - } - }, - "erpDB": { - "server": "erp-server.com", - "port": 1433, - "database": "ERP_Database", - "user": "erp_user", - "password": "erp_password", - "options": { - "encrypt": true, - "trustServerCertificate": false - } + "sampleDB": { + "type": "mssql", + "server": "localhost", + "port": 1433, + "database": "SampleDB", + "user": "sa", + "password": "yourpassword", + "options": { + "encrypt": false, + "trustServerCertificate": true + } + }, + "mysqlDB": { + "type": "mysql", + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password", + "options": { + "connectionTimeout": 30000 + } + }, + "mariaDB": { + "type": "mariadb", + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password", + "options": { + "connectionTimeout": 30000 } } } ``` +**์ฐธ๊ณ :** +- `type` ํ•„๋“œ๋Š” ์„ ํƒ์‚ฌํ•ญ์ž…๋‹ˆ๋‹ค. ์ง€์ •ํ•˜์ง€ ์•Š์œผ๋ฉด ํ•˜์œ„ ํ˜ธํ™˜์„ฑ์„ ์œ„ํ•ด ๊ธฐ๋ณธ๊ฐ’ `mssql`์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. +- ์ง€์› ํƒ€์ž…: `mssql`, `mysql`, `mariadb` + ## ๐Ÿš€ ๊ธฐ๋ณธ ์‚ฌ์šฉ๋ฒ• ### ์–ธ์–ด ์„ค์ • @@ -366,7 +415,7 @@ node src/excel-cli.js export --xml ./queries/sales-report.xml \ ```xml - + @@ -374,7 +423,7 @@ node src/excel-cli.js export --xml ./queries/sales-report.xml \ - + diff --git a/USER_MANUAL.md b/USER_MANUAL.md index 2a8a133..c9a0ca8 100644 --- a/USER_MANUAL.md +++ b/USER_MANUAL.md @@ -19,7 +19,25 @@ 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 (v1.3.3) +### What's New (v2.1.5, 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, v1.3.4) + +- Adapter-level DB connection test queries + - Added `getTestQuery()` to all DB adapters + - MSSQL: `SELECT 1 as test`, MySQL/MariaDB: `SELECT 1 as test`, PostgreSQL: `SELECT 1`, SQLite: `SELECT 1`, Oracle: `SELECT 1 FROM dual` + - `excel-cli.js` now uses the adapterโ€™s test query for connection validation (fixes Oracle validation) +- Sample schema alignment (Orders) + - PostgreSQL/MySQL: added `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID` + - Aligns with sample data and improves parity with MSSQL schema + +### What's New (v2.1.3, v1.3.3) - Added `exceptColumns` sheet option (XML/JSON) to exclude specific columns from outputs - Documentation synchronization across KR/EN @@ -29,6 +47,7 @@ SQL2Excel is a powerful Node.js-based tool for generating Excel files from SQL q - ๐Ÿ“Š **Multi-Sheet Support**: Save multiple SQL query results in separate sheets within one Excel file - ๐ŸŽจ **Template Style System**: Pre-defined Excel styling templates for consistent design with 7 built-in styles - ๐Ÿ”— **Multiple DB Connections**: Use different database connections for each sheet +- ๐Ÿ—„๏ธ **Multi-Database Support (v2.0.0-beta+)**: Support for MSSQL, MySQL, and MariaDB with unified interface - ๐Ÿ“ **Variable System**: Use variables in queries for dynamic query generation - ๐Ÿ”„ **Enhanced Dynamic Variables**: Extract values from database in real-time with advanced processing - ๐Ÿ”„ **Query Reuse**: Define common queries and reuse them across multiple sheets @@ -44,11 +63,11 @@ SQL2Excel is a powerful Node.js-based tool for generating Excel files from SQL q - ๐ŸŒ **Multi-language Support**: Korean and English release packages - ๐Ÿ”ง **Release Automation**: Automated release package generation with proper documentation - ๐Ÿ•’ **Creation Timestamp**: Display creation timestamp on each Excel sheet -- โฐ **Enhanced DateTime Variables**: 20+ automatic datetime variables for real-time timestamp generation +- โฐ **Enhanced DateTime Variables**: 22 timezones worldwide with custom format support - ๐Ÿ“‹ **SQL Query Formatting**: Preserve original SQL formatting with line breaks in Table of Contents - ๐Ÿ”ง **Input Validation**: Automatic whitespace trimming for file path inputs -### What's New (v1.3.2) +### What's New (v2.1.2, v1.3.2) - Per-sheet export routing by extension - `.xlsx` / `.xls` โ†’ Generate a single Excel workbook (existing behavior) @@ -72,12 +91,12 @@ Previously in v1.2.11 #### For Development/Source Code Usage - Node.js 16.0 or higher -- SQL Server 2012 or higher +- Database Server (MSSQL 2012+, MySQL 5.7+, or MariaDB 10.2+) - Appropriate database permissions #### For Standalone Executable Usage - Windows 10 or higher (64-bit) -- SQL Server 2012 or higher +- Database Server (MSSQL 2012+, MySQL 5.7+, or MariaDB 10.2+) - Appropriate database permissions - **No Node.js installation required** @@ -102,26 +121,47 @@ npm run build ### 3. Database Connection Setup Create `config/dbinfo.json` file: + +#### Multi-Database Support (v2.0.0-beta+) ```json { - "dbs": { - "sampleDB": { - "server": "localhost", - "port": 1433, - "database": "SampleDB", - "user": "sa", - "password": "yourpassword", - "options": { - "encrypt": false, - "trustServerCertificate": true - } - }, - "erpDB": { - "server": "erp-server.com", - "port": 1433, - "database": "ERP_Database", - "user": "erp_user", - "password": "erp_password", + "sampleDB": { + "type": "mssql", // Optional: "mssql" (default), "mysql", or "mariadb" + "server": "localhost", + "port": 1433, + "database": "SampleDB", + "user": "sa", + "password": "yourpassword", + "options": { + "encrypt": false, + "trustServerCertificate": true + } + }, + "mysqlDB": { + "type": "mysql", // MySQL database + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password", + "options": { + "connectionTimeout": 30000 + } + }, + "mariaDB": { + "type": "mariadb", // MariaDB database + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password" + }, + "erpDB": { + "server": "erp-server.com", + "port": 1433, + "database": "ERP_Database", + "user": "erp_user", + "password": "erp_password", "options": { "encrypt": true, "trustServerCertificate": false @@ -414,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-beta+)โ€. +- **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-beta+)โ€ 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. @@ -495,15 +549,15 @@ The tool supports advanced dynamic variables that can extract data at runtime an #### XML Configuration ```xml - - + + - - + + @@ -527,6 +581,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. @@ -780,7 +838,137 @@ This feature works automatically - no configuration required! ## ๐ŸŽจ Advanced Features -### 1. Excel Styling +### 1. Multi-Database Support (v2.0.0-beta+) + +SQL2Excel now supports multiple database types with a unified interface: + +#### Supported Databases +- **MSSQL** (SQL Server 2012+) +- **MySQL** (5.7+) +- **MariaDB** (10.2+) + +#### Configuration +Add the `type` field to your database connection in `config/dbinfo.json`: + +```json +{ + "mssqlDB": { + "type": "mssql", // or omit for backward compatibility + "server": "localhost", + "port": 1433, + "database": "SampleDB", + "user": "sa", + "password": "password", + "options": { + "encrypt": false, + "trustServerCertificate": true + } + }, + "mysqlDB": { + "type": "mysql", + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password" + }, + "mariaDB": { + "type": "mariadb", + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password" + } +} +``` + +#### Mixed Database Queries +You can query different database types in a single Excel file: + +**XML Example:** +```xml + + + + + + + + + SELECT TOP 10 * FROM Customers + + + + + + + SELECT * FROM products LIMIT 10 + + + + + + + SELECT * FROM orders + WHERE order_date >= '2024-01-01' + LIMIT 20 + + + +``` + +**JSON Example:** +```json +{ + "excel": { + "output": "output/mixed_report.xlsx", + "db": "mssqlDB", + "style": "modern" + }, + "sheets": [ + { + "name": "MSSQL Data", + "db": "mssqlDB", + "query": "SELECT TOP 10 * FROM Customers" + }, + { + "name": "MySQL Data", + "db": "mysqlDB", + "query": "SELECT * FROM products LIMIT 10" + }, + { + "name": "MariaDB Data", + "db": "mariaDB", + "query": "SELECT * FROM orders WHERE order_date >= '2024-01-01' LIMIT 20" + } + ] +} +``` + +#### Database-Specific Features +- **MSSQL**: Supports `TOP N` clause, `GETDATE()` function +- **MySQL/MariaDB**: Supports `LIMIT N` clause, `NOW()` function +- **All**: Automatic syntax handling for each database type + +#### Testing Database Connections +Test all configured database connections: +```bash +# Development +node src/excel-cli.js list-dbs + +# Standalone executable +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 ```xml diff --git a/USER_MANUAL_KR.md b/USER_MANUAL_KR.md index 4045368..5bfe185 100644 --- a/USER_MANUAL_KR.md +++ b/USER_MANUAL_KR.md @@ -19,7 +19,25 @@ SQL2Excel์€ ๊ณ ๊ธ‰ ์Šคํƒ€์ผ๋ง, ํ…œํ”Œ๋ฆฟ ์ง€์›, ๋…๋ฆฝ ์‹คํ–‰ ํŒŒ์ผ ๋ฐฐํฌ ๊ธฐ๋Šฅ์„ ๊ฐ–์ถ˜ SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋กœ ์—‘์…€ ํŒŒ์ผ์„ ์ƒ์„ฑํ•˜๋Š” ๊ฐ•๋ ฅํ•œ Node.js ๊ธฐ๋ฐ˜ ๋„๊ตฌ์ž…๋‹ˆ๋‹ค. -### v1.3.3 ์ฃผ์š” ๋ณ€๊ฒฝ +### v2.1.5 ์ฃผ์š” ๋ณ€๊ฒฝ + +- ๋™์  ๋ณ€์ˆ˜ DB ๋ผ์šฐํŒ… + - XML `dynamicVar`์—์„œ `db` ์†์„ฑ ์ง€์› (`database`์˜ ๋ณ„์นญ) + - ๊ฐ ๋™์  ๋ณ€์ˆ˜๋Š” ์ง€์ •๋œ DB ์–ด๋Œ‘ํ„ฐ์—์„œ ์‹คํ–‰, ๋ฏธ์ง€์ • ์‹œ ์ „์—ญ ๊ธฐ๋ณธ DB ์‚ฌ์šฉ +- XML ๊ฒ€์ฆ ์—…๋ฐ์ดํŠธ + - XML ์Šคํ‚ค๋งˆ ๊ฒ€์ฆ์—์„œ `queryDef`์˜ `db` ์†์„ฑ ํ—ˆ์šฉ (์‹คํ–‰ DB๋Š” ์—ฌ์ „ํžˆ ์‹œํŠธ `db` ๋˜๋Š” ์ „์—ญ ๊ธฐ๋ณธ DB๋กœ ๊ฒฐ์ •) + +### v2.1.4 ์ฃผ์š” ๋ณ€๊ฒฝ + +- ์–ด๋Œ‘ํ„ฐ๋ณ„ DB ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ ์ฟผ๋ฆฌ ๋„์ž… + - ๋ชจ๋“  DB ์–ด๋Œ‘ํ„ฐ์— `getTestQuery()` ์ถ”๊ฐ€ + - MSSQL: `SELECT 1 as test`, MySQL/MariaDB: `SELECT 1 as test`, PostgreSQL: `SELECT 1`, SQLite: `SELECT 1`, Oracle: `SELECT 1 FROM dual` + - `excel-cli.js`๊ฐ€ ์–ด๋Œ‘ํ„ฐ์˜ ํ…Œ์ŠคํŠธ ์ฟผ๋ฆฌ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์—ฐ๊ฒฐ ๊ฒ€์ฆ ์ˆ˜ํ–‰ (Oracle ๊ฒ€์ฆ ์ด์Šˆ ํ•ด๊ฒฐ) +- ์ƒ˜ํ”Œ ์Šคํ‚ค๋งˆ ์ •ํ•ฉ์„ฑ(Orders) + - PostgreSQL/MySQL: `SubTotal`, `PaymentMethod`, `PaymentStatus`, `EmployeeID` ์ถ”๊ฐ€ + - ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ์™€ ์ปฌ๋Ÿผ ์ผ์น˜, MSSQL ์Šคํ‚ค๋งˆ์™€์˜ ์ •ํ•ฉ์„ฑ ํ–ฅ์ƒ + +### v2.1.3-beta (v1.3.3) ์ฃผ์š” ๋ณ€๊ฒฝ - ์‹œํŠธ์—์„œ ํŠน์ • ์ปฌ๋Ÿผ ์ œ์™ธ๋ฅผ ์œ„ํ•œ `exceptColumns` ์†์„ฑ ์ถ”๊ฐ€ (XML/JSON) @@ -27,6 +45,7 @@ SQL2Excel์€ ๊ณ ๊ธ‰ ์Šคํƒ€์ผ๋ง, ํ…œํ”Œ๋ฆฟ ์ง€์›, ๋…๋ฆฝ ์‹คํ–‰ ํŒŒ์ผ ๋ฐฐํฌ - ๐Ÿ“Š **๋‹ค์ค‘ ์‹œํŠธ ์ง€์›**: ํ•˜๋‚˜์˜ ์—‘์…€ ํŒŒ์ผ ๋‚ด์—์„œ ์—ฌ๋Ÿฌ SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ๋ณ„๋„์˜ ์‹œํŠธ์— ์ €์žฅ - ๐ŸŽจ **ํ…œํ”Œ๋ฆฟ ์Šคํƒ€์ผ ์‹œ์Šคํ…œ**: ์ผ๊ด€๋œ ๋””์ž์ธ์„ ์œ„ํ•œ ์‚ฌ์ „ ์ •์˜๋œ ์—‘์…€ ์Šคํƒ€์ผ๋ง ํ…œํ”Œ๋ฆฟ (7๊ฐ€์ง€ ๋‚ด์žฅ ์Šคํƒ€์ผ) - ๐Ÿ”— **๋‹ค์ค‘ DB ์—ฐ๊ฒฐ**: ๊ฐ ์‹œํŠธ๋งˆ๋‹ค ๋‹ค๋ฅธ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์‚ฌ์šฉ ๊ฐ€๋Šฅ +- ๐Ÿ—„๏ธ **๋‹ค์ค‘ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ง€์› (v2.0.0-beta+)**: MSSQL, MySQL, MariaDB๋ฅผ ํ†ตํ•ฉ ์ธํ„ฐํŽ˜์ด์Šค๋กœ ์ง€์› - ๐Ÿ“ **๋ณ€์ˆ˜ ์‹œ์Šคํ…œ**: ๋™์  ์ฟผ๋ฆฌ ์ƒ์„ฑ์„ ์œ„ํ•œ ๋ณ€์ˆ˜ ์‚ฌ์šฉ - ๐Ÿ”„ **ํ–ฅ์ƒ๋œ ๋™์  ๋ณ€์ˆ˜**: ์‹ค์‹œ๊ฐ„์œผ๋กœ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์—์„œ ๊ฐ’์„ ์ถ”์ถœํ•˜์—ฌ ๊ณ ๊ธ‰ ์ฒ˜๋ฆฌ - ๐Ÿ”„ **์ฟผ๋ฆฌ ์žฌ์‚ฌ์šฉ**: ๊ณตํ†ต ์ฟผ๋ฆฌ๋ฅผ ์ •์˜ํ•˜๊ณ  ์—ฌ๋Ÿฌ ์‹œํŠธ์—์„œ ์žฌ์‚ฌ์šฉ @@ -42,11 +61,11 @@ SQL2Excel์€ ๊ณ ๊ธ‰ ์Šคํƒ€์ผ๋ง, ํ…œํ”Œ๋ฆฟ ์ง€์›, ๋…๋ฆฝ ์‹คํ–‰ ํŒŒ์ผ ๋ฐฐํฌ - ๐ŸŒ **๋‹ค๊ตญ์–ด ์ง€์›**: ํ•œ๊ตญ์–ด ๋ฐ ์˜์–ด ๋ฆด๋ฆฌ์Šค ํŒจํ‚ค์ง€ - ๐Ÿ”ง **๋ฆด๋ฆฌ์Šค ์ž๋™ํ™”**: ์ ์ ˆํ•œ ๋ฌธ์„œ์™€ ํ•จ๊ป˜ ์ž๋™ ๋ฆด๋ฆฌ์Šค ํŒจํ‚ค์ง€ ์ƒ์„ฑ - ๐Ÿ•’ **์ƒ์„ฑ ํƒ€์ž„์Šคํƒฌํ”„**: ๊ฐ ์—‘์…€ ์‹œํŠธ์— ์ƒ์„ฑ ํƒ€์ž„์Šคํƒฌํ”„ ํ‘œ์‹œ -- โฐ **ํ–ฅ์ƒ๋œ DateTime ๋ณ€์ˆ˜**: ์‹ค์‹œ๊ฐ„ ํƒ€์ž„์Šคํƒฌํ”„ ์ƒ์„ฑ์„ ์œ„ํ•œ 20๊ฐœ ์ด์ƒ์˜ ์ž๋™ datetime ๋ณ€์ˆ˜ +- โฐ **ํ–ฅ์ƒ๋œ DateTime ๋ณ€์ˆ˜**: ์ „์„ธ๊ณ„ 22๊ฐœ ํƒ€์ž„์กด ์ง€์› ๋ฐ ์ปค์Šคํ…€ ํฌ๋งท - ๐Ÿ“‹ **SQL ์ฟผ๋ฆฌ ํฌ๋งทํŒ…**: ๋ชฉ์ฐจ์—์„œ ์ค„๋ฐ”๊ฟˆ์„ ํฌํ•จํ•œ ์›๋ณธ SQL ํฌ๋งท ์œ ์ง€ - ๐Ÿ”ง **์ž…๋ ฅ ์œ ํšจ์„ฑ ๊ฒ€์ฆ**: ํŒŒ์ผ ๊ฒฝ๋กœ ์ž…๋ ฅ์— ๋Œ€ํ•œ ์ž๋™ ๊ณต๋ฐฑ ์ œ๊ฑฐ -### What's New (v1.3.2) +### v2.1.2(v1.3.2) What's New - ํ™•์žฅ์ž ๊ธฐ๋ฐ˜ ์‹œํŠธ๋ณ„ ๋‚ด๋ณด๋‚ด๊ธฐ ๋ผ์šฐํŒ…(์œ ์ง€) - `.xlsx` / `.xls` โ†’ ๋‹จ์ผ ์—‘์…€ ํ†ตํ•ฉ๋ฌธ์„œ ์ƒ์„ฑ (๊ธฐ์กด ๋™์ž‘) @@ -71,12 +90,12 @@ SQL2Excel์€ ๊ณ ๊ธ‰ ์Šคํƒ€์ผ๋ง, ํ…œํ”Œ๋ฆฟ ์ง€์›, ๋…๋ฆฝ ์‹คํ–‰ ํŒŒ์ผ ๋ฐฐํฌ #### ๊ฐœ๋ฐœ/์†Œ์Šค ์ฝ”๋“œ ์‚ฌ์šฉ ์‹œ - Node.js 16.0 ์ด์ƒ -- SQL Server 2012 ์ด์ƒ +- ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์„œ๋ฒ„ (MSSQL 2012+, MySQL 5.7+, ๋˜๋Š” MariaDB 10.2+) - ์ ์ ˆํ•œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๊ถŒํ•œ #### ๋…๋ฆฝ ์‹คํ–‰ ํŒŒ์ผ ์‚ฌ์šฉ ์‹œ - Windows 10 ์ด์ƒ (64๋น„ํŠธ) -- SQL Server 2012 ์ด์ƒ +- ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์„œ๋ฒ„ (MSSQL 2012+, MySQL 5.7+, ๋˜๋Š” MariaDB 10.2+) - ์ ์ ˆํ•œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๊ถŒํ•œ - **Node.js ์„ค์น˜ ๋ถˆํ•„์š”** @@ -101,26 +120,47 @@ npm run build ### 3. ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์„ค์ • `config/dbinfo.json` ํŒŒ์ผ์„ ์ƒ์„ฑํ•˜์„ธ์š”: + +#### ๋‹ค์ค‘ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ง€์› (v2.0.0-beta+) ```json { - "dbs": { - "sampleDB": { - "server": "localhost", - "port": 1433, - "database": "SampleDB", - "user": "sa", - "password": "yourpassword", - "options": { - "encrypt": false, - "trustServerCertificate": true - } - }, - "erpDB": { - "server": "erp-server.com", - "port": 1433, - "database": "ERP_Database", - "user": "erp_user", - "password": "erp_password", + "sampleDB": { + "type": "mssql", // ์„ ํƒ์‚ฌํ•ญ: "mssql" (๊ธฐ๋ณธ๊ฐ’), "mysql", ๋˜๋Š” "mariadb" + "server": "localhost", + "port": 1433, + "database": "SampleDB", + "user": "sa", + "password": "yourpassword", + "options": { + "encrypt": false, + "trustServerCertificate": true + } + }, + "mysqlDB": { + "type": "mysql", // MySQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password", + "options": { + "connectionTimeout": 30000 + } + }, + "mariaDB": { + "type": "mariadb", // MariaDB ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password" + }, + "erpDB": { + "server": "erp-server.com", + "port": 1433, + "database": "ERP_Database", + "user": "erp_user", + "password": "erp_password", "options": { "encrypt": true, "trustServerCertificate": false @@ -426,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-beta+)โ€ ์„น์…˜ ์ฐธ๊ณ . +- **๋Ÿฐํƒ€์ž„ DB ์„ ํƒ ์šฐ์„ ์ˆœ์œ„ (v2.1.5+) + - ๊ธฐ๋ณธ DB ํ‚ค: CLI `--db` > `excel.db` + - ์‹œํŠธ๋ณ„: `sheet.db`๊ฐ€ ๊ธฐ๋ณธ DB๋ฅผ ์˜ค๋ฒ„๋ผ์ด๋“œ + - ๋™์  ๋ณ€์ˆ˜: `dynamicVar.database` ๋˜๋Š” `dynamicVar.db`๊ฐ€ ๊ธฐ๋ณธ DB๋ฅผ ์˜ค๋ฒ„๋ผ์ด๋“œ +- **ํ˜ผํ•ฉ ์‚ฌ์šฉ**: ํ•˜๋‚˜์˜ ๋‚ด๋ณด๋‚ด๊ธฐ์—์„œ ์„œ๋กœ ๋‹ค๋ฅธ DB๋ฅผ ๋™์‹œ์— ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. XML/JSON ์˜ˆ์‹œ๋Š” โ€œ๋‹ค์ค‘ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ง€์› (v2.0.0-beta+)โ€ ์„น์…˜์„ ์ฐธ๊ณ ํ•˜์„ธ์š”. +- **์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ**: ๋‚ด๋ณด๋‚ด๊ธฐ ์ „ `node src/excel-cli.js list-dbs`(๊ฐœ๋ฐœ) ๋˜๋Š” `sql2excel.exe list-dbs`(EXE)๋กœ ํ™•์ธํ•˜์„ธ์š”. +- **์–ด๋Œ‘ํ„ฐ ๋™์ž‘**: ํ–‰ ์ œํ•œ๊ณผ ํ•จ์ˆ˜๊ฐ€ DB๋ณ„๋กœ ์ž๋™ ์กฐ์ •๋ฉ๋‹ˆ๋‹ค (์˜ˆ: MSSQL=TOP, MySQL/MariaDB=LIMIT). +## ๐ŸŽจ ํ…œํ”Œ๋ฆฟ ์Šคํƒ€์ผ ์‹œ์Šคํ…œ | ์Šคํƒ€์ผ ID | ์ด๋ฆ„ | ์„ค๋ช… | |----------|------|------| | `default` | ๊ธฐ๋ณธ ์Šคํƒ€์ผ | ๊ธฐ๋ณธ ์—‘์…€ ์Šคํƒ€์ผ | @@ -507,15 +556,15 @@ node src/excel-cli.js export --xml queries.xml --style modern #### XML ๊ตฌ์„ฑ ```xml - - + + - - + + @@ -539,6 +588,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์€ ์›ํ•˜๋Š” ํ˜•์‹์œผ๋กœ ํ˜„์žฌ ๋‚ ์งœ์™€ ์‹œ๊ฐ„์„ ํ‘œ์‹œํ•  ์ˆ˜ ์žˆ๋Š” ๊ฐ•๋ ฅํ•œ ์ปค์Šคํ…€ ๋‚ ์งœ ๋ณ€์ˆ˜ ์‹œ์Šคํ…œ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ์ด๋Ÿฌํ•œ ๋ณ€์ˆ˜๋Š” ์ฟผ๋ฆฌ, ํŒŒ์ผ ์ด๋ฆ„ ๋ฐ ๋ชจ๋“  ํ…์ŠคํŠธ ์ฝ˜ํ…์ธ ์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. @@ -792,7 +845,137 @@ SQL2Excel์€ ์ƒ์„ฑ๋œ ๊ฐ ์—‘์…€ ์‹œํŠธ์— ์ž๋™์œผ๋กœ ์ƒ์„ฑ ํƒ€์ž„์Šคํƒฌํ”„ ## ๐ŸŽจ ๊ณ ๊ธ‰ ๊ธฐ๋Šฅ -### 1. ์—‘์…€ ์Šคํƒ€์ผ๋ง +### 1. ๋‹ค์ค‘ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ง€์› (v2.0.0-beta+) + +SQL2Excel์€ ์ด์ œ ํ†ตํ•ฉ ์ธํ„ฐํŽ˜์ด์Šค๋กœ ์—ฌ๋Ÿฌ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž…์„ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค: + +#### ์ง€์› ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค +- **MSSQL** (SQL Server 2012+) +- **MySQL** (5.7+) +- **MariaDB** (10.2+) + +#### ์„ค์ • +`config/dbinfo.json`์˜ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ์— `type` ํ•„๋“œ๋ฅผ ์ถ”๊ฐ€ํ•˜์„ธ์š”: + +```json +{ + "mssqlDB": { + "type": "mssql", // ๋˜๋Š” ํ•˜์œ„ ํ˜ธํ™˜์„ฑ์„ ์œ„ํ•ด ์ƒ๋žต ๊ฐ€๋Šฅ + "server": "localhost", + "port": 1433, + "database": "SampleDB", + "user": "sa", + "password": "password", + "options": { + "encrypt": false, + "trustServerCertificate": true + } + }, + "mysqlDB": { + "type": "mysql", + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password" + }, + "mariaDB": { + "type": "mariadb", + "server": "localhost", + "port": 3306, + "database": "mydb", + "user": "root", + "password": "password" + } +} +``` + +#### ํ˜ผํ•ฉ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ฟผ๋ฆฌ +๋‹จ์ผ Excel ํŒŒ์ผ์—์„œ ๋‹ค์–‘ํ•œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž…์„ ์ฟผ๋ฆฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค: + +**XML ์˜ˆ์ œ:** +```xml + + + + + + + + + SELECT TOP 10 * FROM Customers + + + + + + + SELECT * FROM products LIMIT 10 + + + + + + + SELECT * FROM orders + WHERE order_date >= '2024-01-01' + LIMIT 20 + + + +``` + +**JSON ์˜ˆ์ œ:** +```json +{ + "excel": { + "output": "output/mixed_report.xlsx", + "db": "mssqlDB", + "style": "modern" + }, + "sheets": [ + { + "name": "MSSQL ๋ฐ์ดํ„ฐ", + "db": "mssqlDB", + "query": "SELECT TOP 10 * FROM Customers" + }, + { + "name": "MySQL ๋ฐ์ดํ„ฐ", + "db": "mysqlDB", + "query": "SELECT * FROM products LIMIT 10" + }, + { + "name": "MariaDB ๋ฐ์ดํ„ฐ", + "db": "mariaDB", + "query": "SELECT * FROM orders WHERE order_date >= '2024-01-01' LIMIT 20" + } + ] +} +``` + +#### ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค๋ณ„ ๊ธฐ๋Šฅ +- **MSSQL**: `TOP N` ์ ˆ, `GETDATE()` ํ•จ์ˆ˜ ์ง€์› +- **MySQL/MariaDB**: `LIMIT N` ์ ˆ, `NOW()` ํ•จ์ˆ˜ ์ง€์› +- **์ „์ฒด**: ๊ฐ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž…์— ๋Œ€ํ•œ ์ž๋™ ๊ตฌ๋ฌธ ์ฒ˜๋ฆฌ + +#### ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ +๊ตฌ์„ฑ๋œ ๋ชจ๋“  ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ์„ ํ…Œ์ŠคํŠธํ•˜์„ธ์š”: +```bash +# ๊ฐœ๋ฐœ ํ™˜๊ฒฝ +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. ์—‘์…€ ์Šคํƒ€์ผ๋ง #### ๊ธ€๊ผด ์Šคํƒ€์ผ๋ง ```xml diff --git a/config/dbinfo.json b/config/dbinfo.json index cb5b822..4ae2e6d 100644 --- a/config/dbinfo.json +++ b/config/dbinfo.json @@ -1,5 +1,6 @@ { "sampleDB": { + "type": "mssql", "user": "sample", "password": "sample1234!", "server": "localhost", @@ -8,14 +9,38 @@ "options": { "encrypt": true, "trustServerCertificate": true } }, "erpDB": { - "user": "erp", - "password": "erp1234!", + "type": "mssql", + "user": "sample", + "password": "sample1234!", "server": "localhost", "database": "ERP_DB", "port": 1433, "options": { "encrypt": true, "trustServerCertificate": true } }, + "mysql": { + "type": "mysql", + "user": "sahara", + "password": "1111", + "server": "localhost", + "database": "etcdb", + "port": 3306, + "options": { + "connectionTimeout": 30000 + } + }, + "mariaDB": { + "type": "mariadb", + "user": "sahara", + "password": "1111", + "server": "localhost", + "database": "sampledb", + "port": 3306, + "options": { + "connectionTimeout": 3000 + } + }, "sourceDB": { + "type": "mssql", "user": "sample", "password": "sample1234!", "server": "localhost", @@ -27,8 +52,43 @@ "encrypt": true, "trustServerCertificate": true, "enableArithAbort": true, - "requestTimeout": 300000, - "connectionTimeout": 30000 + "requestTimeout": 3000, + "connectionTimeout": 3000 + } + }, + "postgresDB": { + "type": "postgresql", + "user": "postgres", + "password": "1111", + "server": "localhost", + "database": "postgres", + "port": 5432, + "options": { + "max": 10, + "idleTimeoutMillis": 3000, + "connectionTimeout": 3000 + } + }, + "sqliteDB": { + "type": "sqlite", + "database": "./data/mydb.sqlite", + "options": { + "mode": null + } + }, + "oracleDB": { + "type": "oracle", + "user": "c##scott", + "password": "tiger", + "server": "localhost", + "port": 1521, + "serviceName": "xe", + "options": { + "poolMin": 0, + "poolMax": 4, + "poolIncrement": 1, + "queueTimeout": 3000, + "stmtCacheSize": 30 } } -} \ No newline at end of file +} \ No newline at end of file diff --git a/package-lock.json b/package-lock.json index a61ae5d..260d39d 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,21 +1,25 @@ { "name": "sql2excel", - "version": "1.2.5", + "version": "2.1.5", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "sql2excel", - "version": "1.2.5", + "version": "2.1.5", "dependencies": { + "better-sqlite3": "^11.10.0", "exceljs": "^4.3.0", "json5": "^2.2.3", "mssql": "^10.0.0", + "mysql2": "^3.4.0", + "oracledb": "^6.6.0", + "pg": "^8.16.3", "xml2js": "^0.6.2", "yargs": "^17.7.2" }, "bin": { - "sql2excel": "src/excel-cli.js" + "sql2excel": "app.js" }, "devDependencies": { "pkg": "^5.8.1" @@ -807,6 +811,15 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/aws-ssl-profiles": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/aws-ssl-profiles/-/aws-ssl-profiles-1.1.2.tgz", + "integrity": "sha512-NZKeq9AfyQvEeNlN0zSYAaWrmBffJh3IELMZfRpJVWgrpEbtEpnjvzqBPf+mxoI287JohRDoa+/nsfqqiZmF6g==", + "license": "MIT", + "engines": { + "node": ">= 6.0.0" + } + }, "node_modules/balanced-match": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", @@ -833,6 +846,17 @@ ], "license": "MIT" }, + "node_modules/better-sqlite3": { + "version": "11.10.0", + "resolved": "https://registry.npmjs.org/better-sqlite3/-/better-sqlite3-11.10.0.tgz", + "integrity": "sha512-EwhOpyXiOEL/lKzHz9AW1msWFNzGc/z+LzeB3/jnFJpxu+th2yqvzsSWas1v9jgs9+xiXJcD5A8CJxAG2TaghQ==", + "hasInstallScript": true, + "license": "MIT", + "dependencies": { + "bindings": "^1.5.0", + "prebuild-install": "^7.1.1" + } + }, "node_modules/big-integer": { "version": "1.6.52", "resolved": "https://registry.npmjs.org/big-integer/-/big-integer-1.6.52.tgz", @@ -855,6 +879,15 @@ "node": "*" } }, + "node_modules/bindings": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz", + "integrity": "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==", + "license": "MIT", + "dependencies": { + "file-uri-to-path": "1.0.0" + } + }, "node_modules/bl": { "version": "4.1.0", "resolved": "https://registry.npmjs.org/bl/-/bl-4.1.0.tgz", @@ -1031,7 +1064,6 @@ "version": "1.1.4", "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz", "integrity": "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==", - "dev": true, "license": "ISC" }, "node_modules/cliui": { @@ -1205,7 +1237,6 @@ "version": "6.0.0", "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz", "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==", - "dev": true, "license": "MIT", "dependencies": { "mimic-response": "^3.1.0" @@ -1221,7 +1252,6 @@ "version": "0.6.0", "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz", "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==", - "dev": true, "license": "MIT", "engines": { "node": ">=4.0.0" @@ -1270,11 +1300,19 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/denque": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/denque/-/denque-2.1.0.tgz", + "integrity": "sha512-HVQE3AAb/pxF8fQAoiqpvg9i3evqug3hoiwakOyZAwJm+6vZehbkYXZ0l4JxS+I3QxM97v5aaRNhj8v5oBhekw==", + "license": "Apache-2.0", + "engines": { + "node": ">=0.10" + } + }, "node_modules/detect-libc": { "version": "2.0.4", "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.0.4.tgz", "integrity": "sha512-3UDv+G9CsCKO1WKMGw9fwq/SWJYbI0c5Y7LU1AXYoDdbhE2AHQ6N6Nb34sG8Fj7T5APy8qXDCKuuIHd1BR0tVA==", - "dev": true, "license": "Apache-2.0", "engines": { "node": ">=8" @@ -1579,7 +1617,6 @@ "version": "2.0.3", "resolved": "https://registry.npmjs.org/expand-template/-/expand-template-2.0.3.tgz", "integrity": "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==", - "dev": true, "license": "(MIT OR WTFPL)", "engines": { "node": ">=6" @@ -1625,6 +1662,12 @@ "reusify": "^1.0.4" } }, + "node_modules/file-uri-to-path": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz", + "integrity": "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==", + "license": "MIT" + }, "node_modules/fill-range": { "version": "7.1.1", "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", @@ -1786,6 +1829,15 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/generate-function": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/generate-function/-/generate-function-2.3.1.tgz", + "integrity": "sha512-eeB5GfMNeevm/GRYq20ShmsaGcmI81kIX2K9XQx5miC8KdHaC6Jm0qQ8ZNeGOi7wYB8OsdxKs+Y2oVuTFuVwKQ==", + "license": "MIT", + "dependencies": { + "is-property": "^1.0.2" + } + }, "node_modules/get-caller-file": { "version": "2.0.5", "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", @@ -1853,7 +1905,6 @@ "version": "0.0.0", "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz", "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==", - "dev": true, "license": "MIT" }, "node_modules/glob": { @@ -2138,7 +2189,6 @@ "version": "1.3.8", "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz", "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==", - "dev": true, "license": "ISC" }, "node_modules/internal-slot": { @@ -2427,6 +2477,12 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/is-property": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-property/-/is-property-1.0.2.tgz", + "integrity": "sha512-Ks/IoX00TtClbGQr4TWXemAnktAQvYB7HzcCxDGqEZU6oCmb2INHuOoKxbtR+HFkmYWBKv/dOZtGRiAjDhj92g==", + "license": "MIT" + }, "node_modules/is-regex": { "version": "1.2.1", "resolved": "https://registry.npmjs.org/is-regex/-/is-regex-1.2.1.tgz", @@ -2915,6 +2971,36 @@ "integrity": "sha512-xfBaXQd9ryd9dlSDvnvI0lvxfLJlYAZzXomUYzLKtUeOQvOP5piqAWuGtrhWeqaXK9hhoM/iyJc5AV+XfsX3HQ==", "license": "MIT" }, + "node_modules/long": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz", + "integrity": "sha512-mNAgZ1GmyNhD7AuqnTG3/VQ26o760+ZYBPKjPvugO8+nLbYfX6TVpJPseBvopbdY+qpZ/lKUnmEc1LeZYS3QAA==", + "license": "Apache-2.0" + }, + "node_modules/lru-cache": { + "version": "7.18.3", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-7.18.3.tgz", + "integrity": "sha512-jumlc0BIUrS3qJGgIkWZsyfAM7NCWiBcCDhnd+3NNM5KbBmLTgHVfWBcg6W+rLUsIpzpERPsvwUP7CckAQSOoA==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/lru.min": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/lru.min/-/lru.min-1.1.2.tgz", + "integrity": "sha512-Nv9KddBcQSlQopmBHXSsZVY5xsdlZkdH/Iey0BlcBYggMd4two7cZnKOK9vmy3nY0O5RGH99z1PCeTpPqszUYg==", + "license": "MIT", + "engines": { + "bun": ">=1.0.0", + "deno": ">=1.30.0", + "node": ">=8.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wellwelwel" + } + }, "node_modules/math-intrinsics": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", @@ -2952,7 +3038,6 @@ "version": "3.1.0", "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz", "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==", - "dev": true, "license": "MIT", "engines": { "node": ">=10" @@ -2998,7 +3083,6 @@ "version": "0.5.3", "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz", "integrity": "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==", - "dev": true, "license": "MIT" }, "node_modules/ms": { @@ -3052,11 +3136,58 @@ "readable-stream": "^3.6.0" } }, + "node_modules/mysql2": { + "version": "3.15.3", + "resolved": "https://registry.npmjs.org/mysql2/-/mysql2-3.15.3.tgz", + "integrity": "sha512-FBrGau0IXmuqg4haEZRBfHNWB5mUARw6hNwPDXXGg0XzVJ50mr/9hb267lvpVMnhZ1FON3qNd4Xfcez1rbFwSg==", + "license": "MIT", + "dependencies": { + "aws-ssl-profiles": "^1.1.1", + "denque": "^2.1.0", + "generate-function": "^2.3.1", + "iconv-lite": "^0.7.0", + "long": "^5.2.1", + "lru.min": "^1.0.0", + "named-placeholders": "^1.1.3", + "seq-queue": "^0.0.5", + "sqlstring": "^2.3.2" + }, + "engines": { + "node": ">= 8.0" + } + }, + "node_modules/mysql2/node_modules/iconv-lite": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.0.tgz", + "integrity": "sha512-cf6L2Ds3h57VVmkZe+Pn+5APsT7FpqJtEhhieDCvrE2MK5Qk9MyffgQyuxQTm6BChfeZNtcOLHp9IcWRVcIcBQ==", + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/named-placeholders": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/named-placeholders/-/named-placeholders-1.1.3.tgz", + "integrity": "sha512-eLoBxg6wE/rZkJPhU/xRX1WTpkFEwDJEN96oxFrTsqBdbT5ec295Q+CoHrL9IT0DipqKhmGcaZmwOt8OON5x1w==", + "license": "MIT", + "dependencies": { + "lru-cache": "^7.14.1" + }, + "engines": { + "node": ">=12.0.0" + } + }, "node_modules/napi-build-utils": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/napi-build-utils/-/napi-build-utils-1.0.2.tgz", "integrity": "sha512-ONmRUqK7zj7DWX0D9ADe03wbwOBZxNAfF20PlGfCWQcD3+/MakShIHrMqx9YwPTfxDdF1zLeL+RGZiR9kGMLdg==", - "dev": true, "license": "MIT" }, "node_modules/native-duplexpair": { @@ -3069,7 +3200,6 @@ "version": "3.75.0", "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.75.0.tgz", "integrity": "sha512-OhYaY5sDsIka7H7AtijtI9jwGYLyl29eQn/W623DiN/MIv5sUqc4g7BIDThX+gb7di9f6xK02nkp8sdfFWZLTg==", - "dev": true, "license": "MIT", "dependencies": { "semver": "^7.3.5" @@ -3181,6 +3311,16 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/oracledb": { + "version": "6.10.0", + "resolved": "https://registry.npmjs.org/oracledb/-/oracledb-6.10.0.tgz", + "integrity": "sha512-kGUumXmrEWbSpBuKJyb9Ip3rXcNgKK6grunI3/cLPzrRvboZ6ZoLi9JQ+z6M/RIG924tY8BLflihL4CKKQAYMA==", + "hasInstallScript": true, + "license": "(Apache-2.0 OR UPL-1.0)", + "engines": { + "node": ">=14.17" + } + }, "node_modules/own-keys": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/own-keys/-/own-keys-1.0.1.tgz", @@ -3240,6 +3380,95 @@ "node": ">=8" } }, + "node_modules/pg": { + "version": "8.16.3", + "resolved": "https://registry.npmjs.org/pg/-/pg-8.16.3.tgz", + "integrity": "sha512-enxc1h0jA/aq5oSDMvqyW3q89ra6XIIDZgCX9vkMrnz5DFTw/Ny3Li2lFQ+pt3L6MCgm/5o2o8HW9hiJji+xvw==", + "license": "MIT", + "dependencies": { + "pg-connection-string": "^2.9.1", + "pg-pool": "^3.10.1", + "pg-protocol": "^1.10.3", + "pg-types": "2.2.0", + "pgpass": "1.0.5" + }, + "engines": { + "node": ">= 16.0.0" + }, + "optionalDependencies": { + "pg-cloudflare": "^1.2.7" + }, + "peerDependencies": { + "pg-native": ">=3.0.1" + }, + "peerDependenciesMeta": { + "pg-native": { + "optional": true + } + } + }, + "node_modules/pg-cloudflare": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/pg-cloudflare/-/pg-cloudflare-1.2.7.tgz", + "integrity": "sha512-YgCtzMH0ptvZJslLM1ffsY4EuGaU0cx4XSdXLRFae8bPP4dS5xL1tNB3k2o/N64cHJpwU7dxKli/nZ2lUa5fLg==", + "license": "MIT", + "optional": true + }, + "node_modules/pg-connection-string": { + "version": "2.9.1", + "resolved": "https://registry.npmjs.org/pg-connection-string/-/pg-connection-string-2.9.1.tgz", + "integrity": "sha512-nkc6NpDcvPVpZXxrreI/FOtX3XemeLl8E0qFr6F2Lrm/I8WOnaWNhIPK2Z7OHpw7gh5XJThi6j6ppgNoaT1w4w==", + "license": "MIT" + }, + "node_modules/pg-int8": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/pg-int8/-/pg-int8-1.0.1.tgz", + "integrity": "sha512-WCtabS6t3c8SkpDBUlb1kjOs7l66xsGdKpIPZsg4wR+B3+u9UAum2odSsF9tnvxg80h4ZxLWMy4pRjOsFIqQpw==", + "license": "ISC", + "engines": { + "node": ">=4.0.0" + } + }, + "node_modules/pg-pool": { + "version": "3.10.1", + "resolved": "https://registry.npmjs.org/pg-pool/-/pg-pool-3.10.1.tgz", + "integrity": "sha512-Tu8jMlcX+9d8+QVzKIvM/uJtp07PKr82IUOYEphaWcoBhIYkoHpLXN3qO59nAI11ripznDsEzEv8nUxBVWajGg==", + "license": "MIT", + "peerDependencies": { + "pg": ">=8.0" + } + }, + "node_modules/pg-protocol": { + "version": "1.10.3", + "resolved": "https://registry.npmjs.org/pg-protocol/-/pg-protocol-1.10.3.tgz", + "integrity": "sha512-6DIBgBQaTKDJyxnXaLiLR8wBpQQcGWuAESkRBX/t6OwA8YsqP+iVSiond2EDy6Y/dsGk8rh/jtax3js5NeV7JQ==", + "license": "MIT" + }, + "node_modules/pg-types": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/pg-types/-/pg-types-2.2.0.tgz", + "integrity": "sha512-qTAAlrEsl8s4OiEQY69wDvcMIdQN6wdz5ojQiOy6YRMuynxenON0O5oCpJI6lshc6scgAY8qvJ2On/p+CXY0GA==", + "license": "MIT", + "dependencies": { + "pg-int8": "1.0.1", + "postgres-array": "~2.0.0", + "postgres-bytea": "~1.0.0", + "postgres-date": "~1.0.4", + "postgres-interval": "^1.1.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/pgpass": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/pgpass/-/pgpass-1.0.5.tgz", + "integrity": "sha512-FdW9r/jQZhSeohs1Z3sI1yxFQNFvMcnmfuj4WBMUTxOrAyLMaTcE1aAMBiTlbMNaXvBCQuVi0R7hd8udDSP7ug==", + "license": "MIT", + "dependencies": { + "split2": "^4.1.0" + } + }, "node_modules/picomatch": { "version": "2.3.1", "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", @@ -3384,11 +3613,49 @@ "node": ">= 0.4" } }, + "node_modules/postgres-array": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/postgres-array/-/postgres-array-2.0.0.tgz", + "integrity": "sha512-VpZrUqU5A69eQyW2c5CA1jtLecCsN2U/bD6VilrFDWq5+5UIEVO7nazS3TEcHf1zuPYO/sqGvUvW62g86RXZuA==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/postgres-bytea": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/postgres-bytea/-/postgres-bytea-1.0.0.tgz", + "integrity": "sha512-xy3pmLuQqRBZBXDULy7KbaitYqLcmxigw14Q5sj8QBVLqEwXfeybIKVWiqAXTlcvdvb0+xkOtDbfQMOf4lST1w==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/postgres-date": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/postgres-date/-/postgres-date-1.0.7.tgz", + "integrity": "sha512-suDmjLVQg78nMK2UZ454hAG+OAW+HQPZ6n++TNDUX+L0+uUlLywnoxJKDou51Zm+zTCjrCl0Nq6J9C5hP9vK/Q==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/postgres-interval": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/postgres-interval/-/postgres-interval-1.2.0.tgz", + "integrity": "sha512-9ZhXKM/rw350N1ovuWHbGxnGh/SNJ4cnxHiM0rxE4VN41wsg8P8zWn9hv/buK00RP4WvlOyr/RBDiptyxVbkZQ==", + "license": "MIT", + "dependencies": { + "xtend": "^4.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/prebuild-install": { "version": "7.1.1", "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.1.tgz", "integrity": "sha512-jAXscXWMcCK8GgCoHOfIr0ODh5ai8mj63L2nWrjuAgXE6tDyYGnx4/8o/rCgU+B4JSyZBKbeZqzhtwtC3ovxjw==", - "dev": true, "license": "MIT", "dependencies": { "detect-libc": "^2.0.0", @@ -3440,7 +3707,6 @@ "version": "3.0.3", "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.3.tgz", "integrity": "sha512-todwxLMY7/heScKmntwQG8CXVkWUOdYxIvY2s0VWAAMh/nd8SoYiRaKjlr7+iCs984f2P8zvrfWcDDYVb73NfA==", - "dev": true, "license": "MIT", "dependencies": { "end-of-stream": "^1.1.0", @@ -3472,7 +3738,6 @@ "version": "1.2.8", "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz", "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==", - "dev": true, "license": "(BSD-2-Clause OR MIT OR Apache-2.0)", "dependencies": { "deep-extend": "^0.6.0", @@ -3778,6 +4043,11 @@ "node": ">=10" } }, + "node_modules/seq-queue": { + "version": "0.0.5", + "resolved": "https://registry.npmjs.org/seq-queue/-/seq-queue-0.0.5.tgz", + "integrity": "sha512-hr3Wtp/GZIc/6DAGPDcV4/9WoZhjrkXsi5B/07QgX8tsdc6ilr7BFM6PM6rbdAX1kFSDYeZGLipIZZKyQP0O5Q==" + }, "node_modules/set-function-length": { "version": "1.2.2", "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz", @@ -3906,7 +4176,6 @@ "version": "1.0.1", "resolved": "https://registry.npmjs.org/simple-concat/-/simple-concat-1.0.1.tgz", "integrity": "sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==", - "dev": true, "funding": [ { "type": "github", @@ -3927,7 +4196,6 @@ "version": "4.0.1", "resolved": "https://registry.npmjs.org/simple-get/-/simple-get-4.0.1.tgz", "integrity": "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==", - "dev": true, "funding": [ { "type": "github", @@ -3959,12 +4227,30 @@ "node": ">=8" } }, + "node_modules/split2": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/split2/-/split2-4.2.0.tgz", + "integrity": "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==", + "license": "ISC", + "engines": { + "node": ">= 10.x" + } + }, "node_modules/sprintf-js": { "version": "1.1.3", "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.1.3.tgz", "integrity": "sha512-Oo+0REFV59/rz3gfJNKQiBlwfHaSESl1pcGyABQsnnIfWOFt6JNj5gCog2U6MLZ//IGYD+nA8nI+mTShREReaA==", "license": "BSD-3-Clause" }, + "node_modules/sqlstring": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/sqlstring/-/sqlstring-2.3.3.tgz", + "integrity": "sha512-qC9iz2FlN7DQl3+wjwn3802RTyjCx7sDvfQEXchwa6CWOx07/WVfh91gBmQ9fahw8snwGEWU3xGzOt4tFyHLxg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, "node_modules/stop-iteration-iterator": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/stop-iteration-iterator/-/stop-iteration-iterator-1.1.0.tgz", @@ -4133,7 +4419,6 @@ "version": "2.0.1", "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz", "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==", - "dev": true, "license": "MIT", "engines": { "node": ">=0.10.0" @@ -4169,7 +4454,6 @@ "version": "2.1.4", "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.4.tgz", "integrity": "sha512-mDAjwmZdh7LTT6pNleZ05Yt65HC3E+NiQzl672vQG38jIrehtJk/J3mNwIg+vShQPcLF/LV7CMnDW6vjj6sfYQ==", - "dev": true, "license": "MIT", "dependencies": { "chownr": "^1.1.1", @@ -4335,7 +4619,6 @@ "version": "0.6.0", "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz", "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==", - "dev": true, "license": "Apache-2.0", "dependencies": { "safe-buffer": "^5.0.1" @@ -4669,6 +4952,15 @@ "integrity": "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==", "license": "MIT" }, + "node_modules/xtend": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz", + "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==", + "license": "MIT", + "engines": { + "node": ">=0.4" + } + }, "node_modules/y18n": { "version": "5.0.8", "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", diff --git a/package.json b/package.json index 2c24272..ba56e4c 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "sql2excel", - "version": "1.3.3", + "version": "2.1.5", "description": "SQL ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ์—‘์…€ ํŒŒ์ผ๋กœ ์ €์žฅํ•˜๋Š” ๋„๊ตฌ (์‹œํŠธ๋ณ„ ์ฟผ๋ฆฌ, ๋ณ€์ˆ˜, XML/JSON ์ง€์›)", "main": "app.js", "scripts": { @@ -28,7 +28,11 @@ "templates/**/*.xml", ".env", "node_modules/mssql/**/*", - "node_modules/tedious/**/*" + "node_modules/tedious/**/*", + "node_modules/mysql2/**/*", + "node_modules/pg/**/*", + "node_modules/better-sqlite3/**/*", + "node_modules/oracledb/**/*" ], "targets": [ "node18-win-x64" @@ -36,11 +40,15 @@ "outputPath": "dist" }, "dependencies": { - "mssql": "^10.0.0", + "better-sqlite3": "^11.10.0", "exceljs": "^4.3.0", "json5": "^2.2.3", - "yargs": "^17.7.2", - "xml2js": "^0.6.2" + "mssql": "^10.0.0", + "mysql2": "^3.4.0", + "pg": "^8.16.3", + "oracledb": "^6.6.0", + "xml2js": "^0.6.2", + "yargs": "^17.7.2" }, "devDependencies": { "pkg": "^5.8.1" diff --git a/queries/backup-data-test.xml b/queries/backup-data-test.xml index 493607d..a1fbdf1 100644 --- a/queries/backup-data-test.xml +++ b/queries/backup-data-test.xml @@ -116,4 +116,135 @@ ]]> - \ No newline at end of file + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/queries/mariadb-test.xml b/queries/mariadb-test.xml new file mode 100644 index 0000000..5b459e3 --- /dev/null +++ b/queries/mariadb-test.xml @@ -0,0 +1,69 @@ + + + + + + + + + SELECT + '์„œ์šธ' as city, + '${DATE.KST:YYYY๋…„ MM์›” DD์ผ HH์‹œ mm๋ถ„ ss์ดˆ}' as time + UNION ALL + SELECT '๋‰ด์š•', '${DATE.EST:YYYY-MM-DD HH:mm:ss}' + UNION ALL + SELECT '๋Ÿฐ๋˜', '${DATE.GMT:YYYY-MM-DD HH:mm:ss}' + UNION ALL + SELECT '๋„์ฟ„', '${DATE.JST:YYYY-MM-DD HH:mm:ss}' + UNION ALL + SELECT '์‹œ๋“œ๋‹ˆ', '${DATE.AEST:YYYY-MM-DD HH:mm:ss}' + + + + + + SELECT + SCHEMA_NAME as '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค๋ช…', + DEFAULT_CHARACTER_SET_NAME as '๋ฌธ์ž์…‹', + DEFAULT_COLLATION_NAME as '์ฝœ๋ ˆ์ด์…˜' + FROM information_schema.SCHEMATA + WHERE SCHEMA_NAME NOT IN ('information_schema', 'mysql', 'performance_schema', 'sys') + ORDER BY SCHEMA_NAME + + + + + + SELECT + TABLE_SCHEMA as '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค', + TABLE_NAME as 'ํ…Œ์ด๋ธ”๋ช…', + TABLE_ROWS as 'ํ–‰์ˆ˜', + ROUND(DATA_LENGTH / 1024 / 1024, 2) as '๋ฐ์ดํ„ฐํฌ๊ธฐ_MB', + ROUND(INDEX_LENGTH / 1024 / 1024, 2) as '์ธ๋ฑ์Šคํฌ๊ธฐ_MB', + ROUND((DATA_LENGTH + INDEX_LENGTH) / 1024 / 1024, 2) as '์ดํฌ๊ธฐ_MB' + FROM information_schema.TABLES + WHERE TABLE_SCHEMA NOT IN ('information_schema', 'mysql', 'performance_schema', 'sys') + ORDER BY (DATA_LENGTH + INDEX_LENGTH) DESC + LIMIT 50 + + + + + + SELECT + VARIABLE_NAME as '๋ณ€์ˆ˜๋ช…', + VARIABLE_VALUE as '๊ฐ’' + FROM information_schema.GLOBAL_VARIABLES + WHERE VARIABLE_NAME LIKE '%version%' + OR VARIABLE_NAME LIKE '%character%' + OR VARIABLE_NAME LIKE '%collation%' + ORDER BY VARIABLE_NAME + LIMIT 30 + + + + + diff --git a/queries/mysql-simple-test.json b/queries/mysql-simple-test.json new file mode 100644 index 0000000..fcf5054 --- /dev/null +++ b/queries/mysql-simple-test.json @@ -0,0 +1,34 @@ +{ + "excel": { + "output": "output/mysql_simple_${DATE.KST:YYYYMMDD}.xlsx", + "db": "mysql", + "style": "default" + }, + "globalVars": { + "reportTitle": "MySQL Database Report", + "reportDate": "2024" + }, + "sheets": [ + { + "name": "Database Info", + "db": "mysql", + "query": "SELECT SCHEMA_NAME as db_name, DEFAULT_CHARACTER_SET_NAME as charset, DEFAULT_COLLATION_NAME as collation FROM information_schema.SCHEMATA ORDER BY SCHEMA_NAME LIMIT 20" + }, + { + "name": "MySQL Version", + "db": "mysql", + "query": "SELECT @@version as version, @@version_comment as comment, NOW() as `current_time`" + }, + { + "name": "Table Statistics", + "db": "mysql", + "query": "SELECT TABLE_SCHEMA as db_name, COUNT(*) as table_count, SUM(TABLE_ROWS) as total_rows FROM information_schema.TABLES WHERE TABLE_SCHEMA NOT IN ('information_schema', 'mysql', 'performance_schema', 'sys') GROUP BY TABLE_SCHEMA" + }, + { + "name": "MSSQL Test", + "db": "sampleDB", + "query": "SELECT TOP 5 name, database_id, create_date FROM sys.databases ORDER BY name" + } + ] +} + diff --git a/queries/mysql-test-queries.xml b/queries/mysql-test-queries.xml new file mode 100644 index 0000000..23890d1 --- /dev/null +++ b/queries/mysql-test-queries.xml @@ -0,0 +1,130 @@ + + + + + + + + + + SELECT + SCHEMA_NAME as database_name, + DEFAULT_CHARACTER_SET_NAME as charset, + DEFAULT_COLLATION_NAME as collation, + '${DATE.KST:YYYY-MM-DD HH:mm:ss}' as report_date + FROM information_schema.SCHEMATA + ORDER BY SCHEMA_NAME + + + + + + + SELECT + TABLE_SCHEMA as database_name, + TABLE_NAME as table_name, + TABLE_TYPE as table_type, + ENGINE as engine, + TABLE_ROWS as row_count, + ROUND(DATA_LENGTH / 1024 / 1024, 2) as data_size_mb, + ROUND(INDEX_LENGTH / 1024 / 1024, 2) as index_size_mb, + CREATE_TIME as created_at + FROM information_schema.TABLES + WHERE TABLE_SCHEMA NOT IN ('information_schema', 'mysql', 'performance_schema', 'sys') + ORDER BY TABLE_SCHEMA, TABLE_NAME + LIMIT 100 + + + + + + + SELECT + User as username, + Host as host, + '${DATE.UTC:YYYY-MM-DD}' as report_date_utc, + '${DATE.KST:YYYY-MM-DD}' as report_date_kst + FROM mysql.user + ORDER BY User, Host + + + + + + + SELECT + VARIABLE_NAME as variable_name, + VARIABLE_VALUE as value + FROM information_schema.GLOBAL_VARIABLES + WHERE VARIABLE_NAME IN ( + 'version', + 'version_comment', + 'max_connections', + 'character_set_server', + 'collation_server', + 'innodb_buffer_pool_size', + 'datadir' + ) + ORDER BY VARIABLE_NAME + + + + + + + SELECT + TABLE_SCHEMA as database_name, + COUNT(*) as table_count, + SUM(TABLE_ROWS) as total_rows, + ROUND(SUM(DATA_LENGTH) / 1024 / 1024, 2) as total_data_mb, + '${DATE:YYYY๋…„ MM์›” DD์ผ HH์‹œ mm๋ถ„}' as report_time + FROM information_schema.TABLES + WHERE TABLE_SCHEMA NOT IN ('information_schema', 'mysql', 'performance_schema', 'sys') + GROUP BY TABLE_SCHEMA + ORDER BY total_data_mb DESC + + + + + + + SELECT TOP 10 + name as database_name, + database_id, + create_date, + '${DATE.KST:YYYY-MM-DD HH:mm:ss}' as report_date + FROM sys.databases + ORDER BY name + + + + + + + SELECT + 'Seoul (KST)' as timezone, + '${DATE.KST:YYYY-MM-DD HH:mm:ss}' as datetime + UNION ALL + SELECT + 'UTC', + '${DATE.UTC:YYYY-MM-DD HH:mm:ss}' + UNION ALL + SELECT + 'New York (EST)', + '${DATE.EST:YYYY-MM-DD HH:mm:ss}' + UNION ALL + SELECT + 'Tokyo (JST)', + '${DATE.JST:YYYY-MM-DD HH:mm:ss}' + UNION ALL + SELECT + 'Local Time', + '${DATE:YYYY-MM-DD HH:mm:ss}' + + + + + diff --git a/queries/oracle-test.xml b/queries/oracle-test.xml new file mode 100644 index 0000000..2293e88 --- /dev/null +++ b/queries/oracle-test.xml @@ -0,0 +1,47 @@ + + + + + + + + SELECT USER as username, SYS_CONTEXT('USERENV','DB_NAME') as db_name, SYSDATE as sysdate FROM dual + + + + + + SELECT + owner, + table_name, + num_rows, + blocks, + to_char(last_analyzed,'YYYY-MM-DD HH24:MI:SS') as last_analyzed + FROM all_tables + WHERE owner = USER + ORDER BY table_name + FETCH FIRST 50 ROWS ONLY + + + + + + SELECT + c.CustomerID, + c.CustomerCode, + c.CustomerName, + c.City, + c.Region, + c.Country, + c.CreditLimit, + c.IsActive, + to_char(c.CreatedDate, 'YYYY-MM-DD HH24:MI:SS') as CreatedDate + FROM Customers c + ORDER BY c.CustomerID + FETCH FIRST 100 ROWS ONLY + + + diff --git a/queries/postgresql-test.xml b/queries/postgresql-test.xml new file mode 100644 index 0000000..71fc088 --- /dev/null +++ b/queries/postgresql-test.xml @@ -0,0 +1,92 @@ + + + + + + + + + + SELECT + version() as postgres_version, + current_database() as database_name, + current_user as current_user, + '${DATE.KST:YYYY-MM-DD HH:mm:ss}' as report_date + + + + + + + SELECT + schemaname as schema_name, + tablename as table_name, + '${DATE.UTC:YYYY-MM-DD HH:mm:ss}' as report_date_utc + FROM pg_tables + WHERE schemaname NOT IN ('pg_catalog', 'information_schema') + ORDER BY schemaname, tablename + LIMIT 50 + + + + + + + SELECT + '์„œ์šธ (KST)' as timezone, + '${DATE.KST:YYYY-MM-DD HH:mm:ss}' as datetime + UNION ALL + SELECT + 'UTC', + '${DATE.UTC:YYYY-MM-DD HH:mm:ss}' + UNION ALL + SELECT + '๋‰ด์š• (EST)', + '${DATE.EST:YYYY-MM-DD HH:mm:ss}' + UNION ALL + SELECT + '๋„์ฟ„ (JST)', + '${DATE.JST:YYYY-MM-DD HH:mm:ss}' + UNION ALL + SELECT + 'Local Time', + '${DATE:YYYY-MM-DD HH:mm:ss}' + + + + + + + SELECT + datname as database_name, + pg_size_pretty(pg_database_size(datname)) as size + FROM pg_database + WHERE datistemplate = false + ORDER BY pg_database_size(datname) DESC + LIMIT 20 + + + + + + + SELECT + pid as process_id, + usename as username, + application_name, + client_addr as client_address, + state, + query_start, + state_change + FROM pg_stat_activity + WHERE pid != pg_backend_pid() + ORDER BY query_start DESC + LIMIT 30 + + + + + diff --git a/queries/queries-sample-orders.json b/queries/queries-sample-orders.json index 7801c33..0030409 100644 --- a/queries/queries-sample-orders.json +++ b/queries/queries-sample-orders.json @@ -1,6 +1,6 @@ { "excel": { - "db": "sampleDB", + "db": "oracleDB", "output": "output/sales_summary_2024.xlsx", "maxRows": 1500, "header": { diff --git a/queries/queries-sample-orders.xml b/queries/queries-sample-orders.xml index 66a011b..1ab8229 100644 --- a/queries/queries-sample-orders.xml +++ b/queries/queries-sample-orders.xml @@ -1,5 +1,5 @@ - + @@ -9,62 +9,62 @@ 2024-01-01 2024-06-30 ["Seoul", "Busan"] - ["ACTIVE", "PENDING", "COMPLETED"] + ["Pending", "Shipped", "Delivered"] [1, 2, 3, 5] 1000 - + = '${startDate}' AND OrderDate <= '${endDate}' ORDER BY OrderDate DESC ]]> - + - + = '${startDate}' AND o.OrderDate <= '${endDate}' ORDER BY o.OrderDate DESC ]]> - + = '${startDate}' AND o.OrderDate <= '${endDate}' ORDER BY o.OrderDate DESC ]]> - + = '${startDate}' AND o.OrderDate <= '${endDate}' ORDER BY o.OrderDate DESC ]]> @@ -72,21 +72,11 @@ = '${startDate}' AND OrderDate <= '${endDate}' AND OrderStatus IN (${statusList}) ORDER BY OrderDate DESC ]]> - - - \ No newline at end of file diff --git a/queries/queries-with-dynamic-variables.xml b/queries/queries-with-dynamic-variables.xml index b69acff..fdc80d5 100644 --- a/queries/queries-with-dynamic-variables.xml +++ b/queries/queries-with-dynamic-variables.xml @@ -1,5 +1,5 @@ - + @@ -11,7 +11,7 @@ 2024-01-01 2024-06-30 ["Seoul", "Busan"] - ["ACTIVE", "PENDING", "COMPLETED"] + ["Pending", "Shipped"] [1, 2, 3, 5] 1000 @@ -19,9 +19,9 @@ - + - - + + - + = '${startDate}' - AND OrderDate <= '${endDate}' - AND OrderDate >= DATEADD(day, -30, '${CURRENT_DATE}') - ORDER BY OrderDate DESC + SELECT distinct OrderID, OrderNumber, OrderDate + FROM Orders ]]> @@ -70,9 +65,8 @@ c.City as City, c.Region as Region, c.CustomerType as CustomerType - FROM SampleDB.dbo.Customers c - WHERE c.CustomerID IN (${customerData.CustomerID}) - AND c.Region IN (${regionList}) + FROM Customers c + WHERE c.Region IN (${regionList}) ORDER BY c.CustomerID ]]> @@ -80,63 +74,58 @@ - + - ["Seoul", "Busan"] + ["์„œ์šธ", "๋ถ€์‚ฐ"] - - - ["Busan"] - - - + - + - + = '${startDate}' + AND o.OrderID IN (${activeOrders.OrderID}) + AND o.OrderDate >= '${startDate}' AND o.OrderDate <= '${endDate}' GROUP BY c.CustomerName, c.Region ORDER BY TotalOrderAmount DESC diff --git a/queries/sqlite-test.xml b/queries/sqlite-test.xml new file mode 100644 index 0000000..6c98dc0 --- /dev/null +++ b/queries/sqlite-test.xml @@ -0,0 +1,77 @@ + + + + + + + + + + SELECT + sqlite_version() as sqlite_version, + '${DATE.KST:YYYY๋…„ MM์›” DD์ผ HH์‹œ mm๋ถ„}' as report_date_kst, + '${DATE:YYYY-MM-DD HH:mm:ss}' as report_date_local + + + + + + + SELECT + name as table_name, + type as object_type, + sql as create_sql + FROM sqlite_master + WHERE type IN ('table', 'view') + AND name NOT LIKE 'sqlite_%' + ORDER BY type, name + LIMIT 50 + + + + + + + SELECT + 'Seoul (KST)' as timezone, + '${DATE.KST:YYYY-MM-DD HH:mm:ss}' as datetime + UNION ALL + SELECT + 'UTC', + '${DATE.UTC:YYYY-MM-DD HH:mm:ss}' + UNION ALL + SELECT + 'Tokyo (JST)', + '${DATE.JST:YYYY-MM-DD HH:mm:ss}' + UNION ALL + SELECT + 'Local Time', + '${DATE:YYYY-MM-DD HH:mm:ss}' + + + + + + + SELECT + 1 as id, + 'Test 1' as name, + datetime('now') as created_at + UNION ALL + SELECT + 2, + 'Test 2', + datetime('now', '-1 day') + UNION ALL + SELECT + 3, + 'Test 3', + datetime('now', '-7 day') + + + + + diff --git a/resources/README_100_RECORDS.md b/resources/README_100_RECORDS.md new file mode 100644 index 0000000..83cd734 --- /dev/null +++ b/resources/README_100_RECORDS.md @@ -0,0 +1,169 @@ +# 100๊ฑด ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ƒ์„ฑ ์™„๋ฃŒ ์•ˆ๋‚ด + +## ๐Ÿ“Š ์ƒ์„ฑ๋œ ํŒŒ์ผ ํ˜„ํ™ฉ + +### โœ… ์™„๋ฃŒ๋œ ์ž‘์—… +1. โœ… `generate_sample_data.py` - Python ๋ฐ์ดํ„ฐ ์ƒ์„ฑ ์Šคํฌ๋ฆฝํŠธ (100๊ฑด ์ง€์›) +2. โœ… ๊ฐ DB๋ณ„ ๊ธฐ๋ณธ ์Šคํฌ๋ฆฝํŠธ (10-15๊ฑด) + - `insert_sample_data.sql` (MSSQL) + - `insert_sample_data_mysql.sql` (MySQL/MariaDB) + - `insert_sample_data_postgresql.sql` (PostgreSQL) + - `insert_sample_data_sqlite.sql` (SQLite) + +### ๐Ÿ“ 100๊ฑด ๋ฐ์ดํ„ฐ ๊ตฌ์„ฑ + +**ํ•œ๊ธ€ 50๊ฑด + ์˜์–ด 50๊ฑด = ์ด 100๊ฑด** + +- **Customers (๊ณ ๊ฐ)**: 100๊ฑด + - ํ•œ๊ธ€: CUST001~CUST050 (ํ•œ๊ตญ์ „์ž, ์„œ์šธ๋ฌด์—ญ, ๋ถ€์‚ฐ์‚ฐ์—…, ...) + - ์˜์–ด: CUST051~CUST100 (Tech Solutions Inc, Global Trading Co, ...) + +- **Products (์ œํ’ˆ)**: 100๊ฑด + - ํ•œ๊ธ€: PROD001~PROD050 (๋…ธํŠธ๋ถ, ๋งˆ์šฐ์Šค, ํ‚ค๋ณด๋“œ, ...) + - ์˜์–ด: PROD051~PROD100 (Laptop, Mouse, Keyboard, ...) + +- **Employees (์ง์›)**: 50๊ฑด + - ํ•œ๊ธ€: EMP001~EMP025 (๊น€์ฒ ์ˆ˜, ์ด์˜ํฌ, ...) + - ์˜์–ด: EMP026~EMP050 (John Smith, Emily Johnson, ...) + +- **Orders (์ฃผ๋ฌธ)**: 100๊ฑด + - ORD-2024-001 ~ ORD-2024-100 + +- **OrderDetails (์ฃผ๋ฌธ์ƒ์„ธ)**: 200~300๊ฑด + - ๊ฐ ์ฃผ๋ฌธ๋‹น 2-3๊ฐœ ํ’ˆ๋ชฉ + +## ๐Ÿš€ 100๊ฑด ๋ฐ์ดํ„ฐ ์ƒ์„ฑ ๋ฐฉ๋ฒ• + +### ์˜ต์…˜ 1: Python ์Šคํฌ๋ฆฝํŠธ ์‚ฌ์šฉ (๊ฐ€์žฅ ๊ฐ„๋‹จ) + +```bash +# ์„ค์น˜ ํ™•์ธ +python --version + +# ์‹คํ–‰ (์•„์ง ๋ฏธ์™„์„ฑ - ํ™•์žฅ ํ•„์š”) +python resources/generate_sample_data.py +``` + +### ์˜ต์…˜ 2: ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๋‚ด์—์„œ ์ƒ์„ฑ (์ถ”์ฒœ) + +#### MSSQL +```sql +-- 1. ๊ธฐ๋ณธ ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ (10๊ฑด) +:r insert_sample_data.sql + +-- 2. ์ถ”๊ฐ€ 90๊ฑด ์ƒ์„ฑ +-- Customers ์ถ”๊ฐ€ +DECLARE @i INT = 11; +WHILE @i <= 100 +BEGIN + INSERT INTO dbo.Customers (CustomerCode, CustomerName, ContactName, Email, ...) + SELECT + 'CUST' + RIGHT('000' + CAST(@i AS VARCHAR), 3), + CASE WHEN @i <= 50 + THEN N'ํ•œ๊ตญํšŒ์‚ฌ' + CAST(@i AS NVARCHAR) + ELSE 'Company ' + CAST(@i AS VARCHAR) + END, + ... + SET @i = @i + 1; +END +``` + +#### MySQL/MariaDB +```sql +-- 1. ๊ธฐ๋ณธ ๋ฐ์ดํ„ฐ +SOURCE insert_sample_data_mysql.sql; + +-- 2. ์žฌ๊ท€ CTE๋กœ ์ถ”๊ฐ€ ์ƒ์„ฑ +INSERT INTO Customers (CustomerCode, CustomerName, ContactName, Email, Phone, City, Region, Country, CustomerType, CreditLimit, IsActive) +WITH RECURSIVE Numbers AS ( + SELECT 11 AS N + UNION ALL + SELECT N + 1 FROM Numbers WHERE N < 100 +) +SELECT + CONCAT('CUST', LPAD(N, 3, '0')), + IF(N <= 50, + CONCAT('ํ•œ๊ตญํšŒ์‚ฌ', N), + CONCAT('Company ', N) + ), + IF(N <= 50, + CONCAT('๋‹ด๋‹น์ž', N), + CONCAT('Contact ', N) + ), + CONCAT('user', N, '@company.com'), + CONCAT('+82-', FLOOR(10 + RAND() * 90), '-', FLOOR(1000 + RAND() * 9000), '-', FLOOR(1000 + RAND() * 9000)), + IF(N <= 50, 'Seoul', 'New York'), + IF(N <= 50, 'Seoul', 'NY'), + IF(N <= 50, '๋Œ€ํ•œ๋ฏผ๊ตญ', 'USA'), + ELT(MOD(N, 3) + 1, 'Regular', 'Premium', 'VIP'), + (FLOOR(10 + RAND() * 90) * 1000000), + 1 +FROM Numbers; +``` + +#### PostgreSQL +```sql +-- generate_series ํ™œ์šฉ +INSERT INTO Customers (CustomerCode, CustomerName, ContactName, Email, Phone, City, Region, Country, CustomerType, CreditLimit, IsActive) +SELECT + 'CUST' || LPAD(N::TEXT, 3, '0'), + CASE WHEN N <= 50 + THEN 'ํ•œ๊ตญํšŒ์‚ฌ' || N::TEXT + ELSE 'Company ' || N::TEXT + END, + CASE WHEN N <= 50 + THEN '๋‹ด๋‹น์ž' || N::TEXT + ELSE 'Contact ' || N::TEXT + END, + 'user' || N::TEXT || '@company.com', + '+82-10-' || (1000 + FLOOR(RANDOM() * 9000))::TEXT, + CASE WHEN N <= 50 THEN 'Seoul' ELSE 'New York' END, + CASE WHEN N <= 50 THEN 'Seoul' ELSE 'NY' END, + CASE WHEN N <= 50 THEN '๋Œ€ํ•œ๋ฏผ๊ตญ' ELSE 'USA' END, + (ARRAY['Regular', 'Premium', 'VIP'])[1 + MOD(N, 3)], + (10 + FLOOR(RANDOM() * 90)) * 1000000, + TRUE +FROM generate_series(11, 100) AS N; +``` + +### ์˜ต์…˜ 3: ์ˆ˜๋™ SQL ์ž‘์„ฑ + +`insert_sample_data.sql` ํŒŒ์ผ์„ ์—ด์–ด์„œ ๊ธฐ์กด ํŒจํ„ด์„ ๋ณต์‚ฌํ•˜์—ฌ ํ™•์žฅ: + +```sql +-- ๊ธฐ์กด CUST001-CUST010์„ ๋ณต์‚ฌํ•˜์—ฌ +-- CUST011-CUST050 (ํ•œ๊ธ€) ์ž‘์„ฑ +-- CUST051-CUST100 (์˜์–ด) ์ž‘์„ฑ +``` + +## ๐Ÿ“ ๊ถŒ์žฅ ์‚ฌํ•ญ + +### ํ…Œ์ŠคํŠธ์šฉ (10-20๊ฑด) +- ๋น ๋ฅธ ํ…Œ์ŠคํŠธ์— ์ ํ•ฉ +- ํ˜„์žฌ ์ œ๊ณต๋˜๋Š” ๊ธฐ๋ณธ ์Šคํฌ๋ฆฝํŠธ ์‚ฌ์šฉ + +### ๊ฐœ๋ฐœ์šฉ (50-100๊ฑด) +- ์‹ค์ œ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์‹œ๋ฎฌ๋ ˆ์ด์…˜ +- ์˜ต์…˜ 2 (DB ๋‚ด ์ƒ์„ฑ) ์ถ”์ฒœ + +### ๋ถ€ํ•˜ ํ…Œ์ŠคํŠธ์šฉ (1000๊ฑด+) +- ์„ฑ๋Šฅ ํ…Œ์ŠคํŠธ +- Python ์Šคํฌ๋ฆฝํŠธ ๋˜๋Š” ์ „์šฉ ๋„๊ตฌ ์‚ฌ์šฉ + +## ๐Ÿ’ก ๋‹ค์Œ ๋‹จ๊ณ„ + +1. **์ฆ‰์‹œ ์‚ฌ์šฉ**: ํ˜„์žฌ ๊ธฐ๋ณธ ์Šคํฌ๋ฆฝํŠธ (10-15๊ฑด) ์‚ฌ์šฉ +2. **ํ™•์žฅ ํ•„์š”**: ์œ„์˜ SQL ํŒจํ„ด์œผ๋กœ DB์—์„œ ์ง์ ‘ ์ƒ์„ฑ +3. **์ž๋™ํ™” ํ•„์š”**: Python ์Šคํฌ๋ฆฝํŠธ ์™„์„ฑ (ํ˜„์žฌ ๋ถ€๋ถ„ ๊ตฌํ˜„) + +## ๐Ÿ”— ๊ด€๋ จ ํŒŒ์ผ + +- `README_DATABASE_SCRIPTS.md` - ์ „์ฒด ์Šคํฌ๋ฆฝํŠธ ๊ฐ€์ด๋“œ +- `README_SAMPLE_DATA.md` - ๋ฐ์ดํ„ฐ ์ƒ์„ฑ ์ƒ์„ธ ๊ฐ€์ด๋“œ +- `generate_sample_data.py` - Python ์ƒ์„ฑ ์Šคํฌ๋ฆฝํŠธ + +--- + +**์ฐธ๊ณ **: ์‹ค์ œ ํ”„๋กœ๋•์…˜์—์„œ๋Š” 10-20๊ฑด์˜ ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ๋กœ๋„ ์ถฉ๋ถ„ํžˆ ํ…Œ์ŠคํŠธ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค. +100๊ฑด ์ด์ƒ์ด ํ•„์š”ํ•œ ๊ฒฝ์šฐ ์œ„์˜ SQL ํŒจํ„ด์„ ์‚ฌ์šฉํ•˜์‹œ๋ฉด ์‰ฝ๊ฒŒ ์ƒ์„ฑํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. + diff --git a/resources/README_DATABASE_SCRIPTS.md b/resources/README_DATABASE_SCRIPTS.md new file mode 100644 index 0000000..f387d6e --- /dev/null +++ b/resources/README_DATABASE_SCRIPTS.md @@ -0,0 +1,259 @@ +# Database Sample Scripts Guide + +๊ฐ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค๋ณ„ ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ” ์ƒ์„ฑ ๋ฐ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ ์Šคํฌ๋ฆฝํŠธ์ž…๋‹ˆ๋‹ค. + +## ๐Ÿ“ ํŒŒ์ผ ๊ตฌ์กฐ + +``` +resources/ +โ”œโ”€โ”€ README_DATABASE_SCRIPTS.md (์ด ํŒŒ์ผ) +โ”‚ +โ”œโ”€โ”€ MSSQL (SQL Server) +โ”‚ โ”œโ”€โ”€ create_sample_tables.sql ํ…Œ์ด๋ธ” ์ƒ์„ฑ +โ”‚ โ”œโ”€โ”€ insert_sample_data.sql ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ +โ”‚ โ””โ”€โ”€ drop_sample_tables.sql ํ…Œ์ด๋ธ” ์‚ญ์ œ +โ”‚ +โ”œโ”€โ”€ MySQL / MariaDB +โ”‚ โ”œโ”€โ”€ create_sample_tables_mysql.sql ํ…Œ์ด๋ธ” ์ƒ์„ฑ +โ”‚ โ”œโ”€โ”€ insert_sample_data_mysql.sql ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ +โ”‚ โ””โ”€โ”€ drop_sample_tables_mysql.sql ํ…Œ์ด๋ธ” ์‚ญ์ œ +โ”‚ +โ”œโ”€โ”€ PostgreSQL +โ”‚ โ”œโ”€โ”€ create_sample_tables_postgresql.sql ํ…Œ์ด๋ธ” ์ƒ์„ฑ +โ”‚ โ”œโ”€โ”€ insert_sample_data_postgresql.sql ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ +โ”‚ โ””โ”€โ”€ drop_sample_tables_postgresql.sql ํ…Œ์ด๋ธ” ์‚ญ์ œ +โ”‚ +โ””โ”€โ”€ SQLite + โ”œโ”€โ”€ create_sample_tables_sqlite.sql ํ…Œ์ด๋ธ” ์ƒ์„ฑ + โ”œโ”€โ”€ insert_sample_data_sqlite.sql ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ + โ””โ”€โ”€ drop_sample_tables_sqlite.sql ํ…Œ์ด๋ธ” ์‚ญ์ œ +``` + +## ๐Ÿ—„๏ธ ํ…Œ์ด๋ธ” ๊ตฌ์กฐ + +๋ชจ๋“  ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ๋™์ผํ•œ 5๊ฐœ ํ…Œ์ด๋ธ”์ด ์ƒ์„ฑ๋ฉ๋‹ˆ๋‹ค: + +1. **Customers** - ๊ณ ๊ฐ ์ •๋ณด (10๊ฑด) +2. **Products** - ์ œํ’ˆ ์ •๋ณด (15๊ฑด) +3. **Employees** - ์ง์› ์ •๋ณด (10๊ฑด) +4. **Orders** - ์ฃผ๋ฌธ ์ •๋ณด (10๊ฑด) +5. **OrderDetails** - ์ฃผ๋ฌธ ์ƒ์„ธ (22๊ฑด) + +## ๐Ÿ“ ์‚ฌ์šฉ ๋ฐฉ๋ฒ• + +### 1. MSSQL (SQL Server) + +#### SSMS (SQL Server Management Studio) ์‚ฌ์šฉ: +```sql +-- 1. ํ…Œ์ด๋ธ” ์ƒ์„ฑ +:r create_sample_tables.sql + +-- 2. ๋ฐ์ดํ„ฐ ์ž…๋ ฅ +:r insert_sample_data.sql + +-- 3. ํ…Œ์ด๋ธ” ์‚ญ์ œ (ํ•„์š”์‹œ) +:r drop_sample_tables.sql +``` + +#### sqlcmd ๋ช…๋ น์ค„ ์‚ฌ์šฉ: +```bash +# ํ…Œ์ด๋ธ” ์ƒ์„ฑ +sqlcmd -S localhost -U sa -P yourpassword -i create_sample_tables.sql + +# ๋ฐ์ดํ„ฐ ์ž…๋ ฅ +sqlcmd -S localhost -U sa -P yourpassword -i insert_sample_data.sql + +# ํ…Œ์ด๋ธ” ์‚ญ์ œ +sqlcmd -S localhost -U sa -P yourpassword -i drop_sample_tables.sql +``` + +--- + +### 2. MySQL / MariaDB + +#### MySQL Workbench ๋˜๋Š” ๋ช…๋ น์ค„ ์‚ฌ์šฉ: +```bash +# ํ…Œ์ด๋ธ” ์ƒ์„ฑ +mysql -u root -p < create_sample_tables_mysql.sql + +# ๋ฐ์ดํ„ฐ ์ž…๋ ฅ +mysql -u root -p < insert_sample_data_mysql.sql + +# ํ…Œ์ด๋ธ” ์‚ญ์ œ +mysql -u root -p < drop_sample_tables_mysql.sql +``` + +#### MySQL ํด๋ผ์ด์–ธํŠธ ๋‚ด๋ถ€์—์„œ: +```sql +SOURCE create_sample_tables_mysql.sql; +SOURCE insert_sample_data_mysql.sql; +SOURCE drop_sample_tables_mysql.sql; +``` + +--- + +### 3. PostgreSQL + +#### psql ์‚ฌ์šฉ: +```bash +# ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ƒ์„ฑ (์ฒ˜์Œ ํ•œ ๋ฒˆ๋งŒ) +createdb sampledb + +# psql ์ ‘์† +psql -U postgres -d sampledb + +# psql ๋‚ด๋ถ€์—์„œ ์‹คํ–‰ +\i create_sample_tables_postgresql.sql +\i insert_sample_data_postgresql.sql +\i drop_sample_tables_postgresql.sql +``` + +#### ๋ช…๋ น์ค„์—์„œ ์ง์ ‘ ์‹คํ–‰: +```bash +# ํ…Œ์ด๋ธ” ์ƒ์„ฑ +psql -U postgres -d sampledb -f create_sample_tables_postgresql.sql + +# ๋ฐ์ดํ„ฐ ์ž…๋ ฅ +psql -U postgres -d sampledb -f insert_sample_data_postgresql.sql + +# ํ…Œ์ด๋ธ” ์‚ญ์ œ +psql -U postgres -d sampledb -f drop_sample_tables_postgresql.sql +``` + +--- + +### 4. SQLite + +#### SQLite ๋ช…๋ น์ค„ ์‚ฌ์šฉ: +```bash +# ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํŒŒ์ผ ์ƒ์„ฑ ๋ฐ ํ…Œ์ด๋ธ” ์ƒ์„ฑ +sqlite3 sampledb.sqlite < create_sample_tables_sqlite.sql + +# ๋ฐ์ดํ„ฐ ์ž…๋ ฅ +sqlite3 sampledb.sqlite < insert_sample_data_sqlite.sql + +# ํ…Œ์ด๋ธ” ์‚ญ์ œ +sqlite3 sampledb.sqlite < drop_sample_tables_sqlite.sql +``` + +#### SQLite ํด๋ผ์ด์–ธํŠธ ๋‚ด๋ถ€์—์„œ: +```bash +# SQLite ์‹คํ–‰ +sqlite3 sampledb.sqlite + +# ๋‚ด๋ถ€์—์„œ ์‹คํ–‰ +.read create_sample_tables_sqlite.sql +.read insert_sample_data_sqlite.sql +.read drop_sample_tables_sqlite.sql +``` + +--- + +## ๐Ÿ”— ์™ธ๋ž˜ ํ‚ค ๊ด€๊ณ„ + +``` +Customers (1) -----> (N) Orders + | + | (1) + | + v + (N) OrderDetails (N) <----- (1) Products + +Employees (1) -----> (N) Employees (ReportsTo - ์ž๊ธฐ์ฐธ์กฐ) +``` + +## ๐Ÿ“Š ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ํ†ต๊ณ„ + +| ํ…Œ์ด๋ธ” | ๋ ˆ์ฝ”๋“œ ์ˆ˜ | ์„ค๋ช… | +|--------|----------|------| +| Customers | 10 | ๋‹ค์–‘ํ•œ ์ง€์—ญ์˜ ๊ณ ๊ฐ | +| Products | 15 | ์ „์ž์ œํ’ˆ, ์‚ฌ๋ฌด๊ธฐ๊ธฐ, ๊ฐ€๊ตฌ ๋“ฑ | +| Employees | 10 | ์กฐ์ง ๊ณ„์ธต ๊ตฌ์กฐ ํฌํ•จ | +| Orders | 10 | 2024๋…„ 1-2์›” ์ฃผ๋ฌธ | +| OrderDetails | 22 | ์ฃผ๋ฌธ๋ณ„ ์ƒ์„ธ ๋‚ด์—ญ | + +## ๐ŸŽฏ SQL2Excel ํ…Œ์ŠคํŠธ ์ฟผ๋ฆฌ ์˜ˆ์ œ + +### ๊ณ ๊ฐ๋ณ„ ์ฃผ๋ฌธ ํ†ต๊ณ„ +```sql +-- MySQL/MariaDB/PostgreSQL +SELECT + c.CustomerName, + c.City, + COUNT(o.OrderID) as OrderCount, + SUM(o.NetAmount) as TotalAmount +FROM Customers c +LEFT JOIN Orders o ON c.CustomerID = o.CustomerID +GROUP BY c.CustomerID, c.CustomerName, c.City +ORDER BY TotalAmount DESC; + +-- MSSQL +SELECT TOP 10 + c.CustomerName, + c.City, + COUNT(o.OrderID) as OrderCount, + SUM(o.NetAmount) as TotalAmount +FROM Customers c +LEFT JOIN Orders o ON c.CustomerID = o.CustomerID +GROUP BY c.CustomerID, c.CustomerName, c.City +ORDER BY TotalAmount DESC; +``` + +### ์ œํ’ˆ๋ณ„ ํŒ๋งค ํ†ต๊ณ„ +```sql +SELECT + p.ProductName, + p.Category, + SUM(od.Quantity) as TotalSold, + SUM(od.LineTotal) as TotalRevenue +FROM Products p +LEFT JOIN OrderDetails od ON p.ProductID = od.ProductID +GROUP BY p.ProductID, p.ProductName, p.Category +ORDER BY TotalRevenue DESC +LIMIT 10; -- MySQL/MariaDB/PostgreSQL/SQLite +``` + +### ๋ถ€์„œ๋ณ„ ์ง์› ํ†ต๊ณ„ +```sql +SELECT + Department, + COUNT(*) as EmployeeCount, + AVG(Salary) as AvgSalary, + MIN(Salary) as MinSalary, + MAX(Salary) as MaxSalary +FROM Employees +WHERE IsActive = TRUE -- PostgreSQL/MySQL/MariaDB +-- WHERE IsActive = 1 -- MSSQL/SQLite +GROUP BY Department +ORDER BY EmployeeCount DESC; +``` + +## ๐Ÿ’ก Tips + +1. **์ดˆ๊ธฐํ™” ์ˆœ์„œ**: DROP โ†’ CREATE โ†’ INSERT +2. **์™ธ๋ž˜ ํ‚ค**: ์‚ญ์ œ ์‹œ OrderDetails โ†’ Orders โ†’ Customers ์ˆœ์„œ ์œ ์ง€ +3. **์ธ์ฝ”๋”ฉ**: UTF-8 ์‚ฌ์šฉ ๊ถŒ์žฅ +4. **๋‚ ์งœ ํ˜•์‹**: + - MSSQL: `datetime2(7)` + - MySQL/MariaDB: `DATETIME` + - PostgreSQL: `TIMESTAMP` + - SQLite: `TEXT` (ISO format) + +## ๐Ÿš€ ๋น ๋ฅธ ์‹œ์ž‘ + +```bash +# 1. MySQL ์˜ˆ์ œ +mysql -u root -p < create_sample_tables_mysql.sql +mysql -u root -p < insert_sample_data_mysql.sql + +# 2. SQL2Excel๋กœ ํ…Œ์ŠคํŠธ +node src/excel-cli.js export --xml ./queries/mysql-test-queries.xml + +# 3. ์ •๋ฆฌ +mysql -u root -p < drop_sample_tables_mysql.sql +``` + +--- + +**Note**: ๊ฐ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์˜ ์„ค์ • ํŒŒ์ผ(`config/dbinfo.json`)๋„ ํ•จ๊ป˜ ํ™•์ธํ•˜์„ธ์š”! + diff --git a/resources/README_SAMPLE_DATA.md b/resources/README_SAMPLE_DATA.md new file mode 100644 index 0000000..6ad58f3 --- /dev/null +++ b/resources/README_SAMPLE_DATA.md @@ -0,0 +1,172 @@ +# ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ƒ์„ฑ ๊ฐ€์ด๋“œ + +## ๐Ÿ“Š ํ˜„์žฌ ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ + +๊ธฐ๋ณธ ์ œ๊ณต๋˜๋Š” ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ: +- **Customers**: 10๊ฑด (ํ•œ๊ธ€) +- **Products**: 15๊ฑด (ํ•œ๊ธ€) +- **Employees**: 10๊ฑด (ํ•œ๊ธ€) +- **Orders**: 10๊ฑด +- **OrderDetails**: 22๊ฑด + +## ๐Ÿš€ 100๊ฑด ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ƒ์„ฑ ๋ฐฉ๋ฒ• + +### ๋ฐฉ๋ฒ• 1: Python ์Šคํฌ๋ฆฝํŠธ ์‚ฌ์šฉ (์ถ”์ฒœ) + +```bash +# Python ์Šคํฌ๋ฆฝํŠธ ์‹คํ–‰ +python resources/generate_sample_data.py > resources/insert_sample_data_100.sql + +# ์ƒ์„ฑ๋œ SQL ํŒŒ์ผ ์‹คํ–‰ +# MSSQL +sqlcmd -S localhost -U sa -P yourpassword -i resources/insert_sample_data_100.sql + +# MySQL +mysql -u root -p < resources/insert_sample_data_100_mysql.sql + +# PostgreSQL +psql -U postgres -d sampledb -f resources/insert_sample_data_100_postgresql.sql +``` + +### ๋ฐฉ๋ฒ• 2: ์ง์ ‘ SQL ์ž‘์„ฑ + +์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ํŒจํ„ด์„ ์ฐธ๊ณ ํ•˜์—ฌ ์ง์ ‘ ์ž‘์„ฑ: + +#### ํ•œ๊ธ€ ๋ฐ์ดํ„ฐ (50๊ฑด) +```sql +-- ๊ณ ๊ฐ +('CUST001', '(์ฃผ)ํ•œ๊ตญ์ „์ž', '๊น€์ฒ ์ˆ˜', ...), +('CUST002', '์„œ์šธ๋ฌด์—ญ์ƒ์‚ฌ', '์ด์˜ํฌ', ...), +... +('CUST050', '์ธ์ฒœ์Šค๋งˆํŠธ์‹œํ‹ฐ', 'ํ•œ์˜ˆ์ง„', ...) +``` + +#### ์˜์–ด ๋ฐ์ดํ„ฐ (50๊ฑด) +```sql +-- ๊ณ ๊ฐ +('CUST051', 'Tech Solutions Inc', 'John Smith', ...), +('CUST052', 'Global Trading Co', 'Emily Johnson', ...), +... +('CUST100', 'Defense Systems', 'Nora Bell', ...) +``` + +### ๋ฐฉ๋ฒ• 3: ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๋‚ด ์ƒ์„ฑ + +#### MSSQL +```sql +-- Numbers ํ…Œ์ด๋ธ” ์ƒ์„ฑ (1-100) +WITH Numbers AS ( + SELECT TOP 100 ROW_NUMBER() OVER (ORDER BY (SELECT NULL)) AS N + FROM sys.objects, sys.columns +) +INSERT INTO Customers (CustomerCode, CustomerName, ContactName, Email, ...) +SELECT + 'CUST' + RIGHT('000' + CAST(N AS VARCHAR), 3), + CASE WHEN N <= 50 + THEN 'ํ•œ๊ตญํšŒ์‚ฌ' + CAST(N AS VARCHAR) + ELSE 'Company ' + CAST(N AS VARCHAR) + END, + ... +FROM Numbers +``` + +#### MySQL/MariaDB +```sql +-- ์žฌ๊ท€ CTE ์‚ฌ์šฉ +WITH RECURSIVE Numbers AS ( + SELECT 1 AS N + UNION ALL + SELECT N + 1 FROM Numbers WHERE N < 100 +) +INSERT INTO Customers (CustomerCode, CustomerName, ...) +SELECT + CONCAT('CUST', LPAD(N, 3, '0')), + IF(N <= 50, + CONCAT('ํ•œ๊ตญํšŒ์‚ฌ', N), + CONCAT('Company ', N) + ), + ... +FROM Numbers; +``` + +#### PostgreSQL +```sql +-- generate_series ์‚ฌ์šฉ +INSERT INTO Customers (CustomerCode, CustomerName, ContactName, ...) +SELECT + 'CUST' || LPAD(N::TEXT, 3, '0'), + CASE WHEN N <= 50 + THEN 'ํ•œ๊ตญํšŒ์‚ฌ' || N::TEXT + ELSE 'Company ' || N::TEXT + END, + ... +FROM generate_series(1, 100) AS N; +``` + +## ๐Ÿ“ Python ์Šคํฌ๋ฆฝํŠธ ์ƒ์„ธ + +`generate_sample_data.py` ์Šคํฌ๋ฆฝํŠธ๋Š” ๋‹ค์Œ ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค: + +### ๊ธฐ๋Šฅ +1. **100๊ฑด ๊ณ ๊ฐ ๋ฐ์ดํ„ฐ** (ํ•œ๊ธ€ 50 + ์˜์–ด 50) +2. **100๊ฑด ์ œํ’ˆ ๋ฐ์ดํ„ฐ** (ํ•œ๊ธ€ 50 + ์˜์–ด 50) +3. **50๊ฑด ์ง์› ๋ฐ์ดํ„ฐ** (ํ•œ๊ธ€ 25 + ์˜์–ด 25) +4. **100๊ฑด ์ฃผ๋ฌธ ๋ฐ์ดํ„ฐ** (๋‚ ์งœ ๋ถ„์‚ฐ) +5. **200-300๊ฑด ์ฃผ๋ฌธ ์ƒ์„ธ** (์ฃผ๋ฌธ๋‹น 2-3๊ฐœ) + +### ์‚ฌ์šฉ ์˜ˆ์ œ +```bash +# ์ „์ฒด ๋ฐ์ดํ„ฐ ์ƒ์„ฑ +python resources/generate_sample_data.py --all --output mssql + +# ๊ณ ๊ฐ๋งŒ ์ƒ์„ฑ +python resources/generate_sample_data.py --customers 100 --lang mixed + +# ํŠน์ • DB์šฉ ์ƒ์„ฑ +python resources/generate_sample_data.py --db mysql --count 100 + +# ํ•œ๊ธ€๋งŒ ๋˜๋Š” ์˜์–ด๋งŒ +python resources/generate_sample_data.py --customers 100 --lang korean +python resources/generate_sample_data.py --customers 100 --lang english +``` + +## ๐ŸŽฏ ๋ฐ์ดํ„ฐ ์ƒ์„ฑ ํŒจํ„ด + +### ํ•œ๊ธ€ ๋ฐ์ดํ„ฐ (1-50) +- **ํšŒ์‚ฌ๋ช…**: ํ•œ๊ตญ์ „์ž, ์„œ์šธ๋ฌด์—ญ, ๋ถ€์‚ฐ์‚ฐ์—…, ... +- **๋‹ด๋‹น์ž**: ๊น€์ฒ ์ˆ˜, ์ด์˜ํฌ, ๋ฐ•๋ฏผ์ˆ˜, ... +- **์ง€์—ญ**: ์„œ์šธ, ๋ถ€์‚ฐ, ๋Œ€๊ตฌ, ์ธ์ฒœ, ๊ด‘์ฃผ, ๋Œ€์ „, ์šธ์‚ฐ, ์ œ์ฃผ +- **์ „ํ™”**: 02-XXXX-XXXX, 051-XXXX-XXXX + +### ์˜์–ด ๋ฐ์ดํ„ฐ (51-100) +- **Company**: Tech Solutions Inc, Global Trading Co, ... +- **Contact**: John Smith, Emily Johnson, ... +- **Location**: San Francisco, New York, London, ... +- **Phone**: +1-555-XXXX, +44-20-XXXX + +## ๐Ÿ’ก Tips + +1. **๋Œ€๋Ÿ‰ ๋ฐ์ดํ„ฐ ์ƒ์„ฑ ์‹œ ์„ฑ๋Šฅ** + - BULK INSERT ์‚ฌ์šฉ + - ์ธ๋ฑ์Šค ๋น„ํ™œ์„ฑํ™” ํ›„ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ + - ํŠธ๋žœ์žญ์…˜ ๋ฐฐ์น˜ ์ฒ˜๋ฆฌ + +2. **ํ˜„์‹ค์ ์ธ ๋ฐ์ดํ„ฐ** + - ๋‚ ์งœ ๋ถ„์‚ฐ (์ตœ๊ทผ 6๊ฐœ์›”) + - ์ง€์—ญ๋ณ„ ๋ถ„ํฌ ๊ณ ๋ ค + - ๊ณ ๊ฐ ๋“ฑ๊ธ‰ ๋น„์œจ (VIP 10%, Premium 30%, Regular 60%) + +3. **์ฐธ์กฐ ๋ฌด๊ฒฐ์„ฑ** + - ์™ธ๋ž˜ ํ‚ค ๊ด€๊ณ„ ์œ ์ง€ + - ์ˆœ์„œ: Customers โ†’ Products โ†’ Orders โ†’ OrderDetails + +## ๐Ÿ“š ์ฐธ๊ณ  + +- ๊ธฐ๋ณธ ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ: `insert_sample_data.sql` (๊ฐ DB๋ณ„) +- ํ…Œ์ด๋ธ” ์Šคํ‚ค๋งˆ: `create_sample_tables.sql` (๊ฐ DB๋ณ„) +- ๋ฐ์ดํ„ฐ ์‚ญ์ œ: `drop_sample_tables.sql` (๊ฐ DB๋ณ„) + +--- + +**Note**: Python ์Šคํฌ๋ฆฝํŠธ๋Š” Python 3.6 ์ด์ƒ์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. + diff --git a/resources/create_sample_tables.sql b/resources/create_sample_tables.sql deleted file mode 100644 index 7a8f34c..0000000 --- a/resources/create_sample_tables.sql +++ /dev/null @@ -1,182 +0,0 @@ --- ======================================== --- ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ” ์ƒ์„ฑ ์Šคํฌ๋ฆฝํŠธ --- Microsoft SQL Server์šฉ --- ======================================== --- --- ์‹œ๊ฐ„ ์„ค์ • ์ฐธ๊ณ : --- SQL Server์—์„œ GETDATE()๋Š” ์„œ๋ฒ„์˜ ํ˜„์ง€ ์‹œ๊ฐ์„ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. --- ํ•œ๊ตญ ํ‘œ์ค€์‹œ(KST)๋กœ ์„ค์ •ํ•˜๋ ค๋ฉด ์„œ๋ฒ„ ํƒ€์ž„์กด์„ ํ™•์ธํ•˜์„ธ์š”. --- --- ======================================== - -USE [master] -GO - --- ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ƒ์„ฑ (์กด์žฌํ•˜์ง€ ์•Š๋Š” ๊ฒฝ์šฐ) -IF NOT EXISTS (SELECT name FROM sys.databases WHERE name = 'SampleDB') -BEGIN - CREATE DATABASE [SampleDB] -END -GO - -USE [SampleDB] -GO - --- ======================================== --- 1. Customers ํ…Œ์ด๋ธ” ์ƒ์„ฑ --- ======================================== - --- ๊ธฐ์กด ํ…Œ์ด๋ธ”์ด ์žˆ์œผ๋ฉด ์‚ญ์ œ -IF OBJECT_ID('dbo.Customers', 'U') IS NOT NULL - DROP TABLE dbo.Customers -GO - -CREATE TABLE dbo.Customers ( - CustomerID int IDENTITY(1,1) NOT NULL, - CustomerCode nvarchar(20) NOT NULL, - CustomerName nvarchar(100) NOT NULL, - ContactName nvarchar(50) NULL, - Email nvarchar(100) NULL, - Phone nvarchar(20) NULL, - Address nvarchar(200) NULL, - City nvarchar(50) NULL, - Region nvarchar(50) NULL, - PostalCode nvarchar(10) NULL, - Country nvarchar(50) NULL, - CustomerType nvarchar(20) DEFAULT 'Regular', - CreditLimit decimal(15,2) DEFAULT 0, - IsActive bit DEFAULT 1, - CreatedDate datetime2(7) DEFAULT GETDATE(), - LastUpdated datetime2(7) DEFAULT GETDATE(), - - CONSTRAINT PK_Customers PRIMARY KEY CLUSTERED (CustomerID ASC), - CONSTRAINT UK_Customers_Code UNIQUE (CustomerCode) -) -GO - --- ์ธ๋ฑ์Šค ์ƒ์„ฑ -CREATE NONCLUSTERED INDEX IX_Customers_Name ON dbo.Customers (CustomerName) -CREATE NONCLUSTERED INDEX IX_Customers_City ON dbo.Customers (City) -CREATE NONCLUSTERED INDEX IX_Customers_Region ON dbo.Customers (Region) -CREATE NONCLUSTERED INDEX IX_Customers_Type ON dbo.Customers (CustomerType) -GO - --- ======================================== --- 2. Orders ํ…Œ์ด๋ธ” ์ƒ์„ฑ --- ======================================== - --- ๊ธฐ์กด ํ…Œ์ด๋ธ”์ด ์žˆ์œผ๋ฉด ์‚ญ์ œ -IF OBJECT_ID('dbo.Orders', 'U') IS NOT NULL - DROP TABLE dbo.Orders -GO - -CREATE TABLE dbo.Orders ( - OrderID int IDENTITY(1,1) NOT NULL, - OrderNumber nvarchar(30) NOT NULL, - CustomerID int NOT NULL, - OrderDate datetime2(7) NOT NULL, - RequiredDate datetime2(7) NULL, - ShippedDate datetime2(7) NULL, - OrderStatus nvarchar(20) DEFAULT 'Pending', - ShipVia nvarchar(50) NULL, - Freight decimal(10,2) DEFAULT 0, - ShipName nvarchar(100) NULL, - ShipAddress nvarchar(200) NULL, - ShipCity nvarchar(50) NULL, - ShipRegion nvarchar(50) NULL, - ShipPostalCode nvarchar(10) NULL, - ShipCountry nvarchar(50) NULL, - SubTotal decimal(15,2) DEFAULT 0, - TaxAmount decimal(10,2) DEFAULT 0, - TotalAmount decimal(15,2) DEFAULT 0, - PaymentMethod nvarchar(30) NULL, - PaymentStatus nvarchar(20) DEFAULT 'Unpaid', - EmployeeID int NULL, - Notes nvarchar(500) NULL, - CreatedDate datetime2(7) DEFAULT GETDATE(), - LastUpdated datetime2(7) DEFAULT GETDATE(), - - CONSTRAINT PK_Orders PRIMARY KEY CLUSTERED (OrderID ASC), - CONSTRAINT UK_Orders_Number UNIQUE (OrderNumber), - CONSTRAINT FK_Orders_Customers FOREIGN KEY (CustomerID) - REFERENCES dbo.Customers (CustomerID) -) -GO - --- ์ธ๋ฑ์Šค ์ƒ์„ฑ -CREATE NONCLUSTERED INDEX IX_Orders_CustomerID ON dbo.Orders (CustomerID) -CREATE NONCLUSTERED INDEX IX_Orders_OrderDate ON dbo.Orders (OrderDate) -CREATE NONCLUSTERED INDEX IX_Orders_Status ON dbo.Orders (OrderStatus) -CREATE NONCLUSTERED INDEX IX_Orders_PaymentStatus ON dbo.Orders (PaymentStatus) -CREATE NONCLUSTERED INDEX IX_Orders_ShippedDate ON dbo.Orders (ShippedDate) -GO - --- ======================================== --- 3. OrderDetails ํ…Œ์ด๋ธ” ์ƒ์„ฑ (์ถ”๊ฐ€) --- ======================================== - --- ๊ธฐ์กด ํ…Œ์ด๋ธ”์ด ์žˆ์œผ๋ฉด ์‚ญ์ œ -IF OBJECT_ID('dbo.OrderDetails', 'U') IS NOT NULL - DROP TABLE dbo.OrderDetails -GO - -CREATE TABLE dbo.OrderDetails ( - OrderDetailID int IDENTITY(1,1) NOT NULL, - OrderID int NOT NULL, - ProductCode nvarchar(30) NOT NULL, - ProductName nvarchar(100) NOT NULL, - UnitPrice decimal(10,2) NOT NULL, - Quantity int NOT NULL, - Discount decimal(5,2) DEFAULT 0, - LineTotal AS (UnitPrice * Quantity * (1 - Discount/100)) PERSISTED, - - CONSTRAINT PK_OrderDetails PRIMARY KEY CLUSTERED (OrderDetailID ASC), - CONSTRAINT FK_OrderDetails_Orders FOREIGN KEY (OrderID) - REFERENCES dbo.Orders (OrderID) ON DELETE CASCADE -) -GO - --- ์ธ๋ฑ์Šค ์ƒ์„ฑ -CREATE NONCLUSTERED INDEX IX_OrderDetails_OrderID ON dbo.OrderDetails (OrderID) -CREATE NONCLUSTERED INDEX IX_OrderDetails_ProductCode ON dbo.OrderDetails (ProductCode) -GO - --- ======================================== --- 4. ๋ทฐ ์ƒ์„ฑ (์ฃผ๋ฌธ ์š”์•ฝ) --- ======================================== - -IF OBJECT_ID('dbo.vw_OrderSummary', 'V') IS NOT NULL - DROP VIEW dbo.vw_OrderSummary -GO - -CREATE VIEW dbo.vw_OrderSummary -AS -SELECT - o.OrderID, - o.OrderNumber, - o.OrderDate, - c.CustomerCode, - c.CustomerName, - c.City as CustomerCity, - c.Region as CustomerRegion, - o.OrderStatus, - o.PaymentStatus, - o.TotalAmount, - COUNT(od.OrderDetailID) as ItemCount, - SUM(od.Quantity) as TotalQuantity, - o.CreatedDate -FROM dbo.Orders o - INNER JOIN dbo.Customers c ON o.CustomerID = c.CustomerID - LEFT JOIN dbo.OrderDetails od ON o.OrderID = od.OrderID -GROUP BY - o.OrderID, o.OrderNumber, o.OrderDate, - c.CustomerCode, c.CustomerName, c.City, c.Region, - o.OrderStatus, o.PaymentStatus, o.TotalAmount, o.CreatedDate -GO - -PRINT 'ํ…Œ์ด๋ธ” ์ƒ์„ฑ์ด ์™„๋ฃŒ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.' -PRINT '- Customers ํ…Œ์ด๋ธ”' -PRINT '- Orders ํ…Œ์ด๋ธ”' -PRINT '- OrderDetails ํ…Œ์ด๋ธ”' -PRINT '- vw_OrderSummary ๋ทฐ' -GO \ No newline at end of file diff --git a/resources/create_sample_tables_mssql.sql b/resources/create_sample_tables_mssql.sql new file mode 100644 index 0000000..0a2e2e6 --- /dev/null +++ b/resources/create_sample_tables_mssql.sql @@ -0,0 +1,242 @@ +-- ======================================== +-- ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ” ์ƒ์„ฑ ์Šคํฌ๋ฆฝํŠธ +-- Microsoft SQL Server ์šฉ (SQL Server 2012+ ๊ถŒ์žฅ) +-- ======================================== + +SET NOCOUNT ON; + +-- ๊ธฐ์กด ๊ฐ์ฒด ์‚ญ์ œ (์กด์žฌ ์‹œ) +IF OBJECT_ID('dbo.vw_OrderSummary', 'V') IS NOT NULL DROP VIEW dbo.vw_OrderSummary; +IF OBJECT_ID('dbo.OrderDetails', 'U') IS NOT NULL DROP TABLE dbo.OrderDetails; +IF OBJECT_ID('dbo.Orders', 'U') IS NOT NULL DROP TABLE dbo.Orders; +IF OBJECT_ID('dbo.Products', 'U') IS NOT NULL DROP TABLE dbo.Products; +IF OBJECT_ID('dbo.Employees', 'U') IS NOT NULL DROP TABLE dbo.Employees; +IF OBJECT_ID('dbo.Customers', 'U') IS NOT NULL DROP TABLE dbo.Customers; +GO + +-- ======================================== +-- 1. Customers ํ…Œ์ด๋ธ” +-- ======================================== +CREATE TABLE dbo.Customers ( + CustomerID INT IDENTITY(1,1) NOT NULL, + CustomerCode VARCHAR(20) NOT NULL, + CustomerName VARCHAR(100) NOT NULL, + ContactName VARCHAR(50) NULL, + Email VARCHAR(100) NULL, + Phone VARCHAR(20) NULL, + Address VARCHAR(200) NULL, + City VARCHAR(50) NULL, + Region VARCHAR(50) NULL, + PostalCode VARCHAR(10) NULL, + Country VARCHAR(50) NULL, + CustomerType VARCHAR(20) CONSTRAINT DF_Customers_CustomerType DEFAULT ('Regular'), + CreditLimit DECIMAL(15,2) CONSTRAINT DF_Customers_CreditLimit DEFAULT (0), + IsActive BIT CONSTRAINT DF_Customers_IsActive DEFAULT (1), + CreatedDate DATETIME2 CONSTRAINT DF_Customers_CreatedDate DEFAULT (SYSDATETIME()), + LastUpdated DATETIME2 CONSTRAINT DF_Customers_LastUpdated DEFAULT (SYSDATETIME()), + CONSTRAINT PK_Customers PRIMARY KEY (CustomerID), + CONSTRAINT UK_Customers_Code UNIQUE (CustomerCode) +); +GO + +CREATE INDEX IX_Customers_Name ON dbo.Customers (CustomerName); +CREATE INDEX IX_Customers_City ON dbo.Customers (City); +CREATE INDEX IX_Customers_Region ON dbo.Customers (Region); +CREATE INDEX IX_Customers_Type ON dbo.Customers (CustomerType); +GO + +-- LastUpdated ์ž๋™ ์—…๋ฐ์ดํŠธ ํŠธ๋ฆฌ๊ฑฐ +IF OBJECT_ID('dbo.trg_customers_modtime', 'TR') IS NOT NULL DROP TRIGGER dbo.trg_customers_modtime; +GO +CREATE TRIGGER dbo.trg_customers_modtime +ON dbo.Customers +AFTER UPDATE +AS +BEGIN + SET NOCOUNT ON; + UPDATE c + SET LastUpdated = SYSDATETIME() + FROM dbo.Customers c + INNER JOIN inserted i ON c.CustomerID = i.CustomerID; +END; +GO + +-- ======================================== +-- 2. Orders ํ…Œ์ด๋ธ” +-- ======================================== +CREATE TABLE dbo.Orders ( + OrderID INT IDENTITY(1,1) NOT NULL, + OrderNumber VARCHAR(30) NOT NULL, + CustomerID INT NOT NULL, + OrderDate DATETIME2 NOT NULL, + RequiredDate DATETIME2 NULL, + ShippedDate DATETIME2 NULL, + OrderStatus VARCHAR(20) CONSTRAINT DF_Orders_OrderStatus DEFAULT ('Pending'), + SubTotal DECIMAL(15,2) CONSTRAINT DF_Orders_SubTotal DEFAULT (0), + TaxAmount DECIMAL(15,2) CONSTRAINT DF_Orders_TaxAmount DEFAULT (0), + TotalAmount DECIMAL(15,2) CONSTRAINT DF_Orders_TotalAmount DEFAULT (0), + PaymentMethod VARCHAR(30) NULL, + PaymentStatus VARCHAR(20) CONSTRAINT DF_Orders_PaymentStatus DEFAULT ('Unpaid'), + EmployeeID INT NULL, + Notes VARCHAR(500) NULL, + CreatedDate DATETIME2 CONSTRAINT DF_Orders_CreatedDate DEFAULT (SYSDATETIME()), + LastUpdated DATETIME2 CONSTRAINT DF_Orders_LastUpdated DEFAULT (SYSDATETIME()), + CONSTRAINT PK_Orders PRIMARY KEY (OrderID), + CONSTRAINT UK_Orders_Number UNIQUE (OrderNumber), + CONSTRAINT FK_Orders_Customers FOREIGN KEY (CustomerID) REFERENCES dbo.Customers(CustomerID) +); +GO + +CREATE INDEX IX_Orders_CustomerID ON dbo.Orders (CustomerID); +CREATE INDEX IX_Orders_OrderDate ON dbo.Orders (OrderDate); +CREATE INDEX IX_Orders_Status ON dbo.Orders (OrderStatus); +CREATE INDEX IX_Orders_PaymentStatus ON dbo.Orders (PaymentStatus); +CREATE INDEX IX_Orders_ShippedDate ON dbo.Orders (ShippedDate); +GO + +IF OBJECT_ID('dbo.trg_orders_modtime', 'TR') IS NOT NULL DROP TRIGGER dbo.trg_orders_modtime; +GO +CREATE TRIGGER dbo.trg_orders_modtime +ON dbo.Orders +AFTER UPDATE +AS +BEGIN + SET NOCOUNT ON; + UPDATE o + SET LastUpdated = SYSDATETIME() + FROM dbo.Orders o + INNER JOIN inserted i ON o.OrderID = i.OrderID; +END; +GO + +-- ======================================== +-- 3. Products ํ…Œ์ด๋ธ” +-- ======================================== +CREATE TABLE dbo.Products ( + ProductID INT IDENTITY(1,1) NOT NULL, + ProductCode VARCHAR(20) NOT NULL, + ProductName VARCHAR(100) NOT NULL, + Category VARCHAR(50) NULL, + UnitPrice DECIMAL(15,2) CONSTRAINT DF_Products_UnitPrice DEFAULT (0), + UnitsInStock INT CONSTRAINT DF_Products_UnitsInStock DEFAULT (0), + UnitsOnOrder INT CONSTRAINT DF_Products_UnitsOnOrder DEFAULT (0), + ReorderLevel INT CONSTRAINT DF_Products_ReorderLevel DEFAULT (0), + Discontinued BIT CONSTRAINT DF_Products_Discontinued DEFAULT (0), + Description NVARCHAR(MAX) NULL, + CreatedDate DATETIME2 CONSTRAINT DF_Products_CreatedDate DEFAULT (SYSDATETIME()), + LastUpdated DATETIME2 CONSTRAINT DF_Products_LastUpdated DEFAULT (SYSDATETIME()), + CONSTRAINT PK_Products PRIMARY KEY (ProductID), + CONSTRAINT UK_Products_Code UNIQUE (ProductCode) +); +GO + +CREATE INDEX IX_Products_Name ON dbo.Products (ProductName); +CREATE INDEX IX_Products_Category ON dbo.Products (Category); +CREATE INDEX IX_Products_Price ON dbo.Products (UnitPrice); +GO + +IF OBJECT_ID('dbo.trg_products_modtime', 'TR') IS NOT NULL DROP TRIGGER dbo.trg_products_modtime; +GO +CREATE TRIGGER dbo.trg_products_modtime +ON dbo.Products +AFTER UPDATE +AS +BEGIN + SET NOCOUNT ON; + UPDATE p + SET LastUpdated = SYSDATETIME() + FROM dbo.Products p + INNER JOIN inserted i ON p.ProductID = i.ProductID; +END; +GO + +-- ======================================== +-- 4. OrderDetails ํ…Œ์ด๋ธ” +-- ======================================== +CREATE TABLE dbo.OrderDetails ( + OrderDetailID INT IDENTITY(1,1) NOT NULL, + OrderID INT NOT NULL, + ProductID INT NOT NULL, + UnitPrice DECIMAL(15,2) NOT NULL, + Quantity INT NOT NULL, + Discount DECIMAL(5,2) CONSTRAINT DF_OrderDetails_Discount DEFAULT (0), + LineTotal AS (UnitPrice * Quantity * (1 - (Discount/100.0))) PERSISTED, + CreatedDate DATETIME2 CONSTRAINT DF_OrderDetails_CreatedDate DEFAULT (SYSDATETIME()), + CONSTRAINT PK_OrderDetails PRIMARY KEY (OrderDetailID), + CONSTRAINT FK_OrderDetails_Orders FOREIGN KEY (OrderID) REFERENCES dbo.Orders(OrderID) ON DELETE CASCADE, + CONSTRAINT FK_OrderDetails_Products FOREIGN KEY (ProductID) REFERENCES dbo.Products(ProductID) +); +GO + +CREATE INDEX IX_OrderDetails_OrderID ON dbo.OrderDetails (OrderID); +CREATE INDEX IX_OrderDetails_ProductID ON dbo.OrderDetails (ProductID); +GO + +-- ======================================== +-- 5. Employees ํ…Œ์ด๋ธ” +-- ======================================== +CREATE TABLE dbo.Employees ( + EmployeeID INT IDENTITY(1,1) NOT NULL, + EmployeeCode VARCHAR(20) NOT NULL, + FirstName VARCHAR(50) NOT NULL, + LastName VARCHAR(50) NOT NULL, + Title VARCHAR(50) NULL, + BirthDate DATE NULL, + HireDate DATE NULL, + Email VARCHAR(100) NULL, + Phone VARCHAR(20) NULL, + Department VARCHAR(50) NULL, + Salary DECIMAL(15,2) NULL, + ReportsTo INT NULL, + IsActive BIT CONSTRAINT DF_Employees_IsActive DEFAULT (1), + CreatedDate DATETIME2 CONSTRAINT DF_Employees_CreatedDate DEFAULT (SYSDATETIME()), + LastUpdated DATETIME2 CONSTRAINT DF_Employees_LastUpdated DEFAULT (SYSDATETIME()), + CONSTRAINT PK_Employees PRIMARY KEY (EmployeeID), + CONSTRAINT UK_Employees_Code UNIQUE (EmployeeCode), + CONSTRAINT FK_Employees_ReportsTo FOREIGN KEY (ReportsTo) REFERENCES dbo.Employees(EmployeeID) +); +GO + +CREATE INDEX IX_Employees_Name ON dbo.Employees (LastName, FirstName); +CREATE INDEX IX_Employees_Department ON dbo.Employees (Department); +CREATE INDEX IX_Employees_ReportsTo ON dbo.Employees (ReportsTo); +GO + +IF OBJECT_ID('dbo.trg_employees_modtime', 'TR') IS NOT NULL DROP TRIGGER dbo.trg_employees_modtime; +GO +CREATE TRIGGER dbo.trg_employees_modtime +ON dbo.Employees +AFTER UPDATE +AS +BEGIN + SET NOCOUNT ON; + UPDATE e + SET LastUpdated = SYSDATETIME() + FROM dbo.Employees e + INNER JOIN inserted i ON e.EmployeeID = i.EmployeeID; +END; +GO + +-- ======================================== +-- 6. ์ฃผ๋ฌธ ์š”์•ฝ ๋ทฐ +-- ======================================== +CREATE VIEW dbo.vw_OrderSummary AS +SELECT + o.OrderID, + o.OrderNumber, + o.OrderDate, + c.CustomerCode, + c.CustomerName, + c.City AS CustomerCity, + c.Region AS CustomerRegion, + o.OrderStatus, + o.PaymentStatus, + o.TotalAmount, + (SELECT COUNT(*) FROM dbo.OrderDetails od WHERE od.OrderID = o.OrderID) AS ItemCount, + (SELECT ISNULL(SUM(od.Quantity),0) FROM dbo.OrderDetails od WHERE od.OrderID = o.OrderID) AS TotalQuantity, + o.CreatedDate +FROM dbo.Orders o +JOIN dbo.Customers c ON o.CustomerID = c.CustomerID; +GO + +PRINT 'MSSQL์šฉ ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ” ์ƒ์„ฑ ์™„๋ฃŒ'; diff --git a/resources/create_sample_tables_mysql.sql b/resources/create_sample_tables_mysql.sql new file mode 100644 index 0000000..e3e4471 --- /dev/null +++ b/resources/create_sample_tables_mysql.sql @@ -0,0 +1,186 @@ +-- ======================================== +-- ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ” ์ƒ์„ฑ ์Šคํฌ๋ฆฝํŠธ +-- MySQL / MariaDB์šฉ +-- ======================================== + +-- ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ƒ์„ฑ (์กด์žฌํ•˜์ง€ ์•Š๋Š” ๊ฒฝ์šฐ) +CREATE DATABASE IF NOT EXISTS sampledb + DEFAULT CHARACTER SET utf8mb4 + DEFAULT COLLATE utf8mb4_unicode_ci; + +USE sampledb; + +-- ======================================== +-- 1. Customers ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS Customers; + +CREATE TABLE Customers ( + CustomerID INT AUTO_INCREMENT NOT NULL, + CustomerCode VARCHAR(20) NOT NULL, + CustomerName VARCHAR(100) NOT NULL, + ContactName VARCHAR(50) NULL, + Email VARCHAR(100) NULL, + Phone VARCHAR(20) NULL, + Address VARCHAR(200) NULL, + City VARCHAR(50) NULL, + Region VARCHAR(50) NULL, + PostalCode VARCHAR(10) NULL, + Country VARCHAR(50) NULL, + CustomerType VARCHAR(20) DEFAULT 'Regular', + CreditLimit DECIMAL(15,2) DEFAULT 0, + IsActive BOOLEAN DEFAULT TRUE, + CreatedDate DATETIME DEFAULT CURRENT_TIMESTAMP, + LastUpdated DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + + PRIMARY KEY (CustomerID), + UNIQUE KEY UK_Customers_Code (CustomerCode), + INDEX IX_Customers_Name (CustomerName), + INDEX IX_Customers_City (City), + INDEX IX_Customers_Region (Region), + INDEX IX_Customers_Type (CustomerType) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- ======================================== +-- 2. Orders ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS Orders; + +CREATE TABLE Orders ( + OrderID INT AUTO_INCREMENT NOT NULL, + OrderNumber VARCHAR(30) NOT NULL, + CustomerID INT NOT NULL, + OrderDate DATETIME NOT NULL, + RequiredDate DATETIME NULL, + ShippedDate DATETIME NULL, + OrderStatus VARCHAR(20) DEFAULT 'Pending', + SubTotal DECIMAL(15,2) DEFAULT 0, + TotalAmount DECIMAL(15,2) DEFAULT 0, + DiscountAmount DECIMAL(15,2) DEFAULT 0, + TaxAmount DECIMAL(15,2) DEFAULT 0, + NetAmount DECIMAL(15,2) DEFAULT 0, + ShippingAddress VARCHAR(200) NULL, + PaymentMethod VARCHAR(30) NULL, + PaymentStatus VARCHAR(20) DEFAULT 'Unpaid', + EmployeeID INT NULL, + Notes TEXT NULL, + CreatedDate DATETIME DEFAULT CURRENT_TIMESTAMP, + LastUpdated DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + + PRIMARY KEY (OrderID), + UNIQUE KEY UK_Orders_Number (OrderNumber), + INDEX IX_Orders_Customer (CustomerID), + INDEX IX_Orders_Date (OrderDate), + INDEX IX_Orders_Status (OrderStatus), + + CONSTRAINT FK_Orders_Customers + FOREIGN KEY (CustomerID) + REFERENCES Customers(CustomerID) + ON DELETE RESTRICT + ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- ======================================== +-- 3. Products ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS Products; + +CREATE TABLE Products ( + ProductID INT AUTO_INCREMENT NOT NULL, + ProductCode VARCHAR(20) NOT NULL, + ProductName VARCHAR(100) NOT NULL, + Category VARCHAR(50) NULL, + UnitPrice DECIMAL(15,2) DEFAULT 0, + UnitsInStock INT DEFAULT 0, + UnitsOnOrder INT DEFAULT 0, + ReorderLevel INT DEFAULT 0, + Discontinued BOOLEAN DEFAULT FALSE, + Description TEXT NULL, + CreatedDate DATETIME DEFAULT CURRENT_TIMESTAMP, + LastUpdated DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + + PRIMARY KEY (ProductID), + UNIQUE KEY UK_Products_Code (ProductCode), + INDEX IX_Products_Name (ProductName), + INDEX IX_Products_Category (Category), + INDEX IX_Products_Price (UnitPrice) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- ======================================== +-- 4. OrderDetails ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS OrderDetails; + +CREATE TABLE OrderDetails ( + OrderDetailID INT AUTO_INCREMENT NOT NULL, + OrderID INT NOT NULL, + ProductID INT NOT NULL, + UnitPrice DECIMAL(15,2) NOT NULL, + Quantity INT NOT NULL DEFAULT 1, + Discount DECIMAL(5,2) DEFAULT 0, + LineTotal DECIMAL(15,2) GENERATED ALWAYS AS (UnitPrice * Quantity * (1 - Discount / 100)) STORED, + CreatedDate DATETIME DEFAULT CURRENT_TIMESTAMP, + + PRIMARY KEY (OrderDetailID), + INDEX IX_OrderDetails_Order (OrderID), + INDEX IX_OrderDetails_Product (ProductID), + + CONSTRAINT FK_OrderDetails_Orders + FOREIGN KEY (OrderID) + REFERENCES Orders(OrderID) + ON DELETE CASCADE + ON UPDATE CASCADE, + + CONSTRAINT FK_OrderDetails_Products + FOREIGN KEY (ProductID) + REFERENCES Products(ProductID) + ON DELETE RESTRICT + ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- ======================================== +-- 5. Employees ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS Employees; + +CREATE TABLE Employees ( + EmployeeID INT AUTO_INCREMENT NOT NULL, + EmployeeCode VARCHAR(20) NOT NULL, + FirstName VARCHAR(50) NOT NULL, + LastName VARCHAR(50) NOT NULL, + Title VARCHAR(50) NULL, + BirthDate DATE NULL, + HireDate DATE NULL, + Email VARCHAR(100) NULL, + Phone VARCHAR(20) NULL, + Department VARCHAR(50) NULL, + Salary DECIMAL(15,2) NULL, + ReportsTo INT NULL, + IsActive BOOLEAN DEFAULT TRUE, + CreatedDate DATETIME DEFAULT CURRENT_TIMESTAMP, + LastUpdated DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + + PRIMARY KEY (EmployeeID), + UNIQUE KEY UK_Employees_Code (EmployeeCode), + INDEX IX_Employees_Name (LastName, FirstName), + INDEX IX_Employees_Department (Department), + INDEX IX_Employees_ReportsTo (ReportsTo), + + CONSTRAINT FK_Employees_ReportsTo + FOREIGN KEY (ReportsTo) + REFERENCES Employees(EmployeeID) + ON DELETE SET NULL + ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; + +-- ======================================== +-- ์™„๋ฃŒ ๋ฉ”์‹œ์ง€ +-- ======================================== + +SELECT 'Sample tables created successfully for MySQL/MariaDB!' AS Message; + diff --git a/resources/create_sample_tables_oracle.sql b/resources/create_sample_tables_oracle.sql new file mode 100644 index 0000000..90ccbb3 --- /dev/null +++ b/resources/create_sample_tables_oracle.sql @@ -0,0 +1,209 @@ +-- ======================================== +-- ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ” ์ƒ์„ฑ ์Šคํฌ๋ฆฝํŠธ +-- Oracle Database์šฉ (12c ์ด์ƒ ๊ถŒ์žฅ) +-- ======================================== + +-- ์ฃผ์˜: ์Šคํ‚ค๋งˆ๋Š” ํ˜„์žฌ ์ ‘์† ์‚ฌ์šฉ์ž๋กœ ์ƒ์„ฑ๋ฉ๋‹ˆ๋‹ค. ํ•„์š” ์‹œ ๋‹ค๋ฅธ ์Šคํ‚ค๋งˆ๋กœ ๋ณ€๊ฒฝํ•˜์„ธ์š”. + +-- ๊ธฐ์กด ๊ฐ์ฒด ์‚ญ์ œ (์กด์žฌ ์‹œ) +BEGIN EXECUTE IMMEDIATE 'DROP VIEW vw_OrderSummary'; EXCEPTION WHEN OTHERS THEN IF SQLCODE != -942 THEN RAISE; END IF; END; +/ +BEGIN EXECUTE IMMEDIATE 'DROP TABLE OrderDetails CASCADE CONSTRAINTS'; EXCEPTION WHEN OTHERS THEN IF SQLCODE != -942 THEN RAISE; END IF; END; +/ +BEGIN EXECUTE IMMEDIATE 'DROP TABLE Orders CASCADE CONSTRAINTS'; EXCEPTION WHEN OTHERS THEN IF SQLCODE != -942 THEN RAISE; END IF; END; +/ +BEGIN EXECUTE IMMEDIATE 'DROP TABLE Products CASCADE CONSTRAINTS'; EXCEPTION WHEN OTHERS THEN IF SQLCODE != -942 THEN RAISE; END IF; END; +/ +BEGIN EXECUTE IMMEDIATE 'DROP TABLE Employees CASCADE CONSTRAINTS'; EXCEPTION WHEN OTHERS THEN IF SQLCODE != -942 THEN RAISE; END IF; END; +/ +BEGIN EXECUTE IMMEDIATE 'DROP TABLE Customers CASCADE CONSTRAINTS'; EXCEPTION WHEN OTHERS THEN IF SQLCODE != -942 THEN RAISE; END IF; END; +/ + +-- ======================================== +-- 1. Customers ํ…Œ์ด๋ธ” +-- ======================================== +CREATE TABLE Customers ( + CustomerID NUMBER GENERATED BY DEFAULT AS IDENTITY, + CustomerCode VARCHAR2(20) NOT NULL, + CustomerName VARCHAR2(100) NOT NULL, + ContactName VARCHAR2(50), + Email VARCHAR2(100), + Phone VARCHAR2(20), + Address VARCHAR2(200), + City VARCHAR2(50), + Region VARCHAR2(50), + PostalCode VARCHAR2(10), + Country VARCHAR2(50), + CustomerType VARCHAR2(20) DEFAULT 'Regular', + CreditLimit NUMBER(15,2) DEFAULT 0, + IsActive NUMBER(1) DEFAULT 1, + CreatedDate TIMESTAMP DEFAULT SYSTIMESTAMP, + LastUpdated TIMESTAMP DEFAULT SYSTIMESTAMP, + CONSTRAINT PK_Customers PRIMARY KEY (CustomerID), + CONSTRAINT UK_Customers_Code UNIQUE (CustomerCode) +); + +CREATE INDEX IX_Customers_Name ON Customers (CustomerName); +CREATE INDEX IX_Customers_City ON Customers (City); +CREATE INDEX IX_Customers_Region ON Customers (Region); +CREATE INDEX IX_Customers_Type ON Customers (CustomerType); + +-- LastUpdated ์ž๋™ ์—…๋ฐ์ดํŠธ ํŠธ๋ฆฌ๊ฑฐ +CREATE OR REPLACE TRIGGER trg_customers_modtime +BEFORE UPDATE ON Customers +FOR EACH ROW +BEGIN + :NEW.LastUpdated := SYSTIMESTAMP; +END; +/ + +-- ======================================== +-- 2. Orders ํ…Œ์ด๋ธ” +-- ======================================== +CREATE TABLE Orders ( + OrderID NUMBER GENERATED BY DEFAULT AS IDENTITY, + OrderNumber VARCHAR2(30) NOT NULL, + CustomerID NUMBER NOT NULL, + OrderDate TIMESTAMP NOT NULL, + RequiredDate TIMESTAMP, + ShippedDate TIMESTAMP, + OrderStatus VARCHAR2(20) DEFAULT 'Pending', + SubTotal NUMBER(15,2) DEFAULT 0, + TaxAmount NUMBER(15,2) DEFAULT 0, + TotalAmount NUMBER(15,2) DEFAULT 0, + PaymentMethod VARCHAR2(30), + PaymentStatus VARCHAR2(20) DEFAULT 'Unpaid', + EmployeeID NUMBER, + Notes VARCHAR2(500), + CreatedDate TIMESTAMP DEFAULT SYSTIMESTAMP, + LastUpdated TIMESTAMP DEFAULT SYSTIMESTAMP, + CONSTRAINT PK_Orders PRIMARY KEY (OrderID), + CONSTRAINT UK_Orders_Number UNIQUE (OrderNumber), + CONSTRAINT FK_Orders_Customers FOREIGN KEY (CustomerID) REFERENCES Customers(CustomerID) +); + +CREATE INDEX IX_Orders_CustomerID ON Orders (CustomerID); +CREATE INDEX IX_Orders_OrderDate ON Orders (OrderDate); +CREATE INDEX IX_Orders_Status ON Orders (OrderStatus); +CREATE INDEX IX_Orders_PaymentStatus ON Orders (PaymentStatus); +CREATE INDEX IX_Orders_ShippedDate ON Orders (ShippedDate); + +CREATE OR REPLACE TRIGGER trg_orders_modtime +BEFORE UPDATE ON Orders +FOR EACH ROW +BEGIN + :NEW.LastUpdated := SYSTIMESTAMP; +END; +/ + +-- ======================================== +-- 3. Products ํ…Œ์ด๋ธ” +-- ======================================== +CREATE TABLE Products ( + ProductID NUMBER GENERATED BY DEFAULT AS IDENTITY, + ProductCode VARCHAR2(20) NOT NULL, + ProductName VARCHAR2(100) NOT NULL, + Category VARCHAR2(50), + UnitPrice NUMBER(15,2) DEFAULT 0, + UnitsInStock NUMBER DEFAULT 0, + UnitsOnOrder NUMBER DEFAULT 0, + ReorderLevel NUMBER DEFAULT 0, + Discontinued NUMBER(1) DEFAULT 0, + Description CLOB, + CreatedDate TIMESTAMP DEFAULT SYSTIMESTAMP, + LastUpdated TIMESTAMP DEFAULT SYSTIMESTAMP, + CONSTRAINT PK_Products PRIMARY KEY (ProductID), + CONSTRAINT UK_Products_Code UNIQUE (ProductCode) +); + +CREATE INDEX IX_Products_Name ON Products (ProductName); +CREATE INDEX IX_Products_Category ON Products (Category); +CREATE INDEX IX_Products_Price ON Products (UnitPrice); + +CREATE OR REPLACE TRIGGER trg_products_modtime +BEFORE UPDATE ON Products +FOR EACH ROW +BEGIN + :NEW.LastUpdated := SYSTIMESTAMP; +END; +/ + +-- ======================================== +-- 4. OrderDetails ํ…Œ์ด๋ธ” +-- ======================================== +CREATE TABLE OrderDetails ( + OrderDetailID NUMBER GENERATED BY DEFAULT AS IDENTITY, + OrderID NUMBER NOT NULL, + ProductID NUMBER NOT NULL, + UnitPrice NUMBER(15,2) NOT NULL, + Quantity NUMBER NOT NULL, + Discount NUMBER(5,2) DEFAULT 0, + LineTotal NUMBER(15,2) GENERATED ALWAYS AS (UnitPrice * Quantity * (1 - Discount/100)) VIRTUAL, + CreatedDate TIMESTAMP DEFAULT SYSTIMESTAMP, + CONSTRAINT PK_OrderDetails PRIMARY KEY (OrderDetailID), + CONSTRAINT FK_OrderDetails_Orders FOREIGN KEY (OrderID) REFERENCES Orders(OrderID) ON DELETE CASCADE, + CONSTRAINT FK_OrderDetails_Products FOREIGN KEY (ProductID) REFERENCES Products(ProductID) +); + +CREATE INDEX IX_OrderDetails_OrderID ON OrderDetails (OrderID); +CREATE INDEX IX_OrderDetails_ProductID ON OrderDetails (ProductID); + +-- ======================================== +-- 5. Employees ํ…Œ์ด๋ธ” +-- ======================================== +CREATE TABLE Employees ( + EmployeeID NUMBER GENERATED BY DEFAULT AS IDENTITY, + EmployeeCode VARCHAR2(20) NOT NULL, + FirstName VARCHAR2(50) NOT NULL, + LastName VARCHAR2(50) NOT NULL, + Title VARCHAR2(50), + BirthDate DATE, + HireDate DATE, + Email VARCHAR2(100), + Phone VARCHAR2(20), + Department VARCHAR2(50), + Salary NUMBER(15,2), + ReportsTo NUMBER, + IsActive NUMBER(1) DEFAULT 1, + CreatedDate TIMESTAMP DEFAULT SYSTIMESTAMP, + LastUpdated TIMESTAMP DEFAULT SYSTIMESTAMP, + CONSTRAINT PK_Employees PRIMARY KEY (EmployeeID), + CONSTRAINT UK_Employees_Code UNIQUE (EmployeeCode), + CONSTRAINT FK_Employees_ReportsTo FOREIGN KEY (ReportsTo) REFERENCES Employees(EmployeeID) +); + +CREATE INDEX IX_Employees_Name ON Employees (LastName, FirstName); +CREATE INDEX IX_Employees_Department ON Employees (Department); +CREATE INDEX IX_Employees_ReportsTo ON Employees (ReportsTo); + +CREATE OR REPLACE TRIGGER trg_employees_modtime +BEFORE UPDATE ON Employees +FOR EACH ROW +BEGIN + :NEW.LastUpdated := SYSTIMESTAMP; +END; +/ + +-- ======================================== +-- 6. ์ฃผ๋ฌธ ์š”์•ฝ ๋ทฐ +-- ======================================== +CREATE OR REPLACE VIEW vw_OrderSummary AS +SELECT + o.OrderID, + o.OrderNumber, + o.OrderDate, + c.CustomerCode, + c.CustomerName, + c.City AS CustomerCity, + c.Region AS CustomerRegion, + o.OrderStatus, + o.PaymentStatus, + o.TotalAmount, + (SELECT COUNT(*) FROM OrderDetails od WHERE od.OrderID = o.OrderID) AS ItemCount, + (SELECT NVL(SUM(od.Quantity),0) FROM OrderDetails od WHERE od.OrderID = o.OrderID) AS TotalQuantity, + o.CreatedDate +FROM Orders o +JOIN Customers c ON o.CustomerID = c.CustomerID; + +-- ์™„๋ฃŒ ๋ฉ”์‹œ์ง€ +PROMPT 'Oracle์šฉ ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ” ์ƒ์„ฑ ์™„๋ฃŒ' diff --git a/resources/create_sample_tables_postgresql.sql b/resources/create_sample_tables_postgresql.sql new file mode 100644 index 0000000..de4ad7d --- /dev/null +++ b/resources/create_sample_tables_postgresql.sql @@ -0,0 +1,216 @@ +-- ======================================== +-- ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ” ์ƒ์„ฑ ์Šคํฌ๋ฆฝํŠธ +-- PostgreSQL์šฉ +-- ======================================== + +-- ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ƒ์„ฑ (์กด์žฌํ•˜์ง€ ์•Š๋Š” ๊ฒฝ์šฐ) +-- Note: ์ด ๋ถ€๋ถ„์€ psql์—์„œ ์‹คํ–‰ํ•˜๊ฑฐ๋‚˜, ์ด๋ฏธ sampledb๊ฐ€ ์ƒ์„ฑ๋˜์–ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. +-- CREATE DATABASE sampledb ENCODING 'UTF8'; + +-- \c sampledb + +-- ======================================== +-- 1. Customers ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS Customers CASCADE; + +CREATE TABLE Customers ( + CustomerID SERIAL NOT NULL, + CustomerCode VARCHAR(20) NOT NULL, + CustomerName VARCHAR(100) NOT NULL, + ContactName VARCHAR(50) NULL, + Email VARCHAR(100) NULL, + Phone VARCHAR(20) NULL, + Address VARCHAR(200) NULL, + City VARCHAR(50) NULL, + Region VARCHAR(50) NULL, + PostalCode VARCHAR(10) NULL, + Country VARCHAR(50) NULL, + CustomerType VARCHAR(20) DEFAULT 'Regular', + CreditLimit DECIMAL(15,2) DEFAULT 0, + IsActive BOOLEAN DEFAULT TRUE, + CreatedDate TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + LastUpdated TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT PK_Customers PRIMARY KEY (CustomerID), + CONSTRAINT UK_Customers_Code UNIQUE (CustomerCode) +); + +-- ์ธ๋ฑ์Šค ์ƒ์„ฑ +CREATE INDEX IX_Customers_Name ON Customers (CustomerName); +CREATE INDEX IX_Customers_City ON Customers (City); +CREATE INDEX IX_Customers_Region ON Customers (Region); +CREATE INDEX IX_Customers_Type ON Customers (CustomerType); + +-- LastUpdated ์ž๋™ ์—…๋ฐ์ดํŠธ๋ฅผ ์œ„ํ•œ ํŠธ๋ฆฌ๊ฑฐ ํ•จ์ˆ˜ +CREATE OR REPLACE FUNCTION update_modified_column() +RETURNS TRIGGER AS $$ +BEGIN + NEW.LastUpdated = CURRENT_TIMESTAMP; + RETURN NEW; +END; +$$ language 'plpgsql'; + +CREATE TRIGGER update_customers_modtime + BEFORE UPDATE ON Customers + FOR EACH ROW + EXECUTE FUNCTION update_modified_column(); + +-- ======================================== +-- 2. Orders ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS Orders CASCADE; + +CREATE TABLE Orders ( + OrderID SERIAL NOT NULL, + OrderNumber VARCHAR(30) NOT NULL, + CustomerID INTEGER NOT NULL, + OrderDate TIMESTAMP NOT NULL, + RequiredDate TIMESTAMP NULL, + ShippedDate TIMESTAMP NULL, + OrderStatus VARCHAR(20) DEFAULT 'Pending', + SubTotal DECIMAL(15,2) DEFAULT 0, + TotalAmount DECIMAL(15,2) DEFAULT 0, + DiscountAmount DECIMAL(15,2) DEFAULT 0, + TaxAmount DECIMAL(15,2) DEFAULT 0, + NetAmount DECIMAL(15,2) DEFAULT 0, + ShippingAddress VARCHAR(200) NULL, + PaymentMethod VARCHAR(30) NULL, + PaymentStatus VARCHAR(20) DEFAULT 'Unpaid', + EmployeeID INTEGER NULL, + Notes TEXT NULL, + CreatedDate TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + LastUpdated TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT PK_Orders PRIMARY KEY (OrderID), + CONSTRAINT UK_Orders_Number UNIQUE (OrderNumber), + CONSTRAINT FK_Orders_Customers + FOREIGN KEY (CustomerID) + REFERENCES Customers(CustomerID) + ON DELETE RESTRICT + ON UPDATE CASCADE +); + +CREATE INDEX IX_Orders_Customer ON Orders (CustomerID); +CREATE INDEX IX_Orders_Date ON Orders (OrderDate); +CREATE INDEX IX_Orders_Status ON Orders (OrderStatus); + +CREATE TRIGGER update_orders_modtime + BEFORE UPDATE ON Orders + FOR EACH ROW + EXECUTE FUNCTION update_modified_column(); + +-- ======================================== +-- 3. Products ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS Products CASCADE; + +CREATE TABLE Products ( + ProductID SERIAL NOT NULL, + ProductCode VARCHAR(20) NOT NULL, + ProductName VARCHAR(100) NOT NULL, + Category VARCHAR(50) NULL, + UnitPrice DECIMAL(15,2) DEFAULT 0, + UnitsInStock INTEGER DEFAULT 0, + UnitsOnOrder INTEGER DEFAULT 0, + ReorderLevel INTEGER DEFAULT 0, + Discontinued BOOLEAN DEFAULT FALSE, + Description TEXT NULL, + CreatedDate TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + LastUpdated TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT PK_Products PRIMARY KEY (ProductID), + CONSTRAINT UK_Products_Code UNIQUE (ProductCode) +); + +CREATE INDEX IX_Products_Name ON Products (ProductName); +CREATE INDEX IX_Products_Category ON Products (Category); +CREATE INDEX IX_Products_Price ON Products (UnitPrice); + +CREATE TRIGGER update_products_modtime + BEFORE UPDATE ON Products + FOR EACH ROW + EXECUTE FUNCTION update_modified_column(); + +-- ======================================== +-- 4. OrderDetails ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS OrderDetails CASCADE; + +CREATE TABLE OrderDetails ( + OrderDetailID SERIAL NOT NULL, + OrderID INTEGER NOT NULL, + ProductID INTEGER NOT NULL, + UnitPrice DECIMAL(15,2) NOT NULL, + Quantity INTEGER NOT NULL DEFAULT 1, + Discount DECIMAL(5,2) DEFAULT 0, + LineTotal DECIMAL(15,2) GENERATED ALWAYS AS (UnitPrice * Quantity * (1 - Discount / 100)) STORED, + CreatedDate TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT PK_OrderDetails PRIMARY KEY (OrderDetailID), + CONSTRAINT FK_OrderDetails_Orders + FOREIGN KEY (OrderID) + REFERENCES Orders(OrderID) + ON DELETE CASCADE + ON UPDATE CASCADE, + CONSTRAINT FK_OrderDetails_Products + FOREIGN KEY (ProductID) + REFERENCES Products(ProductID) + ON DELETE RESTRICT + ON UPDATE CASCADE +); + +CREATE INDEX IX_OrderDetails_Order ON OrderDetails (OrderID); +CREATE INDEX IX_OrderDetails_Product ON OrderDetails (ProductID); + +-- ======================================== +-- 5. Employees ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS Employees CASCADE; + +CREATE TABLE Employees ( + EmployeeID SERIAL NOT NULL, + EmployeeCode VARCHAR(20) NOT NULL, + FirstName VARCHAR(50) NOT NULL, + LastName VARCHAR(50) NOT NULL, + Title VARCHAR(50) NULL, + BirthDate DATE NULL, + HireDate DATE NULL, + Email VARCHAR(100) NULL, + Phone VARCHAR(20) NULL, + Department VARCHAR(50) NULL, + Salary DECIMAL(15,2) NULL, + ReportsTo INTEGER NULL, + IsActive BOOLEAN DEFAULT TRUE, + CreatedDate TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + LastUpdated TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT PK_Employees PRIMARY KEY (EmployeeID), + CONSTRAINT UK_Employees_Code UNIQUE (EmployeeCode), + CONSTRAINT FK_Employees_ReportsTo + FOREIGN KEY (ReportsTo) + REFERENCES Employees(EmployeeID) + ON DELETE SET NULL + ON UPDATE CASCADE +); + +CREATE INDEX IX_Employees_Name ON Employees (LastName, FirstName); +CREATE INDEX IX_Employees_Department ON Employees (Department); +CREATE INDEX IX_Employees_ReportsTo ON Employees (ReportsTo); + +CREATE TRIGGER update_employees_modtime + BEFORE UPDATE ON Employees + FOR EACH ROW + EXECUTE FUNCTION update_modified_column(); + +-- ======================================== +-- ์™„๋ฃŒ ๋ฉ”์‹œ์ง€ +-- ======================================== + +SELECT 'Sample tables created successfully for PostgreSQL!' AS Message; + diff --git a/resources/create_sample_tables_sqlite.sql b/resources/create_sample_tables_sqlite.sql new file mode 100644 index 0000000..7b45ed0 --- /dev/null +++ b/resources/create_sample_tables_sqlite.sql @@ -0,0 +1,198 @@ +-- ======================================== +-- ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ” ์ƒ์„ฑ ์Šคํฌ๋ฆฝํŠธ +-- SQLite์šฉ +-- ======================================== + +-- SQLite๋Š” ํŒŒ์ผ ๊ธฐ๋ฐ˜์ด๋ฏ€๋กœ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ƒ์„ฑ ๋ถˆํ•„์š” +-- ํŒŒ์ผ๋ช…: sampledb.sqlite + +-- ======================================== +-- 1. Customers ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS Customers; + +CREATE TABLE Customers ( + CustomerID INTEGER PRIMARY KEY AUTOINCREMENT, + CustomerCode TEXT NOT NULL UNIQUE, + CustomerName TEXT NOT NULL, + ContactName TEXT, + Email TEXT, + Phone TEXT, + Address TEXT, + City TEXT, + Region TEXT, + PostalCode TEXT, + Country TEXT, + CustomerType TEXT DEFAULT 'Regular', + CreditLimit REAL DEFAULT 0, + IsActive INTEGER DEFAULT 1, -- SQLite uses INTEGER for BOOLEAN (0=false, 1=true) + CreatedDate TEXT DEFAULT (datetime('now', 'localtime')), + LastUpdated TEXT DEFAULT (datetime('now', 'localtime')) +); + +-- ์ธ๋ฑ์Šค ์ƒ์„ฑ +CREATE INDEX IX_Customers_Name ON Customers (CustomerName); +CREATE INDEX IX_Customers_City ON Customers (City); +CREATE INDEX IX_Customers_Region ON Customers (Region); +CREATE INDEX IX_Customers_Type ON Customers (CustomerType); + +-- LastUpdated ์ž๋™ ์—…๋ฐ์ดํŠธ๋ฅผ ์œ„ํ•œ ํŠธ๋ฆฌ๊ฑฐ +CREATE TRIGGER update_customers_timestamp +AFTER UPDATE ON Customers +FOR EACH ROW +BEGIN + UPDATE Customers + SET LastUpdated = datetime('now', 'localtime') + WHERE CustomerID = NEW.CustomerID; +END; + +-- ======================================== +-- 2. Orders ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS Orders; + +CREATE TABLE Orders ( + OrderID INTEGER PRIMARY KEY AUTOINCREMENT, + OrderNumber TEXT NOT NULL UNIQUE, + CustomerID INTEGER NOT NULL, + OrderDate TEXT NOT NULL, + RequiredDate TEXT, + ShippedDate TEXT, + OrderStatus TEXT DEFAULT 'Pending', + TotalAmount REAL DEFAULT 0, + DiscountAmount REAL DEFAULT 0, + TaxAmount REAL DEFAULT 0, + NetAmount REAL DEFAULT 0, + ShippingAddress TEXT, + Notes TEXT, + CreatedDate TEXT DEFAULT (datetime('now', 'localtime')), + LastUpdated TEXT DEFAULT (datetime('now', 'localtime')), + + FOREIGN KEY (CustomerID) REFERENCES Customers(CustomerID) + ON DELETE RESTRICT + ON UPDATE CASCADE +); + +CREATE INDEX IX_Orders_Customer ON Orders (CustomerID); +CREATE INDEX IX_Orders_Date ON Orders (OrderDate); +CREATE INDEX IX_Orders_Status ON Orders (OrderStatus); + +CREATE TRIGGER update_orders_timestamp +AFTER UPDATE ON Orders +FOR EACH ROW +BEGIN + UPDATE Orders + SET LastUpdated = datetime('now', 'localtime') + WHERE OrderID = NEW.OrderID; +END; + +-- ======================================== +-- 3. Products ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS Products; + +CREATE TABLE Products ( + ProductID INTEGER PRIMARY KEY AUTOINCREMENT, + ProductCode TEXT NOT NULL UNIQUE, + ProductName TEXT NOT NULL, + Category TEXT, + UnitPrice REAL DEFAULT 0, + UnitsInStock INTEGER DEFAULT 0, + UnitsOnOrder INTEGER DEFAULT 0, + ReorderLevel INTEGER DEFAULT 0, + Discontinued INTEGER DEFAULT 0, + Description TEXT, + CreatedDate TEXT DEFAULT (datetime('now', 'localtime')), + LastUpdated TEXT DEFAULT (datetime('now', 'localtime')) +); + +CREATE INDEX IX_Products_Name ON Products (ProductName); +CREATE INDEX IX_Products_Category ON Products (Category); +CREATE INDEX IX_Products_Price ON Products (UnitPrice); + +CREATE TRIGGER update_products_timestamp +AFTER UPDATE ON Products +FOR EACH ROW +BEGIN + UPDATE Products + SET LastUpdated = datetime('now', 'localtime') + WHERE ProductID = NEW.ProductID; +END; + +-- ======================================== +-- 4. OrderDetails ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS OrderDetails; + +CREATE TABLE OrderDetails ( + OrderDetailID INTEGER PRIMARY KEY AUTOINCREMENT, + OrderID INTEGER NOT NULL, + ProductID INTEGER NOT NULL, + UnitPrice REAL NOT NULL, + Quantity INTEGER NOT NULL DEFAULT 1, + Discount REAL DEFAULT 0, + LineTotal REAL GENERATED ALWAYS AS (UnitPrice * Quantity * (1 - Discount / 100)) STORED, + CreatedDate TEXT DEFAULT (datetime('now', 'localtime')), + + FOREIGN KEY (OrderID) REFERENCES Orders(OrderID) + ON DELETE CASCADE + ON UPDATE CASCADE, + FOREIGN KEY (ProductID) REFERENCES Products(ProductID) + ON DELETE RESTRICT + ON UPDATE CASCADE +); + +CREATE INDEX IX_OrderDetails_Order ON OrderDetails (OrderID); +CREATE INDEX IX_OrderDetails_Product ON OrderDetails (ProductID); + +-- ======================================== +-- 5. Employees ํ…Œ์ด๋ธ” ์ƒ์„ฑ +-- ======================================== + +DROP TABLE IF EXISTS Employees; + +CREATE TABLE Employees ( + EmployeeID INTEGER PRIMARY KEY AUTOINCREMENT, + EmployeeCode TEXT NOT NULL UNIQUE, + FirstName TEXT NOT NULL, + LastName TEXT NOT NULL, + Title TEXT, + BirthDate TEXT, -- SQLite stores dates as TEXT in ISO format + HireDate TEXT, + Email TEXT, + Phone TEXT, + Department TEXT, + Salary REAL, + ReportsTo INTEGER, + IsActive INTEGER DEFAULT 1, + CreatedDate TEXT DEFAULT (datetime('now', 'localtime')), + LastUpdated TEXT DEFAULT (datetime('now', 'localtime')), + + FOREIGN KEY (ReportsTo) REFERENCES Employees(EmployeeID) + ON DELETE SET NULL + ON UPDATE CASCADE +); + +CREATE INDEX IX_Employees_Name ON Employees (LastName, FirstName); +CREATE INDEX IX_Employees_Department ON Employees (Department); +CREATE INDEX IX_Employees_ReportsTo ON Employees (ReportsTo); + +CREATE TRIGGER update_employees_timestamp +AFTER UPDATE ON Employees +FOR EACH ROW +BEGIN + UPDATE Employees + SET LastUpdated = datetime('now', 'localtime') + WHERE EmployeeID = NEW.EmployeeID; +END; + +-- ======================================== +-- ์™„๋ฃŒ ๋ฉ”์‹œ์ง€ +-- ======================================== + +SELECT 'Sample tables created successfully for SQLite!' AS Message; + diff --git a/resources/drop_sample_tables.sql b/resources/drop_sample_tables.sql deleted file mode 100644 index a32baed..0000000 --- a/resources/drop_sample_tables.sql +++ /dev/null @@ -1,20 +0,0 @@ - - ------------------------------------------------------------ --- ์™ธ๋ž˜ํ‚ค ์‚ญ์ œ ------------------------------------------------------------ -ALTER TABLE OrderDetails DROP CONSTRAINT FK_OrderDetails_Orders; -ALTER TABLE Orders DROP CONSTRAINT FK_Orders_Customers; - - - ------------------------------------------------------------ --- ํ…Œ์ด๋ธ” ์‚ญ์ œ ------------------------------------------------------------ -DROP TABLE OrderDetails; -DROP TABLE Orders; -DROP TABLE Customers; - - - - diff --git a/resources/drop_sample_tables_mssql.sql b/resources/drop_sample_tables_mssql.sql new file mode 100644 index 0000000..2c8a02b --- /dev/null +++ b/resources/drop_sample_tables_mssql.sql @@ -0,0 +1,34 @@ +-- ======================================== +-- ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ”/๋ทฐ ์‚ญ์ œ ์Šคํฌ๋ฆฝํŠธ (MSSQL) +-- ์˜์กด์„ฑ ์ˆœ์„œ์— ๋งž์ถฐ ์•ˆ์ „ํ•˜๊ฒŒ ๋“œ๋กญ +-- ======================================== + +SET NOCOUNT ON; + +-- 1) ๋ทฐ ๋“œ๋กญ +IF OBJECT_ID('dbo.vw_OrderSummary', 'V') IS NOT NULL DROP VIEW dbo.vw_OrderSummary; +GO + +-- 2) ํŠธ๋ฆฌ๊ฑฐ ๋“œ๋กญ (์กด์žฌ ์‹œ) +IF OBJECT_ID('dbo.trg_customers_modtime', 'TR') IS NOT NULL DROP TRIGGER dbo.trg_customers_modtime; +IF OBJECT_ID('dbo.trg_orders_modtime', 'TR') IS NOT NULL DROP TRIGGER dbo.trg_orders_modtime; +IF OBJECT_ID('dbo.trg_products_modtime', 'TR') IS NOT NULL DROP TRIGGER dbo.trg_products_modtime; +IF OBJECT_ID('dbo.trg_employees_modtime', 'TR') IS NOT NULL DROP TRIGGER dbo.trg_employees_modtime; +GO + +-- 3) ์™ธ๋ž˜ํ‚ค ์ œ์•ฝ ํ•ด์ œ (์กด์žฌ ์‹œ) +IF OBJECT_ID('dbo.FK_OrderDetails_Orders', 'F') IS NOT NULL ALTER TABLE dbo.OrderDetails DROP CONSTRAINT FK_OrderDetails_Orders; +IF OBJECT_ID('dbo.FK_OrderDetails_Products', 'F') IS NOT NULL ALTER TABLE dbo.OrderDetails DROP CONSTRAINT FK_OrderDetails_Products; +IF OBJECT_ID('dbo.FK_Employees_ReportsTo', 'F') IS NOT NULL ALTER TABLE dbo.Employees DROP CONSTRAINT FK_Employees_ReportsTo; +IF OBJECT_ID('dbo.FK_Orders_Customers', 'F') IS NOT NULL ALTER TABLE dbo.Orders DROP CONSTRAINT FK_Orders_Customers; +GO + +-- 4) ํ…Œ์ด๋ธ” ๋“œ๋กญ (์ž์‹ โ†’ ๋ถ€๋ชจ ์ˆœ์„œ) +IF OBJECT_ID('dbo.OrderDetails', 'U') IS NOT NULL DROP TABLE dbo.OrderDetails; +IF OBJECT_ID('dbo.Orders', 'U') IS NOT NULL DROP TABLE dbo.Orders; +IF OBJECT_ID('dbo.Products', 'U') IS NOT NULL DROP TABLE dbo.Products; +IF OBJECT_ID('dbo.Employees', 'U') IS NOT NULL DROP TABLE dbo.Employees; +IF OBJECT_ID('dbo.Customers', 'U') IS NOT NULL DROP TABLE dbo.Customers; +GO + +PRINT 'MSSQL ์ƒ˜ํ”Œ ๊ฐ์ฒด ์‚ญ์ œ ์™„๋ฃŒ'; diff --git a/resources/drop_sample_tables_mysql.sql b/resources/drop_sample_tables_mysql.sql new file mode 100644 index 0000000..7e05931 --- /dev/null +++ b/resources/drop_sample_tables_mysql.sql @@ -0,0 +1,16 @@ +-- ======================================== +-- ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ” ์‚ญ์ œ ์Šคํฌ๋ฆฝํŠธ +-- MySQL / MariaDB์šฉ +-- ======================================== + +USE sampledb; + +-- ์™ธ๋ž˜ ํ‚ค ์ œ์•ฝ ์กฐ๊ฑด ๋•Œ๋ฌธ์— ์—ญ์ˆœ์œผ๋กœ ์‚ญ์ œ +DROP TABLE IF EXISTS OrderDetails; +DROP TABLE IF EXISTS Orders; +DROP TABLE IF EXISTS Products; +DROP TABLE IF EXISTS Employees; +DROP TABLE IF EXISTS Customers; + +SELECT 'Sample tables dropped successfully for MySQL/MariaDB!' AS Message; + diff --git a/resources/drop_sample_tables_oracle.sql b/resources/drop_sample_tables_oracle.sql new file mode 100644 index 0000000..1aa10f6 --- /dev/null +++ b/resources/drop_sample_tables_oracle.sql @@ -0,0 +1,16 @@ +-- ======================================== +-- ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ”/๋ทฐ ์‚ญ์ œ ์Šคํฌ๋ฆฝํŠธ (Oracle) +-- ======================================== +BEGIN EXECUTE IMMEDIATE 'DROP VIEW vw_OrderSummary'; EXCEPTION WHEN OTHERS THEN IF SQLCODE != -942 THEN RAISE; END IF; END; +/ +BEGIN EXECUTE IMMEDIATE 'DROP TABLE OrderDetails CASCADE CONSTRAINTS'; EXCEPTION WHEN OTHERS THEN IF SQLCODE != -942 THEN RAISE; END IF; END; +/ +BEGIN EXECUTE IMMEDIATE 'DROP TABLE Orders CASCADE CONSTRAINTS'; EXCEPTION WHEN OTHERS THEN IF SQLCODE != -942 THEN RAISE; END IF; END; +/ +BEGIN EXECUTE IMMEDIATE 'DROP TABLE Products CASCADE CONSTRAINTS'; EXCEPTION WHEN OTHERS THEN IF SQLCODE != -942 THEN RAISE; END IF; END; +/ +BEGIN EXECUTE IMMEDIATE 'DROP TABLE Employees CASCADE CONSTRAINTS'; EXCEPTION WHEN OTHERS THEN IF SQLCODE != -942 THEN RAISE; END IF; END; +/ +BEGIN EXECUTE IMMEDIATE 'DROP TABLE Customers CASCADE CONSTRAINTS'; EXCEPTION WHEN OTHERS THEN IF SQLCODE != -942 THEN RAISE; END IF; END; +/ +PROMPT 'Oracle์šฉ ์ƒ˜ํ”Œ ๊ฐ์ฒด ์‚ญ์ œ ์™„๋ฃŒ' diff --git a/resources/drop_sample_tables_postgresql.sql b/resources/drop_sample_tables_postgresql.sql new file mode 100644 index 0000000..ded1dab --- /dev/null +++ b/resources/drop_sample_tables_postgresql.sql @@ -0,0 +1,17 @@ +-- ======================================== +-- ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ” ์‚ญ์ œ ์Šคํฌ๋ฆฝํŠธ +-- PostgreSQL์šฉ +-- ======================================== + +-- CASCADE ์˜ต์…˜์œผ๋กœ ์™ธ๋ž˜ ํ‚ค ์ œ์•ฝ ์กฐ๊ฑด ๋ฌด์‹œํ•˜๊ณ  ์‚ญ์ œ +DROP TABLE IF EXISTS OrderDetails CASCADE; +DROP TABLE IF EXISTS Orders CASCADE; +DROP TABLE IF EXISTS Products CASCADE; +DROP TABLE IF EXISTS Employees CASCADE; +DROP TABLE IF EXISTS Customers CASCADE; + +-- ํŠธ๋ฆฌ๊ฑฐ ํ•จ์ˆ˜ ์‚ญ์ œ +DROP FUNCTION IF EXISTS update_modified_column() CASCADE; + +SELECT 'Sample tables dropped successfully for PostgreSQL!' AS Message; + diff --git a/resources/drop_sample_tables_sqlite.sql b/resources/drop_sample_tables_sqlite.sql new file mode 100644 index 0000000..aeb2f91 --- /dev/null +++ b/resources/drop_sample_tables_sqlite.sql @@ -0,0 +1,15 @@ +-- ======================================== +-- ์ƒ˜ํ”Œ ํ…Œ์ด๋ธ” ์‚ญ์ œ ์Šคํฌ๋ฆฝํŠธ +-- SQLite์šฉ +-- ======================================== + +-- SQLite๋Š” IF EXISTS๋ฅผ ์ง€์›ํ•˜๋ฏ€๋กœ ์•ˆ์ „ํ•˜๊ฒŒ ์‚ญ์ œ ๊ฐ€๋Šฅ +-- ์™ธ๋ž˜ ํ‚ค ์ œ์•ฝ ์กฐ๊ฑด ๋•Œ๋ฌธ์— ์—ญ์ˆœ์œผ๋กœ ์‚ญ์ œ +DROP TABLE IF EXISTS OrderDetails; +DROP TABLE IF EXISTS Orders; +DROP TABLE IF EXISTS Products; +DROP TABLE IF EXISTS Employees; +DROP TABLE IF EXISTS Customers; + +SELECT 'Sample tables dropped successfully for SQLite!' AS Message; + diff --git a/resources/generate_sample_data.py b/resources/generate_sample_data.py new file mode 100644 index 0000000..004e116 --- /dev/null +++ b/resources/generate_sample_data.py @@ -0,0 +1,357 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +""" +์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ƒ์„ฑ ์Šคํฌ๋ฆฝํŠธ +100๊ฑด์˜ ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ƒ์„ฑ (ํ•œ๊ธ€ 50๊ฑด + ์˜์–ด 50๊ฑด) +""" + +import random +from datetime import datetime, timedelta +import argparse +import os +import sys + +# ํ•œ๊ธ€ ๋ฐ์ดํ„ฐ +korean_companies = [ + 'ํ•œ๊ตญ์ „์ž', '์„œ์šธ๋ฌด์—ญ์ƒ์‚ฌ', '๋ถ€์‚ฐ์‚ฐ์—…', '๋Œ€๊ตฌ์„ฌ์œ ', '์ธ์ฒœ๋ฌผ๋ฅ˜์„ผํ„ฐ', + '๊ด‘์ฃผ์‹ํ’ˆ์œ ํ†ต', '์ œ์ฃผํŠน์‚ฐ๋ฌผ', '์šธ์‚ฐํ™”ํ•™๊ณต์—…', '๋Œ€์ „๊ธฐ์ˆ ์—ฐ๊ตฌ์†Œ', '๊ฒฝ๊ธฐํ†ต์ƒ', + '์„œ์šธ๊ฐ€๊ตฌ', '๋ถ€์‚ฐ์ˆ˜์‚ฐ', '๋Œ€๊ตฌํ•œ๋ฐฉ์•ฝํ’ˆ', '์ธ์ฒœํ•ด์šด', '๊ด‘์ฃผ์ž๋™์ฐจ๋ถ€ํ’ˆ', + '์ œ์ฃผ๊ด€๊ด‘๊ฐœ๋ฐœ', '์šธ์‚ฐ์กฐ์„ ', '๋Œ€์ „๋ฐ”์ด์˜ค', '๊ฒฝ๊ธฐ๋ฐ˜๋„์ฒด', '์„œ์šธํŒจ์…˜', + '๋ถ€์‚ฐ์ฒ ๊ฐ•', '๋Œ€๊ตฌ์„ฌ์œ ๊ณต์—…', '์ธ์ฒœ์œ ๋ฆฌ', '๊ด‘์ฃผ์ „์ž๋ถ€ํ’ˆ', '์ œ์ฃผ์‹ํ’ˆ', + '์šธ์‚ฐ์ •์œ ', '๋Œ€์ „์ „์ž', '๊ฒฝ๊ธฐํ™”ํ•™', '์„œ์šธ๊ฑด์„ค', '๋ถ€์‚ฐ๊ฑด์„ค์ž์žฌ', + '๋Œ€๊ตฌ๊ธฐ๊ณ„', '์ธ์ฒœํ•ญ๋งŒ', '๊ด‘์ฃผ๊ด‘์‚ฐ', '์ œ์ฃผ์—๋„ˆ์ง€', '์šธ์‚ฐ์ž๋™์ฐจ', + '๋Œ€์ „์†Œํ”„ํŠธ์›จ์–ด', '๊ฒฝ๊ธฐ๋ฌผ๋ฅ˜', '์„œ์šธ์˜๋ฃŒ๊ธฐ๊ธฐ', '๋ถ€์‚ฐ๋ฐ”์ด์˜ค', '๋Œ€๊ตฌIT', + '์ธ์ฒœ์‹ ์žฌ์ƒ์—๋„ˆ์ง€', '๊ด‘์ฃผ์Šค๋งˆํŠธํŒฉํ† ๋ฆฌ', '์ œ์ฃผ๋ฐ์ดํ„ฐ์„ผํ„ฐ', '์šธ์‚ฐ๋””์Šคํ”Œ๋ ˆ์ด', '๋Œ€์ „์šฐ์ฃผํ•ญ๊ณต', + '๊ฒฝ๊ธฐAI์‚ฐ์—…', '์„œ์šธํ•€ํ…Œํฌ', '๋ถ€์‚ฐ๋กœ๋ด‡์‚ฐ์—…', '๋Œ€๊ตฌ๋“œ๋ก ', '์ธ์ฒœ์Šค๋งˆํŠธ์‹œํ‹ฐ' +] + +korean_names = [ + '๊น€์ฒ ์ˆ˜', '์ด์˜ํฌ', '๋ฐ•๋ฏผ์ˆ˜', '์ตœ์ง€์˜', '์ •ํ˜„์šฐ', + '๊ฐ•์ˆ˜์ง„', '์œค์„œ์—ฐ', '์ž„๋™ํ˜', '์†ก๋ฏธ๋ž˜', 'ํ•œ์ง€ํ›ˆ', + '๊น€์˜์ˆ˜', '์ด์ˆœํฌ', '๋ฐ•๊ฑดํ˜ธ', '์ตœ๋ฏธ์˜', '์ •ํƒœ์œค', + '๊ฐ•๋ฏผ์„', '์œคํ˜œ์ง„', '์ž„์žฌํ˜„', '์†กํ˜„์ฃผ', 'ํ•œ์ˆ˜์—ฐ', + '๊น€๋™ํ˜„', '์ด์ง€์€', '๋ฐ•์ƒ์ฒ ', '์ตœ์œค์ •', '์ •์ˆ˜ํ˜„', + '๊ฐ•ํƒœ์˜', '์œค๋ฏธ์„ ', '์ž„๊ฒฝํ˜ธ', '์†ก์žฌ๋ฏผ', 'ํ•œ์˜๋ฏธ', + '๊น€๋ฏผ์žฌ', '์ด์ƒํ›ˆ', '๋ฐ•์ •์•„', '์ตœ์Šนํ˜„', '์ •์œ ์ง„', + '๊ฐ•๋„ํ˜„', '์œค์„œ์ค€', '์ž„ํ•˜์€', '์†ก์ง€์šฐ', 'ํ•œ์Šน์šฐ', + '๊น€์‹œ์šฐ', '์ด์˜ˆ์€', '๋ฐ•ํ•˜์ค€', '์ตœ์„œ์œค', '์ •๋ฏผ์žฌ', + '๊ฐ•์œ ๋‚˜', '์œค๋„์œค', '์ž„์„œ์ค€', '์†ก์ง€์•ˆ', 'ํ•œ์˜ˆ์ง„' +] + +korean_cities = ['์„œ์šธ', '๋ถ€์‚ฐ', '๋Œ€๊ตฌ', '์ธ์ฒœ', '๊ด‘์ฃผ', '๋Œ€์ „', '์šธ์‚ฐ', '์ œ์ฃผ', '์ˆ˜์›', '์„ฑ๋‚จ'] +korean_regions = ['์„œ์šธ', '๋ถ€์‚ฐ', '๋Œ€๊ตฌ', '์ธ์ฒœ', '๊ด‘์ฃผ', '๋Œ€์ „', '์šธ์‚ฐ', '์ œ์ฃผ', '๊ฒฝ๊ธฐ', '๊ฐ•์›'] + +# ์˜์–ด ๋ฐ์ดํ„ฐ +english_companies = [ + 'Tech Solutions Inc', 'Global Trading Co', 'Digital Innovations', 'Advanced Manufacturing', 'Pacific Logistics', + 'Euro Electronics', 'Asia Pacific Trade', 'Northern Industries', 'Smart Tech Corp', 'International Supply', + 'Future Systems', 'Green Energy Ltd', 'Advanced Materials', 'Ocean Freight Co', 'Digital Commerce', + 'Biotech Research', 'Automotive Parts Ltd', 'Cloud Services Inc', 'Pharma Solutions', 'Robotics International', + 'Financial Systems', 'Renewable Power', 'Aerospace Tech', 'Smart Agriculture', 'Quantum Computing', + 'Marine Solutions', 'AI Development', 'Logistics Solutions', 'Construction Tech', 'Food Processing', + 'Textile Manufacturing', 'Chemical Industries', 'Mining Corporation', 'Healthcare Systems', 'Education Technology', + 'Entertainment Media', 'Security Solutions', 'Environmental Tech', 'Transportation Systems', 'Telecommunications', + 'Water Treatment', 'Fashion Design', 'Gaming Studios', 'Space Technology', 'Furniture Design', + 'Printing Services', 'Packaging Solutions', 'Laboratory Equipment', 'Sports Equipment', 'Defense Systems' +] + +english_names = [ + 'John Smith', 'Emily Johnson', 'Michael Brown', 'Sarah Davis', 'David Wilson', + 'Sophie Martin', 'James Lee', 'Emma Anderson', 'Oliver Taylor', 'Isabella Thomas', + 'William Jackson', 'Olivia White', 'Ethan Harris', 'Ava Martinez', 'Noah Robinson', + 'Mia Clark', 'Lucas Rodriguez', 'Charlotte Lewis', 'Benjamin Walker', 'Amelia Hall', + 'Henry Allen', 'Harper Young', 'Alexander King', 'Evelyn Wright', 'Sebastian Lopez', + 'Ella Hill', 'Jack Scott', 'Aria Green', 'Mason Adams', 'Luna Baker', + 'Logan Nelson', 'Layla Carter', 'Elijah Mitchell', 'Chloe Perez', 'Matthew Roberts', + 'Avery Turner', 'Daniel Phillips', 'Sofia Campbell', 'Joseph Parker', 'Victoria Evans', + 'David Edwards', 'Grace Collins', 'Samuel Stewart', 'Zoe Sanchez', 'Ryan Morris', + 'Penelope Rogers', 'Isaac Reed', 'Stella Cook', 'Christian Morgan', 'Nora Bell' +] + +english_cities = [ + 'San Francisco', 'New York', 'London', 'Berlin', 'Sydney', + 'Paris', 'Singapore', 'Stockholm', 'Austin', 'Toronto', + 'Tokyo', 'Manchester', 'Munich', 'Amsterdam', 'Seattle', + 'Zurich', 'Milan', 'Dublin', 'Brussels', 'Seoul', + 'Chicago', 'Copenhagen', 'Houston', 'Rotterdam', 'Boston', + 'Oslo', 'San Jose', 'Singapore', 'Melbourne', 'Madrid', + 'Mumbai', 'Sรฃo Paulo', 'Johannesburg', 'Philadelphia', 'Edinburgh', + 'Los Angeles', 'Tel Aviv', 'Helsinki', 'Vienna', 'Hong Kong', + 'Dubai', 'Paris', 'San Francisco', 'Cape Canaveral', 'Gothenburg', + 'Hamburg', 'Atlanta', 'Basel', 'Denver', 'Arlington' +] + +# ์ œํ’ˆ ์นดํ…Œ๊ณ ๋ฆฌ (ํ•œ๊ธ€/์˜์–ด) +korean_products = [ + ('๋…ธํŠธ๋ถ', '์ „์ž์ œํ’ˆ'), ('๋งˆ์šฐ์Šค', '์ „์ž์ œํ’ˆ'), ('ํ‚ค๋ณด๋“œ', '์ „์ž์ œํ’ˆ'), ('๋ชจ๋‹ˆํ„ฐ', '์ „์ž์ œํ’ˆ'), ('์™ธ์žฅ SSD', '์ €์žฅ์žฅ์น˜'), + ('USB ๋ฉ”๋ชจ๋ฆฌ', '์ €์žฅ์žฅ์น˜'), ('์ด์–ดํฐ', '์˜ค๋””์˜ค'), ('์Šคํ”ผ์ปค', '์˜ค๋””์˜ค'), ('์›น์บ ', '์ „์ž์ œํ’ˆ'), ('ํƒœ๋ธ”๋ฆฟ', '์ „์ž์ œํ’ˆ'), + ('ํ”„๋ฆฐํ„ฐ', '์‚ฌ๋ฌด๊ธฐ๊ธฐ'), ('๋ณตํ•ฉ๊ธฐ', '์‚ฌ๋ฌด๊ธฐ๊ธฐ'), ('์Šคํƒ ๋“œ', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('์˜์ž', '๊ฐ€๊ตฌ'), ('์บ๋น„๋‹›', '๊ฐ€๊ตฌ'), + ('์ฑ…์ƒ', '๊ฐ€๊ตฌ'), ('๋žจํ”„', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('์ถฉ์ „๊ธฐ', '์ „์ž์ œํ’ˆ'), ('์ผ€์ด๋ธ”', '์ „์ž์ œํ’ˆ'), ('ํ—ˆ๋ธŒ', '์ „์ž์ œํ’ˆ'), + ('ํ—ค๋“œ์…‹', '์˜ค๋””์˜ค'), ('๋งˆ์ดํฌ', '์˜ค๋””์˜ค'), ('์Šค์บ๋„ˆ', '์‚ฌ๋ฌด๊ธฐ๊ธฐ'), ('๋ผ๋ฒจ๊ธฐ', '์‚ฌ๋ฌด๊ธฐ๊ธฐ'), ('๊ณ„์‚ฐ๊ธฐ', '์‚ฌ๋ฌด์šฉํ’ˆ'), + ('ํ™”์ดํŠธ๋ณด๋“œ', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('๋ณต์‚ฌ๊ธฐ', '์‚ฌ๋ฌด๊ธฐ๊ธฐ'), ('ํŒŒ์‡„๊ธฐ', '์‚ฌ๋ฌด๊ธฐ๊ธฐ'), ('๋ฐ”์ธ๋”', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('ํ•„๊ธฐ๊ตฌ', '์‚ฌ๋ฌด์šฉํ’ˆ'), + ('๋…ธํŠธ', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('ํŒŒ์ผ', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('ํด๋ฆฝ', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('ํ…Œ์ดํ”„', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('๊ฐ€์œ„', '์‚ฌ๋ฌด์šฉํ’ˆ'), + ('์Šคํ…Œ์ดํ”Œ๋Ÿฌ', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('ํŽ€์น˜', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('์ž', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('ํ˜•๊ด‘ํŽœ', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('์ง€์šฐ๊ฐœ', '์‚ฌ๋ฌด์šฉํ’ˆ'), + ('์ˆ˜์ •ํ…Œ์ดํ”„', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('ํฌ์ŠคํŠธ์ž‡', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('๋‹ฌ๋ ฅ', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('ํ”Œ๋ž˜๋„ˆ', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('์‹œ๊ณ„', '์‚ฌ๋ฌด์šฉํ’ˆ'), + ('์“ฐ๋ ˆ๊ธฐํ†ต', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('์šฐ์‚ฐ๊ฝ‚์ด', '์‚ฌ๋ฌด์šฉํ’ˆ'), ('์‹ ๋ฐœ์žฅ', '๊ฐ€๊ตฌ'), ('์‚ฌ๋ฌผํ•จ', '๊ฐ€๊ตฌ'), ('์นธ๋ง‰์ด', '๊ฐ€๊ตฌ') +] + +english_products = [ + ('Laptop Computer', 'Electronics'), ('Wireless Mouse', 'Electronics'), ('Mechanical Keyboard', 'Electronics'), + ('Monitor 27inch', 'Electronics'), ('External SSD', 'Storage'), ('USB Flash Drive', 'Storage'), + ('Wireless Earbuds', 'Audio'), ('Bluetooth Speaker', 'Audio'), ('HD Webcam', 'Electronics'), + ('Tablet Device', 'Electronics'), ('Laser Printer', 'Office Equipment'), ('Multifunction Printer', 'Office Equipment'), + ('Desk Lamp', 'Office Supplies'), ('Office Chair', 'Furniture'), ('File Cabinet', 'Furniture'), + ('Standing Desk', 'Furniture'), ('LED Lamp', 'Office Supplies'), ('Power Adapter', 'Electronics'), + ('USB Cable', 'Electronics'), ('USB Hub', 'Electronics'), ('Gaming Headset', 'Audio'), + ('Studio Microphone', 'Audio'), ('Document Scanner', 'Office Equipment'), ('Label Printer', 'Office Equipment'), + ('Calculator', 'Office Supplies'), ('Whiteboard', 'Office Supplies'), ('Copier', 'Office Equipment'), + ('Paper Shredder', 'Office Equipment'), ('Ring Binder', 'Office Supplies'), ('Pen Set', 'Office Supplies'), + ('Notebook', 'Office Supplies'), ('File Folder', 'Office Supplies'), ('Paper Clips', 'Office Supplies'), + ('Adhesive Tape', 'Office Supplies'), ('Scissors', 'Office Supplies'), ('Stapler', 'Office Supplies'), + ('Hole Punch', 'Office Supplies'), ('Ruler Set', 'Office Supplies'), ('Highlighter', 'Office Supplies'), + ('Eraser', 'Office Supplies'), ('Correction Tape', 'Office Supplies'), ('Sticky Notes', 'Office Supplies'), + ('Wall Calendar', 'Office Supplies'), ('Daily Planner', 'Office Supplies'), ('Wall Clock', 'Office Supplies'), + ('Waste Bin', 'Office Supplies'), ('Umbrella Stand', 'Office Supplies'), ('Shoe Rack', 'Furniture'), + ('Storage Locker', 'Furniture'), ('Privacy Screen', 'Furniture') +] + +def _fmt_str(s): + return "'" + str(s).replace("'", "''") + "'" + +def _fmt_bool(dialect, v): + if dialect == 'postgresql': + return 'TRUE' if v else 'FALSE' + # others accept 1/0, Oracle uses NUMBER(1) + return '1' if v else '0' + +def _fmt_dt_str(dt): + return dt.strftime('%Y-%m-%d %H:%M:%S') + +def _fmt_datetime(dialect, dt): + s = _fmt_dt_str(dt) + if dialect == 'oracle': + return f"TO_TIMESTAMP({_fmt_str(s)}, 'YYYY-MM-DD HH24:MI:SS')" + return _fmt_str(s) + +def _now(): + return datetime.utcnow() + +def gen_customers(rows): + data = [] + for i in range(rows // 2): + data.append({ + 'code': f"CUST{i+1:03d}", + 'name': ("(์ฃผ)" if i < 10 else "") + korean_companies[i % len(korean_companies)], + 'contact': korean_names[i % len(korean_names)], + 'email': f"{korean_names[i % len(korean_names)].replace(' ', '').lower()}@{korean_companies[i % len(korean_companies)].replace(' ', '').lower()}.co.kr", + 'phone': f"02-{random.randint(1000,9999)}-{random.randint(1000,9999)}", + 'address': '์„œ์šธ์‹œ ๊ฐ•๋‚จ๊ตฌ', + 'city': korean_cities[i % len(korean_cities)], + 'region': korean_regions[i % len(korean_regions)], + 'country': '๋Œ€ํ•œ๋ฏผ๊ตญ', + 'ctype': random.choice(['Premium','Regular','VIP']), + 'credit': float(random.randint(150,2000) * 100000), + 'active': True + }) + for i in range(rows - len(data)): + data.append({ + 'code': f"CUST{i+1+len(data):03d}", + 'name': english_companies[i % len(english_companies)], + 'contact': english_names[i % len(english_names)], + 'email': f"{english_names[i % len(english_names)].split()[0].lower()}@{english_companies[i % len(english_companies)].split()[0].lower()}.com", + 'phone': f"+1-555-{random.randint(1000,9999)}", + 'address': 'Address', + 'city': english_cities[i % len(english_cities)], + 'region': 'State', + 'country': 'USA', + 'ctype': random.choice(['Premium','Regular','VIP']), + 'credit': float(random.randint(200,2500) * 100000), + 'active': True + }) + return data + +def gen_products(rows): + data = [] + for i in range(rows // 2): + name, cat = korean_products[i % len(korean_products)] + data.append({ + 'code': f"P-{100+i}", 'name': name, 'cat': cat, + 'price': round(random.uniform(10, 2000), 2), + 'stock': random.randint(0, 500), 'onorder': random.randint(0, 200), + 'reorder': random.randint(0, 50), 'disc': False, + 'desc': None + }) + for i in range(rows - len(data)): + name, cat = english_products[i % len(english_products)] + data.append({ + 'code': f"P-{200+i}", 'name': name, 'cat': cat, + 'price': round(random.uniform(10, 2000), 2), + 'stock': random.randint(0, 500), 'onorder': random.randint(0, 200), + 'reorder': random.randint(0, 50), 'disc': False, + 'desc': None + }) + return data + +def gen_employees(rows): + data = [] + base = datetime(1980, 1, 1) + for i in range(rows): + first = random.choice(['Alice','Brian','Cathy','David','Evan','Fiona','George','Hanna','Ian','Julia']) + last = random.choice(['Kim','Lee','Park','Choi','Jung','Kang','Yoon','Lim','Song','Han']) + hire = _now() - timedelta(days=random.randint(0, 3650)) + birth = datetime(1970,1,1) + timedelta(days=random.randint(0, 20000)) + data.append({ + 'code': f"E-{i+1:03d}", 'first': first, 'last': last, + 'title': random.choice(['Manager','Engineer','Analyst','Assistant','Director']), + 'birth': birth.date(), 'hire': hire.date(), + 'email': f"{first.lower()}.{last.lower()}@example.com", + 'phone': f"010-{random.randint(1000,9999)}-{random.randint(1000,9999)}", + 'dept': random.choice(['Sales','IT','Finance','HR','Marketing']), + 'salary': round(random.uniform(3000,9000),2), + 'reports': None if i==0 else random.randint(1, i), + 'active': True + }) + return data + +def gen_orders(rows, customers_count, employees_count): + data = [] + start = datetime(2024,1,1) + for i in range(rows): + odt = start + timedelta(days=random.randint(0,60), hours=random.randint(0,23), minutes=random.randint(0,59)) + ship = None if random.random() < 0.3 else (odt + timedelta(days=random.randint(1,7))) + req = odt + timedelta(days=random.randint(1,10)) + subtotal = round(random.uniform(50, 5000), 2) + tax = round(subtotal * 0.1, 2) + total = round(subtotal + tax, 2) + data.append({ + 'number': f"SO-2024{i+1:05d}", + 'customer_id': random.randint(1, customers_count), + 'order_date': odt, + 'required_date': req, + 'shipped_date': ship, + 'status': random.choice(['Pending','Shipped','Delivered']), + 'subtotal': subtotal, + 'tax': tax, + 'total': total, + 'pay_method': random.choice(['Card','Wire','Cash']), + 'pay_status': random.choice(['Unpaid','Paid']), + 'emp_id': random.randint(1, max(1, employees_count)), + 'notes': None + }) + return data + +def gen_order_details(rows, orders_count, products_count): + data = [] + for _ in range(rows): + qty = random.randint(1,5) + price = round(random.uniform(5, 2000),2) + data.append({ + 'order_id': random.randint(1, orders_count), + 'product_id': random.randint(1, products_count), + 'unit_price': price, + 'qty': qty, + 'discount': round(random.choice([0,0,0,5,10]),2) + }) + return data + +def render_inserts(dialect, table, rows): + lines = [] + if table == 'customers': + cols = '(CustomerCode, CustomerName, ContactName, Email, Phone, Address, City, Region, Country, CustomerType, CreditLimit, IsActive)' + for r in rows: + vals = [ + _fmt_str(r['code']), _fmt_str(r['name']), _fmt_str(r['contact']), _fmt_str(r['email']), _fmt_str(r['phone']), + _fmt_str(r['address']), _fmt_str(r['city']), _fmt_str(r['region']), _fmt_str(r['country']), _fmt_str(r['ctype']), + f"{r['credit']:.2f}", _fmt_bool(dialect, r['active']) + ] + lines.append(f"INSERT INTO Customers {cols} VALUES (" + ", ".join(vals) + ");") + elif table == 'products': + cols = '(ProductCode, ProductName, Category, UnitPrice, UnitsInStock, UnitsOnOrder, ReorderLevel, Discontinued, Description)' + for r in rows: + vals = [ + _fmt_str(r['code']), _fmt_str(r['name']), _fmt_str(r['cat']), f"{r['price']:.2f}", + str(r['stock']), str(r['onorder']), str(r['reorder']), _fmt_bool(dialect, r['disc']), 'NULL' if r['desc'] is None else _fmt_str(r['desc']) + ] + lines.append(f"INSERT INTO Products {cols} VALUES (" + ", ".join(vals) + ");") + elif table == 'employees': + cols = '(EmployeeCode, FirstName, LastName, Title, BirthDate, HireDate, Email, Phone, Department, Salary, ReportsTo, IsActive)' + for r in rows: + birth = _fmt_str(r['birth'].strftime('%Y-%m-%d')) if dialect != 'oracle' else f"TO_DATE({_fmt_str(r['birth'].strftime('%Y-%m-%d'))}, 'YYYY-MM-DD')" + hire = _fmt_str(r['hire'].strftime('%Y-%m-%d')) if dialect != 'oracle' else f"TO_DATE({_fmt_str(r['hire'].strftime('%Y-%m-%d'))}, 'YYYY-MM-DD')" + vals = [ + _fmt_str(r['code']), _fmt_str(r['first']), _fmt_str(r['last']), _fmt_str(r['title']), + birth, hire, _fmt_str(r['email']), _fmt_str(r['phone']), _fmt_str(r['dept']), f"{r['salary']:.2f}", + 'NULL' if r['reports'] is None else str(r['reports']), _fmt_bool(dialect, r['active']) + ] + lines.append(f"INSERT INTO Employees {cols} VALUES (" + ", ".join(vals) + ");") + elif table == 'orders': + cols = '(OrderNumber, CustomerID, OrderDate, RequiredDate, ShippedDate, OrderStatus, SubTotal, TaxAmount, TotalAmount, PaymentMethod, PaymentStatus, EmployeeID, Notes)' + for r in rows: + order_dt = _fmt_datetime(dialect, r['order_date']) + req_dt = _fmt_datetime(dialect, r['required_date']) + ship_dt = 'NULL' if r['shipped_date'] is None else _fmt_datetime(dialect, r['shipped_date']) + vals = [ + _fmt_str(r['number']), str(r['customer_id']), order_dt, req_dt, ship_dt, + _fmt_str(r['status']), f"{r['subtotal']:.2f}", f"{r['tax']:.2f}", f"{r['total']:.2f}", + _fmt_str(r['pay_method']), _fmt_str(r['pay_status']), str(r['emp_id']), 'NULL' + ] + lines.append(f"INSERT INTO Orders {cols} VALUES (" + ", ".join(vals) + ");") + elif table == 'orderdetails': + cols = '(OrderID, ProductID, UnitPrice, Quantity, Discount)' + for r in rows: + vals = [str(r['order_id']), str(r['product_id']), f"{r['unit_price']:.2f}", str(r['qty']), f"{r['discount']:.2f}"] + lines.append(f"INSERT INTO OrderDetails {cols} VALUES (" + ", ".join(vals) + ");") + return lines + +def main(): + parser = argparse.ArgumentParser() + parser.add_argument('--dialect', '--db', dest='dialect', choices=['mssql','mysql','postgresql','oracle','sqlite'], default='mssql') + parser.add_argument('--tables', default='customers,products,employees,orders,orderdetails') + parser.add_argument('--rows', type=int, default=100) + parser.add_argument('--output', default='') + args = parser.parse_args() + + # Normalize dialect (accept common synonyms via --db/--dialect) + alias_map = { + 'postgres': 'postgresql', 'pg': 'postgresql', + 'maria': 'mysql', 'mariadb': 'mysql' + } + dialect = alias_map.get(args.dialect.lower(), args.dialect.lower()) + tables = [t.strip().lower() for t in args.tables.split(',') if t.strip()] + rows = args.rows + + customers = gen_customers(rows) + products = gen_products(rows) + employees = gen_employees(min(100, max(10, rows//2))) + orders = gen_orders(min(100, rows), len(customers), len(employees)) + orderdetails = gen_order_details(rows*2, len(orders), len(products)) + + all_lines = [] + if 'customers' in tables: + all_lines.append(f"-- Customers ({len(customers)} records)") + all_lines.extend(render_inserts(dialect, 'customers', customers)) + if 'products' in tables: + all_lines.append(f"-- Products ({len(products)} records)") + all_lines.extend(render_inserts(dialect, 'products', products)) + if 'employees' in tables: + all_lines.append(f"-- Employees ({len(employees)} records)") + all_lines.extend(render_inserts(dialect, 'employees', employees)) + if 'orders' in tables: + all_lines.append(f"-- Orders ({len(orders)} records)") + all_lines.extend(render_inserts(dialect, 'orders', orders)) + if 'orderdetails' in tables: + all_lines.append(f"-- OrderDetails ({len(orderdetails)} records)") + all_lines.extend(render_inserts(dialect, 'orderdetails', orderdetails)) + + output = "\n".join(all_lines) + "\n" + out_path = args.output + if not out_path: + script_dir = os.path.dirname(__file__) + out_path = os.path.join(script_dir, f"sample_data_{dialect}.sql") + with open(out_path, 'w', encoding='utf-8') as f: + f.write(output) + sys.stdout.write(out_path + "\n") + +if __name__ == "__main__": + main() + diff --git a/resources/insert_sample_data.sql b/resources/insert_sample_data.sql deleted file mode 100644 index d36590f..0000000 --- a/resources/insert_sample_data.sql +++ /dev/null @@ -1,277 +0,0 @@ --- ======================================== --- ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ ์Šคํฌ๋ฆฝํŠธ --- Microsoft SQL Server์šฉ --- ======================================== - -USE [SampleDB] -GO - --- ======================================== --- 1. Customers ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ --- ======================================== - -PRINT '๊ณ ๊ฐ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ ์ค‘...' - --- ๊ธฐ์กด ๋ฐ์ดํ„ฐ ์‚ญ์ œ (์ฐธ์กฐ๋ฌด๊ฒฐ์„ฑ ๋•Œ๋ฌธ์— ์—ญ์ˆœ์œผ๋กœ) -DELETE FROM dbo.OrderDetails -DELETE FROM dbo.Orders -DELETE FROM dbo.Customers -GO - --- IDENTITY ์‹œ๋“œ ๋ฆฌ์…‹ -DBCC CHECKIDENT ('dbo.Customers', RESEED, 0) -DBCC CHECKIDENT ('dbo.Orders', RESEED, 0) -DBCC CHECKIDENT ('dbo.OrderDetails', RESEED, 0) -GO - --- ๊ณ ๊ฐ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ -INSERT INTO dbo.Customers ( - CustomerCode, CustomerName, ContactName, Email, Phone, - Address, City, Region, PostalCode, Country, - CustomerType, CreditLimit, IsActive, CreatedDate -) VALUES --- ์„œ์šธ ์ง€์—ญ ๊ณ ๊ฐ -('CUST001', '์‚ผ์„ฑ์ „์ž(์ฃผ)', '๊น€์ฒ ์ˆ˜', 'kim@samsung.com', '02-1234-5678', - '์„œ์šธํŠน๋ณ„์‹œ ์„œ์ดˆ๊ตฌ ์„œ์ดˆ๋Œ€๋กœ 1321', '์„œ์šธ', '์„œ์šธ', '06765', '๋Œ€ํ•œ๋ฏผ๊ตญ', 'VIP', 50000000, 1, '2024-01-15'), - -('CUST002', 'LG์ „์ž(์ฃผ)', '๋ฐ•์˜ํฌ', 'park@lg.com', '02-2345-6789', - '์„œ์šธํŠน๋ณ„์‹œ ์˜๋“ฑํฌ๊ตฌ ์—ฌ์˜๋Œ€๋กœ 128', '์„œ์šธ', '์„œ์šธ', '07336', '๋Œ€ํ•œ๋ฏผ๊ตญ', 'VIP', 30000000, 1, '2024-01-20'), - -('CUST003', 'ํ˜„๋Œ€์ž๋™์ฐจ(์ฃผ)', '์ด๋ฏผ์ˆ˜', 'lee@hyundai.com', '02-3456-7890', - '์„œ์šธํŠน๋ณ„์‹œ ์ข…๋กœ๊ตฌ ์œจ๊ณก๋กœ 75', '์„œ์šธ', '์„œ์šธ', '03045', '๋Œ€ํ•œ๋ฏผ๊ตญ', 'Premium', 40000000, 1, '2024-02-01'), - -('CUST004', '์‹ ์„ธ๊ณ„๋ฐฑํ™”์ ', '์ •์ˆ˜์ง„', 'jung@shinsegae.com', '02-4567-8901', - '์„œ์šธํŠน๋ณ„์‹œ ์ค‘๊ตฌ ์†Œ๊ณต๋กœ 63', '์„œ์šธ', '์„œ์šธ', '04530', '๋Œ€ํ•œ๋ฏผ๊ตญ', 'Regular', 10000000, 1, '2024-02-10'), - --- ๋ถ€์‚ฐ ์ง€์—ญ ๊ณ ๊ฐ -('CUST005', '๋ถ€์‚ฐํ•ญ๋งŒ๊ณต์‚ฌ', '๊น€๋ถ€์‚ฐ', 'kim@busanport.com', '051-999-1234', - '๋ถ€์‚ฐ๊ด‘์—ญ์‹œ ์ค‘๊ตฌ ํ•ด๊ด€๋กœ 1', '๋ถ€์‚ฐ', '๋ถ€์‚ฐ', '48943', '๋Œ€ํ•œ๋ฏผ๊ตญ', 'Premium', 20000000, 1, '2024-02-15'), - -('CUST006', '๋กฏ๋ฐ๋ฐฑํ™”์  ์„ผํ…€์‹œํ‹ฐ์ ', '์ตœ๋กฏ๋ฐ', 'choi@lotte.com', '051-888-2345', - '๋ถ€์‚ฐ๊ด‘์—ญ์‹œ ํ•ด์šด๋Œ€๊ตฌ ์„ผํ…€๋‚จ๋Œ€๋กœ 35', '๋ถ€์‚ฐ', '๋ถ€์‚ฐ', '48058', '๋Œ€ํ•œ๋ฏผ๊ตญ', 'Regular', 8000000, 1, '2024-03-01'), - --- ๋Œ€๊ตฌ ์ง€์—ญ ๊ณ ๊ฐ -('CUST007', '๋Œ€๊ตฌ์€ํ–‰', '์„œ๋Œ€๊ตฌ', 'seo@dgb.co.kr', '053-777-3456', - '๋Œ€๊ตฌ๊ด‘์—ญ์‹œ ์ค‘๊ตฌ ๋‹ฌ๊ตฌ๋ฒŒ๋Œ€๋กœ 2077', '๋Œ€๊ตฌ', '๊ฒฝ๋ถ', '41911', '๋Œ€ํ•œ๋ฏผ๊ตญ', 'Premium', 15000000, 1, '2024-03-05'), - --- ์ธ์ฒœ ์ง€์—ญ ๊ณ ๊ฐ -('CUST008', '์ธ์ฒœ๊ตญ์ œ๊ณตํ•ญ๊ณต์‚ฌ', '์•ˆ์ธ์ฒœ', 'ahn@airport.kr', '032-666-4567', - '์ธ์ฒœ๊ด‘์—ญ์‹œ ์ค‘๊ตฌ ๊ณตํ•ญ๋กœ 272', '์ธ์ฒœ', '์ธ์ฒœ', '22382', '๋Œ€ํ•œ๋ฏผ๊ตญ', 'VIP', 25000000, 1, '2024-03-10'), - --- ๊ด‘์ฃผ ์ง€์—ญ ๊ณ ๊ฐ -('CUST009', '๊ธฐ์•„์ž๋™์ฐจ ๊ด‘์ฃผ๊ณต์žฅ', '์กฐ๊ด‘์ฃผ', 'cho@kia.com', '062-555-5678', - '๊ด‘์ฃผ๊ด‘์—ญ์‹œ ๊ด‘์‚ฐ๊ตฌ ์†Œ์ดŒ๋กœ 60', '๊ด‘์ฃผ', '์ „๋‚จ', '62034', '๋Œ€ํ•œ๋ฏผ๊ตญ', 'Premium', 18000000, 1, '2024-03-15'), - --- ๋Œ€์ „ ์ง€์—ญ ๊ณ ๊ฐ -('CUST010', 'KAIST', '๋ฌธ๋Œ€์ „', 'moon@kaist.ac.kr', '042-444-6789', - '๋Œ€์ „๊ด‘์—ญ์‹œ ์œ ์„ฑ๊ตฌ ๋Œ€ํ•™๋กœ 291', '๋Œ€์ „', '๋Œ€์ „', '34141', '๋Œ€ํ•œ๋ฏผ๊ตญ', 'Regular', 5000000, 1, '2024-03-20'), - --- ํ•ด์™ธ ๊ณ ๊ฐ -('CUST011', 'Sony Corporation', 'Tanaka Hiroshi', 'tanaka@sony.co.jp', '+81-3-1234-5678', - '1-7-1 Konan, Minato-ku', 'Tokyo', 'Tokyo', '108-0075', 'Japan', 'VIP', 60000000, 1, '2024-04-01'), - -('CUST012', 'Apple Inc.', 'John Smith', 'john.smith@apple.com', '+1-408-996-1010', - 'One Apple Park Way', 'Cupertino', 'California', '95014', 'USA', 'VIP', 80000000, 1, '2024-04-05'), - --- ๋น„ํ™œ์„ฑ ๊ณ ๊ฐ -('CUST013', '๊ตฌ)๋Œ€์šฐ์ „์ž', '๊น€๋Œ€์šฐ', 'kim@daewoo.com', '02-9999-0000', - '์„œ์šธํŠน๋ณ„์‹œ ์ค‘๊ตฌ ์ฒญ๊ณ„์ฒœ๋กœ 100', '์„œ์šธ', '์„œ์šธ', '04517', '๋Œ€ํ•œ๋ฏผ๊ตญ', 'Regular', 0, 0, '2023-12-01') - -PRINT '๊ณ ๊ฐ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ ์™„๋ฃŒ (13๊ฐœ)' -GO - --- ======================================== --- 2. Orders ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ --- ======================================== - -PRINT '์ฃผ๋ฌธ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ ์ค‘...' - -INSERT INTO dbo.Orders ( - OrderNumber, CustomerID, OrderDate, RequiredDate, ShippedDate, - OrderStatus, ShipVia, Freight, ShipName, ShipAddress, ShipCity, ShipRegion, ShipCountry, - SubTotal, TaxAmount, TotalAmount, PaymentMethod, PaymentStatus, EmployeeID, Notes -) VALUES --- 2024๋…„ 1์›” ์ฃผ๋ฌธ -('ORD-2024-0001', 1, '2024-01-16', '2024-01-26', '2024-01-18', - 'Shipped', 'ํ•œ์ง„ํƒ๋ฐฐ', 5000, '์‚ผ์„ฑ์ „์ž(์ฃผ)', '์„œ์šธํŠน๋ณ„์‹œ ์„œ์ดˆ๊ตฌ ์„œ์ดˆ๋Œ€๋กœ 1321', '์„œ์šธ', '์„œ์šธ', '๋Œ€ํ•œ๋ฏผ๊ตญ', - 950000, 95000, 1050000, '์‹ ์šฉ์นด๋“œ', 'Paid', 101, '๊ธด๊ธ‰๋ฐฐ์†ก ์š”์ฒญ'), - -('ORD-2024-0002', 2, '2024-01-22', '2024-02-01', '2024-01-25', - 'Shipped', 'CJ๋Œ€ํ•œํ†ต์šด', 3000, 'LG์ „์ž(์ฃผ)', '์„œ์šธํŠน๋ณ„์‹œ ์˜๋“ฑํฌ๊ตฌ ์—ฌ์˜๋Œ€๋กœ 128', '์„œ์šธ', '์„œ์šธ', '๋Œ€ํ•œ๋ฏผ๊ตญ', - 1200000, 120000, 1323000, '๊ณ„์ขŒ์ด์ฒด', 'Paid', 102, NULL), - --- 2024๋…„ 2์›” ์ฃผ๋ฌธ -('ORD-2024-0003', 3, '2024-02-05', '2024-02-15', '2024-02-07', - 'Shipped', '๋กœ์  ํƒ๋ฐฐ', 7000, 'ํ˜„๋Œ€์ž๋™์ฐจ(์ฃผ)', '์„œ์šธํŠน๋ณ„์‹œ ์ข…๋กœ๊ตฌ ์œจ๊ณก๋กœ 75', '์„œ์šธ', '์„œ์šธ', '๋Œ€ํ•œ๋ฏผ๊ตญ', - 2500000, 250000, 2757000, '์‹ ์šฉ์นด๋“œ', 'Paid', 103, '๋Œ€๋Ÿ‰์ฃผ๋ฌธ'), - -('ORD-2024-0004', 4, '2024-02-12', '2024-02-22', '2024-02-14', - 'Shipped', 'ํ•œ์ง„ํƒ๋ฐฐ', 2000, '์‹ ์„ธ๊ณ„๋ฐฑํ™”์ ', '์„œ์šธํŠน๋ณ„์‹œ ์ค‘๊ตฌ ์†Œ๊ณต๋กœ 63', '์„œ์šธ', '์„œ์šธ', '๋Œ€ํ•œ๋ฏผ๊ตญ', - 800000, 80000, 882000, '์‹ ์šฉ์นด๋“œ', 'Paid', 101, NULL), - -('ORD-2024-0005', 5, '2024-02-18', '2024-02-28', '2024-02-20', - 'Shipped', '๋ถ€์‚ฐํƒ๋ฐฐ', 4000, '๋ถ€์‚ฐํ•ญ๋งŒ๊ณต์‚ฌ', '๋ถ€์‚ฐ๊ด‘์—ญ์‹œ ์ค‘๊ตฌ ํ•ด๊ด€๋กœ 1', '๋ถ€์‚ฐ', '๋ถ€์‚ฐ', '๋Œ€ํ•œ๋ฏผ๊ตญ', - 1500000, 150000, 1654000, '๊ณ„์ขŒ์ด์ฒด', 'Paid', 104, '๋ถ€์‚ฐ์ง€์—ญ ๋ฐฐ์†ก'), - --- 2024๋…„ 3์›” ์ฃผ๋ฌธ -('ORD-2024-0006', 6, '2024-03-03', '2024-03-13', '2024-03-05', - 'Shipped', 'CJ๋Œ€ํ•œํ†ต์šด', 3500, '๋กฏ๋ฐ๋ฐฑํ™”์  ์„ผํ…€์‹œํ‹ฐ์ ', '๋ถ€์‚ฐ๊ด‘์—ญ์‹œ ํ•ด์šด๋Œ€๊ตฌ ์„ผํ…€๋‚จ๋Œ€๋กœ 35', '๋ถ€์‚ฐ', '๋ถ€์‚ฐ', '๋Œ€ํ•œ๋ฏผ๊ตญ', - 600000, 60000, 663500, '์‹ ์šฉ์นด๋“œ', 'Paid', 105, NULL), - -('ORD-2024-0007', 7, '2024-03-08', '2024-03-18', '2024-03-10', - 'Shipped', '๋Œ€๊ตฌํƒ๋ฐฐ', 2500, '๋Œ€๊ตฌ์€ํ–‰', '๋Œ€๊ตฌ๊ด‘์—ญ์‹œ ์ค‘๊ตฌ ๋‹ฌ๊ตฌ๋ฒŒ๋Œ€๋กœ 2077', '๋Œ€๊ตฌ', '๊ฒฝ๋ถ', '๋Œ€ํ•œ๋ฏผ๊ตญ', - 1100000, 110000, 1212500, '๊ณ„์ขŒ์ด์ฒด', 'Paid', 106, NULL), - -('ORD-2024-0008', 8, '2024-03-12', '2024-03-22', '2024-03-14', - 'Shipped', '์ธ์ฒœํƒ๋ฐฐ', 6000, '์ธ์ฒœ๊ตญ์ œ๊ณตํ•ญ๊ณต์‚ฌ', '์ธ์ฒœ๊ด‘์—ญ์‹œ ์ค‘๊ตฌ ๊ณตํ•ญ๋กœ 272', '์ธ์ฒœ', '์ธ์ฒœ', '๋Œ€ํ•œ๋ฏผ๊ตญ', - 3200000, 320000, 3526000, '์‹ ์šฉ์นด๋“œ', 'Paid', 107, '๊ณตํ•ญ ์ง๋ฐฐ์†ก'), - --- 2024๋…„ 4์›” ์ฃผ๋ฌธ (์ผ๋ถ€ ๋ฏธ์ฒ˜๋ฆฌ) -('ORD-2024-0009', 9, '2024-04-02', '2024-04-12', '2024-04-04', - 'Shipped', '๊ด‘์ฃผํƒ๋ฐฐ', 4500, '๊ธฐ์•„์ž๋™์ฐจ ๊ด‘์ฃผ๊ณต์žฅ', '๊ด‘์ฃผ๊ด‘์—ญ์‹œ ๊ด‘์‚ฐ๊ตฌ ์†Œ์ดŒ๋กœ 60', '๊ด‘์ฃผ', '์ „๋‚จ', '๋Œ€ํ•œ๋ฏผ๊ตญ', - 1800000, 180000, 1984500, '๊ณ„์ขŒ์ด์ฒด', 'Paid', 108, NULL), - -('ORD-2024-0010', 10, '2024-04-08', '2024-04-18', NULL, - 'Processing', NULL, 0, 'KAIST', '๋Œ€์ „๊ด‘์—ญ์‹œ ์œ ์„ฑ๊ตฌ ๋Œ€ํ•™๋กœ 291', '๋Œ€์ „', '๋Œ€์ „', '๋Œ€ํ•œ๋ฏผ๊ตญ', - 500000, 50000, 550000, '๊ณ„์ขŒ์ด์ฒด', 'Pending', 109, '์—ฐ๊ตฌ์šฉ ์žฅ๋น„'), - -('ORD-2024-0011', 11, '2024-04-15', '2024-04-25', NULL, - 'Processing', NULL, 0, 'Sony Corporation', '1-7-1 Konan, Minato-ku', 'Tokyo', 'Tokyo', 'Japan', - 5000000, 0, 5000000, '์‹ ์šฉ์นด๋“œ', 'Pending', 110, 'ํ•ด์™ธ๋ฐฐ์†ก'), - -('ORD-2024-0012', 12, '2024-04-20', '2024-04-30', NULL, - 'Pending', NULL, 0, 'Apple Inc.', 'One Apple Park Way', 'Cupertino', 'California', 'USA', - 8000000, 0, 8000000, '๊ณ„์ขŒ์ด์ฒด', 'Pending', 111, '๋Œ€๋Ÿ‰ ํ•ด์™ธ์ฃผ๋ฌธ'), - --- ์ทจ์†Œ๋œ ์ฃผ๋ฌธ -('ORD-2024-0013', 1, '2024-04-25', '2024-05-05', NULL, - 'Cancelled', NULL, 0, '์‚ผ์„ฑ์ „์ž(์ฃผ)', '์„œ์šธํŠน๋ณ„์‹œ ์„œ์ดˆ๊ตฌ ์„œ์ดˆ๋Œ€๋กœ 1321', '์„œ์šธ', '์„œ์šธ', '๋Œ€ํ•œ๋ฏผ๊ตญ', - 300000, 30000, 330000, NULL, 'Cancelled', 101, '๊ณ ๊ฐ ์š”์ฒญ์œผ๋กœ ์ทจ์†Œ') - -PRINT '์ฃผ๋ฌธ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ ์™„๋ฃŒ (13๊ฐœ)' -GO - --- ======================================== --- 3. OrderDetails ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ --- ======================================== - -PRINT '์ฃผ๋ฌธ์ƒ์„ธ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ ์ค‘...' - -INSERT INTO dbo.OrderDetails ( - OrderID, ProductCode, ProductName, UnitPrice, Quantity, Discount -) VALUES --- ์ฃผ๋ฌธ 1๋ฒˆ ์ƒ์„ธ (์‚ผ์„ฑ์ „์ž) -(1, 'PROD-001', '๊ฐค๋Ÿญ์‹œ S24 Ultra', 1300000, 1, 0), -(1, 'PROD-002', '๊ฐค๋Ÿญ์‹œ ์›Œ์น˜6', 350000, 1, 10), - --- ์ฃผ๋ฌธ 2๋ฒˆ ์ƒ์„ธ (LG์ „์ž) -(2, 'PROD-011', 'LG OLED TV 65์ธ์น˜', 2200000, 1, 0), -(2, 'PROD-012', 'LG ์‚ฌ์šด๋“œ๋ฐ”', 450000, 1, 5), - --- ์ฃผ๋ฌธ 3๋ฒˆ ์ƒ์„ธ (ํ˜„๋Œ€์ž๋™์ฐจ) -(3, 'PROD-021', 'ํ˜„๋Œ€ ์ œ๋„ค์‹œ์Šค G90 ๋ถ€ํ’ˆ์„ธํŠธ', 5000000, 1, 20), - --- ์ฃผ๋ฌธ 4๋ฒˆ ์ƒ์„ธ (์‹ ์„ธ๊ณ„๋ฐฑํ™”์ ) -(4, 'PROD-031', '๋ช…ํ’ˆ ํ•ธ๋“œ๋ฐฑ ์ปฌ๋ ‰์…˜', 1200000, 1, 15), -(4, 'PROD-032', '๋ธŒ๋žœ๋“œ ํ–ฅ์ˆ˜ ์„ธํŠธ', 800000, 1, 20), - --- ์ฃผ๋ฌธ 5๋ฒˆ ์ƒ์„ธ (๋ถ€์‚ฐํ•ญ๋งŒ๊ณต์‚ฌ) -(5, 'PROD-041', 'ํ•ญ๋งŒ ๊ด€๋ฆฌ ์‹œ์Šคํ…œ', 2500000, 1, 10), -(5, 'PROD-042', '๋ณด์•ˆ ์นด๋ฉ”๋ผ ์„ธํŠธ', 800000, 1, 5), - --- ์ฃผ๋ฌธ 6๋ฒˆ ์ƒ์„ธ (๋กฏ๋ฐ๋ฐฑํ™”์ ) -(6, 'PROD-051', '๋งค์žฅ ๋””์Šคํ”Œ๋ ˆ์ด ์‹œ์Šคํ…œ', 1500000, 1, 0), - --- ์ฃผ๋ฌธ 7๋ฒˆ ์ƒ์„ธ (๋Œ€๊ตฌ์€ํ–‰) -(7, 'PROD-061', '์€ํ–‰ ๋ณด์•ˆ ์†”๋ฃจ์…˜', 2000000, 1, 5), -(7, 'PROD-062', 'ATM ๊ด€๋ฆฌ ์‹œ์Šคํ…œ', 800000, 1, 0), - --- ์ฃผ๋ฌธ 8๋ฒˆ ์ƒ์„ธ (์ธ์ฒœ๊ณตํ•ญ) -(8, 'PROD-071', '๊ณตํ•ญ ๋ณด์•ˆ ์‹œ์Šคํ…œ', 4000000, 1, 0), -(8, 'PROD-072', '์Šน๊ฐ ์•ˆ๋‚ด ์‹œ์Šคํ…œ', 2500000, 1, 10), - --- ์ฃผ๋ฌธ 9๋ฒˆ ์ƒ์„ธ (๊ธฐ์•„์ž๋™์ฐจ) -(9, 'PROD-081', '์ž๋™์ฐจ ์ƒ์‚ฐ๋ผ์ธ ๋ถ€ํ’ˆ', 3000000, 1, 10), -(9, 'PROD-082', 'ํ’ˆ์งˆ๊ด€๋ฆฌ ์žฅ๋น„', 1200000, 1, 5), - --- ์ฃผ๋ฌธ 10๋ฒˆ ์ƒ์„ธ (KAIST) -(10, 'PROD-091', '์—ฐ๊ตฌ์šฉ ์ปดํ“จํ„ฐ ์‹œ์Šคํ…œ', 800000, 1, 0), -(10, 'PROD-092', '์‹คํ—˜์‹ค ์ธก์ • ์žฅ๋น„', 400000, 1, 5), - --- ์ฃผ๋ฌธ 11๋ฒˆ ์ƒ์„ธ (Sony) -(11, 'PROD-101', '๊ณ ๊ธ‰ ์นด๋ฉ”๋ผ ์‹œ์Šคํ…œ', 8000000, 1, 15), -(11, 'PROD-102', 'ํ”„๋กœ ์˜ค๋””์˜ค ์žฅ๋น„', 3000000, 1, 10), - --- ์ฃผ๋ฌธ 12๋ฒˆ ์ƒ์„ธ (Apple) -(12, 'PROD-111', '๊ธฐ์—…์šฉ MacBook Pro ์„ธํŠธ', 12000000, 1, 20), -(12, 'PROD-112', '์•„์ดํŒจ๋“œ ํ”„๋กœ ๋Œ€๋Ÿ‰ ๊ตฌ๋งค', 8000000, 1, 15) - --- ์ฃผ๋ฌธ 13๋ฒˆ์€ ์ทจ์†Œ๋˜์–ด ์ƒ์„ธ๋‚ด์—ญ ์—†์Œ - -PRINT '์ฃผ๋ฌธ์ƒ์„ธ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ ์™„๋ฃŒ (18๊ฐœ)' -GO - --- ======================================== --- 4. Orders ํ…Œ์ด๋ธ”์˜ SubTotal, TotalAmount ์—…๋ฐ์ดํŠธ --- ======================================== - -PRINT '์ฃผ๋ฌธ ๊ธˆ์•ก ์žฌ๊ณ„์‚ฐ ์ค‘...' - -UPDATE o -SET - SubTotal = ISNULL(detail_sum.SubTotal, 0), - TotalAmount = ISNULL(detail_sum.SubTotal, 0) + o.TaxAmount + o.Freight -FROM dbo.Orders o -LEFT JOIN ( - SELECT - OrderID, - SUM(LineTotal) as SubTotal - FROM dbo.OrderDetails - GROUP BY OrderID -) detail_sum ON o.OrderID = detail_sum.OrderID - -PRINT '์ฃผ๋ฌธ ๊ธˆ์•ก ์žฌ๊ณ„์‚ฐ ์™„๋ฃŒ' -GO - --- ======================================== --- 5. ๋ฐ์ดํ„ฐ ์ž…๋ ฅ ๊ฒฐ๊ณผ ํ™•์ธ --- ======================================== - -PRINT '' -PRINT '=== ๋ฐ์ดํ„ฐ ์ž…๋ ฅ ์™„๋ฃŒ ===' -PRINT '' - --- ํ…Œ์ด๋ธ”๋ณ„ ๋ฐ์ดํ„ฐ ๊ฐœ์ˆ˜ ํ™•์ธ -SELECT 'Customers' as TableName, COUNT(*) as RecordCount FROM dbo.Customers -UNION ALL -SELECT 'Orders' as TableName, COUNT(*) as RecordCount FROM dbo.Orders -UNION ALL -SELECT 'OrderDetails' as TableName, COUNT(*) as RecordCount FROM dbo.OrderDetails - -PRINT '' -PRINT '=== ์ฃผ๋ฌธ ์ƒํƒœ๋ณ„ ์ง‘๊ณ„ ===' - --- ์ฃผ๋ฌธ ์ƒํƒœ๋ณ„ ์ง‘๊ณ„ -SELECT - OrderStatus, - COUNT(*) as OrderCount, - SUM(TotalAmount) as TotalAmount -FROM dbo.Orders -GROUP BY OrderStatus -ORDER BY OrderCount DESC - -PRINT '' -PRINT '=== ์ง€์—ญ๋ณ„ ๊ณ ๊ฐ ์ˆ˜ ===' - --- ์ง€์—ญ๋ณ„ ๊ณ ๊ฐ ์ˆ˜ -SELECT - Region, - COUNT(*) as CustomerCount -FROM dbo.Customers -WHERE IsActive = 1 -GROUP BY Region -ORDER BY CustomerCount DESC - -PRINT '' -PRINT '์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ์ž…๋ ฅ์ด ๋ชจ๋‘ ์™„๋ฃŒ๋˜์—ˆ์Šต๋‹ˆ๋‹ค!' -GO \ No newline at end of file diff --git a/src/database/DatabaseFactory.js b/src/database/DatabaseFactory.js new file mode 100644 index 0000000..2f3ddb7 --- /dev/null +++ b/src/database/DatabaseFactory.js @@ -0,0 +1,116 @@ +const MSSQLAdapter = require('./MSSQLAdapter'); +const MySQLAdapter = require('./MySQLAdapter'); +const PostgreSQLAdapter = require('./PostgreSQLAdapter'); +const SQLiteAdapter = require('./SQLiteAdapter'); +const OracleAdapter = require('./OracleAdapter'); +const { getMessages } = require('../utils/messages'); + +/** + * DatabaseFactory - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž…์— ๋”ฐ๋ผ ์ ์ ˆํ•œ ์–ด๋Œ‘ํ„ฐ๋ฅผ ์ƒ์„ฑ + */ +class DatabaseFactory { + /** + * ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์–ด๋Œ‘ํ„ฐ ์ƒ์„ฑ + * @param {string} dbType - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… (mssql, mysql, mariadb, postgresql, sqlite) + * @param {Object} config - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์„ค์ • + * @param {string} language - ์–ธ์–ด ์„ค์ • (en/kr) + * @returns {Object} ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์–ด๋Œ‘ํ„ฐ ์ธ์Šคํ„ด์Šค + */ + static createAdapter(dbType, config, language = 'en') { + const msg = getMessages('database', language); + const normalizedType = (dbType || 'mssql').toLowerCase(); + + switch (normalizedType) { + case 'mssql': + case 'sqlserver': + return new MSSQLAdapter(config, language); + + case 'mysql': + case 'mariadb': + return new MySQLAdapter(config, language); + + case 'postgresql': + case 'postgres': + case 'pg': + return new PostgreSQLAdapter(config, language); + + case 'sqlite': + case 'sqlite3': + return new SQLiteAdapter(config, language); + + case 'oracle': + case 'oracledb': + case 'oci': + return new OracleAdapter(config, language); + + default: + throw new Error(`${msg.unsupportedDbType} ${dbType}`); + } + } + + /** + * ์ง€์›ํ•˜๋Š” ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… ๋ชฉ๋ก + * @returns {Array} ์ง€์› DB ํƒ€์ž… ์ •๋ณด + */ + static getSupportedTypes() { + return [ + { type: 'mssql', name: 'Microsoft SQL Server', defaultPort: 1433 }, + { type: 'mysql', name: 'MySQL', defaultPort: 3306 }, + { type: 'mariadb', name: 'MariaDB', defaultPort: 3306 }, + { type: 'postgresql', name: 'PostgreSQL', defaultPort: 5432 }, + { type: 'sqlite', name: 'SQLite', defaultPort: null }, + { type: 'oracle', name: 'Oracle Database', defaultPort: 1521 } + ]; + } + + /** + * ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž…๋ณ„ ๊ธฐ๋ณธ ํฌํŠธ ๋ฒˆํ˜ธ + * @param {string} dbType - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… + * @returns {number|null} ๊ธฐ๋ณธ ํฌํŠธ ๋ฒˆํ˜ธ + */ + static getDefaultPort(dbType) { + const typeInfo = this.getSupportedTypes().find(t => t.type === dbType.toLowerCase()); + return typeInfo ? typeInfo.defaultPort : null; + } + + /** + * ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์„ค์ • ์œ ํšจ์„ฑ ๊ฒ€์ฆ + * @param {string} dbType - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… + * @param {Object} config - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์„ค์ • + * @param {string} language - ์–ธ์–ด ์„ค์ • + * @returns {boolean} ์œ ํšจ์„ฑ ๊ฒ€์ฆ ๊ฒฐ๊ณผ + */ + static validateConfig(dbType, config, language = 'en') { + const msg = getMessages('database', language); + const normalizedType = (dbType || 'mssql').toLowerCase(); + + // SQLite๋Š” ํŒŒ์ผ ๊ธฐ๋ฐ˜์ด๋ฏ€๋กœ database ๋˜๋Š” server ํ•„๋“œ๋งŒ ํ•„์š” + if (normalizedType === 'sqlite' || normalizedType === 'sqlite3') { + if (!config.database && !config.server) { + throw new Error(`${msg.requiredConfigMissing} database or server (file path)`); + } + return true; + } + + // ๋‹ค๋ฅธ DB๋“ค์€ server, database, user, password ํ•„์š” + const requiredFields = ['server', 'database', 'user', 'password']; + const missingFields = requiredFields.filter(field => !config[field]); + + if (missingFields.length > 0) { + throw new Error(`${msg.requiredConfigMissing} ${missingFields.join(', ')}`); + } + + // Port number validation (optional, use default if not provided) + if (config.port) { + const port = parseInt(config.port, 10); + if (isNaN(port) || port < 1 || port > 65535) { + throw new Error(msg.portInvalid); + } + } + + return true; + } +} + +module.exports = DatabaseFactory; + diff --git a/src/database/MSSQLAdapter.js b/src/database/MSSQLAdapter.js new file mode 100644 index 0000000..10becdd --- /dev/null +++ b/src/database/MSSQLAdapter.js @@ -0,0 +1,192 @@ +const mssql = require('mssql'); +const { getMessages } = require('../utils/messages'); +const { formatDate, createInClause } = require('../utils/date-utils'); + +/** + * MSSQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์–ด๋Œ‘ํ„ฐ + */ +class MSSQLAdapter { + constructor(config, language = 'en') { + this.config = config; + this.msg = getMessages('database', language); + this.dbPools = {}; + this.dbType = 'mssql'; + } + + /** + * MSSQL ์—ฐ๊ฒฐ ํ’€ ์ƒ์„ฑ + * @param {Object} config - MSSQL ์—ฐ๊ฒฐ ์„ค์ • + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + * @returns {Promise} ์—ฐ๊ฒฐ ํ’€ + */ + async createConnectionPool(config, dbKey) { + if (!this.dbPools[dbKey]) { + if (!config) { + throw new Error(`${this.msg.dbIdNotFound} ${dbKey}`); + } + + console.log(`[DB] ${dbKey} ${this.msg.dbConnecting}`); + const pool = new mssql.ConnectionPool(config); + await pool.connect(); + this.dbPools[dbKey] = pool; + console.log(`[DB] ${dbKey} ${this.msg.dbConnected}`); + } + return this.dbPools[dbKey]; + } + + /** + * MSSQL ์ฟผ๋ฆฌ ์‹คํ–‰ + * @param {mssql.ConnectionPool} pool - ์—ฐ๊ฒฐ ํ’€ + * @param {string} sql - SQL ์ฟผ๋ฆฌ + * @returns {Promise} ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ + */ + async executeQuery(pool, sql) { + return await pool.request().query(sql); + } + + /** + * MSSQL TOP ์ ˆ ์ถ”๊ฐ€ (MSSQL ํŠนํ™”) + * @param {string} sql - ์›๋ณธ SQL ์ฟผ๋ฆฌ + * @param {number} maxRows - ์ตœ๋Œ€ ํ–‰ ์ˆ˜ + * @returns {string} TOP ์ ˆ์ด ์ถ”๊ฐ€๋œ SQL + */ + addTopClause(sql, maxRows) { + if (!maxRows || maxRows <= 0) return sql; + + // SQL์— TOP ์ ˆ์ด ์—†๋Š” ๊ฒฝ์šฐ์—๋งŒ ์ถ”๊ฐ€ + if (!sql.trim().toUpperCase().includes('TOP ')) { + // SELECT ๋‹ค์Œ์— TOP N์„ ์‚ฝ์ž… + return sql.replace(/^\s*SELECT\s+/i, `SELECT TOP ${maxRows} `); + } + return sql; + } + + /** + * MSSQL GETDATE() ํ•จ์ˆ˜ ๋Œ€์ฒด (MSSQL ํŠนํ™”) + * @param {string} sql - SQL ์ฟผ๋ฆฌ + * @returns {string} GETDATE() ํ•จ์ˆ˜๊ฐ€ ์น˜ํ™˜๋œ SQL + */ + replaceGetDateFunction(sql) { + // MSSQL์˜ GETDATE() ํ•จ์ˆ˜๋ฅผ JavaScript Date๋กœ ์น˜ํ™˜ + const currentDate = new Date().toISOString().slice(0, 19).replace('T', ' '); + return sql.replace(/\bGETDATE\(\)\b/gi, `'${currentDate}'`); + } + + /** + * ๋‚ ์งœ ํฌ๋งทํŒ… ํ•จ์ˆ˜ (์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํ•จ์ˆ˜ ์‚ฌ์šฉ) + * @param {Date} date - Date ๊ฐ์ฒด + * @param {string} format - ํฌ๋งท ๋ฌธ์ž์—ด (YYYY, MM, DD, HH, mm, ss ๋“ฑ) + * @returns {string} ํฌ๋งทํŒ…๋œ ๋‚ ์งœ ๋ฌธ์ž์—ด + */ + formatDate(date, format) { + return formatDate(date, format); + } + + /** + * MSSQL IN ์ ˆ ์ƒ์„ฑ (์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํ•จ์ˆ˜ ์‚ฌ์šฉ) + * @param {Array} values - ๊ฐ’ ๋ฐฐ์—ด + * @returns {string} IN ์ ˆ ๋ฌธ์ž์—ด + */ + createInClause(values) { + return createInClause(values); + } + + /** + * MSSQL ์—ฐ๊ฒฐ ์„ค์ • ๊ฒ€์ฆ + * @param {Object} config - ์—ฐ๊ฒฐ ์„ค์ • + * @returns {boolean} ์œ ํšจ์„ฑ ์—ฌ๋ถ€ + */ + validateConnectionConfig(config) { + const requiredFields = ['server', 'database', 'user', 'password']; + return requiredFields.every(field => config.hasOwnProperty(field)); + } + + /** + * MSSQL ์—ฐ๊ฒฐ ํ’€ ์ข…๋ฃŒ + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + */ + async closeConnection(dbKey) { + if (this.dbPools[dbKey]) { + console.log(`[DB] ${dbKey} ${this.msg.dbClosing}`); + await this.dbPools[dbKey].close(); + delete this.dbPools[dbKey]; + } + } + + /** + * ๋ชจ๋“  MSSQL ์—ฐ๊ฒฐ ํ’€ ์ข…๋ฃŒ + */ + async closeAllConnections() { + for (const [dbKey, pool] of Object.entries(this.dbPools)) { + console.log(`[DB] ${dbKey} ${this.msg.dbClosing}`); + await pool.close(); + } + this.dbPools = {}; + } + + /** + * MSSQL ํŠนํ™” ์—๋Ÿฌ ์ฒ˜๋ฆฌ + * @param {Error} error - ์—๋Ÿฌ ๊ฐ์ฒด + * @returns {string} ์‚ฌ์šฉ์ž ์นœํ™”์ ์ธ ์—๋Ÿฌ ๋ฉ”์‹œ์ง€ + */ + formatErrorMessage(error) { + if (error.code === 'ELOGIN') { + return this.msg.errorLogin; + } else if (error.code === 'ESOCKET') { + return this.msg.errorSocket; + } else if (error.code === 'ENAME') { + return this.msg.errorName; + } else if (error.code === 'ETIMEOUT') { + return this.msg.errorTimeout; + } else if (error.code === 'EALREADYCONNECTED') { + return this.msg.errorAlreadyConnected; + } else if (error.code === 'ENOTOPEN') { + return this.msg.errorNotOpen; + } else { + return `${this.msg.mssqlError} ${error.message}`; + } + } + + /** + * MSSQL ์—ฐ๊ฒฐ ์ƒํƒœ ํ™•์ธ + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + * @returns {boolean} ์—ฐ๊ฒฐ ์ƒํƒœ + */ + isConnected(dbKey) { + return this.dbPools[dbKey] && this.dbPools[dbKey].connected; + } + + /** + * MSSQL ์—ฐ๊ฒฐ ํ’€ ์ •๋ณด ์กฐํšŒ + * @returns {Object} ์—ฐ๊ฒฐ ํ’€ ์ •๋ณด + */ + getConnectionInfo() { + const info = {}; + for (const [dbKey, pool] of Object.entries(this.dbPools)) { + info[dbKey] = { + connected: pool.connected, + size: pool.size, + available: pool.available, + pending: pool.pending, + borrowed: pool.borrowed + }; + } + return info; + } + + /** + * ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… ๋ฐ˜ํ™˜ + * @returns {string} ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… + */ + getType() { + return this.dbType; + } + + /** ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ์šฉ ์ฟผ๋ฆฌ */ + getTestQuery() { + return 'SELECT 1 as test'; + } +} + +module.exports = MSSQLAdapter; + diff --git a/src/database/MySQLAdapter.js b/src/database/MySQLAdapter.js new file mode 100644 index 0000000..9371d69 --- /dev/null +++ b/src/database/MySQLAdapter.js @@ -0,0 +1,223 @@ +const mysql = require('mysql2/promise'); +const { getMessages } = require('../utils/messages'); +const { formatDate, createInClause } = require('../utils/date-utils'); + +/** + * MySQL/MariaDB ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์–ด๋Œ‘ํ„ฐ + */ +class MySQLAdapter { + constructor(config, language = 'en') { + this.config = config; + this.msg = getMessages('database', language); + this.dbPools = {}; + this.dbType = 'mysql'; + } + + /** + * MySQL ์—ฐ๊ฒฐ ์ƒ์„ฑ (Pool ๋Œ€์‹  ๋‹จ์ผ Connection ์‚ฌ์šฉ) + * @param {Object} config - MySQL ์—ฐ๊ฒฐ ์„ค์ • + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + * @returns {Promise} ์—ฐ๊ฒฐ ๊ฐ์ฒด + */ + async createConnectionPool(config, dbKey) { + if (!this.dbPools[dbKey]) { + if (!config) { + throw new Error(`${this.msg.dbIdNotFound} ${dbKey}`); + } + + console.log(`[DB] ${dbKey} ${this.msg.dbConnecting}`); + + const connectionConfig = { + host: config.server, + port: parseInt(config.port, 10) || 3306, + user: config.user, + password: config.password, + database: config.database, + connectTimeout: config.options?.connectionTimeout || 30000, + ssl: config.options?.ssl || false + }; + + // Pool ๋Œ€์‹  ๋‹จ์ผ Connection ์‚ฌ์šฉ (client-util-app๊ณผ ๋™์ผ) + const connection = await mysql.createConnection(connectionConfig); + + this.dbPools[dbKey] = connection; + console.log(`[DB] ${dbKey} ${this.msg.dbConnected}`); + } + return this.dbPools[dbKey]; + } + + /** + * MySQL ์ฟผ๋ฆฌ ์‹คํ–‰ + * @param {mysql.Connection} connection - ์—ฐ๊ฒฐ ๊ฐ์ฒด + * @param {string} sql - SQL ์ฟผ๋ฆฌ + * @returns {Promise} ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ (MSSQL ํ˜•์‹๊ณผ ํ˜ธํ™˜) + */ + async executeQuery(connection, sql) { + try { + const [rows] = await connection.execute(sql); + + // MSSQL ๊ฒฐ๊ณผ ํ˜•์‹๊ณผ ํ˜ธํ™˜๋˜๋„๋ก ๋ณ€ํ™˜ + return { + recordset: rows, + recordsets: [rows], + rowsAffected: [rows.affectedRows || rows.length], + output: {}, + rowCount: Array.isArray(rows) ? rows.length : 0 + }; + } catch (error) { + // ์—ฐ๊ฒฐ ์—๋Ÿฌ ์‹œ ์žฌ์—ฐ๊ฒฐ ์‹œ๋„ + if (error.code === 'PROTOCOL_CONNECTION_LOST' || error.code === 'ECONNRESET') { + // ์žฌ์—ฐ๊ฒฐ์€ createConnectionPool์„ ํ†ตํ•ด ์ž๋™์œผ๋กœ ์ฒ˜๋ฆฌ๋จ + throw new Error(`${this.msg.errorConnection} - ${error.message}`); + } + throw error; + } + } + + /** + * MySQL LIMIT ์ ˆ ์ถ”๊ฐ€ (MySQL ํŠนํ™”) + * @param {string} sql - ์›๋ณธ SQL ์ฟผ๋ฆฌ + * @param {number} maxRows - ์ตœ๋Œ€ ํ–‰ ์ˆ˜ + * @returns {string} LIMIT ์ ˆ์ด ์ถ”๊ฐ€๋œ SQL + */ + addTopClause(sql, maxRows) { + if (!maxRows || maxRows <= 0) return sql; + + // SQL์— LIMIT ์ ˆ์ด ์—†๋Š” ๊ฒฝ์šฐ์—๋งŒ ์ถ”๊ฐ€ + const upperSql = sql.trim().toUpperCase(); + if (!upperSql.includes('LIMIT ')) { + // SQL ๋์— LIMIT N ์ถ”๊ฐ€ + return `${sql.trim()} LIMIT ${maxRows}`; + } + return sql; + } + + /** + * MySQL NOW() ํ•จ์ˆ˜ ๋Œ€์ฒด (MySQL ํŠนํ™”) + * @param {string} sql - SQL ์ฟผ๋ฆฌ + * @returns {string} NOW() ํ•จ์ˆ˜๊ฐ€ ์น˜ํ™˜๋œ SQL + */ + replaceGetDateFunction(sql) { + // MySQL์€ NOW() ํ•จ์ˆ˜๋ฅผ ์ง€์›ํ•˜๋ฏ€๋กœ, GETDATE()๋ฅผ NOW()๋กœ ๋ณ€๊ฒฝ + return sql.replace(/\bGETDATE\(\)\b/gi, 'NOW()'); + } + + /** + * ๋‚ ์งœ ํฌ๋งทํŒ… ํ•จ์ˆ˜ (์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํ•จ์ˆ˜ ์‚ฌ์šฉ) + * @param {Date} date - Date ๊ฐ์ฒด + * @param {string} format - ํฌ๋งท ๋ฌธ์ž์—ด (YYYY, MM, DD, HH, mm, ss ๋“ฑ) + * @returns {string} ํฌ๋งทํŒ…๋œ ๋‚ ์งœ ๋ฌธ์ž์—ด + */ + formatDate(date, format) { + return formatDate(date, format); + } + + /** + * MySQL IN ์ ˆ ์ƒ์„ฑ (์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํ•จ์ˆ˜ ์‚ฌ์šฉ) + * @param {Array} values - ๊ฐ’ ๋ฐฐ์—ด + * @returns {string} IN ์ ˆ ๋ฌธ์ž์—ด + */ + createInClause(values) { + return createInClause(values); + } + + /** + * MySQL ์—ฐ๊ฒฐ ์„ค์ • ๊ฒ€์ฆ + * @param {Object} config - ์—ฐ๊ฒฐ ์„ค์ • + * @returns {boolean} ์œ ํšจ์„ฑ ์—ฌ๋ถ€ + */ + validateConnectionConfig(config) { + const requiredFields = ['server', 'database', 'user', 'password']; + return requiredFields.every(field => config.hasOwnProperty(field)); + } + + /** + * MySQL ์—ฐ๊ฒฐ ์ข…๋ฃŒ + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + */ + async closeConnection(dbKey) { + if (this.dbPools[dbKey]) { + console.log(`[DB] ${dbKey} ${this.msg.dbClosing}`); + try { + await this.dbPools[dbKey].end(); + } catch (error) { + console.warn(`Warning: MySQL disconnect error: ${error.message}`); + } + delete this.dbPools[dbKey]; + } + } + + /** + * ๋ชจ๋“  MySQL ์—ฐ๊ฒฐ ์ข…๋ฃŒ + */ + async closeAllConnections() { + for (const [dbKey, connection] of Object.entries(this.dbPools)) { + console.log(`[DB] ${dbKey} ${this.msg.dbClosing}`); + try { + await connection.end(); + } catch (error) { + console.warn(`Warning: MySQL disconnect error: ${error.message}`); + } + } + this.dbPools = {}; + } + + /** + * MySQL ํŠนํ™” ์—๋Ÿฌ ์ฒ˜๋ฆฌ + * @param {Error} error - ์—๋Ÿฌ ๊ฐ์ฒด + * @returns {string} ์‚ฌ์šฉ์ž ์นœํ™”์ ์ธ ์—๋Ÿฌ ๋ฉ”์‹œ์ง€ + */ + formatErrorMessage(error) { + if (error.code === 'ER_ACCESS_DENIED_ERROR') { + return this.msg.errorAuth; + } else if (error.code === 'ECONNREFUSED' || error.code === 'ETIMEDOUT') { + return this.msg.errorConnection; + } else if (error.code === 'ER_BAD_DB_ERROR') { + return this.msg.errorDatabase; + } else if (error.code === 'PROTOCOL_CONNECTION_LOST') { + return this.msg.errorConnection; + } else { + return `${this.msg.mysqlError} ${error.message}`; + } + } + + /** + * MySQL ์—ฐ๊ฒฐ ์ƒํƒœ ํ™•์ธ + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + * @returns {boolean} ์—ฐ๊ฒฐ ์ƒํƒœ + */ + isConnected(dbKey) { + return this.dbPools[dbKey] !== undefined; + } + + /** + * MySQL ์—ฐ๊ฒฐ ์ •๋ณด ์กฐํšŒ + * @returns {Object} ์—ฐ๊ฒฐ ์ •๋ณด + */ + getConnectionInfo() { + const info = {}; + for (const [dbKey, connection] of Object.entries(this.dbPools)) { + info[dbKey] = { + connected: true, + threadId: connection.threadId + }; + } + return info; + } + + /** + * ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… ๋ฐ˜ํ™˜ + * @returns {string} ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… + */ + getType() { + return this.dbType; + } + + /** ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ์šฉ ์ฟผ๋ฆฌ */ + getTestQuery() { + return 'SELECT 1 as test'; + } +} + +module.exports = MySQLAdapter; + diff --git a/src/database/OracleAdapter.js b/src/database/OracleAdapter.js new file mode 100644 index 0000000..e1e9182 --- /dev/null +++ b/src/database/OracleAdapter.js @@ -0,0 +1,191 @@ +const oracledb = require('oracledb'); +const { getMessages } = require('../utils/messages'); +const { formatDate, createInClause } = require('../utils/date-utils'); + +/** + * Oracle ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์–ด๋Œ‘ํ„ฐ + */ +class OracleAdapter { + constructor(config, language = 'en') { + this.config = config; + this.msg = getMessages('database', language); + this.dbPools = {}; + this.dbType = 'oracle'; + + // Recommended for performance + oracledb.outFormat = oracledb.OUT_FORMAT_OBJECT; + } + + /** + * Oracle ์—ฐ๊ฒฐ ํ’€ ์ƒ์„ฑ + * @param {Object} config - Oracle ์—ฐ๊ฒฐ ์„ค์ • + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + * @returns {Promise} ์—ฐ๊ฒฐ ํ’€ + */ + async createConnectionPool(config, dbKey) { + if (!this.dbPools[dbKey]) { + if (!config) { + throw new Error(`${this.msg.dbIdNotFound} ${dbKey}`); + } + + console.log(`[DB] ${dbKey} ${this.msg.dbConnecting}`); + + const host = config.server; + const port = parseInt(config.port, 10) || 1521; + const serviceName = config.serviceName || config.sid || config.database; + const connectString = config.connectString || `${host}:${port}/${serviceName}`; + + const poolConfig = { + user: config.user, + password: config.password, + connectString, + poolMin: config.options?.poolMin ?? 0, + poolMax: config.options?.poolMax ?? 4, + poolIncrement: config.options?.poolIncrement ?? 1, + queueTimeout: config.options?.queueTimeout ?? 30000, + stmtCacheSize: config.options?.stmtCacheSize ?? 30 + }; + + try { + const pool = await oracledb.createPool(poolConfig); + // Test a simple query + const conn = await pool.getConnection(); + await conn.execute('SELECT 1 FROM dual'); + await conn.close(); + this.dbPools[dbKey] = pool; + console.log(`[DB] ${dbKey} ${this.msg.dbConnected}`); + } catch (error) { + throw error; + } + } + return this.dbPools[dbKey]; + } + + /** + * Oracle ์ฟผ๋ฆฌ ์‹คํ–‰ + * @param {oracledb.Pool} pool - ์—ฐ๊ฒฐ ํ’€ + * @param {string} sql - SQL ์ฟผ๋ฆฌ + * @returns {Promise} ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ (MSSQL ํ˜•์‹๊ณผ ํ˜ธํ™˜) + */ + async executeQuery(pool, sql) { + let connection; + try { + connection = await pool.getConnection(); + const result = await connection.execute(sql); + + const rows = result.rows || []; + + return { + recordset: rows, + recordsets: [rows], + rowsAffected: [result.rowsAffected ?? (Array.isArray(rows) ? rows.length : 0)], + output: {}, + rowCount: Array.isArray(rows) ? rows.length : 0 + }; + } catch (error) { + throw error; + } finally { + if (connection) { + try { await connection.close(); } catch (_) {} + } + } + } + + /** + * Oracle ํŽ˜์ด์ง•/์ œํ•œ์ ˆ ์ถ”๊ฐ€ (12c+): FETCH FIRST N ROWS ONLY + */ + addTopClause(sql, maxRows) { + if (!maxRows || maxRows <= 0) return sql; + const upper = sql.trim().toUpperCase(); + if (upper.includes('FETCH FIRST') || upper.includes('ROWNUM')) return sql; + return `${sql.trim()} FETCH FIRST ${maxRows} ROWS ONLY`; + } + + /** + * GETDATE() ์น˜ํ™˜ โ†’ SYSTIMESTAMP + */ + replaceGetDateFunction(sql) { + return sql.replace(/\bGETDATE\(\)\b/gi, 'SYSTIMESTAMP'); + } + + /** ๋‚ ์งœ ํฌ๋งทํŒ… ์œ„์ž„ */ + formatDate(date, format) { return formatDate(date, format); } + + /** IN ์ ˆ ์ƒ์„ฑ ์œ„์ž„ */ + createInClause(values) { return createInClause(values); } + + /** + * Oracle ์—ฐ๊ฒฐ ์„ค์ • ๊ฒ€์ฆ + */ + validateConnectionConfig(config) { + const requiredFields = ['server', 'user', 'password']; + const hasHost = requiredFields.every(field => config.hasOwnProperty(field)); + const hasService = !!(config.serviceName || config.sid || config.database || config.connectString); + return hasHost && hasService; + } + + /** ์—ฐ๊ฒฐ ์ข…๋ฃŒ */ + async closeConnection(dbKey) { + if (this.dbPools[dbKey]) { + console.log(`[DB] ${dbKey} ${this.msg.dbClosing}`); + try { + await this.dbPools[dbKey].close(10); + } catch (error) { + console.warn(`Warning: Oracle disconnect error: ${error.message}`); + } + delete this.dbPools[dbKey]; + } + } + + /** ๋ชจ๋“  ์—ฐ๊ฒฐ ์ข…๋ฃŒ */ + async closeAllConnections() { + for (const [dbKey, pool] of Object.entries(this.dbPools)) { + console.log(`[DB] ${dbKey} ${this.msg.dbClosing}`); + try { + await pool.close(10); + } catch (error) { + console.warn(`Warning: Oracle disconnect error: ${error.message}`); + } + } + this.dbPools = {}; + } + + /** ์—๋Ÿฌ ๋ฉ”์‹œ์ง€ ๋งคํ•‘ */ + formatErrorMessage(error) { + const message = error.message || ''; + if (message.includes('ORA-01017')) { + return this.msg.errorAuth; + } else if (message.includes('DPI-1047')) { + return 'Oracle Client not found: Install Oracle Instant Client and set PATH.'; + } else if (message.includes('ORA-12154') || message.includes('ORA-12514') || message.includes('ORA-12541')) { + return this.msg.errorConnection; + } else if (message.includes('ORA-12545') || message.includes('ETIMEDOUT') || message.includes('ECONNREFUSED')) { + return this.msg.errorConnection; + } + return `Oracle Error: ${message}`; + } + + /** ์—ฐ๊ฒฐ ์ƒํƒœ */ + isConnected(dbKey) { + return this.dbPools[dbKey] !== undefined; + } + + /** ์—ฐ๊ฒฐ ํ’€ ์ •๋ณด */ + getConnectionInfo() { + const info = {}; + for (const [dbKey, pool] of Object.entries(this.dbPools)) { + info[dbKey] = { connected: true, poolMin: pool.poolMin, poolMax: pool.poolMax, connectionsOpen: pool.connectionsOpen }; + } + return info; + } + + /** DB ํƒ€์ž… */ + getType() { return this.dbType; } + + /** ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ์šฉ ์ฟผ๋ฆฌ */ + getTestQuery() { + return 'SELECT 1 FROM dual'; + } +} + +module.exports = OracleAdapter; diff --git a/src/database/PostgreSQLAdapter.js b/src/database/PostgreSQLAdapter.js new file mode 100644 index 0000000..d354317 --- /dev/null +++ b/src/database/PostgreSQLAdapter.js @@ -0,0 +1,229 @@ +const { Pool } = require('pg'); +const { getMessages } = require('../utils/messages'); +const { formatDate, createInClause } = require('../utils/date-utils'); + +/** + * PostgreSQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์–ด๋Œ‘ํ„ฐ + */ +class PostgreSQLAdapter { + constructor(config, language = 'en') { + this.config = config; + this.msg = getMessages('database', language); + this.dbPools = {}; // dbPools๋Š” ๋‹จ์ผ Pool ๊ฐ์ฒด๋ฅผ ์ €์žฅ + this.dbType = 'postgresql'; + } + + /** + * PostgreSQL ์—ฐ๊ฒฐ ํ’€ ์ƒ์„ฑ + * @param {Object} config - PostgreSQL ์—ฐ๊ฒฐ ์„ค์ • + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + * @returns {Promise} ์—ฐ๊ฒฐ ํ’€ + */ + async createConnectionPool(config, dbKey) { + if (!this.dbPools[dbKey]) { + if (!config) { + throw new Error(`${this.msg.dbIdNotFound} ${dbKey}`); + } + + console.log(`[DB] ${dbKey} ${this.msg.dbConnecting}`); + + const poolConfig = { + host: config.server, + port: parseInt(config.port, 10) || 5432, + user: config.user, + password: config.password, + database: config.database, + max: config.options?.max || 10, + idleTimeoutMillis: config.options?.idleTimeoutMillis || 30000, + connectionTimeoutMillis: config.options?.connectionTimeout || 30000, + ssl: config.options?.ssl || false + }; + + const pool = new Pool(poolConfig); + + // ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ + try { + await pool.query('SELECT 1'); + this.dbPools[dbKey] = pool; + console.log(`[DB] ${dbKey} ${this.msg.dbConnected}`); + } catch (error) { + await pool.end(); + throw error; + } + } + return this.dbPools[dbKey]; + } + + /** + * PostgreSQL ์ฟผ๋ฆฌ ์‹คํ–‰ + * @param {Pool} pool - ์—ฐ๊ฒฐ ํ’€ + * @param {string} sql - SQL ์ฟผ๋ฆฌ + * @returns {Promise} ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ (MSSQL ํ˜•์‹๊ณผ ํ˜ธํ™˜) + */ + async executeQuery(pool, sql) { + try { + const result = await pool.query(sql); + + // MSSQL ๊ฒฐ๊ณผ ํ˜•์‹๊ณผ ํ˜ธํ™˜๋˜๋„๋ก ๋ณ€ํ™˜ + return { + recordset: result.rows, + recordsets: [result.rows], + rowsAffected: [result.rowCount], + output: {}, + rowCount: result.rowCount + }; + } catch (error) { + throw error; + } + } + + /** + * PostgreSQL LIMIT ์ ˆ ์ถ”๊ฐ€ (PostgreSQL ํŠนํ™”) + * @param {string} sql - ์›๋ณธ SQL ์ฟผ๋ฆฌ + * @param {number} maxRows - ์ตœ๋Œ€ ํ–‰ ์ˆ˜ + * @returns {string} LIMIT ์ ˆ์ด ์ถ”๊ฐ€๋œ SQL + */ + addTopClause(sql, maxRows) { + if (!maxRows || maxRows <= 0) return sql; + + // SQL์— LIMIT ์ ˆ์ด ์—†๋Š” ๊ฒฝ์šฐ์—๋งŒ ์ถ”๊ฐ€ + const upperSql = sql.trim().toUpperCase(); + if (!upperSql.includes('LIMIT ')) { + // SQL ๋์— LIMIT N ์ถ”๊ฐ€ + return `${sql.trim()} LIMIT ${maxRows}`; + } + return sql; + } + + /** + * PostgreSQL NOW() ํ•จ์ˆ˜ ๋Œ€์ฒด (PostgreSQL ํŠนํ™”) + * @param {string} sql - SQL ์ฟผ๋ฆฌ + * @returns {string} NOW() ํ•จ์ˆ˜๊ฐ€ ์น˜ํ™˜๋œ SQL + */ + replaceGetDateFunction(sql) { + // PostgreSQL์€ NOW() ํ•จ์ˆ˜๋ฅผ ์ง€์›ํ•˜๋ฏ€๋กœ, GETDATE()๋ฅผ NOW()๋กœ ๋ณ€๊ฒฝ + return sql.replace(/\bGETDATE\(\)\b/gi, 'NOW()'); + } + + /** + * ๋‚ ์งœ ํฌ๋งทํŒ… ํ•จ์ˆ˜ (์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํ•จ์ˆ˜ ์‚ฌ์šฉ) + * @param {Date} date - Date ๊ฐ์ฒด + * @param {string} format - ํฌ๋งท ๋ฌธ์ž์—ด (YYYY, MM, DD, HH, mm, ss ๋“ฑ) + * @returns {string} ํฌ๋งทํŒ…๋œ ๋‚ ์งœ ๋ฌธ์ž์—ด + */ + formatDate(date, format) { + return formatDate(date, format); + } + + /** + * PostgreSQL IN ์ ˆ ์ƒ์„ฑ (์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํ•จ์ˆ˜ ์‚ฌ์šฉ) + * @param {Array} values - ๊ฐ’ ๋ฐฐ์—ด + * @returns {string} IN ์ ˆ ๋ฌธ์ž์—ด + */ + createInClause(values) { + return createInClause(values); + } + + /** + * PostgreSQL ์—ฐ๊ฒฐ ์„ค์ • ๊ฒ€์ฆ + * @param {Object} config - ์—ฐ๊ฒฐ ์„ค์ • + * @returns {boolean} ์œ ํšจ์„ฑ ์—ฌ๋ถ€ + */ + validateConnectionConfig(config) { + const requiredFields = ['server', 'database', 'user', 'password']; + return requiredFields.every(field => config.hasOwnProperty(field)); + } + + /** + * PostgreSQL ์—ฐ๊ฒฐ ํ’€ ์ข…๋ฃŒ + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + */ + async closeConnection(dbKey) { + if (this.dbPools[dbKey]) { + console.log(`[DB] ${dbKey} ${this.msg.dbClosing}`); + try { + await this.dbPools[dbKey].end(); + } catch (error) { + console.warn(`Warning: PostgreSQL disconnect error: ${error.message}`); + } + delete this.dbPools[dbKey]; + } + } + + /** + * ๋ชจ๋“  PostgreSQL ์—ฐ๊ฒฐ ํ’€ ์ข…๋ฃŒ + */ + async closeAllConnections() { + for (const [dbKey, pool] of Object.entries(this.dbPools)) { + console.log(`[DB] ${dbKey} ${this.msg.dbClosing}`); + try { + await pool.end(); + } catch (error) { + console.warn(`Warning: PostgreSQL disconnect error: ${error.message}`); + } + } + this.dbPools = {}; + } + + /** + * PostgreSQL ํŠนํ™” ์—๋Ÿฌ ์ฒ˜๋ฆฌ + * @param {Error} error - ์—๋Ÿฌ ๊ฐ์ฒด + * @returns {string} ์‚ฌ์šฉ์ž ์นœํ™”์ ์ธ ์—๋Ÿฌ ๋ฉ”์‹œ์ง€ + */ + formatErrorMessage(error) { + // PostgreSQL ์—๋Ÿฌ ์ฝ”๋“œ: https://www.postgresql.org/docs/current/errcodes-appendix.html + if (error.code === '28P01') { + return this.msg.errorAuth; + } else if (error.code === 'ECONNREFUSED' || error.code === 'ETIMEDOUT') { + return this.msg.errorConnection; + } else if (error.code === '3D000') { + return this.msg.errorDatabase; + } else if (error.code === 'ENOTFOUND') { + return this.msg.errorConnection; + } else { + return `PostgreSQL Error: ${error.message}`; + } + } + + /** + * PostgreSQL ์—ฐ๊ฒฐ ์ƒํƒœ ํ™•์ธ + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + * @returns {boolean} ์—ฐ๊ฒฐ ์ƒํƒœ + */ + isConnected(dbKey) { + return this.dbPools[dbKey] !== undefined; + } + + /** + * PostgreSQL ์—ฐ๊ฒฐ ํ’€ ์ •๋ณด ์กฐํšŒ + * @returns {Object} ์—ฐ๊ฒฐ ํ’€ ์ •๋ณด + */ + getConnectionInfo() { + const info = {}; + for (const [dbKey, pool] of Object.entries(this.dbPools)) { + info[dbKey] = { + connected: true, + totalCount: pool.totalCount, + idleCount: pool.idleCount, + waitingCount: pool.waitingCount + }; + } + return info; + } + + /** + * ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… ๋ฐ˜ํ™˜ + * @returns {string} ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… + */ + getType() { + return this.dbType; + } + + /** ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ์šฉ ์ฟผ๋ฆฌ */ + getTestQuery() { + return 'SELECT 1'; + } +} + +module.exports = PostgreSQLAdapter; + diff --git a/src/database/SQLiteAdapter.js b/src/database/SQLiteAdapter.js new file mode 100644 index 0000000..c241f90 --- /dev/null +++ b/src/database/SQLiteAdapter.js @@ -0,0 +1,238 @@ +const Database = require('better-sqlite3'); +const { getMessages } = require('../utils/messages'); +const { formatDate, createInClause } = require('../utils/date-utils'); + +/** + * SQLite ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์–ด๋Œ‘ํ„ฐ (using better-sqlite3) + */ +class SQLiteAdapter { + constructor(config, language = 'en') { + this.config = config; + this.msg = getMessages('database', language); + this.dbConnections = {}; // SQLite๋Š” ํŒŒ์ผ ๊ธฐ๋ฐ˜์ด๋ฏ€๋กœ connection ์ €์žฅ + this.dbType = 'sqlite'; + } + + /** + * SQLite ์—ฐ๊ฒฐ ์ƒ์„ฑ + * @param {Object} config - SQLite ์—ฐ๊ฒฐ ์„ค์ • + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + * @returns {Promise} ์—ฐ๊ฒฐ ๊ฐ์ฒด + */ + async createConnectionPool(config, dbKey) { + if (!this.dbConnections[dbKey]) { + if (!config) { + throw new Error(`${this.msg.dbIdNotFound} ${dbKey}`); + } + + console.log(`[DB] ${dbKey} ${this.msg.dbConnecting}`); + + // SQLite๋Š” ํŒŒ์ผ ๊ฒฝ๋กœ๋ฅผ ์‚ฌ์šฉ (server ํ•„๋“œ์— ํŒŒ์ผ ๊ฒฝ๋กœ ์ €์žฅ) + const dbPath = config.database || config.server || ':memory:'; + const options = { + readonly: config.options?.readonly || false, + fileMustExist: config.options?.fileMustExist || false, + timeout: config.options?.timeout || 5000, + verbose: config.options?.verbose || null + }; + + try { + const db = new Database(dbPath, options); + this.dbConnections[dbKey] = db; + console.log(`[DB] ${dbKey} ${this.msg.dbConnected} (${dbPath})`); + return db; + } catch (error) { + throw error; + } + } + return this.dbConnections[dbKey]; + } + + /** + * SQLite ์ฟผ๋ฆฌ ์‹คํ–‰ + * @param {Object} db - SQLite ์—ฐ๊ฒฐ ๊ฐ์ฒด + * @param {string} sql - SQL ์ฟผ๋ฆฌ + * @returns {Promise} ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ (MSSQL ํ˜•์‹๊ณผ ํ˜ธํ™˜) + */ + async executeQuery(db, sql) { + try { + // SELECT ์ฟผ๋ฆฌ์ธ์ง€ ํ™•์ธ + const isSelect = sql.trim().toUpperCase().startsWith('SELECT'); + + if (isSelect) { + const rows = db.prepare(sql).all(); + + // MSSQL ๊ฒฐ๊ณผ ํ˜•์‹๊ณผ ํ˜ธํ™˜๋˜๋„๋ก ๋ณ€ํ™˜ + return { + recordset: rows, + recordsets: [rows], + rowsAffected: [rows.length], + output: {}, + rowCount: rows.length + }; + } else { + // INSERT, UPDATE, DELETE ๋“ฑ + const result = db.prepare(sql).run(); + + return { + recordset: [], + recordsets: [[]], + rowsAffected: [result.changes || 0], + output: {}, + rowCount: result.changes || 0 + }; + } + } catch (error) { + throw error; + } + } + + /** + * SQLite LIMIT ์ ˆ ์ถ”๊ฐ€ (SQLite ํŠนํ™”) + * @param {string} sql - ์›๋ณธ SQL ์ฟผ๋ฆฌ + * @param {number} maxRows - ์ตœ๋Œ€ ํ–‰ ์ˆ˜ + * @returns {string} LIMIT ์ ˆ์ด ์ถ”๊ฐ€๋œ SQL + */ + addTopClause(sql, maxRows) { + if (!maxRows || maxRows <= 0) return sql; + + // SQL์— LIMIT ์ ˆ์ด ์—†๋Š” ๊ฒฝ์šฐ์—๋งŒ ์ถ”๊ฐ€ + const upperSql = sql.trim().toUpperCase(); + if (!upperSql.includes('LIMIT ')) { + // SQL ๋์— LIMIT N ์ถ”๊ฐ€ + return `${sql.trim()} LIMIT ${maxRows}`; + } + return sql; + } + + /** + * SQLite datetime() ํ•จ์ˆ˜ ๋Œ€์ฒด (SQLite ํŠนํ™”) + * @param {string} sql - SQL ์ฟผ๋ฆฌ + * @returns {string} datetime() ํ•จ์ˆ˜๊ฐ€ ์น˜ํ™˜๋œ SQL + */ + replaceGetDateFunction(sql) { + // SQLite๋Š” datetime('now') ํ•จ์ˆ˜๋ฅผ ์‚ฌ์šฉํ•˜๋ฏ€๋กœ, GETDATE()๋ฅผ datetime('now')๋กœ ๋ณ€๊ฒฝ + return sql.replace(/\bGETDATE\(\)\b/gi, "datetime('now')"); + } + + /** + * ๋‚ ์งœ ํฌ๋งทํŒ… ํ•จ์ˆ˜ (์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํ•จ์ˆ˜ ์‚ฌ์šฉ) + * @param {Date} date - Date ๊ฐ์ฒด + * @param {string} format - ํฌ๋งท ๋ฌธ์ž์—ด (YYYY, MM, DD, HH, mm, ss ๋“ฑ) + * @returns {string} ํฌ๋งทํŒ…๋œ ๋‚ ์งœ ๋ฌธ์ž์—ด + */ + formatDate(date, format) { + return formatDate(date, format); + } + + /** + * SQLite IN ์ ˆ ์ƒ์„ฑ (์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํ•จ์ˆ˜ ์‚ฌ์šฉ) + * @param {Array} values - ๊ฐ’ ๋ฐฐ์—ด + * @returns {string} IN ์ ˆ ๋ฌธ์ž์—ด + */ + createInClause(values) { + return createInClause(values); + } + + /** + * SQLite ์—ฐ๊ฒฐ ์„ค์ • ๊ฒ€์ฆ + * @param {Object} config - ์—ฐ๊ฒฐ ์„ค์ • + * @returns {boolean} ์œ ํšจ์„ฑ ์—ฌ๋ถ€ + */ + validateConnectionConfig(config) { + // SQLite๋Š” ํŒŒ์ผ ๊ธฐ๋ฐ˜์ด๋ฏ€๋กœ database ๋˜๋Š” server ํ•„๋“œ๋งŒ ํ•„์š” + return config.hasOwnProperty('database') || config.hasOwnProperty('server'); + } + + /** + * SQLite ์—ฐ๊ฒฐ ์ข…๋ฃŒ + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + */ + async closeConnection(dbKey) { + if (this.dbConnections[dbKey]) { + console.log(`[DB] ${dbKey} ${this.msg.dbClosing}`); + try { + this.dbConnections[dbKey].close(); + } catch (error) { + console.warn(`Warning: SQLite disconnect error: ${error.message}`); + } + delete this.dbConnections[dbKey]; + } + } + + /** + * ๋ชจ๋“  SQLite ์—ฐ๊ฒฐ ์ข…๋ฃŒ + */ + async closeAllConnections() { + for (const [dbKey, db] of Object.entries(this.dbConnections)) { + console.log(`[DB] ${dbKey} ${this.msg.dbClosing}`); + try { + db.close(); + } catch (error) { + console.warn(`Warning: SQLite disconnect error: ${error.message}`); + } + } + this.dbConnections = {}; + } + + /** + * SQLite ํŠนํ™” ์—๋Ÿฌ ์ฒ˜๋ฆฌ + * @param {Error} error - ์—๋Ÿฌ ๊ฐ์ฒด + * @returns {string} ์‚ฌ์šฉ์ž ์นœํ™”์ ์ธ ์—๋Ÿฌ ๋ฉ”์‹œ์ง€ + */ + formatErrorMessage(error) { + if (error.code === 'SQLITE_CANTOPEN') { + return 'SQLite Error: Cannot open database file. Check file path and permissions.'; + } else if (error.code === 'SQLITE_CORRUPT') { + return 'SQLite Error: Database file is corrupted.'; + } else if (error.code === 'SQLITE_NOTADB') { + return 'SQLite Error: File is not a database file.'; + } else if (error.code === 'SQLITE_READONLY') { + return 'SQLite Error: Database is read-only.'; + } else if (error.errno === 14 || error.message.includes('unable to open')) { + return 'SQLite Error: Cannot open database file. Check file path and permissions.'; + } else { + return `SQLite Error: ${error.message}`; + } + } + + /** + * SQLite ์—ฐ๊ฒฐ ์ƒํƒœ ํ™•์ธ + * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + * @returns {boolean} ์—ฐ๊ฒฐ ์ƒํƒœ + */ + isConnected(dbKey) { + return this.dbConnections[dbKey] !== undefined; + } + + /** + * SQLite ์—ฐ๊ฒฐ ์ •๋ณด ์กฐํšŒ + * @returns {Object} ์—ฐ๊ฒฐ ์ •๋ณด + */ + getConnectionInfo() { + const info = {}; + for (const [dbKey] of Object.entries(this.dbConnections)) { + info[dbKey] = { + connected: true, + type: 'file-based' + }; + } + return info; + } + + /** + * ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… ๋ฐ˜ํ™˜ + * @returns {string} ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํƒ€์ž… + */ + getType() { + return this.dbType; + } + + /** ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ์šฉ ์ฟผ๋ฆฌ */ + getTestQuery() { + return 'SELECT 1'; + } +} + +module.exports = SQLiteAdapter; + diff --git a/src/excel-cli.js b/src/excel-cli.js index bd0faf1..5d597b0 100644 --- a/src/excel-cli.js +++ b/src/excel-cli.js @@ -350,30 +350,22 @@ function loadDatabaseConfig(configPath) { } } -// ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ async function testDatabaseConnection(dbKey, dbConfig) { - let pool = null; + let connection = null; + let adapter = null; try { console.log(msg.dbConnecting.replace('{dbKey}', dbKey)); - pool = new mssql.ConnectionPool({ - user: dbConfig.user, - password: dbConfig.password, - server: dbConfig.server, - database: dbConfig.database, - port: dbConfig.port || 1433, - options: dbConfig.options || { - encrypt: true, - trustServerCertificate: true - }, - connectionTimeout: 10000, - requestTimeout: 5000 - }); - - await pool.connect(); + // DatabaseFactory๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์ ์ ˆํ•œ ์–ด๋Œ‘ํ„ฐ ์ƒ์„ฑ + const DatabaseFactory = require('./database/DatabaseFactory'); + const dbType = dbConfig.type || 'mssql'; + + adapter = DatabaseFactory.createAdapter(dbType, dbConfig, LANGUAGE); + connection = await adapter.createConnectionPool(dbConfig, dbKey); - const request = pool.request(); - await request.query('SELECT 1 as test'); + // ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ ์ฟผ๋ฆฌ ์‹คํ–‰ (๊ฐ Adapter์— ์ •์˜๋œ ํ…Œ์ŠคํŠธ ์ฟผ๋ฆฌ ์‚ฌ์šฉ) + const testSql = (typeof adapter.getTestQuery === 'function') ? adapter.getTestQuery() : 'SELECT 1 as test'; + await adapter.executeQuery(connection, testSql); console.log(msg.dbConnectionSuccess.replace('{dbKey}', dbKey)); return { success: true, message: msg.dbConnectionSuccess.replace('{dbKey}', '') }; @@ -383,9 +375,9 @@ async function testDatabaseConnection(dbKey, dbConfig) { return { success: false, message: error.message }; } finally { - if (pool) { + if (connection && adapter) { try { - await pool.close(); + await adapter.closeConnection(dbKey); } catch (closeError) { // ์—ฐ๊ฒฐ ์ข…๋ฃŒ ์˜ค๋ฅ˜๋Š” ๋ฌด์‹œ } diff --git a/src/index.js b/src/index.js index d798d3d..1acee95 100644 --- a/src/index.js +++ b/src/index.js @@ -5,7 +5,7 @@ const VariableProcessor = require('./variable-processor'); const StyleManager = require('./style-manager'); const QueryParser = require('./query-parser'); const ExcelGenerator = require('./excel-generator'); -const MSSQLHelper = require('./mssql-helper'); +const DatabaseFactory = require('./database/DatabaseFactory'); // ์–ธ์–ด ์„ค์ • (ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์‚ฌ์šฉ, ๊ธฐ๋ณธ๊ฐ’ ์˜์–ด) const LANGUAGE = process.env.LANGUAGE || 'en'; @@ -217,14 +217,22 @@ async function main() { } const configObj = JSON5.parse(FileUtils.readFileSafely(configPath, 'utf8')); - // MSSQL ํ—ฌํผ ์ธ์Šคํ„ด์Šค ์ƒ์„ฑ - const mssqlHelper = new MSSQLHelper(LANGUAGE); + // DB ์–ด๋Œ‘ํ„ฐ ๋งต (๊ฐ DB๋ณ„๋กœ ์ ์ ˆํ•œ ์–ด๋Œ‘ํ„ฐ ์ƒ์„ฑ) + const dbAdapters = {}; - // ์—ฐ๊ฒฐ ์„ค์ • ๊ฒ€์ฆ + // ์—ฐ๊ฒฐ ์„ค์ • ๊ฒ€์ฆ ๋ฐ ์–ด๋Œ‘ํ„ฐ ์ƒ์„ฑ for (const [dbKey, config] of Object.entries(configObj || {})) { - if (!mssqlHelper.validateConnectionConfig(config)) { + // type์ด ์—†์œผ๋ฉด ๊ธฐ๋ณธ๊ฐ’ 'mssql' ์‚ฌ์šฉ (ํ•˜์œ„ ํ˜ธํ™˜์„ฑ) + const dbType = config.type || 'mssql'; + + // ์–ด๋Œ‘ํ„ฐ ์ƒ์„ฑ + const adapter = DatabaseFactory.createAdapter(dbType, config, LANGUAGE); + + if (!adapter.validateConnectionConfig(config)) { throw new Error(`${msg.dbConfigInvalid} ${dbKey} ${msg.requiredFields}`); } + + dbAdapters[dbKey] = adapter; } // ๊ธฐ๋ณธ DB ์—ฐ๊ฒฐ ์„ค์ • @@ -235,7 +243,8 @@ async function main() { // DB ์—ฐ๊ฒฐ ํ’€ ์ƒ์„ฑ ํ•จ์ˆ˜ async function getDbPool(dbKey) { - return await mssqlHelper.createConnectionPool(configObj[dbKey], dbKey); + const adapter = dbAdapters[dbKey]; + return await adapter.createConnectionPool(configObj[dbKey], dbKey); } // ๊ธฐ๋ณธ DB ์—ฐ๊ฒฐ @@ -243,16 +252,15 @@ async function main() { // ๋™์  ๋ณ€์ˆ˜ ์ฒ˜๋ฆฌ (DB ์—ฐ๊ฒฐ ํ›„, ์‹œํŠธ ์ฒ˜๋ฆฌ ์ „) if (dynamicVars && dynamicVars.length > 0) { - await variableProcessor.processDynamicVariables(dynamicVars, mssqlHelper, defaultDbKey, mergedVars, configObj); + await variableProcessor.processDynamicVariables(dynamicVars, dbAdapters, defaultDbKey, mergedVars, configObj); } // ์—‘์…€ ํŒŒ์ผ ๊ฒฝ๋กœ ๊ฒฐ์ • (CLI > excel > ์ฟผ๋ฆฌํŒŒ์ผ > ๊ธฐ๋ณธ๊ฐ’) // DB ์ด๋ฆ„ ๋ณ€์ˆ˜๋ฅผ ํ•ฉ์„ฑํ•˜์—ฌ ํŒŒ์ผ๋ช…์— ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋„๋ก ์ฃผ์ž… const mergedOutVars = { ...mergedVars, DB_NAME: defaultDbKey }; let outFile = argv.out || excelOutput || outputPath || 'output.xlsx'; - // ์‚ฌ์šฉ์ž ์ง€์ • ํ˜•์‹ $(VAR} โ†’ ํ‘œ์ค€ ${VAR} ๋กœ ์ •๊ทœํ™” (์˜ˆ: $(DB_NAME} ์ง€์›) - outFile = outFile.replace(/\$\((\w+)\}/g, '${$1}'); - outFile = variableProcessor.substituteVars(outFile, mergedOutVars); + // ํŒŒ์ผ๋ช…์— ํฌํ•จ๋œ ๋ณ€์ˆ˜ ์น˜ํ™˜ (์˜ˆ: ${DATE.KST:YYYYMMDD}) + outFile = variableProcessor.substituteVars(outFile, mergedVars); outFile = FileUtils.resolvePath(outFile); FileUtils.ensureDirExists(outFile); @@ -299,9 +307,11 @@ async function main() { // maxRows ์ œํ•œ ์ ์šฉ (๊ฐœ๋ณ„ ์‹œํŠธ ์„ค์ • > ์ „์—ญ ์„ค์ • ์šฐ์„ ) const effectiveMaxRows = sheetDef.maxRows || globalMaxRows; if (effectiveMaxRows && effectiveMaxRows > 0) { - // MSSQL ํ—ฌํผ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ TOP ์ ˆ ์ถ”๊ฐ€ + // ์‹œํŠธ๋ณ„ DB ์–ด๋Œ‘ํ„ฐ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ TOP/LIMIT ์ ˆ ์ถ”๊ฐ€ + const sheetDbKey = sheetDef.db || defaultDbKey; + const sheetAdapter = dbAdapters[sheetDbKey]; const originalSql = sql; - sql = mssqlHelper.addTopClause(sql, effectiveMaxRows); + sql = sheetAdapter.addTopClause(sql, effectiveMaxRows); if (originalSql !== sql) { const source = sheetDef.maxRows ? msg.maxRowsLimitSheet : msg.maxRowsLimitGlobal; @@ -313,11 +323,12 @@ async function main() { // ์‹œํŠธ๋ณ„ DB ์—ฐ๊ฒฐ ๊ฒฐ์ • (๊ฐœ๋ณ„ ์‹œํŠธ ์„ค์ • > ๊ธฐ๋ณธ DB ์„ค์ • ์šฐ์„ ) const sheetDbKey = sheetDef.db || defaultDbKey; + const currentAdapter = dbAdapters[sheetDbKey]; const currentPool = await getDbPool(sheetDbKey); console.log(`${msg.infoExecuting} '${sheetName}' ${msg.onDb} '${sheetDbKey}'`); try { - const result = await mssqlHelper.executeQuery(currentPool, sql); + const result = await currentAdapter.executeQuery(currentPool, sql); const recordCount = result.recordset.length; // ์‹œํŠธ๋ณ„ ์Šคํƒ€์ผ ์ ์šฉ (์šฐ์„ ์ˆœ์œ„: ์‹œํŠธ๋ณ„ > XML ์ „์—ญ > CLI > ๊ธฐ๋ณธ) @@ -387,7 +398,7 @@ async function main() { console.log(`\t---> ${recordCount} ${msg.rowsSelected} `); } catch (error) { console.log(msg.errorHeader); - console.log(mssqlHelper.formatErrorMessage(error)); + console.log(currentAdapter.formatErrorMessage(error)); console.log(`${msg.sql} ${sql}`); console.log(msg.errorFooter); } @@ -416,7 +427,9 @@ async function main() { } // ๋ชจ๋“  DB ์—ฐ๊ฒฐ ์ •๋ฆฌ - await mssqlHelper.closeAllConnections(); + for (const adapter of Object.values(dbAdapters)) { + await adapter.closeAllConnections(); + } } // ๋ชจ๋“ˆ๋กœ ์‚ฌ์šฉ๋  ๋•Œ๋ฅผ ์œ„ํ•ด main ํ•จ์ˆ˜๋ฅผ export diff --git a/src/mssql-helper.js b/src/mssql-helper.js deleted file mode 100644 index edc76f9..0000000 --- a/src/mssql-helper.js +++ /dev/null @@ -1,303 +0,0 @@ -const mssql = require('mssql'); - -// ๋‹ค๊ตญ์–ด ๋ฉ”์‹œ์ง€ -const messages = { - en: { - dbIdNotFound: 'DB connection ID not found:', - dbConnecting: 'connecting to database...', - dbConnected: 'database connected', - dbClosing: 'closing database connection', - errorLogin: 'Database login failed: Check username or password.', - errorSocket: 'Database connection failed: Check server address and port.', - errorName: 'Database name error: Check database name.', - errorTimeout: 'Query execution timeout: Optimize query or increase timeout.', - errorAlreadyConnected: 'Database already connected.', - errorNotOpen: 'Database connection is not open.', - mssqlError: 'MSSQL Error:' - }, - kr: { - dbIdNotFound: 'DB ์ ‘์† ID๋ฅผ ์ฐพ์„ ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค:', - dbConnecting: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์—ฐ๊ฒฐ ์ค‘...', - dbConnected: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์™„๋ฃŒ', - dbClosing: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์ข…๋ฃŒ', - errorLogin: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๋กœ๊ทธ์ธ ์‹คํŒจ: ์‚ฌ์šฉ์ž๋ช… ๋˜๋Š” ๋น„๋ฐ€๋ฒˆํ˜ธ๋ฅผ ํ™•์ธํ•˜์„ธ์š”.', - errorSocket: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์‹คํŒจ: ์„œ๋ฒ„ ์ฃผ์†Œ์™€ ํฌํŠธ๋ฅผ ํ™•์ธํ•˜์„ธ์š”.', - errorName: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ด๋ฆ„ ์˜ค๋ฅ˜: ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ด๋ฆ„์„ ํ™•์ธํ•˜์„ธ์š”.', - errorTimeout: '์ฟผ๋ฆฌ ์‹คํ–‰ ์‹œ๊ฐ„ ์ดˆ๊ณผ: ์ฟผ๋ฆฌ๋ฅผ ์ตœ์ ํ™”ํ•˜๊ฑฐ๋‚˜ ํƒ€์ž„์•„์›ƒ์„ ๋Š˜๋ ค์ฃผ์„ธ์š”.', - errorAlreadyConnected: '์ด๋ฏธ ์—ฐ๊ฒฐ๋œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์ž…๋‹ˆ๋‹ค.', - errorNotOpen: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ์ด ์—ด๋ ค์žˆ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.', - mssqlError: 'MSSQL ์˜ค๋ฅ˜:' - } -}; - -/** - * MSSQL ํŠนํ™” ๊ธฐ๋Šฅ๋“ค์„ ๋‹ด๋‹นํ•˜๋Š” ํ—ฌํผ ๋ชจ๋“ˆ - */ -class MSSQLHelper { - constructor(language = 'en') { - this.dbPools = {}; - this.msg = messages[language] || messages.en; - } - - /** - * MSSQL ์—ฐ๊ฒฐ ํ’€ ์ƒ์„ฑ - * @param {Object} config - MSSQL ์—ฐ๊ฒฐ ์„ค์ • - * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค - * @returns {Promise} ์—ฐ๊ฒฐ ํ’€ - */ - async createConnectionPool(config, dbKey) { - if (!this.dbPools[dbKey]) { - if (!config) { - throw new Error(`${this.msg.dbIdNotFound} ${dbKey}`); - } - - console.log(`[DB] ${dbKey} ${this.msg.dbConnecting}`); - const pool = new mssql.ConnectionPool(config); - await pool.connect(); - this.dbPools[dbKey] = pool; - console.log(`[DB] ${dbKey} ${this.msg.dbConnected}`); - } - return this.dbPools[dbKey]; - } - - /** - * MSSQL ์ฟผ๋ฆฌ ์‹คํ–‰ - * @param {mssql.ConnectionPool} pool - ์—ฐ๊ฒฐ ํ’€ - * @param {string} sql - SQL ์ฟผ๋ฆฌ - * @returns {Promise} ์ฟผ๋ฆฌ ๊ฒฐ๊ณผ - */ - async executeQuery(pool, sql) { - return await pool.request().query(sql); - } - - /** - * MSSQL TOP ์ ˆ ์ถ”๊ฐ€ (MSSQL ํŠนํ™”) - * @param {string} sql - ์›๋ณธ SQL ์ฟผ๋ฆฌ - * @param {number} maxRows - ์ตœ๋Œ€ ํ–‰ ์ˆ˜ - * @returns {string} TOP ์ ˆ์ด ์ถ”๊ฐ€๋œ SQL - */ - addTopClause(sql, maxRows) { - if (!maxRows || maxRows <= 0) return sql; - - // SQL์— TOP ์ ˆ์ด ์—†๋Š” ๊ฒฝ์šฐ์—๋งŒ ์ถ”๊ฐ€ - if (!sql.trim().toUpperCase().includes('TOP ')) { - // SELECT ๋‹ค์Œ์— TOP N์„ ์‚ฝ์ž… - return sql.replace(/^\s*SELECT\s+/i, `SELECT TOP ${maxRows} `); - } - return sql; - } - - /** - * MSSQL GETDATE() ํ•จ์ˆ˜ ๋Œ€์ฒด (MSSQL ํŠนํ™”) - * @param {string} sql - SQL ์ฟผ๋ฆฌ - * @returns {string} GETDATE() ํ•จ์ˆ˜๊ฐ€ ์น˜ํ™˜๋œ SQL - */ - replaceGetDateFunction(sql) { - // MSSQL์˜ GETDATE() ํ•จ์ˆ˜๋ฅผ JavaScript Date๋กœ ์น˜ํ™˜ - const currentDate = new Date().toISOString().slice(0, 19).replace('T', ' '); - return sql.replace(/\bGETDATE\(\)\b/gi, `'${currentDate}'`); - } - - /** - * ๋‚ ์งœ ํฌ๋งทํŒ… ํ•จ์ˆ˜ (UTC ๊ธฐ์ค€) - * @param {Date} date - Date ๊ฐ์ฒด - * @param {string} format - ํฌ๋งท ๋ฌธ์ž์—ด (YYYY, MM, DD, HH, mm, ss ๋“ฑ) - * @returns {string} ํฌ๋งทํŒ…๋œ ๋‚ ์งœ ๋ฌธ์ž์—ด - */ - formatDate(date, format) { - // UTC ๊ธฐ์ค€์œผ๋กœ ๋‚ ์งœ/์‹œ๊ฐ„ ์ถ”์ถœ - const map = { - // Year - 'YYYY': String(date.getUTCFullYear()), - 'yyyy': String(date.getUTCFullYear()), - 'YY': String(date.getUTCFullYear()).slice(-2), - 'yy': String(date.getUTCFullYear()).slice(-2), - // Month - 'MM': String(date.getUTCMonth() + 1).padStart(2, '0'), - 'M': String(date.getUTCMonth() + 1), - // Day - 'DD': String(date.getUTCDate()).padStart(2, '0'), - 'dd': String(date.getUTCDate()).padStart(2, '0'), - 'D': String(date.getUTCDate()), - 'd': String(date.getUTCDate()), - // Hour - 'HH': String(date.getUTCHours()).padStart(2, '0'), - 'hh': String(date.getUTCHours()).padStart(2, '0'), - 'H': String(date.getUTCHours()), - 'h': String(date.getUTCHours()), - // Minute - 'mm': String(date.getUTCMinutes()).padStart(2, '0'), - 'm': String(date.getUTCMinutes()), - // Second - 'ss': String(date.getUTCSeconds()).padStart(2, '0'), - 's': String(date.getUTCSeconds()), - // Milliseconds - 'SSS': String(date.getUTCMilliseconds()).padStart(3, '0'), - 'sss': String(date.getUTCMilliseconds()).padStart(3, '0') - }; - - let result = format; - // ๊ธด ํŒจํ„ด๋ถ€ํ„ฐ ๋จผ์ € ์น˜ํ™˜ํ•ด ๋ถ€๋ถ„ ์ค‘๋ณต์„ ๋ฐฉ์ง€ - const tokensInOrder = [ - 'YYYY', 'yyyy', 'SSS', 'sss', - 'HH', 'hh', 'MM', 'DD', 'dd', 'YY', 'yy', - 'H', 'h', 'M', 'D', 'd', 'mm', 'ss', 'm', 's' - ]; - tokensInOrder.forEach(token => { - result = result.replace(new RegExp(token, 'g'), map[token]); - }); - return result; - } - - /** - * ๋‚ ์งœ ํฌ๋งทํŒ… ํ•จ์ˆ˜ (๋กœ์ปฌ ์‹œ๊ฐ„ ๊ธฐ์ค€) - * @param {Date} date - Date ๊ฐ์ฒด - * @param {string} format - ํฌ๋งท ๋ฌธ์ž์—ด (yyyy, MM, dd, HH, mm, ss ๋“ฑ) - * @returns {string} ํฌ๋งทํŒ…๋œ ๋‚ ์งœ ๋ฌธ์ž์—ด - */ - formatDateLocal(date, format) { - const map = { - // Year - 'YYYY': String(date.getFullYear()), - 'yyyy': String(date.getFullYear()), - 'YY': String(date.getFullYear()).slice(-2), - 'yy': String(date.getFullYear()).slice(-2), - // Month - 'MM': String(date.getMonth() + 1).padStart(2, '0'), - 'M': String(date.getMonth() + 1), - // Day - 'DD': String(date.getDate()).padStart(2, '0'), - 'dd': String(date.getDate()).padStart(2, '0'), - 'D': String(date.getDate()), - 'd': String(date.getDate()), - // Hour - 'HH': String(date.getHours()).padStart(2, '0'), - 'hh': String(date.getHours()).padStart(2, '0'), - 'H': String(date.getHours()), - 'h': String(date.getHours()), - // Minute - 'mm': String(date.getMinutes()).padStart(2, '0'), - 'm': String(date.getMinutes()), - // Second - 'ss': String(date.getSeconds()).padStart(2, '0'), - 's': String(date.getSeconds()), - // Milliseconds - 'SSS': String(date.getMilliseconds()).padStart(3, '0'), - 'sss': String(date.getMilliseconds()).padStart(3, '0') - }; - - let result = format; - const tokensInOrder = [ - 'YYYY', 'yyyy', 'SSS', 'sss', - 'HH', 'hh', 'MM', 'DD', 'dd', 'YY', 'yy', - 'H', 'h', 'M', 'D', 'd', 'mm', 'ss', 'm', 's' - ]; - tokensInOrder.forEach(token => { - result = result.replace(new RegExp(token, 'g'), map[token]); - }); - return result; - } - - /** - * MSSQL IN ์ ˆ ์ƒ์„ฑ (MSSQL ํŠนํ™”) - * @param {Array} values - ๊ฐ’ ๋ฐฐ์—ด - * @returns {string} IN ์ ˆ ๋ฌธ์ž์—ด - */ - createInClause(values) { - if (!Array.isArray(values) || values.length === 0) { - return "NULL"; // ๋นˆ ๋ฐฐ์—ด์ผ ๊ฒฝ์šฐ NULL ๋ฐ˜ํ™˜ (์ˆซ์ž/๋ฌธ์ž์—ด ํƒ€์ž… ๋ชจ๋‘ ์•ˆ์ „) - } - - return values.map(v => { - if (typeof v === 'string') { - return `'${v.replace(/'/g, "''")}'`; // SQL ์ธ์ ์…˜ ๋ฐฉ์ง€๋ฅผ ์œ„ํ•œ ๋”ฐ์˜ดํ‘œ ์ด์Šค์ผ€์ดํ•‘ - } - return v; - }).join(', '); - } - - /** - * MSSQL ์—ฐ๊ฒฐ ์„ค์ • ๊ฒ€์ฆ - * @param {Object} config - ์—ฐ๊ฒฐ ์„ค์ • - * @returns {boolean} ์œ ํšจ์„ฑ ์—ฌ๋ถ€ - */ - validateConnectionConfig(config) { - const requiredFields = ['server', 'database', 'user', 'password']; - return requiredFields.every(field => config.hasOwnProperty(field)); - } - - /** - * MSSQL ์—ฐ๊ฒฐ ํ’€ ์ข…๋ฃŒ - * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค - */ - async closeConnection(dbKey) { - if (this.dbPools[dbKey]) { - console.log(`[DB] ${dbKey} ${this.msg.dbClosing}`); - await this.dbPools[dbKey].close(); - delete this.dbPools[dbKey]; - } - } - - /** - * ๋ชจ๋“  MSSQL ์—ฐ๊ฒฐ ํ’€ ์ข…๋ฃŒ - */ - async closeAllConnections() { - for (const [dbKey, pool] of Object.entries(this.dbPools)) { - console.log(`[DB] ${dbKey} ${this.msg.dbClosing}`); - await pool.close(); - } - this.dbPools = {}; - } - - /** - * MSSQL ํŠนํ™” ์—๋Ÿฌ ์ฒ˜๋ฆฌ - * @param {Error} error - ์—๋Ÿฌ ๊ฐ์ฒด - * @returns {string} ์‚ฌ์šฉ์ž ์นœํ™”์ ์ธ ์—๋Ÿฌ ๋ฉ”์‹œ์ง€ - */ - formatErrorMessage(error) { - if (error.code === 'ELOGIN') { - return this.msg.errorLogin; - } else if (error.code === 'ESOCKET') { - return this.msg.errorSocket; - } else if (error.code === 'ENAME') { - return this.msg.errorName; - } else if (error.code === 'ETIMEOUT') { - return this.msg.errorTimeout; - } else if (error.code === 'EALREADYCONNECTED') { - return this.msg.errorAlreadyConnected; - } else if (error.code === 'ENOTOPEN') { - return this.msg.errorNotOpen; - } else { - return `${this.msg.mssqlError} ${error.message}`; - } - } - - /** - * MSSQL ์—ฐ๊ฒฐ ์ƒํƒœ ํ™•์ธ - * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค - * @returns {boolean} ์—ฐ๊ฒฐ ์ƒํƒœ - */ - isConnected(dbKey) { - return this.dbPools[dbKey] && this.dbPools[dbKey].connected; - } - - /** - * MSSQL ์—ฐ๊ฒฐ ํ’€ ์ •๋ณด ์กฐํšŒ - * @returns {Object} ์—ฐ๊ฒฐ ํ’€ ์ •๋ณด - */ - getConnectionInfo() { - const info = {}; - for (const [dbKey, pool] of Object.entries(this.dbPools)) { - info[dbKey] = { - connected: pool.connected, - size: pool.size, - available: pool.available, - pending: pool.pending, - borrowed: pool.borrowed - }; - } - return info; - } -} - -module.exports = MSSQLHelper; diff --git a/src/query-parser.js b/src/query-parser.js index d9bc83c..8cf9374 100644 --- a/src/query-parser.js +++ b/src/query-parser.js @@ -135,8 +135,8 @@ class QueryParser { const allowedAttributes = { excel: ['db', 'output', 'maxRows', 'style', 'aggregateInfoTemplate'], var: ['name'], - dynamicVar: ['name', 'description', 'type', 'database'], - queryDef: ['id', 'description'], + dynamicVar: ['name', 'description', 'type', 'database', 'db'], + queryDef: ['id', 'description', 'db'], // exceptColumns ์†์„ฑ ์‚ฌ์šฉ (๋Œ€์†Œ๋ฌธ์ž ๊ตฌ๋ถ„ ์—†์ด ํ—ˆ์šฉ), ํ•˜์œ„ํ˜ธํ™˜: except_columns๋„ ํŒŒ์‹ฑ์—์„œ ์ง€์› sheet: ['name', 'use', 'queryRef', 'aggregateColumn', 'aggregateInfoTemplate', 'maxRows', 'db', 'style', 'exceptColumns'], param: ['name'] @@ -339,7 +339,7 @@ class QueryParser { const query = dv._.toString().trim(); const type = dv.$.type || 'column_identified'; const description = dv.$.description || ''; - const database = dv.$.database || ''; + const database = dv.$.database || dv.$.db || ''; dynamicVars.push({ name: dv.$.name, @@ -413,7 +413,13 @@ class QueryParser { } } else { // ์ง์ ‘ ์ฟผ๋ฆฌ๊ฐ€ ์žˆ์œผ๋ฉด ์‚ฌ์šฉ - query = (s._ || (s["_"] ? s["_"] : (s["$"] ? s["$"] : '')) || (s["__cdata"] ? s["__cdata"] : '') || (s["cdata"] ? s["cdata"] : '') || (s["#cdata-section"] ? s["#cdata-section"] : '') || (s["__text"] ? s["__text"] : '') || (s["#text"] ? s["#text"] : '') || (s["$text"] ? s["$text"] : '') || (s["$value"] ? s["$value"] : '') || (s["value"] ? s["value"] : '') || '').toString().trim(); + // ํƒœ๊ทธ๊ฐ€ ์žˆ๋Š” ๊ฒฝ์šฐ: s.query[0] + if (s.query && s.query[0]) { + query = (typeof s.query[0] === 'string' ? s.query[0] : (s.query[0]._ || s.query[0]['#text'] || '')).toString().trim(); + } else { + // ์ง์ ‘ ํ…์ŠคํŠธ๋กœ ์ž‘์„ฑ๋œ ๊ฒฝ์šฐ: s._ + query = (s._ || (s["_"] ? s["_"] : (s["$"] ? s["$"] : '')) || (s["__cdata"] ? s["__cdata"] : '') || (s["cdata"] ? s["cdata"] : '') || (s["#cdata-section"] ? s["#cdata-section"] : '') || (s["__text"] ? s["__text"] : '') || (s["#text"] ? s["#text"] : '') || (s["$text"] ? s["$text"] : '') || (s["$value"] ? s["$value"] : '') || (s["value"] ? s["value"] : '') || '').toString().trim(); + } } // exceptColumns ์†์„ฑ(case-insensitive) ํƒ์ƒ‰: exceptColumns / except_columns ๋‘˜ ๋‹ค ์ง€์› diff --git a/src/utils/date-utils.js b/src/utils/date-utils.js new file mode 100644 index 0000000..82b67b0 --- /dev/null +++ b/src/utils/date-utils.js @@ -0,0 +1,147 @@ +/** + * ๋‚ ์งœ ๊ด€๋ จ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํ•จ์ˆ˜ ๋ชจ๋“ˆ + */ + +/** + * ๋‚ ์งœ ํฌ๋งทํŒ… ํ•จ์ˆ˜ (UTC ๊ธฐ์ค€) + * @param {Date} date - Date ๊ฐ์ฒด + * @param {string} format - ํฌ๋งท ๋ฌธ์ž์—ด (YYYY, MM, DD, HH, mm, ss ๋“ฑ) + * @returns {string} ํฌ๋งทํŒ…๋œ ๋‚ ์งœ ๋ฌธ์ž์—ด + * + * @example + * formatDate(new Date(), 'YYYY-MM-DD HH:mm:ss') + * // => '2024-10-22 14:30:45' + * + * formatDate(new Date(), 'YYYY๋…„ MM์›” DD์ผ') + * // => '2024๋…„ 10์›” 22์ผ' + */ +function formatDate(date, format) { + + const map = { + // Year + 'YYYY': String(date.getFullYear()), + 'yyyy': String(date.getFullYear()), + 'YY': String(date.getFullYear()).slice(-2), + 'yy': String(date.getFullYear()).slice(-2), + // Month + 'MM': String(date.getMonth() + 1).padStart(2, '0'), + 'M': String(date.getMonth() + 1), + // Day + 'DD': String(date.getDate()).padStart(2, '0'), + 'dd': String(date.getDate()).padStart(2, '0'), + 'D': String(date.getDate()), + 'd': String(date.getDate()), + // Hour + 'HH': String(date.getHours()).padStart(2, '0'), + 'hh': String(date.getHours()).padStart(2, '0'), + 'H': String(date.getHours()), + 'h': String(date.getHours()), + // Minute + 'mm': String(date.getMinutes()).padStart(2, '0'), + 'm': String(date.getMinutes()), + // Second + 'ss': String(date.getSeconds()).padStart(2, '0'), + 's': String(date.getSeconds()), + // Milliseconds + 'SSS': String(date.getMilliseconds()).padStart(3, '0'), + 'sss': String(date.getMilliseconds()).padStart(3, '0') + }; + + let result = format; + const tokensInOrder = [ + 'YYYY', 'yyyy', 'SSS', 'sss', + 'HH', 'hh', 'MM', 'DD', 'dd', 'YY', 'yy', + 'H', 'h', 'M', 'D', 'd', 'mm', 'ss', 'm', 's' + ]; + tokensInOrder.forEach(token => { + result = result.replace(new RegExp(token, 'g'), map[token]); + }); + + return result; + } + +/** + * IN ์ ˆ ์ƒ์„ฑ ์œ ํ‹ธ๋ฆฌํ‹ฐ + * @param {Array} values - ๊ฐ’ ๋ฐฐ์—ด + * @returns {string} IN ์ ˆ ๋ฌธ์ž์—ด + * + * @example + * createInClause([1, 2, 3]) + * // => '1, 2, 3' + * + * createInClause(['a', 'b', 'c']) + * // => "'a', 'b', 'c'" + * + * createInClause([]) + * // => 'NULL' + */ +function createInClause(values) { + if (!Array.isArray(values) || values.length === 0) { + return "NULL"; // ๋นˆ ๋ฐฐ์—ด์ผ ๊ฒฝ์šฐ NULL ๋ฐ˜ํ™˜ (์ˆซ์ž/๋ฌธ์ž์—ด ํƒ€์ž… ๋ชจ๋‘ ์•ˆ์ „) + } + + return values.map(v => { + if (typeof v === 'string') { + return `'${v.replace(/'/g, "''")}'`; // SQL ์ธ์ ์…˜ ๋ฐฉ์ง€๋ฅผ ์œ„ํ•œ ๋”ฐ์˜ดํ‘œ ์ด์Šค์ผ€์ดํ•‘ + } + return v; + }).join(', '); +} + +/** + * ํƒ€์ž„์กด๋ณ„ UTC ์˜คํ”„์…‹ (๋ถ„ ๋‹จ์œ„) + */ +const timezoneOffsets = { + 'UTC': 0, // ํ˜‘์ • ์„ธ๊ณ„์‹œ + 'GMT': 0, // ๊ทธ๋ฆฌ๋‹ˆ์น˜ ํ‘œ์ค€์‹œ (UTC์™€ ๋™์ผ) + 'KST': 540, // ํ•œ๊ตญ ํ‘œ์ค€์‹œ (UTC+9) + 'JST': 540, // ์ผ๋ณธ ํ‘œ์ค€์‹œ (UTC+9) + 'CST': 480, // ์ค‘๊ตญ ํ‘œ์ค€์‹œ (UTC+8) + 'SGT': 480, // ์‹ฑ๊ฐ€ํฌ๋ฅด ํ‘œ์ค€์‹œ (UTC+8) + 'PHT': 480, // ํ•„๋ฆฌํ•€ ํ‘œ์ค€์‹œ (UTC+8) + 'AEST': 600, // ํ˜ธ์ฃผ ๋™๋ถ€ ํ‘œ์ค€์‹œ (UTC+10) + 'ICT': 420, // ์ธ๋„์ฐจ์ด๋‚˜ ํ‘œ์ค€์‹œ (UTC+7) - ํƒœ๊ตญ, ๋ฒ ํŠธ๋‚จ + 'CET': 60, // ์ค‘์•™ ์œ ๋Ÿฝ ํ‘œ์ค€์‹œ (UTC+1) - ๋…์ผ, ํ”„๋ž‘์Šค, ์ดํƒˆ๋ฆฌ์•„, ํด๋ž€๋“œ + 'EET': 120, // ๋™์œ ๋Ÿฝ ํ‘œ์ค€์‹œ (UTC+2) + 'IST': 330, // ์ธ๋„ ํ‘œ์ค€์‹œ (UTC+5:30) + 'GST': 240, // ๊ฑธํ”„ ํ‘œ์ค€์‹œ (UTC+4) + 'EST': -300, // ๋ฏธ๊ตญ ๋™๋ถ€ ํ‘œ์ค€์‹œ (UTC-5) + 'CST_US': -360, // ๋ฏธ๊ตญ/์บ๋‚˜๋‹ค/๋ฉ•์‹œ์ฝ” ์ค‘๋ถ€ ํ‘œ์ค€์‹œ (UTC-6) + 'MST': -420, // ๋ฏธ๊ตญ ์‚ฐ์•… ํ‘œ์ค€์‹œ (UTC-7) + 'PST': -480, // ๋ฏธ๊ตญ ์„œ๋ถ€ ํ‘œ์ค€์‹œ (UTC-8) + 'AST': -240, // ๋Œ€์„œ์–‘ ํ‘œ์ค€์‹œ (UTC-4) - ์บ๋‚˜๋‹ค ๋™๋ถ€ + 'AKST': -540, // ์•Œ๋ž˜์Šค์นด ํ‘œ์ค€์‹œ (UTC-9) + 'HST': -600, // ํ•˜์™€์ด ํ‘œ์ค€์‹œ (UTC-10) + 'BRT': -180, // ๋ธŒ๋ผ์งˆ ํ‘œ์ค€์‹œ (UTC-3) + 'ART': -180 // ์•„๋ฅดํ—จํ‹ฐ๋‚˜ ํ‘œ์ค€์‹œ (UTC-3) +}; + +/** + * ํƒ€์ž„์กด์— ๋งž๋Š” ๋‚ ์งœ ์ƒ์„ฑ + * @param {string} timezone - ํƒ€์ž„์กด ์ฝ”๋“œ (์˜ˆ: 'KST', 'UTC') + * @returns {Date} ํƒ€์ž„์กด์ด ์ ์šฉ๋œ ๋‚ ์งœ ๊ฐ์ฒด + */ +function getDateByTimezone(timezone) { + const now = new Date(); + const utcTime = now.getTime() + (now.getTimezoneOffset() * 60 * 1000); + const offsetMinutes = timezoneOffsets[timezone] || 0; + return new Date(utcTime + (offsetMinutes * 60 * 1000)); +} + +/** + * ํ˜„์žฌ ํƒ€์ž„์Šคํƒฌํ”„ ๋ฌธ์ž์—ด ์ƒ์„ฑ + * @param {string} format - ํฌ๋งท (๊ธฐ๋ณธ๊ฐ’: 'YYYYMMDDHHmmss') + * @returns {string} ํƒ€์ž„์Šคํƒฌํ”„ ๋ฌธ์ž์—ด + */ +function getNowTimestampStr(format = 'YYYYMMDDHHmmss') { + return formatDate(new Date(), format); +} + +module.exports = { + formatDate, + createInClause, + timezoneOffsets, + getDateByTimezone, + getNowTimestampStr +}; + diff --git a/src/utils/messages.js b/src/utils/messages.js new file mode 100644 index 0000000..c2316ce --- /dev/null +++ b/src/utils/messages.js @@ -0,0 +1,165 @@ +/** + * ๋‹ค๊ตญ์–ด ๋ฉ”์‹œ์ง€ ์ค‘์•™ ๊ด€๋ฆฌ ๋ชจ๋“ˆ + */ + +// ์–ธ์–ด ์„ค์ • (ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์‚ฌ์šฉ, ๊ธฐ๋ณธ๊ฐ’ ์˜์–ด) +const LANGUAGE = process.env.LANGUAGE || 'en'; + +/** + * ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๊ด€๋ จ ๋ฉ”์‹œ์ง€ + */ +const databaseMessages = { + en: { + dbIdNotFound: 'DB connection ID not found:', + dbConnecting: 'connecting to database...', + dbConnected: 'database connected', + dbClosing: 'closing database connection', + errorLogin: 'Database login failed: Check username or password.', + errorAuth: 'Database authentication failed: Check username or password.', + errorSocket: 'Database connection failed: Check server address and port.', + errorConnection: 'Database connection failed: Check server address and port.', + errorName: 'Database name error: Check database name.', + errorDatabase: 'Database error: Check database name.', + errorTimeout: 'Query execution timeout: Optimize query or increase timeout.', + errorAlreadyConnected: 'Database already connected.', + errorNotOpen: 'Database connection is not open.', + mssqlError: 'MSSQL Error:', + mysqlError: 'MySQL Error:', + unsupportedDbType: 'Unsupported database type:', + requiredConfigMissing: 'Required configuration is missing:', + portInvalid: 'Port number must be between 1-65535.' + }, + kr: { + dbIdNotFound: 'DB ์ ‘์† ID๋ฅผ ์ฐพ์„ ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค:', + dbConnecting: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์—ฐ๊ฒฐ ์ค‘...', + dbConnected: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์™„๋ฃŒ', + dbClosing: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์ข…๋ฃŒ', + errorLogin: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๋กœ๊ทธ์ธ ์‹คํŒจ: ์‚ฌ์šฉ์ž๋ช… ๋˜๋Š” ๋น„๋ฐ€๋ฒˆํ˜ธ๋ฅผ ํ™•์ธํ•˜์„ธ์š”.', + errorAuth: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ธ์ฆ ์‹คํŒจ: ์‚ฌ์šฉ์ž๋ช… ๋˜๋Š” ๋น„๋ฐ€๋ฒˆํ˜ธ๋ฅผ ํ™•์ธํ•˜์„ธ์š”.', + errorSocket: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์‹คํŒจ: ์„œ๋ฒ„ ์ฃผ์†Œ์™€ ํฌํŠธ๋ฅผ ํ™•์ธํ•˜์„ธ์š”.', + errorConnection: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์‹คํŒจ: ์„œ๋ฒ„ ์ฃผ์†Œ์™€ ํฌํŠธ๋ฅผ ํ™•์ธํ•˜์„ธ์š”.', + errorName: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ด๋ฆ„ ์˜ค๋ฅ˜: ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ด๋ฆ„์„ ํ™•์ธํ•˜์„ธ์š”.', + errorDatabase: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์˜ค๋ฅ˜: ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ด๋ฆ„์„ ํ™•์ธํ•˜์„ธ์š”.', + errorTimeout: '์ฟผ๋ฆฌ ์‹คํ–‰ ์‹œ๊ฐ„ ์ดˆ๊ณผ: ์ฟผ๋ฆฌ๋ฅผ ์ตœ์ ํ™”ํ•˜๊ฑฐ๋‚˜ ํƒ€์ž„์•„์›ƒ์„ ๋Š˜๋ ค์ฃผ์„ธ์š”.', + errorAlreadyConnected: '์ด๋ฏธ ์—ฐ๊ฒฐ๋œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์ž…๋‹ˆ๋‹ค.', + errorNotOpen: '๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ์ด ์—ด๋ ค์žˆ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.', + mssqlError: 'MSSQL ์˜ค๋ฅ˜:', + mysqlError: 'MySQL ์˜ค๋ฅ˜:', + unsupportedDbType: '์ง€์›ํ•˜์ง€ ์•Š๋Š” ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์œ ํ˜•:', + requiredConfigMissing: 'ํ•„์ˆ˜ ์„ค์ •์ด ๋ˆ„๋ฝ๋˜์—ˆ์Šต๋‹ˆ๋‹ค:', + portInvalid: 'ํฌํŠธ ๋ฒˆํ˜ธ๋Š” 1-65535 ์‚ฌ์ด์—ฌ์•ผ ํ•ฉ๋‹ˆ๋‹ค.' + } +}; + +/** + * ๋ณ€์ˆ˜ ์ฒ˜๋ฆฌ ๊ด€๋ จ ๋ฉ”์‹œ์ง€ + */ +const variableMessages = { + en: { + dynamicVarSet: 'Dynamic variable set:', + dynamicVarProcessStart: '\n๐Ÿ”„ Dynamic variable processing started', + dynamicVarProcessing: '\n๐Ÿ“Š Processing dynamic variable:', + noDesc: 'no description', + database: ' Database:', + dynamicVarSpecified: 'dynamic variable specified', + default: 'default', + keyValuePairs: ' โœ…', + keyValuePairsText: 'key-value pairs', + keyValuePairsNeedMin2Cols: ' โš ๏ธ', + keyValuePairsNeedMin2ColsText: 'key_value_pairs type requires at least 2 columns', + columnsRows: ' โœ…', + columnsText: 'columns,', + rowsText: 'rows', + noResults: ' โš ๏ธ', + noResultsText: 'No query results', + processError: ' โŒ', + processErrorText: 'Error during processing:', + dynamicVarProcessComplete: '\nโœ… Dynamic variable processing completed', + variableSubstStart: 'Variable substitution started:', + dynamicVarSub: 'Dynamic variable', + substituted: 'substituted:', + array: 'array', + toInClause: 'โ†’ IN clause', + objectType: 'object type', + errorDuring: 'Error during', + substitution: 'substitution:', + timestampFunc: 'Timestamp function', + generalVar: 'General variable', + envVar: 'Environment variable', + simpleString: '(simple string)', + skipped: 'skipped: already processed variable', + unresolvedVars: 'Unresolved variables:', + unresolvedDynamicVar: 'Unresolved dynamic variable', + replacedWith: 'โ†’ replaced with', + unresolvedVar: 'Unresolved variable', + emptyString: '(empty string)', + nullValue: '(no match)' + }, + kr: { + dynamicVarSet: '๋™์  ๋ณ€์ˆ˜ ์„ค์ •:', + dynamicVarProcessStart: '\n๐Ÿ”„ ๋™์  ๋ณ€์ˆ˜ ์ฒ˜๋ฆฌ ์‹œ์ž‘', + dynamicVarProcessing: '\n๐Ÿ“Š ๋™์  ๋ณ€์ˆ˜ ์ฒ˜๋ฆฌ ์ค‘:', + noDesc: '์„ค๋ช… ์—†์Œ', + database: ' ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค:', + dynamicVarSpecified: '๋™์  ๋ณ€์ˆ˜ ์ง€์ •', + default: '๊ธฐ๋ณธ', + keyValuePairs: ' โœ…', + keyValuePairsText: 'ํ‚ค-๊ฐ’ ์Œ', + keyValuePairsNeedMin2Cols: ' โš ๏ธ', + keyValuePairsNeedMin2ColsText: 'key_value_pairs ํƒ€์ž…์€ ์ตœ์†Œ 2๊ฐœ์˜ ์ปฌ๋Ÿผ์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค', + columnsRows: ' โœ…', + columnsText: '์ปฌ๋Ÿผ,', + rowsText: 'ํ–‰', + noResults: ' โš ๏ธ', + noResultsText: '์ฟผ๋ฆฌ ๊ฒฐ๊ณผ ์—†์Œ', + processError: ' โŒ', + processErrorText: '์ฒ˜๋ฆฌ ์ค‘ ์˜ค๋ฅ˜:', + dynamicVarProcessComplete: '\nโœ… ๋™์  ๋ณ€์ˆ˜ ์ฒ˜๋ฆฌ ์™„๋ฃŒ', + variableSubstStart: '๋ณ€์ˆ˜ ์น˜ํ™˜ ์‹œ์ž‘:', + dynamicVarSub: '๋™์  ๋ณ€์ˆ˜', + substituted: '์น˜ํ™˜๋จ:', + array: '๋ฐฐ์—ด', + toInClause: 'โ†’ IN ์ ˆ', + objectType: '๊ฐ์ฒด ํƒ€์ž…', + errorDuring: '์˜ค๋ฅ˜ ๋ฐœ์ƒ:', + substitution: '์น˜ํ™˜:', + timestampFunc: 'ํƒ€์ž„์Šคํƒฌํ”„ ํ•จ์ˆ˜', + generalVar: '์ผ๋ฐ˜ ๋ณ€์ˆ˜', + envVar: 'ํ™˜๊ฒฝ ๋ณ€์ˆ˜', + simpleString: '(๋‹จ์ˆœ ๋ฌธ์ž์—ด)', + skipped: '๊ฑด๋„ˆ๋œ€: ์ด๋ฏธ ์ฒ˜๋ฆฌ๋œ ๋ณ€์ˆ˜', + unresolvedVars: '๋ฏธํ•ด๊ฒฐ ๋ณ€์ˆ˜:', + unresolvedDynamicVar: '๋ฏธํ•ด๊ฒฐ ๋™์  ๋ณ€์ˆ˜', + replacedWith: 'โ†’ ๊ต์ฒด๋จ:', + unresolvedVar: '๋ฏธํ•ด๊ฒฐ ๋ณ€์ˆ˜', + emptyString: '(๋นˆ ๋ฌธ์ž์—ด)', + nullValue: '(์ผ์น˜ ์—†์Œ)' + } +}; + +/** + * ๋ฉ”์‹œ์ง€ ๊ฐ€์ ธ์˜ค๊ธฐ ํ•จ์ˆ˜ + * @param {string} category - ๋ฉ”์‹œ์ง€ ์นดํ…Œ๊ณ ๋ฆฌ ('database', 'variable') + * @param {string} language - ์–ธ์–ด ์ฝ”๋“œ ('en', 'kr') + * @returns {Object} ํ•ด๋‹น ์นดํ…Œ๊ณ ๋ฆฌ์˜ ๋ฉ”์‹œ์ง€ ๊ฐ์ฒด + */ +function getMessages(category, language = LANGUAGE) { + const lang = language || 'en'; + + switch (category) { + case 'database': + return databaseMessages[lang] || databaseMessages.en; + case 'variable': + return variableMessages[lang] || variableMessages.en; + default: + return {}; + } +} + +module.exports = { + getMessages, + databaseMessages, + variableMessages, + LANGUAGE +}; + diff --git a/src/variable-processor.js b/src/variable-processor.js index fbd8160..a75c207 100644 --- a/src/variable-processor.js +++ b/src/variable-processor.js @@ -1,9 +1,8 @@ -const MSSQLHelper = require('./mssql-helper'); +const { getMessages, LANGUAGE } = require('./utils/messages'); +const { formatDate, createInClause, timezoneOffsets } = require('./utils/date-utils'); -// ์–ธ์–ด ์„ค์ • (ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์‚ฌ์šฉ, ๊ธฐ๋ณธ๊ฐ’ ์˜์–ด) -const LANGUAGE = process.env.LANGUAGE || 'en'; - -// ๋‹ค๊ตญ์–ด ๋ฉ”์‹œ์ง€ +// ๋‹ค๊ตญ์–ด ๋ฉ”์‹œ์ง€๋Š” utils/messages.js์—์„œ ๊ด€๋ฆฌ +// ํ•˜์œ„ ํ˜ธํ™˜์„ฑ์„ ์œ„ํ•ด ์—ฌ๊ธฐ์— ์žฌ์ •์˜ const messages = { en: { dynamicVarSet: 'Dynamic variable set:', @@ -95,8 +94,21 @@ const msg = messages[LANGUAGE] || messages.en; class VariableProcessor { constructor() { this.dynamicVariables = {}; - this.mssqlHelper = new MSSQLHelper(LANGUAGE); - this.msg = msg; + this.msg = getMessages('variable', LANGUAGE); + } + + /** + * IN ์ ˆ ์ƒ์„ฑ ์œ ํ‹ธ๋ฆฌํ‹ฐ (์žฌ์‚ฌ์šฉ) + */ + createInClause(values) { + return createInClause(values); + } + + /** + * ๋‚ ์งœ ํฌ๋งทํŒ… ํ•จ์ˆ˜ (์žฌ์‚ฌ์šฉ) + */ + formatDate(date, format) { + return formatDate(date, format); } /** @@ -112,12 +124,12 @@ class VariableProcessor { /** * ๋™์  ๋ณ€์ˆ˜ ์ฒ˜๋ฆฌ * @param {Array} dynamicVars - ๋™์  ๋ณ€์ˆ˜ ์ •์˜ ๋ฐฐ์—ด - * @param {MSSQLHelper} mssqlHelper - MSSQL ํ—ฌํผ ์ธ์Šคํ„ด์Šค - * @param {string} dbKey - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค + * @param {Object} dbAdapters - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์–ด๋Œ‘ํ„ฐ ๋งต (dbKey -> adapter) + * @param {string} defaultDbKey - ๊ธฐ๋ณธ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ‚ค * @param {Object} globalVars - ์ „์—ญ ๋ณ€์ˆ˜ * @param {Object} configObj - ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์„ค์ • ๊ฐ์ฒด */ - async processDynamicVariables(dynamicVars, mssqlHelper, dbKey, globalVars, configObj) { + async processDynamicVariables(dynamicVars, dbAdapters, defaultDbKey, globalVars, configObj) { // ๋™์  ๋ณ€์ˆ˜ ์ดˆ๊ธฐํ™” this.dynamicVariables = {}; @@ -128,17 +140,23 @@ class VariableProcessor { if (dynamicVar.name && dynamicVar.query) { try { console.log(`${this.msg.dynamicVarProcessing} ${dynamicVar.name} (${dynamicVar.description || this.msg.noDesc})`); - + // ์ฟผ๋ฆฌ์—์„œ ๋ณ€์ˆ˜ ์น˜ํ™˜ (๊ธฐ์กด ๋ณ€์ˆ˜๋“ค๋กœ) const processedQuery = this.substituteVars(dynamicVar.query, globalVars); // ๋™์  ๋ณ€์ˆ˜์— ์ง€์ •๋œ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์‚ฌ์šฉ (์žˆ์œผ๋ฉด), ์—†์œผ๋ฉด ๊ธฐ๋ณธ๊ฐ’ ์‚ฌ์šฉ - const targetDbKey = dynamicVar.database || dbKey; + const targetDbKey = dynamicVar.database || defaultDbKey; console.log(`${this.msg.database} ${targetDbKey} (${dynamicVar.database ? this.msg.dynamicVarSpecified : this.msg.default})`); + // ๋Œ€์ƒ DB์— ๋งž๋Š” ์–ด๋Œ‘ํ„ฐ ์„ ํƒ + const adapter = dbAdapters[targetDbKey] || dbAdapters[defaultDbKey]; + if (!adapter) { + throw new Error(`DB adapter not found for key: ${targetDbKey}`); + } + // DB์—์„œ ๋ฐ์ดํ„ฐ ์กฐํšŒ - const pool = await mssqlHelper.createConnectionPool(configObj[targetDbKey], targetDbKey); - const result = await mssqlHelper.executeQuery(pool, processedQuery); + const pool = await adapter.createConnectionPool(configObj[targetDbKey], targetDbKey); + const result = await adapter.executeQuery(pool, processedQuery); if (result.recordset && result.recordset.length > 0) { const data = result.recordset; @@ -229,7 +247,7 @@ class VariableProcessor { try { // ๋ฐฐ์—ด ํƒ€์ž…์ธ ๊ฒฝ์šฐ IN์ ˆ ์ฒ˜๋ฆฌ if (Array.isArray(value)) { - const inClause = this.mssqlHelper.createInClause(value); + const inClause = this.createInClause(value); result = result.replace(pattern, inClause); if (debugVariables && beforeReplace !== result) { @@ -246,12 +264,12 @@ class VariableProcessor { if (Array.isArray(keyValue)) { // column_identified: ๋ฐฐ์—ด ๊ฐ’์„ IN์ ˆ๋กœ ๋ณ€ํ™˜ - const inClause = this.mssqlHelper.createInClause(keyValue); + const inClause = this.createInClause(keyValue); result = result.replace(keyPattern, inClause); } else { // key_value_pairs: ํ‚ค ๊ฐ’๋“ค์„ ๋ฐฐ์—ด๋กœ ๋ฐ˜ํ™˜ (IN์ ˆ์šฉ) if (Array.isArray(keyValue)) { - const inClause = this.mssqlHelper.createInClause(keyValue); + const inClause = this.createInClause(keyValue); result = result.replace(keyPattern, inClause); } else { // ๋‹จ์ผ ๊ฐ’์ธ ๊ฒฝ์šฐ @@ -270,11 +288,11 @@ class VariableProcessor { if (allValues.every(v => Array.isArray(v))) { // column_identified: ๋ชจ๋“  ๋ฐฐ์—ด ๊ฐ’์„ ํ†ตํ•ฉํ•˜์—ฌ IN์ ˆ๋กœ const flatValues = allValues.flat(); - const inClause = this.mssqlHelper.createInClause(flatValues); + const inClause = this.createInClause(flatValues); result = result.replace(pattern, inClause); } else { // key_value_pairs: ๋ชจ๋“  ๊ฐ’๋“ค์„ IN์ ˆ๋กœ - const inClause = this.mssqlHelper.createInClause(allValues); + const inClause = this.createInClause(allValues); result = result.replace(pattern, inClause); } @@ -295,32 +313,7 @@ class VariableProcessor { } }); - // ํƒ€์ž„์กด๋ณ„ ์˜คํ”„์…‹ ์„ค์ • (UTC ๊ธฐ์ค€, ๋ถ„ ๋‹จ์œ„) - const timezoneOffsets = { - 'UTC': 0, // ํ˜‘์ • ์„ธ๊ณ„์‹œ - 'GMT': 0, // ๊ทธ๋ฆฌ๋‹ˆ์น˜ ํ‘œ์ค€์‹œ (UTC์™€ ๋™์ผ) - 'KST': 540, // ํ•œ๊ตญ ํ‘œ์ค€์‹œ (UTC+9) - 'JST': 540, // ์ผ๋ณธ ํ‘œ์ค€์‹œ (UTC+9) - 'CST': 480, // ์ค‘๊ตญ ํ‘œ์ค€์‹œ (UTC+8) - 'SGT': 480, // ์‹ฑ๊ฐ€ํฌ๋ฅด ํ‘œ์ค€์‹œ (UTC+8) - 'PHT': 480, // ํ•„๋ฆฌํ•€ ํ‘œ์ค€์‹œ (UTC+8) - 'AEST': 600, // ํ˜ธ์ฃผ ๋™๋ถ€ ํ‘œ์ค€์‹œ (UTC+10) - 'ICT': 420, // ์ธ๋„์ฐจ์ด๋‚˜ ํ‘œ์ค€์‹œ (UTC+7) - ํƒœ๊ตญ, ๋ฒ ํŠธ๋‚จ - 'CET': 60, // ์ค‘์•™ ์œ ๋Ÿฝ ํ‘œ์ค€์‹œ (UTC+1) - ๋…์ผ, ํ”„๋ž‘์Šค, ์ดํƒˆ๋ฆฌ์•„, ํด๋ž€๋“œ - 'EET': 120, // ๋™์œ ๋Ÿฝ ํ‘œ์ค€์‹œ (UTC+2) - 'IST': 330, // ์ธ๋„ ํ‘œ์ค€์‹œ (UTC+5:30) - 'GST': 240, // ๊ฑธํ”„ ํ‘œ์ค€์‹œ (UTC+4) - 'EST': -300, // ๋ฏธ๊ตญ ๋™๋ถ€ ํ‘œ์ค€์‹œ (UTC-5) - 'CST_US': -360, // ๋ฏธ๊ตญ/์บ๋‚˜๋‹ค/๋ฉ•์‹œ์ฝ” ์ค‘๋ถ€ ํ‘œ์ค€์‹œ (UTC-6) - 'MST': -420, // ๋ฏธ๊ตญ ์‚ฐ์•… ํ‘œ์ค€์‹œ (UTC-7) - 'PST': -480, // ๋ฏธ๊ตญ ์„œ๋ถ€ ํ‘œ์ค€์‹œ (UTC-8) - 'AST': -240, // ๋Œ€์„œ์–‘ ํ‘œ์ค€์‹œ (UTC-4) - ์บ๋‚˜๋‹ค ๋™๋ถ€ - 'AKST': -540, // ์•Œ๋ž˜์Šค์นด ํ‘œ์ค€์‹œ (UTC-9) - 'HST': -600, // ํ•˜์™€์ด ํ‘œ์ค€์‹œ (UTC-10) - 'BRT': -180, // ๋ธŒ๋ผ์งˆ ํ‘œ์ค€์‹œ (UTC-3) - 'ART': -180 // ์•„๋ฅดํ—จํ‹ฐ๋‚˜ ํ‘œ์ค€์‹œ (UTC-3) - }; - + // ํƒ€์ž„์กด๋ณ„ ์˜คํ”„์…‹์€ utils/date-utils.js์—์„œ ๊ด€๋ฆฌ // ํƒ€์ž„์กด ์ง€์ • ์—†๋Š” ๋กœ์ปฌ ๋‚ ์งœ ๋ณ€์ˆ˜ ์น˜ํ™˜ (์˜ˆ: ${DATE:YYYY-MM-DD}) const localDatePattern = /\$\{DATE:([^}]+)\}/g; let localDateMatch; @@ -331,7 +324,7 @@ class VariableProcessor { try { // ๋กœ์ปฌ ์‹œ๊ฐ„ ์‚ฌ์šฉ (์‹œ์Šคํ…œ ํƒ€์ž„์กด) const now = new Date(); - const formattedDate = this.mssqlHelper.formatDateLocal(now, format); + const formattedDate = this.formatDate(now, format); result = result.replace(fullMatch, formattedDate); if (debugVariables) { @@ -360,7 +353,7 @@ class VariableProcessor { // ํƒ€์ž„์กด ์˜คํ”„์…‹์„ ์ ์šฉํ•œ ๋‚ ์งœ ๊ณ„์‚ฐ const date = new Date(now.getTime() + (offsetMinutes * 60 * 1000)); - const formattedDate = this.mssqlHelper.formatDate(date, format); + const formattedDate = this.formatDate(date, format); result = result.replace(fullMatch, formattedDate); if (debugVariables) { @@ -379,7 +372,7 @@ class VariableProcessor { // ๋ฐฐ์—ด ํƒ€์ž…์ธ ๊ฒฝ์šฐ IN์ ˆ ์ฒ˜๋ฆฌ if (Array.isArray(value)) { - const inClause = this.mssqlHelper.createInClause(value); + const inClause = this.createInClause(value); if (debugVariables) { console.log(`${this.msg.generalVar} [${v}] ${this.msg.substituted} ${this.msg.array} ${value.length}๊ฐœ ${this.msg.toInClause}`); @@ -415,7 +408,7 @@ class VariableProcessor { // ํ™˜๊ฒฝ ๋ณ€์ˆ˜๊ฐ€ ๋ฐฐ์—ด ํ˜•ํƒœ์ธ์ง€ ํ™•์ธ (JSON ํ˜•ํƒœ๋กœ ์ €์žฅ๋œ ๊ฒฝ์šฐ) const parsed = JSON.parse(envValue); if (Array.isArray(parsed)) { - const inClause = this.mssqlHelper.createInClause(parsed); + const inClause = this.createInClause(parsed); result = result.replace(fullMatch, inClause); if (debugVariables) {