Erreur MySQL 1071 : La clé spécifiée était trop longue
Un index est plus large que ce qu'InnoDB autorise (3072 octets, ou 767 octets avec d'anciens formats de ligne), généralement sur un long VARCHAR utf8mb4.
- Numéro d'erreur
1071- Nom
ER_TOO_LONG_KEY- SQLSTATE
42000- Catégorie
- Clés et contraintes
Ce que cela signifie
La longueur maximale de la clé se compte en octets, pas en caractères. Avec utf8mb4 chaque caractère peut prendre 4 octets, donc VARCHAR(255) nécessite jusqu'à 1020 octets par colonne. InnoDB avec le DYNAMIC ou COMPRESSED format de ligne permet 3072 octets par index ; les anciens COMPACT et REDUNDANT formats permettent 767, ce qui est l'endroit où VARCHAR(255) dans utf8mb4 échoue.
Causes courantes
- Un index unique sur un long
utf8mb4VARCHAR, surtout sur MySQL 5.6 ou avec un ancien format de ligne. - Un index composite dont les colonnes dépassent, cumulées, la limite.
Comment le corriger
-
Utilisez le
DYNAMICformat de ligne (le défaut depuis MySQL 5.7).ALTER TABLE users ROW_FORMAT = DYNAMIC;
-
Indexez un préfixe de la colonne, ce qui fonctionne pour les index non uniques.
CREATE INDEX idx_users_bio ON users (bio(191));
-
Raccourcissez la colonne si des valeurs longues ne sont pas nécessaires, par exemple
VARCHAR(191)pour un email indexé dansutf8mb4sous la limite de 767 octets.
Erreurs liées
Plus d'erreurs de clés et de contraintes
1062Entrée en double pour la clé1452Échec de la clé étrangère : impossible d'ajouter la ligne enfant1451Échec de la clé étrangère : impossible de supprimer la ligne parente1216Impossible d'ajouter ou de mettre à jour une ligne enfant1217Impossible de supprimer ou de mettre à jour une ligne parente1215Impossible d'ajouter une contrainte de clé étrangère3780Les colonnes de clé étrangère sont incompatibles1822Index manquant pour la contrainte de clé étrangère
Le code et le texte du message sont issus de Référence des messages d'erreur MySQL 8.4. Parcourir la liste complète Liste des erreurs MySQL ou Rechercher toutes les erreurs de base de données.
Travailler sur MySQL dans SQLly
Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d’erreur clairs, pour MySQL et les autres bases de données que vous utilisez.