// MySQL 오류 참조

MySQL 오류 1071: 지정된 키가 너무 깁니다

인덱스가 InnoDB가 허용하는 폭(3072바이트, 이전 행 형식에서는 767바이트)을 넘는 경우로, 보통 긴 utf8mb4 VARCHAR에서 일어납니다.

오류 번호
1071
이름
ER_TOO_LONG_KEY
SQLSTATE
42000
카테고리
키 및 제약 조건
오류 메시지
Specified key was too long; max key length is %d bytes

의미

최대 키 길이는 문자 수가 아니라 바이트 수로 계산됩니다. 이때 utf8mb4 각 문자는 4바이트를 차지할 수 있으므로, VARCHAR(255) 열마다 최대 1020바이트까지 필요합니다. 다음을 쓰는 InnoDB에서는 DYNAMIC 또는 COMPRESSED 행 포맷은 인덱스당 3072바이트를 허용합니다; 이전의 COMPACT 그리고 REDUNDANT 포맷은 767을 허용하며, 여기서 VARCHAR(255) in utf8mb4 실패합니다.

일반적인 원인

  • 다음과 같이 긴 컬럼에 대한 고유 인덱스 utf8mb4 VARCHAR, 특히 MySQL 5.6이나 오래된 행 형식에서 그렇습니다.
  • 열의 합이 제한을 초과하는 복합 인덱스.

해결 방법

  1. 다음을 사용하세요 DYNAMIC 행 포맷(MySQL 5.7 이후 기본값).

    ALTER TABLE users ROW_FORMAT = DYNAMIC;
  2. 열의 접두사를 인덱싱하세요. 이 방법은 비고유 인덱스에서 동작합니다.

    CREATE INDEX idx_users_bio ON users (bio(191));
  3. 긴 값이 필요 없을 때는 열을 줄이세요. 예: VARCHAR(191) 인덱싱된 이메일의 경우 utf8mb4 767바이트 제한 안에 들어갑니다.

관련 오류

그 밖의 키 및 제약 조건 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 MySQL 8.4 오류 메시지 참조. 전체 목록은 MySQL 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 MySQL 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. MySQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.