ERP-node/db/migrations/046_QUICK_FIX.md

4.1 KiB

채번 규칙 마이그레이션 오류 긴급 수정

🚨 발생한 오류들

오류 1: check_table_scope_requires_table_name

SQL Error [23514]: ERROR: new row for relation "numbering_rules" violates check constraint "check_table_scope_requires_table_name"

원인: scope_type='table'인데 table_name=NULL

오류 2: check_global_scope_no_table_name

SQL Error [23514]: ERROR: new row for relation "numbering_rules" violates check constraint "check_global_scope_no_table_name"

원인: scope_type='global'인데 table_name='' (빈 문자열)

근본 원인

마이그레이션이 부분적으로 실행되어 데이터와 제약조건이 불일치 상태입니다.

해결 방법

🎯 가장 쉬운 방법 (권장)

PgAdmin 또는 DBeaver에서 046_SIMPLE_FIX.sql 실행

이 파일은 다음을 자동으로 처리합니다:

  1. 기존 제약조건 모두 제거
  2. table_name NULL → 빈 문자열로 변경
  3. scope_type을 모두 'table'로 변경
  4. 결과 확인
-- db/migrations/046_SIMPLE_FIX.sql 전체 내용을 복사하여 실행하세요

실행 후:

  • 046_update_numbering_rules_scope_type.sql 전체 실행
  • 완료!

옵션 2: 명령줄에서 실행

# 1. 긴급 수정 SQL 실행
psql -h localhost -U postgres -d ilshin -f db/fix_existing_numbering_rules.sql

# 2. 전체 마이그레이션 실행
psql -h localhost -U postgres -d ilshin -f db/migrations/046_update_numbering_rules_scope_type.sql

옵션 3: Docker 컨테이너 내부에서 실행

# 1. Docker 컨테이너 확인
docker ps | grep postgres

# 2. 컨테이너 내부 접속
docker exec -it <CONTAINER_NAME> psql -U postgres -d ilshin

# 3. SQL 실행
UPDATE numbering_rules SET table_name = '' WHERE table_name IS NULL;

# 4. 확인
SELECT COUNT(*) FROM numbering_rules WHERE table_name IS NULL;
-- 결과: 0

# 5. 종료
\q

🔍 왜 이 문제가 발생했나?

기존 마이그레이션 순서 (잘못됨)

-- 1. scope_type 변경 (먼저 실행됨)
UPDATE numbering_rules SET scope_type = 'table' WHERE scope_type IN ('global', 'menu');

-- 2. table_name 정리 (나중에 실행됨)
UPDATE numbering_rules SET table_name = '' WHERE table_name IS NULL;

-- 3. 제약조건 추가
ALTER TABLE numbering_rules ADD CONSTRAINT check_table_scope_requires_table_name ...

문제점:

  • scope_type='table'로 변경된 후
  • 아직 table_name=NULL인 상태
  • 이 상태에서 INSERT/UPDATE 시도 시 제약조건 위반

수정된 마이그레이션 순서 (올바름)

-- 1. table_name 정리 (먼저 실행!)
UPDATE numbering_rules SET table_name = '' WHERE table_name IS NULL;

-- 2. scope_type 변경
UPDATE numbering_rules SET scope_type = 'table' WHERE scope_type IN ('global', 'menu');

-- 3. 제약조건 추가
ALTER TABLE numbering_rules ADD CONSTRAINT check_table_scope_requires_table_name ...

📋 실행 체크리스트

  • 옵션 1, 2, 또는 3 중 하나 선택하여 데이터 수정 완료
  • SELECT COUNT(*) FROM numbering_rules WHERE table_name IS NULL; 실행 → 결과가 0인지 확인
  • 전체 마이그레이션 046_update_numbering_rules_scope_type.sql 실행
  • 백엔드 재시작
  • 프론트엔드에서 채번 규칙 테스트

🎯 완료 후 확인사항

SQL로 최종 확인

-- 1. 모든 규칙이 table 타입인지
SELECT scope_type, COUNT(*) 
FROM numbering_rules 
GROUP BY scope_type;
-- 결과: table만 나와야 함

-- 2. table_name이 NULL인 규칙이 없는지
SELECT COUNT(*) 
FROM numbering_rules 
WHERE table_name IS NULL;
-- 결과: 0

-- 3. 샘플 데이터 확인
SELECT 
  rule_id,
  rule_name,
  scope_type,
  table_name,
  company_code
FROM numbering_rules
LIMIT 5;

💡 추가 정보

수정된 마이그레이션 파일(046_update_numbering_rules_scope_type.sql)은 이제 올바른 순서로 실행되도록 업데이트되었습니다. 하지만 이미 실행된 부분적인 마이그레이션으로 인해 데이터가 불일치 상태일 수 있으므로, 위의 긴급 수정을 먼저 실행하는 것이 안전합니다.