操作MySQL出错提示“BLOB/TEXT column used in key specification without a key length”解决办法

最新推荐文章于 2025-08-07 08:30:00 发布

转载最新推荐文章于 2025-08-07 08:30:00 发布 · 5k 阅读

3 ·

CC 4.0 BY-SA版权

原文链接：https://blog.youkuaiyun.com/helloxiaozhe/article/details/83018347

mysql 专栏收录该内容

71 篇文章

订阅专栏

本文详细解析了在MySQL数据库操作中常见的错误1170，即BLOB/TEXT字段在键规范中未指定键长度的问题。文章阐述了错误出现的原因，包括在创建或修改表时对BLOB/TEXT字段的不当使用，以及在将DataFrame数据保存至MySQL时的常见陷阱。提供了几种解决方案，如移除unique限制、改变字段类型为VARCHAR并设置长度，以及如何正确地将DataFrame数据转换为适合MySQL的格式。

[ERR] 12> 1170 - BLOB/TEXT column 'TABLE_OBJID' used in key specification without a key length

mysql出错提示“BLOB/TEXT column used in key specification without a key length”解决办法

一、问题

pandas对象将DataFrame数据保存到mysql中时，出现错误提示：
　　BLOB/TEXT column used in key specification without a key length

或者

在MySQL数据库中，当MySQL创建新表或者更改已存在表，这个表存在主键，并且是unique唯一性约束和索引约束时，或者是在定义一个索引来更改数据表的text字段操作语句的时候，下面的错误信息很可能会出现，并且经过当前操作命令的完成。错误信息为BLOB或者TEXT字段使用了未指定键值长度的键，发生了这样的错误：BLOB/TEXT column 'name' used in key specification without a key length。

查阅资料后才知道，原来Mysql数据库对于BLOB/TEXT这样类型的数据结构只能索引前N个字符。所以这样的数据类型不能作为主键，也不能是UNIQUE的。所以要换成VARCHAR，但是VARCHAR类型的大小也不能大于255，当VARCHAR类型的字段大小如果大于255的时候也会转换成小的TEXT来处理。所以也同样有问题。

此外，因为MySQL只能将BLOB/TEXT类型字段设置索引为BLOB/TEXT数据的钱N个字符，因此错误常常发生在字段被定义为TEXT/BLOB类型或者和TEXT/BLOB同质的数据类型，如TINYTEXT,MEDIUMTEXT,LONGTEXT ,TINYBLOB,MEDIUMBLOB 和LONGBLOB，并且当前操作是将这个字段设置成主键或者是索引的操作。在未指定TEXT/BLOB‘键长’的情况下，字段是变动的并且是动态的大小所以MySQL不能够保证字段的唯一性。因此当使用TEXT/BLOB类型字段做为索引时，N的值必须提供出来才可以让MySQL决定键长，但是MySQL不支持在TEXT/BLOB限制，TEXT(88)是不行的。

当你试图将数据表中的一个非TEXT或者非BLOB类型如VARCHAR或ENUM的字段转换成TEXT/BLOB，同时这个字段已经被定义了unique限制或者是索引，这个错误也会弹出，并且更改数据表的命令会执行失败

二、原因

出问题的原因是DataFrame对象索引的数据类型是TEXT/BLOB或其从属的类型，当将其作为mysql中的主键的时候，如果这些数据类型缺少明确的长度值，mysql无法保证主键的唯一性，因为这个主键是一个变量，其长度是动态的。所以当使用 TEXT/BLOB类型的数据作为索引的时候，数据的长度必须提供给mysql，使其能够明确键的长度。但是mysql不支持对TEXT/BLOB长度的限制。

同样的错误也会出现在试图将非TEXT/BLOB类型的数据列转换成TEXT/BLOB类型，这些列被定义成独立的索引。AlterTable命令会失效。

三、解决方法

解决方案是将unique限制和索引从TEXT/BLOB字段中移除，或者是设置另一个字段为主键。如果不得不设置成主键，而想限制TEXT/BLOB的长度，可以尝试使用VARCHAR并设置其长度。VARCHAR默认长度是255个字符，并且其长度必须在其声明之后的右边括号中设置，例如，VARCHAR(200)将其设置成200个字符长度。

有时候，即使你在数据表中不使用TEXT/BLOB类型或者同质类型，error1170 也会出现，这个问题出现在当你设置一个VARCHAR字段为主键，但是却错误的设置了长度或者字符数，事实上，VARCHAR只能接受最大为256个字符串，但是你错误的设置成VARCHAR(512)等一些错误的设置，这些错误的设置会强制MySQL自动将VARCHAR(512)等转换成SMALLINT类型，同时这个字段被设置成primary key ，unique限制或者index索引等，然后执行操作就出现error 1170错误，解决问题的方法，为VARCHAR域指定小于256的长度。

mysql #1170错误（42000） BLOB/TEXT Column Used in Key Specification Without a Key Length

将DataFrame数据输出到mysql时强制将索引转换成VARCHAR并限制其长度，其中的code是索引的标签：

1 data.to_sql('data',engine,if_exists='replace',dtype={'code':VARCHAR(data.index.get_level_values('code').str.len().max())})

参考：https://www.cnblogs.com/zhangjpn/p/6133793.html

https://blog.youkuaiyun.com/u012069924/article/details/28858337