Adobe Commerce 데이터베이스 숫자 값이 범위를 벗어났습니다. INT에서 BIGINT

마지막 업데이트: 2025년 5월 5일
  • 주제:

작성 대상:

  • 개발자
경고
이 문서에서 솔루션을 구현하기 전에(INT에서 BIGINT 스키마 업데이트로) 판매자는 항상 변경할 필드에 다른 테이블에 대한 외래 키 관계가 없는지 확인해야 합니다. 필드에 다른 테이블에 대한 외래 키 관계가 있는 경우 관련 필드가 INT이므로 문제가 발생합니다. 다음 쿼리를 사용하여 이를 확인할 수 있습니다. 이 쿼리는 주어진 테이블 필드에 대해 데이터베이스에서 사용할 수 있는 외래 키 관계를 나열합니다.
SELECT
     TABLE_NAME,COLUMN_NAME,CONSTRAINT_NAME,REFERENCED_TABLE_NAME,REFERENCED_COLUMN_NAME
FROM
   INFORMATION_SCHEMA.KEY_COLUMN_USAGE
WHERE
     REFERENCED_TABLE_SCHEMA = '<database_name>' AND
     REFERENCED_TABLE_NAME = '<table_name>' AND
     REFERENCED_COLUMN_NAME = '<table_field>';

영향을 받는 제품 및 버전

이 문서에서는 가격 변경, 제품 삭제 및 복제와 같은 제품 업데이트를 저장할 수 없는 경우에 대한 솔루션을 제공합니다.
재고 항목을 저장할 수 없다는 오류 메시지가 표시될 수 있습니다. 다시 시도하십시오. 제품 업데이트 후 배포하지 못할 수 있습니다. php bin/magento setup:upgrade을(를) 실행할 때 다음 MySQL 오류 메시지가 표시될 수도 있습니다(클라우드 인프라의 Adobe Commerce에서 이 오류는 배포 로그에 표시됨).

SQLSTATE[22003]: Numeric value out of range: 167 Out of range value for column 'value_id' at row 1, query was: INSERT INTO `catalog_product_entity_decimal` (`attribute_id`,`store_id`,`row_id`,`value`) VALUES (?, ?, ?, ?) ON DUPLICATE KEY UPDATE `attribute_id` = VALUES(`attribute_id`), `store_id` = VALUES(`store_id`), `row_id` = VALUES(`row_id`), `value` = VALUES(`value`)

이 문서에 설명된 솔루션은 다음과 같습니다.

  • 테이블에서 [ AUTO_INCREMENT ]을(를) 다음 값으로 업데이트하거나
  • INT에서 BIGINT 스키마 업데이트로

어떤 솔루션을 사용하는지는 문제의 원인이 무엇인지에 따라 다릅니다. 원인을 파악하려면 아래 단계를 참조하십시오.

원인 확인 단계

터미널에서 다음 명령을 실행하여 기본 키의 가장 높은 값을 확인합니다. SELECT MAX(value_id) FROM catalog_product_entity_int;

max(value_id)이(가) max int(11) [ 4294967296 ]보다 낮고 [ AUTO_INCREMENT ]의 값이 max int(11) [ 4294967296 ]보다 크거나 같은 경우 테이블에서 다음 값으로 [ AUTO_INCREMENT ]을(를) 업데이트하는 것이 좋습니다. 그렇지 않으면 INT에서 BIGINT 스키마 업데이트를 고려하십시오.

테이블에서 다음 값으로 AUTO_INCREMENT 업데이트

경고
테이블을 변경하기 전에 데이터베이스 백업을 수행합니다. 또한 사이트를 유지 관리 모드로 전환하세요. 또한 변경한 후 데이터베이스 테이블(변경된 테이블만)에서 MySQL optimize 명령을 실행하는 것이 좋습니다.
노트
특정 테이블에서 최적화 명령을 실행하는 동안 사이트는 유지 관리 모드에 있어야 합니다. 이렇게 하면 테이블이 완전히 다시 빌드되고 테이블에서 데이터를 삭제한 후 공간이 확보됩니다.

아래 예제 터미널 출력에 표시된 대로 표시된 값이 max int(11) [ 4294967296 ]보다 낮은 경우 [ AUTO_INCREMENT ] 테이블이 max [ int(11) ] 값보다 크거나 같은 숫자로 변경되었습니다.

MariaDB [xxx]> SELECT MAX(value_id) FROM catalog_product_entity_int;
+---------------------+
| MAX(source_item_id) |
+---------------------+
|          4283174130 |
+---------------------+

이 오류가 발생했는지 확인하려면 터미널에서 다음 명령을 실행합니다.

MariaDB [xxx]> show create table catalog_product_entity_int;

...
) ENGINE=InnoDB AUTO_INCREMENT=4294967297 DEFAULT CHARSET=utf8 COMMENT='Catalog Product Integer Attribute Backend Table';

위의 예에서 보듯이 테이블 [ AUTO_INCREMENT ]이(가) max int(11) [ 4294967296 ]보다 큰 숫자로 변경되었습니다. 해결 방법은 테이블에서 다음 값으로 [ AUTO_INCREMENT]을(를) 업데이트하는 것입니다.

ALTER TABLE catalog_product_entity_int AUTO_INCREMENT = 4283174131;

INT에서 BIGINT 스키마 업데이트로

그러나 다음 쿼리 SELECT MAX(value_id) FROM catalog_product_entity_int;을(를) 실행할 때 표시된 값이 max int(11) [ 4294967296 ]보다 큰 경우 INT - BIGINT 스키마 업데이트를 수행하는 것이 좋습니다. 데이터 형식 BIGINT의 값 범위가 더 큽니다.

방법은 다음과 같습니다.

  1. app/code/ 디렉터리 내에 사용자 지정 모듈을 만듭니다.
  2. 사용자 지정 모듈에서 db_schema.xml ​을(를) 만듭니다. db_schema.xml ​에서 데이터 형식을 BIGINT(으)로 설정합니다.
  3. 다음 콘텐츠를 추가한 다음 bin/magento setup:upgrade을(를) 실행하여 위의 변경 내용을 해당 테이블에 적용합니다.
<?xml version="1.0"?>
<schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Setup/Declaration/Schema/etc/schema.xsd">
    <table name="catalog_product_entity_int">
        <column xsi:type="bigint" name="value_id" unsigned="false" nullable="false" identity="true"
                comment="Value ID"/>
    </table>
</schema>

관련 읽기

recommendation-more-help