@simplysm/orm-common 14.0.1 → 14.0.5

package/src/query-builder/mssql/mssql-expr-renderer.ts

@@ -116,7 +116,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
     throw new Error(`알 수 없는 값 타입: ${typeof value}`);
   }
 
-  /** DataType → SQL type */
+  /** DataType → SQL 타입 변환 */
   renderDataType(dataType: DataType): string {
     switch (dataType.type) {
       case "int":
@@ -176,7 +176,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
   //#region ========== comparison (null-safe) ==========
 
   protected eq(expr: ExprEq): string {
-    // MSSQL: null-safe equal (OR Pattern)
+    // MSSQL: NULL 안전 동등 비교 (OR 패턴)
     const left = this.render(expr.source);
     const right = this.render(expr.target);
     return `((${left} IS NULL AND ${right} IS NULL) OR ${left} = ${right})`;
@@ -228,7 +228,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
 
   protected in(expr: ExprIn): string {
     if (expr.values.length === 0) {
-      return "1=0"; // empty IN is always false
+      return "1=0"; // 빈 IN은 항상 false
     }
     const values = expr.values.map((v) => this.render(v)).join(", ");
     return `${this.render(expr.source)} IN (${values})`;
@@ -239,7 +239,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
   }
 
   protected exists(expr: ExprExists): string {
-    // Render as SELECT 1
+    // SELECT 1로 렌더링
     const subquery = this.buildSelect({
       ...expr.query,
       select: { _: { type: "value", value: 1 } },
@@ -270,7 +270,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
   //#region ========== String (null handling) ==========
 
   protected concat(expr: ExprConcat): string {
-    // MSSQL 2012+: CONCAT function automatically treats NULL as empty string
+    // MSSQL 2012+: CONCAT 함수는 NULL을 자동으로 빈 문자열로 처리
     const args = expr.args.map((a) => this.render(a)).join(", ");
     return `CONCAT(${args})`;
   }
@@ -288,7 +288,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
   }
 
   protected padStart(expr: ExprPadStart): string {
-    // MSSQL: RIGHT(REPLICATE(fill, len) + source, len)
+    // MSSQL: RIGHT(REPLICATE(채움문자, 길이) + 원본, 길이)
     const source = this.render(expr.source);
     const len = this.render(expr.length);
     const fill = this.render(expr.fillString);
@@ -308,12 +308,12 @@ export class MssqlExprRenderer extends ExprRendererBase {
   }
 
   protected length(expr: ExprLength): string {
-    // MSSQL: LEN() (null handling)
+    // MSSQL: LEN() (null 처리)
     return `LEN(ISNULL(${this.render(expr.arg)}, N''))`;
   }
 
   protected byteLength(expr: ExprByteLength): string {
-    // MSSQL: DATALENGTH() (null handling)
+    // MSSQL: DATALENGTH() (null 처리)
     return `DATALENGTH(ISNULL(${this.render(expr.arg)}, N''))`;
   }
 
@@ -321,7 +321,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
     if (expr.length != null) {
       return `SUBSTRING(${this.render(expr.source)}, ${this.render(expr.start)}, ${this.render(expr.length)})`;
     }
-    // MSSQL: if no length, go to end
+    // MSSQL: 길이 미지정 시 끝까지
     return `SUBSTRING(${this.render(expr.source)}, ${this.render(expr.start)}, LEN(${this.render(expr.source)}))`;
   }
 
@@ -384,9 +384,9 @@ export class MssqlExprRenderer extends ExprRendererBase {
 
   protected isoWeekStartDate(expr: ExprIsoWeekStartDate): string {
     const src = this.render(expr.arg);
-    // ISO week start date (Monday) - always returns Monday regardless of @@DATEFIRST
-    // Principle: DATEDIFF(DAY, 0, date) is the number of days from 1900-01-01 (Monday)
-    // (days + 6) % 7 + 1 = 1(Mon), 2(Tue), ..., 7(Sun)
+    // ISO 주 시작일 (월요일) - @@DATEFIRST와 무관하게 항상 월요일 반환
+    // 원리: DATEDIFF(DAY, 0, date)는 1900-01-01(월요일)부터의 일수
+    // (days + 6) % 7 + 1 = 1(월), 2(화), ..., 7(일)
     const weekDay = `((DATEDIFF(DAY, 0, ${src}) + 6) % 7 + 1)`;
     return `DATEADD(DAY, 1 - ${weekDay}, CAST(${src} AS DATE))`;
   }
@@ -411,7 +411,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
   }
 
   protected formatDate(expr: ExprFormatDate): string {
-    // JS format → MSSQL FORMAT style
+    // JS 포맷 → MSSQL FORMAT 스타일
     const mssqlFormat = this.convertDateFormat(expr.format);
     return `FORMAT(${this.render(expr.source)}, '${mssqlFormat}')`;
   }
@@ -434,7 +434,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
   }
 
   private convertDateFormat(format: string): string {
-    // For MSSQL FORMAT function (uses the same format)
+    // MSSQL FORMAT 함수용 (동일 포맷 사용)
     return format;
   }
 
@@ -504,7 +504,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
   protected greatest(expr: ExprGreatest): string {
     if (expr.args.length === 0) throw new Error("greatest에는 최소 1개의 인수가 필요합니다.");
     if (expr.args.length === 1) return this.render(expr.args[0]);
-    // MSSQL 2012+: VALUES + MAX approach
+    // MSSQL 2012+: VALUES + MAX 방식
     const values = expr.args.map((a) => `(${this.render(a)})`).join(", ");
     return `(SELECT MAX(v) FROM (VALUES ${values}) AS t(v))`;
   }
@@ -512,7 +512,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
   protected least(expr: ExprLeast): string {
     if (expr.args.length === 0) throw new Error("least에는 최소 1개의 인수가 필요합니다.");
     if (expr.args.length === 1) return this.render(expr.args[0]);
-    // MSSQL 2012+: VALUES + MIN approach
+    // MSSQL 2012+: VALUES + MIN 방식
     const values = expr.args.map((a) => `(${this.render(a)})`).join(", ");
     return `(SELECT MIN(v) FROM (VALUES ${values}) AS t(v))`;
   }
@@ -537,7 +537,7 @@ export class MssqlExprRenderer extends ExprRendererBase {
     const fn = this.renderWindowFn(expr.fn);
     let over = this.renderWindowSpec(expr.spec);
 
-    // LAST_VALUE default frame only sees up to CURRENT ROW, so full frame must be specified
+    // LAST_VALUE 기본 프레임은 CURRENT ROW까지만 보므로 전체 프레임을 지정해야 함
     if (expr.fn.type === "lastValue" && over.length > 0) {
       over += " ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING";
     }

package/src/query-builder/mssql/mssql-query-builder.ts

@@ -43,7 +43,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
 
   //#region ========== Utilities ==========
 
-  /** Render table name */
+  /** 테이블명 렌더링 */
   protected tableName(obj: QueryDefObjectName): string {
     const parts: string[] = [];
     if (obj.database != null) {
@@ -58,7 +58,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
     return parts.join(".");
   }
 
-  /** Render OFFSET...FETCH clause */
+  /** OFFSET...FETCH 절 렌더링 */
   protected renderLimit(limit: [number, number] | undefined): string {
     if (limit == null) return "";
     const [offset, count] = limit;
@@ -68,15 +68,15 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
   protected renderJoin(join: SelectQueryDefJoin): string {
     const alias = this.expr.wrap(join.as);
 
-    // Detect if LATERAL JOIN is needed → MSSQL uses OUTER APPLY
+    // LATERAL JOIN이 필요한지 감지 → MSSQL은 OUTER APPLY 사용
     if (this.needsLateral(join)) {
-      // If from is an array (UNION ALL), use renderFrom(join.from),
-      // otherwise (orderBy, top, select, etc.) use renderFrom(join) to generate subquery
+      // from이 배열(UNION ALL)이면 renderFrom(join.from) 사용,
+      // 그 외(orderBy, top, select 등)이면 renderFrom(join)으로 서브쿼리 생성
       const from = Array.isArray(join.from) ? this.renderFrom(join.from) : this.renderFrom(join);
       return ` OUTER APPLY ${from} AS ${alias}`;
     }
 
-    // Normal JOIN
+    // 일반 JOIN
     const from = this.renderFrom(join.from);
     const where =
       join.where != null && join.where.length > 0
@@ -122,7 +122,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
       const from = this.renderFrom(def.from);
       sql += ` FROM ${from} AS ${this.expr.wrap(def.as)}`;
 
-      // LOCK (force row-level lock with ROWLOCK - same behavior as MySQL/PostgreSQL FOR UPDATE)
+      // LOCK (ROWLOCK으로 행 수준 잠금 강제 - MySQL/PostgreSQL의 FOR UPDATE와 동일 동작)
       if (def.lock) {
         sql += " WITH (UPDLOCK, ROWLOCK)";
       }
@@ -165,14 +165,14 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
 
     let sql = "";
 
-    // IDENTITY_INSERT ON (when inserting explicit values into AI column)
+    // IDENTITY_INSERT ON (AI column에 명시적 값을 삽입할 때)
     if (def.overrideIdentity) {
       sql += `SET IDENTITY_INSERT ${table} ON;\n`;
     }
 
     sql += `INSERT INTO ${table} (${colList})`;
 
-    // OUTPUT (MSSQL native support)
+    // OUTPUT (MSSQL 네이티브 지원)
     if (def.output != null) {
       const outputCols = def.output.columns.map((c) => `INSERTED.${this.expr.wrap(c)}`).join(", ");
       sql += ` OUTPUT ${outputCols}`;
@@ -191,7 +191,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
       sql += `;\nSET IDENTITY_INSERT ${table} OFF;`;
     }
 
-    // With overrideIdentity: SET ON → results[0], INSERT → results[1], SET OFF → results[2]
+    // overrideIdentity 사용 시: SET ON → results[0], INSERT → results[1], SET OFF → results[2]
     return { sql, resultSetIndex: def.overrideIdentity ? 1 : undefined };
   }
 
@@ -202,7 +202,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
     const colList = columns.map((c) => this.expr.wrap(c)).join(", ");
     const values = columns.map((c) => this.expr.escapeValue(def.record[c])).join(", ");
 
-    // Render existsSelectQuery as SELECT 1 AS _
+    // existsSelectQuery를 SELECT 1 AS _로 렌더링
     const existsQuerySql = this.select({
       ...def.existsSelectQuery,
       select: { _: { type: "value", value: 1 } },
@@ -210,7 +210,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
 
     let sql = `INSERT INTO ${table} (${colList})`;
 
-    // OUTPUT (MSSQL: OUTPUT must be placed before SELECT)
+    // OUTPUT (MSSQL: OUTPUT은 SELECT 앞에 위치해야 함)
     if (def.output != null) {
       const outputCols = def.output.columns.map((c) => `INSERTED.${this.expr.wrap(c)}`).join(", ");
       sql += ` OUTPUT ${outputCols}`;
@@ -225,7 +225,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
     const table = this.tableName(def.table);
     const selectSql = this.select(def.recordsSelectQuery).sql;
 
-    // Extract columns from INSERT INTO SELECT
+    // INSERT INTO SELECT에서 column 추출
     const selectDef = def.recordsSelectQuery;
     const colList =
       selectDef.select != null
@@ -292,7 +292,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
     }
     sql += ` ${alias}`;
 
-    // OUTPUT (MSSQL: DELETED for DELETE)
+    // OUTPUT (MSSQL: DELETE에는 DELETED 사용)
     if (def.output != null) {
       const outputCols = def.output.columns.map((c) => `DELETED.${this.expr.wrap(c)}`).join(", ");
       sql += ` OUTPUT ${outputCols}`;
@@ -310,17 +310,17 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
   //#region ========== DML - UPSERT ==========
 
   protected upsert(def: UpsertQueryDef): QueryBuildResult {
-    // MSSQL: Use MERGE
+    // MSSQL: MERGE 사용
     const table = this.tableName(def.table);
     const alias = this.expr.wrap(def.existsSelectQuery.as);
     const existsWhere = def.existsSelectQuery.where;
 
-    // UPDATE SET part
+    // UPDATE SET 부분
     const updateSetParts = Object.entries(def.updateRecord).map(
       ([col, e]) => `${this.expr.wrap(col)} = ${this.expr.render(e)}`,
     );
 
-    // INSERT part
+    // INSERT 부분
     const insertColumns = Object.keys(def.insertRecord);
     const insertColList = insertColumns.map((c) => this.expr.wrap(c)).join(", ");
     const insertValues = insertColumns.map((c) => this.expr.render(def.insertRecord[c])).join(", ");
@@ -356,7 +356,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
     const colDefs = def.columns.map((col) => {
       let colSql = `${this.expr.wrap(col.name)} ${this.expr.renderDataType(col.dataType)}`;
 
-      // nullable: true → NULL, else → NOT NULL
+      // nullable: true → NULL, 아니면 → NOT NULL
       if (col.nullable === true) {
         colSql += " NULL";
       } else {
@@ -374,7 +374,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
       return colSql;
     });
 
-    // Primary Key with CONSTRAINT name
+    // CONSTRAINT 이름이 포함된 Primary Key
     if (def.primaryKey != null && def.primaryKey.length > 0) {
       const pkCols = def.primaryKey.map((c) => this.expr.wrap(c)).join(", ");
       const pkName = this.expr.wrap(`PK_${def.table.name}`);
@@ -396,7 +396,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
   }
 
   protected truncate(def: TruncateQueryDef): QueryBuildResult {
-    // MSSQL: TRUNCATE automatically resets IDENTITY
+    // MSSQL: TRUNCATE는 IDENTITY를 자동으로 초기화
     return { sql: `TRUNCATE TABLE ${this.tableName(def.table)}` };
   }
 
@@ -447,13 +447,13 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
       colSql += " NOT NULL";
     }
 
-    // MSSQL: ALTER COLUMN (IDENTITY and DEFAULT require separate handling)
+    // MSSQL: ALTER COLUMN (IDENTITY와 DEFAULT는 별도 처리 필요)
     return { sql: `ALTER TABLE ${table} ALTER COLUMN ${colSql}` };
   }
 
   protected renameColumn(def: RenameColumnQueryDef): QueryBuildResult {
     const table = this.tableName(def.table);
-    // MSSQL: Use sp_rename
+    // MSSQL: sp_rename 사용
     const tableCol = this.expr.escapeString(`${table}.${def.column}`);
     const newName = this.expr.escapeString(def.newName);
     return { sql: `EXEC sp_rename '${tableCol}', '${newName}', 'COLUMN'` };
@@ -487,7 +487,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
 
     let sql = `ALTER TABLE ${table} ADD CONSTRAINT ${this.expr.wrap(fk.name)} FOREIGN KEY (${fkCols}) REFERENCES ${targetTable} (${targetCols})`;
 
-    // MSSQL/PostgreSQL: separate index generation needed for FK
+    // MSSQL/PostgreSQL: FK에 대한 별도 인덱스 생성 필요
     const idxName = `IDX_${def.table.name}_${fk.name.replace(/^FK_/, "")}`;
     sql += `;\nCREATE INDEX ${this.expr.wrap(idxName)} ON ${table} (${fkCols});`;
 
@@ -519,7 +519,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
   protected createView(def: CreateViewQueryDef): QueryBuildResult {
     const view = this.tableName(def.view);
     const selectSql = this.select(def.queryDef).sql;
-    // MSSQL: CREATE OR ALTER VIEW (2016 SP1+)
+    // MSSQL: CREATE OR ALTER VIEW (2016 SP1 이상)
     return { sql: `CREATE OR ALTER VIEW ${view} AS ${selectSql}` };
   }
 
@@ -530,7 +530,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
   protected createProc(def: CreateProcQueryDef): QueryBuildResult {
     const proc = this.tableName(def.procedure);
 
-    // Process params
+    // 파라미터 처리
     const paramList =
       def.params
         ?.map((p) => {
@@ -626,7 +626,7 @@ EXEC sp_executesql @sql;`,
 
     const dbName = this.expr.escapeString(def.database);
     const schema = this.expr.escapeString(schemaName);
-    // MSSQL: check database existence then check schema (using dynamic SQL)
+    // MSSQL: 데이터베이스 존재 여부 확인 후 schema 확인 (동적 SQL 사용)
     return {
       sql: `DECLARE @result NVARCHAR(MAX) = NULL;
 IF EXISTS (SELECT 1 FROM sys.databases WHERE name = '${dbName}')

package/src/query-builder/mysql/mysql-expr-renderer.ts

@@ -122,7 +122,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
     throw new Error(`알 수 없는 값 타입: ${typeof value}`);
   }
 
-  /** DataType → SQL type */
+  /** DataType → SQL 타입 변환 */
   renderDataType(dataType: DataType): string {
     switch (dataType.type) {
       case "int":
@@ -182,7 +182,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
   //#region ========== comparison (null-safe) ==========
 
   protected eq(expr: ExprEq): string {
-    // MySQL: <=> operator (null-safe equal)
+    // MySQL: <=> 연산자 (NULL 안전 동등 비교)
     return `${this.render(expr.source)} <=> ${this.render(expr.target)}`;
   }
 
@@ -231,7 +231,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
 
   protected in(expr: ExprIn): string {
     if (expr.values.length === 0) {
-      return "1=0"; // empty IN is always false
+      return "1=0"; // 빈 IN은 항상 false
     }
     const values = expr.values.map((v) => this.render(v)).join(", ");
     return `${this.render(expr.source)} IN (${values})`;
@@ -242,7 +242,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
   }
 
   protected exists(expr: ExprExists): string {
-    // Render as SELECT 1
+    // SELECT 1로 렌더링
     const subquery = this.buildSelect({
       ...expr.query,
       select: { _: { type: "value", value: 1 } },
@@ -273,7 +273,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
   //#region ========== String (null handling) ==========
 
   protected concat(expr: ExprConcat): string {
-    // null handling: IFNULL(arg, '')
+    // null 처리: IFNULL(arg, '')
     const args = expr.args.map((a) => `IFNULL(${this.render(a)}, '')`);
     return `CONCAT(${args.join(", ")})`;
   }
@@ -307,12 +307,12 @@ export class MysqlExprRenderer extends ExprRendererBase {
   }
 
   protected length(expr: ExprLength): string {
-    // null handling: IFNULL(arg, '')
+    // null 처리: IFNULL(arg, '')
     return `CHAR_LENGTH(IFNULL(${this.render(expr.arg)}, ''))`;
   }
 
   protected byteLength(expr: ExprByteLength): string {
-    // null handling: IFNULL(arg, '')
+    // null 처리: IFNULL(arg, '')
     return `LENGTH(IFNULL(${this.render(expr.arg)}, ''))`;
   }
 
@@ -380,7 +380,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
   }
 
   protected isoWeekStartDate(expr: ExprIsoWeekStartDate): string {
-    // ISO week start date (Monday)
+    // ISO 주 시작일 (월요일)
     return `DATE_SUB(${this.render(expr.arg)}, INTERVAL (WEEKDAY(${this.render(expr.arg)})) DAY)`;
   }
 
@@ -415,7 +415,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
   }
 
   protected formatDate(expr: ExprFormatDate): string {
-    // JS format → MySQL format
+    // JS 포맷 → MySQL 포맷
     const mysqlFormat = this.convertDateFormat(expr.format);
     return `DATE_FORMAT(${this.render(expr.source)}, '${mysqlFormat}')`;
   }
@@ -438,7 +438,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
   }
 
   private convertDateFormat(format: string): string {
-    // Simple transform (yyyy-MM-dd HH:mm:ss format)
+    // 단순 변환 (yyyy-MM-dd HH:mm:ss 포맷)
     return format
       .replace(/yyyy/g, "%Y")
       .replace(/MM/g, "%m")
@@ -455,7 +455,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
   protected coalesce(expr: ExprCoalesce): string {
     if (expr.args.length === 0) return "NULL";
     if (expr.args.length === 1) return this.render(expr.args[0]);
-    // Render as COALESCE (first non-null among multiple values)
+    // COALESCE로 렌더링 (여러 값 중 첫 번째 non-null 반환)
     return `COALESCE(${expr.args.map((a) => this.render(a)).join(", ")})`;
   }
 
@@ -522,8 +522,8 @@ export class MysqlExprRenderer extends ExprRendererBase {
   }
 
   protected rowNum(_expr: ExprRowNum): string {
-    // MySQL: use variables or ROW_NUMBER() window function
-    // Implemented with ROW_NUMBER() here (MySQL 8.0+)
+    // MySQL: 변수 또는 ROW_NUMBER() 윈도우 함수 사용
+    // 여기서는 ROW_NUMBER()로 구현 (MySQL 8.0+)
     return "ROW_NUMBER() OVER ()";
   }
 
@@ -543,7 +543,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
     const fn = this.renderWindowFn(expr.fn);
     let over = this.renderWindowSpec(expr.spec);
 
-    // LAST_VALUE default frame only sees up to CURRENT ROW, so full frame must be specified
+    // LAST_VALUE 기본 프레임은 CURRENT ROW까지만 보므로 전체 프레임을 지정해야 함
     if (expr.fn.type === "lastValue" && over.length > 0) {
       over += " ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING";
     }