最近在阿里云服务器上部署一个自己写的小 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. cookie的理解

    第一:每个特定的域名下最多生成20个cookie IE6或更低版本最多20个cookie IE7和之后的版本最多可以有50个cookie Firefox最多50个cookie chrome和Safar ...

  2. Win10 .net framework 3.5 安装失败 0x80073712 [解决了]

    Win10 .net framework 3.5 安装失败 0x80073712 用了各种办法,一直解决不了. 最后用了: 使用 https://www.microsoft.com/zh-cn/sof ...

  3. 题解 洛谷P6853 station

    蒟蒻语 还是蒟蒻太菜了,这场 div1 竟然一题都没做出来/kk/kk/kk 蒟蒻解 首先我们把每 5 个点分为一组.然后分组结果大概是这样子: 可以看到首先下面需要有一条边来让整张图有一条支撑的路径 ...

  4. Jwt令牌创建

    添加依赖 <dependencies> <!-- jwt --> <dependency> <groupId>io.jsonwebtoken</g ...

  5. 我的第一次shell

    我的第一次shell 最近我们的项目需要进行优化,整体架构进行改造. 然后我们红超哥就看我骨骼惊奇,说小伙子你想不想当做掌门人呀.(我说不想哈哈) 想不想也没用了,红超哥说我们现在的架构有所改变,需要 ...

  6. mybaties 使用注解注入动态sql (if-else)-转义字符

    看到网上使用注解动态注入sql都是判断参数是否为空,我做项目的时候需要判断参数是否为字符串,需要对引号进行转义,所以把代码贴过来了. 注意:test表达式不能引用传入的参数,直接使用参数即可----- ...

  7. 学好Spark/Kafka必须要掌握的Scala技术点(一)变量、表达式、循环、Option、方法和函数,数组、映射、元组、集合

    前言 Scala是以JVM为运行环境的面向对象的函数式编程语言,它可以直接访问Java类库并且与Java框架进行交互操作.正如之前所介绍,Spark是用Scala语言编写的,Kafka server端 ...

  8. GaussDB(DWS)应用实践丨负载管理与作业排队处理方法

    摘要:本文用来总结一些GaussDB(DWS)在实际应用过程中,可能出现的各种作业排队的情况,以及出现排队时,我们应该怎么去判断是否正常,调整一些参数,让资源分配与负载管理更符合当前的业务:或者在作业 ...

  9. Docker(六):Docker安装Kibana

    查找Kibana镜像 镜像仓库 https://hub.docker.com/ 下拉镜像 docker pull kibana:7.7.0 查看镜像 docker images 创建Kibana容器 ...

  10. 使用脚手架搭建vue项目

    全局安装环境 安装webpack npm install webpack -g 安装vue脚手架 npm install -g @vue/cli-init 初始化vue项目 vue init webp ...