feat: Complete Phase 1 of Prisma to Raw Query migration

Phase 1 완료: Raw Query 기반 데이터베이스 아키텍처 구축

 구현 완료 내용:
- DatabaseManager 클래스 구현 (연결 풀, 트랜잭션 관리)
- QueryBuilder 유틸리티 (동적 쿼리 생성)
- 타입 정의 및 검증 로직 (database.ts, databaseValidator.ts)
- 단위 테스트 작성 및 통과

🔧 전환 완료 서비스:
- externalCallConfigService.ts (Raw Query 전환)
- multiConnectionQueryService.ts (Raw Query 전환)

📚 문서:
- PHASE1_USAGE_GUIDE.md (사용 가이드)
- DETAILED_FILE_MIGRATION_PLAN.md (상세 계획)
- PRISMA_TO_RAW_QUERY_MIGRATION_PLAN.md (Phase 1 완료 표시)

🧪 테스트:
- database.test.ts (핵심 기능 테스트)
- 모든 테스트 통과 확인

이제 Phase 2 (핵심 서비스 전환)로 진행 가능

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
kjs
2025-09-30 15:29:20 +09:00
parent f336e3b31f
commit ed78ef184d
12 changed files with 3757 additions and 183 deletions

View File

@@ -147,9 +147,9 @@ export class MultiConnectionQueryService {
// INSERT 쿼리 구성 (DB 타입별 처리)
const columns = Object.keys(data);
let values = Object.values(data);
// Oracle의 경우 테이블 스키마 확인 및 데이터 타입 변환 처리
if (connection.db_type?.toLowerCase() === 'oracle') {
if (connection.db_type?.toLowerCase() === "oracle") {
try {
// Oracle 테이블 스키마 조회
const schemaQuery = `
@@ -158,67 +158,80 @@ export class MultiConnectionQueryService {
WHERE TABLE_NAME = UPPER('${tableName}')
ORDER BY COLUMN_ID
`;
logger.info(`🔍 Oracle 테이블 스키마 조회: ${schemaQuery}`);
const schemaResult = await ExternalDbConnectionService.executeQuery(
connectionId,
schemaQuery
);
if (schemaResult.success && schemaResult.data) {
logger.info(`📋 Oracle 테이블 ${tableName} 스키마:`);
schemaResult.data.forEach((col: any) => {
logger.info(` - ${col.COLUMN_NAME}: ${col.DATA_TYPE}, NULL: ${col.NULLABLE}, DEFAULT: ${col.DATA_DEFAULT || 'None'}`);
logger.info(
` - ${col.COLUMN_NAME}: ${col.DATA_TYPE}, NULL: ${col.NULLABLE}, DEFAULT: ${col.DATA_DEFAULT || "None"}`
);
});
// 필수 컬럼 중 누락된 컬럼이 있는지 확인 (기본값이 없는 NOT NULL 컬럼만)
const providedColumns = columns.map(col => col.toUpperCase());
const missingRequiredColumns = schemaResult.data.filter((schemaCol: any) =>
schemaCol.NULLABLE === 'N' &&
!schemaCol.DATA_DEFAULT &&
!providedColumns.includes(schemaCol.COLUMN_NAME)
const providedColumns = columns.map((col) => col.toUpperCase());
const missingRequiredColumns = schemaResult.data.filter(
(schemaCol: any) =>
schemaCol.NULLABLE === "N" &&
!schemaCol.DATA_DEFAULT &&
!providedColumns.includes(schemaCol.COLUMN_NAME)
);
if (missingRequiredColumns.length > 0) {
const missingNames = missingRequiredColumns.map((col: any) => col.COLUMN_NAME);
logger.error(`❌ 필수 컬럼 누락: ${missingNames.join(', ')}`);
throw new Error(`필수 컬럼이 누락되었습니다: ${missingNames.join(', ')}`);
const missingNames = missingRequiredColumns.map(
(col: any) => col.COLUMN_NAME
);
logger.error(`❌ 필수 컬럼 누락: ${missingNames.join(", ")}`);
throw new Error(
`필수 컬럼이 누락되었습니다: ${missingNames.join(", ")}`
);
}
logger.info(`✅ 스키마 검증 통과: 모든 필수 컬럼이 제공되었거나 기본값이 있습니다.`);
logger.info(
`✅ 스키마 검증 통과: 모든 필수 컬럼이 제공되었거나 기본값이 있습니다.`
);
}
} catch (schemaError) {
logger.warn(`⚠️ 스키마 조회 실패 (계속 진행): ${schemaError}`);
}
values = values.map(value => {
values = values.map((value) => {
// null이나 undefined는 그대로 유지
if (value === null || value === undefined) {
return value;
}
// 숫자로 변환 가능한 문자열은 숫자로 변환
if (typeof value === 'string' && value.trim() !== '') {
if (typeof value === "string" && value.trim() !== "") {
const numValue = Number(value);
if (!isNaN(numValue)) {
logger.info(`🔄 Oracle 데이터 타입 변환: "${value}" (string) → ${numValue} (number)`);
logger.info(
`🔄 Oracle 데이터 타입 변환: "${value}" (string) → ${numValue} (number)`
);
return numValue;
}
}
return value;
});
}
let query: string;
let queryParams: any[];
const dbType = connection.db_type?.toLowerCase() || 'postgresql';
const dbType = connection.db_type?.toLowerCase() || "postgresql";
switch (dbType) {
case 'oracle':
case "oracle":
// Oracle: :1, :2 스타일 바인딩 사용, RETURNING 미지원
const oraclePlaceholders = values.map((_, index) => `:${index + 1}`).join(", ");
const oraclePlaceholders = values
.map((_, index) => `:${index + 1}`)
.join(", ");
query = `INSERT INTO ${tableName} (${columns.join(", ")}) VALUES (${oraclePlaceholders})`;
queryParams = values;
logger.info(`🔍 Oracle INSERT 상세 정보:`);
@@ -227,42 +240,57 @@ export class MultiConnectionQueryService {
logger.info(` - 값: ${JSON.stringify(values)}`);
logger.info(` - 쿼리: ${query}`);
logger.info(` - 파라미터: ${JSON.stringify(queryParams)}`);
logger.info(` - 데이터 타입: ${JSON.stringify(values.map(v => typeof v))}`);
logger.info(
` - 데이터 타입: ${JSON.stringify(values.map((v) => typeof v))}`
);
break;
case 'mysql':
case 'mariadb':
case "mysql":
case "mariadb":
// MySQL/MariaDB: ? 스타일 바인딩 사용, RETURNING 미지원
const mysqlPlaceholders = values.map(() => '?').join(", ");
const mysqlPlaceholders = values.map(() => "?").join(", ");
query = `INSERT INTO ${tableName} (${columns.join(", ")}) VALUES (${mysqlPlaceholders})`;
queryParams = values;
logger.info(`MySQL/MariaDB INSERT 쿼리:`, { query, params: queryParams });
logger.info(`MySQL/MariaDB INSERT 쿼리:`, {
query,
params: queryParams,
});
break;
case 'sqlserver':
case 'mssql':
case "sqlserver":
case "mssql":
// SQL Server: @param1, @param2 스타일 바인딩 사용
const sqlServerPlaceholders = values.map((_, index) => `@param${index + 1}`).join(", ");
const sqlServerPlaceholders = values
.map((_, index) => `@param${index + 1}`)
.join(", ");
query = `INSERT INTO ${tableName} (${columns.join(", ")}) VALUES (${sqlServerPlaceholders})`;
queryParams = values;
logger.info(`SQL Server INSERT 쿼리:`, { query, params: queryParams });
logger.info(`SQL Server INSERT 쿼리:`, {
query,
params: queryParams,
});
break;
case 'sqlite':
case "sqlite":
// SQLite: ? 스타일 바인딩 사용, RETURNING 지원 (3.35.0+)
const sqlitePlaceholders = values.map(() => '?').join(", ");
const sqlitePlaceholders = values.map(() => "?").join(", ");
query = `INSERT INTO ${tableName} (${columns.join(", ")}) VALUES (${sqlitePlaceholders}) RETURNING *`;
queryParams = values;
logger.info(`SQLite INSERT 쿼리:`, { query, params: queryParams });
break;
case 'postgresql':
case "postgresql":
default:
// PostgreSQL: $1, $2 스타일 바인딩 사용, RETURNING 지원
const pgPlaceholders = values.map((_, index) => `$${index + 1}`).join(", ");
const pgPlaceholders = values
.map((_, index) => `$${index + 1}`)
.join(", ");
query = `INSERT INTO ${tableName} (${columns.join(", ")}) VALUES (${pgPlaceholders}) RETURNING *`;
queryParams = values;
logger.info(`PostgreSQL INSERT 쿼리:`, { query, params: queryParams });
logger.info(`PostgreSQL INSERT 쿼리:`, {
query,
params: queryParams,
});
break;
}