@simplysm/orm-common 13.0.100 → 14.0.4

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)";
       }
@@ -157,7 +157,7 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
     const table = this.tableName(def.table);
 
     if (def.records.length === 0) {
-      throw new Error("INSERT requires at least one record.");
+      throw new Error("INSERT에는 최소 1개의 레코드가 필요합니다.");
     }
 
     const columns = Object.keys(def.records[0]);
@@ -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) => {
@@ -574,13 +574,13 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
   //#region ========== Utils ==========
 
   protected clearSchema(def: ClearSchemaQueryDef): QueryBuildResult {
-    // SQL injection prevention: identifier validation
+    // SQL 인젝션 방지: 식별자 유효성 검사
     if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(def.database)) {
-      throw new Error(`Invalid database name: ${def.database}`);
+      throw new Error(`잘못된 데이터베이스 이름: ${def.database}`);
     }
     const schemaName = def.schema ?? "dbo";
     if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(schemaName)) {
-      throw new Error(`Invalid schema name: ${schemaName}`);
+      throw new Error(`잘못된 schema 이름: ${schemaName}`);
     }
 
     const db = this.expr.wrap(def.database);
@@ -590,22 +590,22 @@ export class MssqlQueryBuilder extends QueryBuilderBase {
 DECLARE @sql NVARCHAR(MAX);
 SET @sql = N'';
 
--- Drop FK constraints
+-- FK 제약조건 삭제
 SELECT @sql = @sql + N'ALTER TABLE ' + QUOTENAME(OBJECT_SCHEMA_NAME(parent_object_id)) + '.' + QUOTENAME(OBJECT_NAME(parent_object_id)) + N' DROP CONSTRAINT ' + QUOTENAME(name) + N';' + CHAR(13)
 FROM ${db}.sys.foreign_keys
 WHERE OBJECT_SCHEMA_NAME(parent_object_id) = '${schema}';
 
--- Drop tables
+-- 테이블 삭제
 SELECT @sql = @sql + N'DROP TABLE ' + QUOTENAME(SCHEMA_NAME(schema_id)) + '.' + QUOTENAME(name) + N';' + CHAR(13)
 FROM ${db}.sys.tables
 WHERE SCHEMA_NAME(schema_id) = '${schema}';
 
--- Drop views
+-- 뷰 삭제
 SELECT @sql = @sql + N'DROP VIEW ' + QUOTENAME(SCHEMA_NAME(schema_id)) + '.' + QUOTENAME(name) + N';' + CHAR(13)
 FROM ${db}.sys.views
 WHERE schema_id = SCHEMA_ID('${schema}');
 
--- Drop procedures
+-- 프로시저 삭제
 SELECT @sql = @sql + N'DROP PROCEDURE ' + QUOTENAME(SCHEMA_NAME(schema_id)) + '.' + QUOTENAME(name) + N';' + CHAR(13)
 FROM ${db}.sys.procedures
 WHERE SCHEMA_NAME(schema_id) = '${schema}';
@@ -615,18 +615,18 @@ EXEC sp_executesql @sql;`,
   }
 
   protected schemaExists(def: SchemaExistsQueryDef): QueryBuildResult {
-    // SQL injection prevention: identifier validation
+    // SQL 인젝션 방지: 식별자 유효성 검사
     if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(def.database)) {
-      throw new Error(`Invalid database name: ${def.database}`);
+      throw new Error(`잘못된 데이터베이스 이름: ${def.database}`);
     }
     const schemaName = def.schema ?? "dbo";
     if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(schemaName)) {
-      throw new Error(`Invalid schema name: ${schemaName}`);
+      throw new Error(`잘못된 schema 이름: ${schemaName}`);
     }
 
     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

@@ -69,28 +69,28 @@ import type { DataType } from "../../types/column";
 import { ExprRendererBase } from "../base/expr-renderer-base";
 
 /**
- * MySQL expression renderer
+ * MySQL 표현식 렌더러
  */
 export class MysqlExprRenderer extends ExprRendererBase {
-  //#region ========== Utilities (public - also used by QueryBuilder) ==========
+  //#region ========== 유틸리티 (public - QueryBuilder에서도 사용) ==========
 
-  /** Wrap identifier */
+  /** 식별자 감싸기 */
   wrap(name: string): string {
     return `\`${name.replace(/`/g, "``")}\``;
   }
 
-  /** Escape for SQL string literals (returns without quotes) */
+  /** SQL 문자열 리터럴용 이스케이프 (따옴표 제외) */
   escapeString(value: string): string {
     return value
-      .replace(/\\/g, "\\\\") // backslash (highest priority)
-      .replace(/'/g, "''") // single quote
-      .replace(/\0/g, "\\0") // NULL byte
-      .replace(/\n/g, "\\n") // newline
-      .replace(/\r/g, "\\r") // carriage return
-      .replace(/\t/g, "\\t"); // tab
+      .replace(/\\/g, "\\\\") // 백슬래시 (최우선)
+      .replace(/'/g, "''") // 작은따옴표
+      .replace(/\0/g, "\\0") // NULL 바이트
+      .replace(/\n/g, "\\n") // 줄바꿈
+      .replace(/\r/g, "\\r") // 캐리지 리턴
+      .replace(/\t/g, "\\t"); // 탭
   }
 
-  /** value escape */
+  /** 값 이스케이프 */
   escapeValue(value: unknown): string {
     if (value == null) {
       return "NULL";
@@ -119,10 +119,10 @@ export class MysqlExprRenderer extends ExprRendererBase {
     if (value instanceof Uint8Array) {
       return `0x${bytes.toHex(value)}`;
     }
-    throw new Error(`Unknown value type: ${typeof value}`);
+    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)}`;
   }
 
@@ -221,7 +221,7 @@ export class MysqlExprRenderer extends ExprRendererBase {
   }
 
   protected like(expr: ExprLike): string {
-    // Always add ESCAPE '\'
+    // 항상 ESCAPE '\' 추가
     return `${this.render(expr.source)} LIKE ${this.render(expr.pattern)} ESCAPE '\\\\'`;
   }
 
@@ -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(", ")})`;
   }
 
@@ -512,18 +512,18 @@ export class MysqlExprRenderer extends ExprRendererBase {
   //#region ========== Other ==========
 
   protected greatest(expr: ExprGreatest): string {
-    if (expr.args.length === 0) throw new Error("greatest requires at least one argument.");
+    if (expr.args.length === 0) throw new Error("greatest에는 최소 1개의 인수가 필요합니다.");
     return `GREATEST(${expr.args.map((a) => this.render(a)).join(", ")})`;
   }
 
   protected least(expr: ExprLeast): string {
-    if (expr.args.length === 0) throw new Error("least requires at least one argument.");
+    if (expr.args.length === 0) throw new Error("least에는 최소 1개의 인수가 필요합니다.");
     return `LEAST(${expr.args.map((a) => this.render(a)).join(", ")})`;
   }
 
   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";
     }