MySQL 帐户名由用户名和主机名组成,这使得可以为从不同主机连接的具有相同用户名的用户创建不同的帐户。本节介绍帐户名的语法,包括特殊值和通配符规则。
在大多数方面,帐户名类似于 MySQL 角色名,在第 8.2.5 节,“指定角色名”中描述了一些差异。
帐户名出现在 SQL 语句中,例如 CREATE USER
、GRANT
和 SET PASSWORD
,并遵循以下规则
帐户名语法为
'
。user_name
'@'host_name
'@'
部分是可选的。仅包含用户名的帐户名等效于host_name
''
。例如,user_name
'@'%''me'
等效于'me'@'%'
。如果用户名和主机名作为未加引号的标识符合法,则不需要加引号。如果
user_name
字符串包含特殊字符(如空格或-
),或者host_name
字符串包含特殊字符或通配符(如.
或%
),则必须使用引号。例如,在帐户名'test-user'@'%.com'
中,用户名和主机名部分都需要加引号。使用反引号 (
`
)、单引号 ('
) 或双引号 ("
) 将用户名和主机名作为标识符或字符串加引号。有关字符串加引号和标识符加引号的指南,请参见第 11.1.1 节,“字符串文字”和第 11.2 节,“模式对象名”。在SHOW
语句结果中,用户名和主机名使用反引号 (`
) 加引号。如果用户名和主机名部分加引号,则必须分别加引号。也就是说,写
'me'@'localhost'
,而不是'me@localhost'
。(后者实际上等效于'me@localhost'@'%'
,尽管此行为现在已弃用。)对
CURRENT_USER
或CURRENT_USER()
函数的引用等效于按字面意义指定当前客户端的用户名和主机名。
MySQL 将帐户名存储在 mysql
系统数据库中的授权表中,使用单独的列存储用户名和主机名部分
有关存储在授权表中的用户名和主机名的属性的更多详细信息,例如最大长度,请参见授权表范围列属性.
用户名和主机名具有以下描述的某些特殊值或通配符约定。
帐户名称的用户名部分可以是非空值,该值与传入连接尝试的用户名完全匹配,也可以是空值(空字符串),该值与任何用户名匹配。具有空用户名的帐户是匿名用户。要在 SQL 语句中指定匿名用户,请使用带引号的空用户名部分,例如 ''@'localhost'
。
帐户名称的主机名部分可以采用多种形式,并且允许使用通配符。
主机值可以是主机名或 IP 地址(IPv4 或 IPv6)。名称
'localhost'
表示本地主机。IP 地址'127.0.0.1'
表示 IPv4 环回接口。IP 地址'::1'
表示 IPv6 环回接口。在主机名或 IP 地址值中允许使用
%
和_
通配符,但这已弃用,因此在 MySQL 的未来版本中可能会被移除。这些字符与使用LIKE
运算符执行的模式匹配操作具有相同的含义。例如,主机值为'%'
匹配任何主机名,而值为'%.mysql.com'
匹配mysql.com
域中的任何主机。'198.51.100.%'
匹配 198.51.100 类 C 网络中的任何主机。由于主机值中允许使用 IP 通配符值(例如,
'198.51.100.%'
匹配子网上的每个主机),因此有人可能会试图利用此功能,将主机命名为198.51.100.somewhere.com
。为了阻止此类尝试,MySQL 不会对以数字和点开头的主机名执行匹配。例如,如果主机名为1.2.example.com
,则其名称永远不会与帐户名称的主机部分匹配。IP 通配符值只能匹配 IP 地址,不能匹配主机名。如果
partial_revokes
为ON
,MySQL 会将授权中的%
和_
视为文字字符,而不是通配符。使用这些通配符已弃用(无论此变量的值如何);您应该预计此功能将在 MySQL 的未来版本中被移除。对于指定为 IPv4 地址的主机值,可以给出网络掩码以指示要用于网络号的地址位数。网络掩码表示法不能用于 IPv6 地址。
语法为
。例如host_ip
/netmask
CREATE USER 'david'@'198.51.100.0/255.255.255.0';
这使
david
能够从任何具有 IP 地址client_ip
的客户端主机连接,只要以下条件为真client_ip & netmask = host_ip
也就是说,对于刚刚显示的
CREATE USER
语句client_ip & 255.255.255.0 = 198.51.100.0
满足此条件的 IP 地址范围从
198.51.100.0
到198.51.100.255
。网络掩码通常以设置为 1 的位开头,后面跟着设置为 0 的位。例如
198.0.0.0/255.0.0.0
: 198 类 A 网络上的任何主机198.51.0.0/255.255.0.0
: 198.51 类 B 网络上的任何主机198.51.100.0/255.255.255.0
: 198.51.100 类 C 网络上的任何主机198.51.100.1
: 只有具有此特定 IP 地址的主机
指定为 IPv4 地址的主机值可以使用 CIDR 表示法编写,例如
198.51.100.44/24
。
服务器使用系统 DNS 解析器为客户端主机名或 IP 地址返回的值,将帐户名称中的主机值与客户端主机进行匹配。除了帐户主机值使用网络掩码表示法指定的情况外,服务器都会执行此比较作为字符串匹配,即使帐户主机值以 IP 地址形式给出。这意味着您应该以 DNS 使用的相同格式指定帐户主机值。以下是一些需要注意的问题示例
假设本地网络上的主机具有完全限定名称
host1.example.com
。如果 DNS 将此主机的名称查找返回为host1.example.com
,请在帐户主机值中使用该名称。如果 DNS 只返回host1
,请使用host1
代替。如果 DNS 将给定主机的 IP 地址返回为
198.51.100.2
,则它与帐户主机值为198.51.100.2
但不匹配198.051.100.2
的值匹配。类似地,它与198.51.100.%
但不匹配198.051.100.%
这样的帐户主机模式匹配。
为了避免此类问题,建议检查 DNS 返回主机名和地址的格式。在 MySQL 帐户名称中使用相同格式的值。