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

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

下面是翻译文章,原文链接: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 官方文档学习。

MySQL 标识符到底区分大小写么——官方文档告诉你的更多相关文章

  1. Mysql优化(出自官方文档) - 第九篇(优化数据库结构篇)

    目录 Mysql优化(出自官方文档) - 第九篇(优化数据库结构篇) 1 Optimizing Data Size 2 Optimizing MySQL Data Types 3 Optimizing ...

  2. Mysql优化(出自官方文档) - 第一篇(SQL优化系列)

    Mysql优化(出自官方文档) - 第一篇 目录 Mysql优化(出自官方文档) - 第一篇 1 WHERE Clause Optimization 2 Range Optimization Skip ...

  3. 看MySQL官方文档的示例SQL有感

    [背景] 周末比较闲,我这个人又没有什么爱好,当然了读书除外:前一些天我一个同事说:“你一个dba想去写一本“django”书,合适吗?” 我想也是,一个人不能忘了本,所以MySQL还是要好好的搞一搞 ...

  4. Mysql优化(出自官方文档) - 第三篇

    目录 Mysql优化(出自官方文档) - 第三篇 1 Multi-Range Read Optimization(MRR) 2 Block Nested-Loop(BNL) and Batched K ...

  5. Mysql优化(出自官方文档) - 第五篇

    目录 Mysql优化(出自官方文档) - 第五篇 1 GROUP BY Optimization 2 DISTINCT Optimization 3 LIMIT Query Optimization ...

  6. Mysql优化(出自官方文档) - 第八篇(索引优化系列)

    目录 Mysql优化(出自官方文档) - 第八篇(索引优化系列) Optimization and Indexes 1 Foreign Key Optimization 2 Column Indexe ...

  7. 从官方文档中探索MySQL分页的几种方式及分页优化

    概览 相比于Oracle,SQL Server 等数据库,MySQL分页的方式简单得多了,官方自带了分页语法 limit 语句: select * from test_t LIMIT {[offset ...

  8. 手把手教你看MySQL官方文档

    前言: 在学习和使用MySQL的过程中,难免会遇到各种问题.不知道当你遇到相关问题时会怎么做,我在工作或写文章的过程中,遇到不懂或需要求证的问题时通常会去查阅官方文档.慢慢的,阅读文档也有了一些经验, ...

  9. Mysql优化(出自官方文档) - 第十二篇(优化锁操作篇)

    Mysql优化(出自官方文档) - 第十二篇(优化锁操作篇) 目录 Mysql优化(出自官方文档) - 第十二篇(优化锁操作篇) 1 Internal Locking Methods Row-Leve ...

随机推荐

  1. RocketMQ开发者指南

    1. 概念和特性 概念:介绍RocketMQ的基本概念模型 1 消息模型(Message Model) RocketMQ主要由 Producer.Broker.Consumer 三部分组成,其中Pro ...

  2. 人社部新职业,Panda Global发现区块链新职业榜上有名!

    近日,为了助力新冠肺炎疫情的防控,扎实做好"六稳"工作,全面落实"六保"任务,促就业拓岗位,人力资源社会保障部联合市场监管总局.国家统计局近日正式向社会发布一批 ...

  3. python 数据分析与挖掘实战01

    python 数据分析与挖掘实战 day 01 08/02 这种从数据中"淘金",从大量数据包括文本中挖掘出隐含的.未知的.对决策有潜在价值关系.模式或者趋势,并用这些知识和规则建 ...

  4. 用Ubuntu和树莓派系统部署kubernetes集群后的一些心得

    方案 环境 操作系统:Ubuntu 16.04 & Raspbian GNU/Linux 9(Stretch Desktop) kubernetes :1.15.3 flannel:0.11. ...

  5. rsync全网备份low方法

    要求: 1.基本备份要求已知3 台服务器主机名分别为web01.backup .nfs01,主机信息见下表:服务器说明外网IP(NAT) 内网IP(NAT) 主机名称nginx web 服务器10.0 ...

  6. STL—— 容器(vector)的数据插入之 insert()

    vector 容器可以使用 vectorName.insert() 方法插入元素,vectorName.insert() 函数一共有4种重载方法: 第一种 insert() 用法:在指定地址插入单个元 ...

  7. linux下postgresql安装

    1.下载地址 https://www.enterprisedb.com/download-postgresql-binaries 2.创建用户并修改密码 [root@node01 ~]# userad ...

  8. 【教程】IDEA创建Maven项目并整合Tomcat发布,问题解决大全

    一篇入门教程 一.创建项目并运行 参考这个视频,能顺利运行 helloworld ,本人用的 IDEA2020.2.3 .jdk11 .Tomcat9 .Maven3.6 bilibili-IDEA( ...

  9. npm的下载与安装

    1.Node (1)什么是Node.js Node.js 就是运行在服务端的 JavaScript.Node.js 是一个基于Chrome JavaScript 运行时建立的一个平台. (2)Node ...

  10. 网络编程-python实现-TCP(1.1.3)

    @ 目录 1.TCP是什么 2.代码实现 1.TCP是什么 传输控制协议(TCP,Transmission Control Protocol)是一种面向连接的.可靠的.基于字节流的传输层通信协议,由I ...