메인 콘텐츠로 건너뛰기
TOAST 컬럼, replication slot, publication, 스키마 변경, 데이터 타입 매핑 등 Postgres 복제의 작동 방식과 관련된 많은 질문은 ClickPipes for Postgres FAQ에서 다룹니다. 해당 정보는 Managed Postgres 마이그레이션에도 적용됩니다.

복제 중 “enum의 입력 값이 잘못되었습니다” 오류가 표시됩니다

이 오류는 원본 Postgres에 있는 enum 값이 대상 Managed Postgres에는 없을 때 발생합니다. 논리적 복제는 ALTER TYPE ... ADD VALUE 명령을 자동으로 전파하지 않으므로, 초기 스키마 설정 후 원본에 추가된 새 enum 값 때문에 대상에서 삽입이 실패합니다. 이 문제를 해결하려면 대상 Postgres의 enum 유형에 누락된 값을 추가하십시오:
ALTER TYPE your_enum_type ADD VALUE 'new_value';
your_enum_type을 enum 유형 이름으로, 'new_value'를 오류 메시지에 표시된 누락된 값으로 바꾸십시오.

복제 중 고유 제약 조건 위반 오류가 발생하는 경우

논리적 복제 중에는 복제 순서로 인해 대상에 이미 존재하는 고유 제약 조건과 충돌이 발생하여 고유 제약 조건 위반이 생길 수 있습니다. 이는 후속 업데이트에서 해결되기 전에 일시적으로 고유성 위반이 발생하는 작업을 재생하는 CDC 워크로드에서 나타날 수 있습니다. 복제를 다시 진행할 수 있도록 대상 Postgres에서 고유 제약 조건을 삭제하세요:
ALTER TABLE your_table DROP CONSTRAINT your_constraint_name;
다음을 실행하여 제약 조건 이름을 확인할 수 있습니다:
SELECT conname, conrelid::regclass
FROM pg_constraint
WHERE contype = 'u';
복제가 완료되어 소스가 더 이상 활성 상태가 아니면 컷오버 시점에 제약 조건을 다시 추가하십시오:
ALTER TABLE your_table ADD CONSTRAINT your_constraint_name UNIQUE (column1, column2);
마지막 수정일 2026년 6월 10일