증분 ID 변경

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

이 문서에서는 ALTER TABLE SQL 문을 사용하여 특정 Commerce 저장소의 Commerce 데이터베이스(DB) 엔터티(주문, 송장, 메모 등)에 대한 증분 ID를 변경하는 방법에 대해 설명합니다.

영향을 받는 버전

다음과 같은 경우 새 DB 엔티티의 증분 ID를 변경해야 할 수 있습니다.

라이브 사이트에서 하드 백업 복원 후
일부 주문 레코드가 손실되었지만 해당 ID는 현재 판매자 계정의 결제 게이트웨이(예: PayPal)에서 이미 사용되고 있습니다. 이러한 경우 결제 게이트웨이는 동일한 ID를 가진 새 주문 처리를 중지하고 "송장 ID 복제" 오류를 반환합니다

INFO

또한 PayPal의 지급 입고 환경설정에서 송장 ID당 복수 지급을 허용하여 PayPal에 대한 지급 게이트웨이 문제를 해결할 수 있습니다. 기술 자료에서 PayPal 게이트웨이 거부 요청 - 중복 송장 문제 를 참조하십시오.

다음 쿼리를 사용하여 엔터티 시퀀스 테이블의 현재 auto_increment 값을 확인하십시오.

code language-sql
SHOW TABLE STATUS FROM `{database_name}` WHERE `name` LIKE 'sequence_{entity_type}_{store_id}';

ID=1인 저장소에서 주문에 대한 자동 증가를 확인하는 경우 테이블 이름은 'sequence_order_1'이 됩니다.

auto_increment 열의 값이 '1234'인 경우 ID=1과(와) 함께 스토어에 배치된 다음 순서는 ID가 '#100001234'입니다.

다음 쿼리를 사용하여 엔티티를 업데이트합니다.

ALTER TABLE sequence_{entity_type}_{store_id} AUTO_INCREMENT = {new_increment_value};

INFO

중요: 새 증분 값은 현재 증분 값보다 커야 합니다.

다음 쿼리를 실행한 후:

ALTER TABLE sequence_order_1 AUTO_INCREMENT = 2000;

ID=1과(와) 함께 스토어에 배치된 다음 주문에는 ID가 '#100002000'입니다.

클라우드 인프라에서 Adobe Commerce의 프로덕션 환경에서 ALTER TABLE 쿼리를 실행하기 전에 다음 단계를 수행하는 것이 좋습니다.

[지원되는 모든 버전]

recommendation-more-help

386822bd-e32c-40a8-81c2-ed90ad1e198c