// MySQL 오류 참조
MySQL 오류 1071: 지정된 키가 너무 깁니다
인덱스가 InnoDB가 허용하는 폭(3072바이트, 이전 행 형식에서는 767바이트)을 넘는 경우로, 보통 긴 utf8mb4 VARCHAR에서 일어납니다.
- 오류 번호
1071- 이름
ER_TOO_LONG_KEY- SQLSTATE
42000- 카테고리
- 키 및 제약 조건
의미
최대 키 길이는 문자 수가 아니라 바이트 수로 계산됩니다. 이때 utf8mb4 각 문자는 4바이트를 차지할 수 있으므로, VARCHAR(255) 열마다 최대 1020바이트까지 필요합니다. 다음을 쓰는 InnoDB에서는 DYNAMIC 또는 COMPRESSED 행 포맷은 인덱스당 3072바이트를 허용합니다; 이전의 COMPACT 그리고 REDUNDANT 포맷은 767을 허용하며, 여기서 VARCHAR(255) in utf8mb4 실패합니다.
일반적인 원인
- 다음과 같이 긴 컬럼에 대한 고유 인덱스
utf8mb4VARCHAR, 특히 MySQL 5.6이나 오래된 행 형식에서 그렇습니다. - 열의 합이 제한을 초과하는 복합 인덱스.
해결 방법
-
다음을 사용하세요
DYNAMIC행 포맷(MySQL 5.7 이후 기본값).ALTER TABLE users ROW_FORMAT = DYNAMIC;
-
열의 접두사를 인덱싱하세요. 이 방법은 비고유 인덱스에서 동작합니다.
CREATE INDEX idx_users_bio ON users (bio(191));
-
긴 값이 필요 없을 때는 열을 줄이세요. 예:
VARCHAR(191)인덱싱된 이메일의 경우utf8mb4767바이트 제한 안에 들어갑니다.
관련 오류
그 밖의 키 및 제약 조건 오류
1062키에 대한 중복 항목1452외래 키 실패: 자식 행을 추가할 수 없습니다1451외래 키 실패: 부모 행을 삭제할 수 없습니다1216자식 행을 추가하거나 업데이트할 수 없습니다1217부모 행을 삭제하거나 업데이트할 수 없습니다1215외래 키 제약 조건을 추가할 수 없습니다3780외래 키 열이 호환되지 않습니다1822외래 키 제약 조건에 대한 인덱스가 없습니다
코드와 메시지 텍스트의 출처는 다음과 같습니다 MySQL 8.4 오류 메시지 참조. 전체 목록은 MySQL 오류 목록 또는 모든 데이터베이스 오류 검색.
// 오류는 줄이고, 수정은 빠르게
SQLly에서 MySQL 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. MySQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.