本节描述如何使用命令行选项来指定如何建立与 MySQL 服务器的连接,对于客户端程序如 mysql 或 mysqldump。有关使用 URI 类连接字符串或键值对建立连接的信息,对于客户端程序如 MySQL Shell,请参阅 第 6.2.5 节,“使用 URI 类字符串或键值对连接到服务器”。如果您无法连接,请参阅 第 8.2.22 节,“排查连接到 MySQL 的问题” 以获取更多信息。
为了使客户端程序能够连接到 MySQL 服务器,它必须使用正确的连接参数,例如运行服务器的主机名称以及您 MySQL 帐户的用户名和密码。每个连接参数都有一个默认值,但您可以使用在命令行或选项文件中指定的程序选项来覆盖默认值。
此处的示例使用 mysql 客户端程序,但这些原理适用于其他客户端程序,如 mysqldump、mysqladmin 或 mysqlshow。
此命令调用 mysql 而不指定任何显式连接参数
mysql由于没有参数选项,因此应用默认值
默认主机名是
localhost。在 Unix 上,这具有特殊含义,如下所述。默认用户名在 Windows 上是
ODBC,在 Unix 上是您的 Unix 登录名。没有发送密码,因为没有给出
--password或-p。
要显式指定主机名和用户名,以及密码,请在命令行上提供适当的选项。要选择默认数据库,请添加一个数据库名称参数。示例
mysql --host=localhost --user=myname --password=password mydb
mysql -h localhost -u myname -ppassword mydb对于密码选项,密码值是可选的
如果您使用
--password或-p选项并指定密码值,则--password=或-p与其后的密码之间必须 没有空格。如果您使用
--password或-p但没有指定密码值,则客户端程序会提示您输入密码。在您输入密码时,密码不会显示。这比在命令行上给出密码更安全,因为命令行可能会让系统上的其他用户通过执行诸如 ps 之类的命令来查看密码行。请参阅 第 8.1.2.1 节,“密码安全的最终用户指南”。要显式指定没有密码,并且客户端程序不应提示输入密码,请使用
--skip-password选项。
如上所述,在命令行上包含密码值存在安全风险。为了避免这种风险,请指定 --password 或 -p 选项,后面不带任何密码值
mysql --host=localhost --user=myname --password mydb
mysql -h localhost -u myname -p mydb当给出 --password 或 -p 选项而不带任何密码值时,客户端程序会打印提示并等待您输入密码。(在这些示例中,mydb 不被 解释为密码,因为它与前面的密码选项之间有空格。)
在某些系统上,MySQL 用来提示输入密码的库例程会自动将密码限制为八个字符。该限制是系统库的属性,而不是 MySQL 的属性。在内部,MySQL 不会对密码的长度有任何限制。为了解决受此限制影响的系统上的限制,请在选项文件中指定您的密码(请参阅 第 6.2.2.2 节,“使用选项文件”)。另一个解决方法是将您的 MySQL 密码更改为长度不超过八个字符的值,但这样做有一个缺点,即更短的密码往往不太安全。
客户端程序确定要建立何种类型的连接,如下所示
如果主机未指定或为
localhost,则连接到本地主机在 Windows 上,如果服务器在启动时启用了
shared_memory系统变量以支持共享内存连接,则客户端使用共享内存连接。在 Unix 上,MySQL 程序对主机名
localhost进行特殊处理,这与您对其他基于网络的程序的期望可能不同:客户端使用 Unix 套接字文件连接。可以使用--socket选项或MYSQL_UNIX_PORT环境变量来指定套接字名称。
在 Windows 上,如果
host为.(句点),或者 TCP/IP 未启用且未指定--socket选项或主机为空,则客户端将使用命名管道连接,前提是服务器在启动时启用了named_pipe系统变量来支持命名管道连接。如果命名管道连接不受支持或进行连接的用户不是由named_pipe_full_access_group系统变量指定的 Windows 组的成员,则会发生错误。否则,连接将使用 TCP/IP。
--protocol 选项使您可以使用特定传输协议,即使其他选项通常会导致使用其他协议。也就是说,--protocol 显式指定传输协议,并覆盖前面的规则,即使对于 localhost 也是如此。
仅使用或检查与所选传输协议相关的连接选项。其他连接选项将被忽略。例如,在 Unix 上使用 --host=localhost 时,客户端会尝试使用 Unix 套接字文件连接到本地服务器,即使给出了 --port 或 -P 选项来指定 TCP/IP 端口号。
要确保客户端与本地服务器建立 TCP/IP 连接,请使用 --host 或 -h 来指定主机名值为 127.0.0.1(而不是 localhost),或者本地服务器的 IP 地址或名称。您也可以使用 --protocol=TCP 选项显式指定传输协议,即使对于 localhost 也是如此。示例
mysql --host=127.0.0.1
mysql --protocol=TCP如果服务器配置为接受 IPv6 连接,则客户端可以使用 --host=::1 通过 IPv6 连接到本地服务器。请参见 第 7.1.13 节,“IPv6 支持”。
在 Windows 上,要强制 MySQL 客户端使用命名管道连接,请指定 --pipe 或 --protocol=PIPE 选项,或者将 .(句点)指定为主机名。如果服务器在启动时未启用 named_pipe 系统变量来支持命名管道连接,或者进行连接的用户不是由 named_pipe_full_access_group 系统变量指定的 Windows 组的成员,则会发生错误。如果您不想使用默认管道名称,请使用 --socket 选项来指定管道的名称。
与远程服务器的连接使用 TCP/IP。此命令使用默认端口号 (3306) 连接到在 remote.example.com 上运行的服务器
mysql --host=remote.example.com要显式指定端口号,请使用 --port 或 -P 选项
mysql --host=remote.example.com --port=13306您也可以为与本地服务器的连接指定端口号。但是,如前所述,Unix 上与 localhost 的连接默认使用套接字文件,因此除非您像前面所述那样强制进行 TCP/IP 连接,否则任何指定端口号的选项都会被忽略。
对于此命令,程序在 Unix 上使用套接字文件,--port 选项将被忽略
mysql --port=13306 --host=localhost要使用端口号,请强制进行 TCP/IP 连接。例如,以以下任一方式调用程序
mysql --port=13306 --host=127.0.0.1
mysql --port=13306 --protocol=TCP有关控制客户端程序如何与服务器建立连接的选项的更多信息,请参见 第 6.2.3 节,“与服务器建立连接的命令选项”。
可以指定连接参数,而无需在每次调用客户端程序时在命令行上输入它们
在选项文件的
[client]部分中指定连接参数。文件中的相关部分可能如下所示[client] host=host_name user=user_name password=password有关更多信息,请参见 第 6.2.2.2 节,“使用选项文件”。
可以使用环境变量指定一些连接参数。示例
要指定 mysql 的主机,请使用
MYSQL_HOST。在 Windows 上,要指定 MySQL 用户名,请使用
USER。
有关支持的环境变量的列表,请参见 第 6.9 节,“环境变量”。