最近在阿里云服务器上部署一个自己写的小 demo 时遇到一点问题,查看 Tomcat 日志后定位到问题出现在与数据库服务器交互的地方,执行 SQL 语句时会返回 指定列.指定名 不存在的错误。多方查证后发现原来 MySQL 的标识符大小写区分规则在 Unix 和 Windows 系统上是不同的。为了解决这个问题我去查看了 MySQL 官方给出的参考手册后解决,同时为了学习我参考手册中对应部分做了一次全面翻译。

先说结论:在 Windows 操作系统中将 MySQL 的系统变量 lower_case_table_names 值修改为 2,并在开发时详细规定好标识符名的大小写规则。

SRE实战 互联网时代守护先锋,助力企业售后服务体系运筹帷幄!一键直达领取阿里云限量特价优惠。

下面是翻译文章,原文链接:MySQL :: MySQL 5.6 Reference Manual :: 9.2.2 Identifier Case Sensitivity

标识符大小写区分规则

在 MySQL 中,数据库存储在文件系统中的 data 目录。每个数据库对应一个子目录,每张表对应一个子文件(也可能更多,取决于使用的存储引擎)。触发器也有对应文件。所以,数据库、表和底层触发器是否区分大小写取决于底层操作系统。也就是说标识符在 Windows 系统中是大小写不敏感的,在大多数 Unix 系统中是大小写敏感的。MacOS 是一个特例,虽然它是基于 Unix 的系统,但是其默认文件系统(HFS+)是大小写不敏感的。不过,MacOS 也支持 Unix 系统都支持的 UFS 文件系统。请参见 1.7.1 MySQL Extensions to Standard SQL 。此外,系统变量 lower_case_table_names 也会影响 MySQL 服务器是否区分标识符的大小写,本章后续内容会介绍。

需要注意的是,尽管数据库、表和触发器名在某些平台上不区分大小写,也不应该在一个同一个语句中分别使用大写和小写。下面这行语句不会执行因为它同时使用了 my_tableMY_TABLE

SELECT * FROM my_table WHERE MY_TABLE.col=1;

列、索引、存储例程 、事件名和列的别名无论在什么操作系统中都不区分大小写。

此外,日志文件的名称区分大小写,这一点和标准 SQL 语言不同。

默认情况下,表名在 Unix 系统中大小写敏感,在 Windows 和 MacOS 中不敏感。下面这行语句在 Unix 系统中不会执行,因为它同时使用 a 和 A 来做表的别名:

SELECT col_name FROM tbl_name AS a
       WHERE a.col_name = 1 OR A.col_name = 2;

但是,在 Windows 操作系统中这行语句是可以执行的。为了避免这些不同引起的问题,最好采用一致的约定,比如创建和使用数据库和表时都采用小写字母,这样的约定会最大程度的提升你代码的跨平台性(portability)和易用性(ease)。

数据库和表名在磁盘上如何存储和使用取决于 lower_case_table_names 系统变量,启动 MySQL Server 后可以设置这个变量的值。下表 给出lower_case_table_names 的可选值和对应的含义。改变量的值不会影响触发器的大小写区分规则。在 Unix 系统中, lower_case_table_names 默认值为 0,在 Windows 系统中默认值是 1 。在 MacOS 中默认值为 2。

Value Meaning
0 数据库和表名的大小写取决于 CREATE TABLECREATE DATABASE 语句中指明的大小写,标识符名是大小写敏感的。在 WIndos 或 MacOS 等文件系统大小写不敏感的操作系统中不应将此变量的值设为 0,如果强行设置为 0,并且使用不同大小写的字母访问使用 MyISAM 引擎的数据表,可能会导致索引损坏。
1 数据库和表名以小写形式存放在磁盘上,标识符名大小写不敏感。此时 MySQL 执行 SQL 语句时会将所有的数据库名、表名和表别名转换成小写。
2 数据库和表名的大小写取决于 CREATE TABLECREATE DATABASE 语句中指明的大小写,但是执行查询语句时 MySQL 会将其传化成小写,这种情况下标识符名不区分大小写。这个值仅适用于文件系统大小写不敏感的操作系统!当使用 InnDB 引擎,数据表的具体表现和值为 1 时相同。

如果你只在一个平台上使用 MySQL ,一般来说是不用修改 lower_case_table_names 的默认值的。但是在文件系统规则不同的平台上转移表时可能会发生错误。例如,在 Unix 系统中 my_tableMY_TABLE 是两个不同的表,但是在 WIndows 系统上是同一个。有两种方法可以保证在不同平台上转移数据时不发生错误:

  • 在每个系统中都设置 lower_case_table_names = 1 ,不过这样设置会导致执行 SHOW DATABASESSHOW TABLES 语句不会正确返回创建时使用的大小写区分。

  • 在 Unix 系统上设置 lower_case_table_names = 0 ,Windows 系统上设置 lower_case_table_names = 2 。这样能保留数据库和表名的原始大小写区分。 使用这种方法,您必须保证在 Windows 系统上执行语句时始终使用正确的大小写区分。如果大小写区分不当,将语句转移到 Unix 系统时会发生错误。

    注意:如果使用 InnDB 作为引擎,为了避免传输数据时发生的错误,应该在所有平台上都设置 lower_case_table_names = 1 从而将标识符强制转化成小写。

如果您准备在 Unix 系统中设置 lower_case_table_names = 1 ,在设置完成之后、重启 MySQL Server 之前必须手动将表名修改为小写。使用 RENAME TABLE 语句完成:

RENAME TABLE T1 TO t1;

如果要修改一个或多个数据库,请在设置 lower_case_table_names = 1 之前备份,然后删除数据库,在设置 lower_case_table_names = 1 之后重新加载数据库:

  1. 使用 mysqldump 备份每一个需要重新创建的数据库:

    mysqldump --databases db1 > db1.sql
    mysqldump --databases db2 > db2.sql
    ...
  2. 使用 DROP DATABASE 语句删除数据库。

  3. 关闭 MySQL Server ,设置 lower_case_table_names 之后重启服务器。

  4. 重新加载数据库,由于修改了 lower_case_table_names 变量,每个数据库和表名在重新创建时都会转换成小写。

    mysql < db1.sql
    mysql < db2.sql
    ...

如果标识符名的大写形式在二进制规则排序后相等,则可以认为它们是重复的。这种情况在游标,条件,过程,函数,保存点,存储例程的参数,存储的程序局部变量和插件中适用。在列名,约束,数据库,分区,预编译语句,表名,触发器,用户和用户定义变量中是无效的

  1. 原文中使用的词为 stored routine,笔者才疏学浅,不知道这个单词表示什么,机翻得到的“存储例程”。
  2. MyISAM 和 InnDB 都是 MySQL 使用的数据库引擎
  3. 原文中使用的词为 statements prepared with PREPARE,猜测 JDBC 中的 PreparedStatement 对象就是来源于此,之后会挑时间查阅 MySQL 官方文档学习。
扫码关注我们
微信号:SRE实战
拒绝背锅 运筹帷幄