本节介绍启动 MySQL Cluster Manager 客户端和连接到 MySQL Cluster Manager 代理。
MySQL Cluster Manager 8.0.31 包含一个命令行客户端
mcm,位于安装
bin
目录中。可以使用下表中显示的任何一个选项调用mcm (有关某些选项的详细说明,
请参阅使用mcm客户端连接到代理):
表 4.3 mcm 选项
长表 | 简写 | 描述 |
---|---|---|
--help |
-? |
显示mcm客户端选项 |
|
|
连接到mcmd时使用的主机 |
|
|
连接代理的用户名 |
|
|
连接代理的密码 |
--port = |
|
连接到mcmd时使用的可选端口 |
--version |
-V |
显示 MySQL Cluster Manager 代理/客户端版本 |
MySQL Cluster Manager 使用的客户端/服务器协议是平台无关的。 您可以在任何可用的平台上使用mcm客户端连接到任何 MySQL Cluster Manager 代理。这意味着,例如,您可以使用 Microsoft Windows 上的mcm客户端连接到在 Linux 主机上运行的 MySQL Cluster Manager 代理。
您还可以使用mysql客户端在mcm本身(甚至mcmd)不可用的平台上运行 MySQL Cluster Manager 客户端会话。有关详细信息,请参阅使用mysql客户端连接到代理。
如果您在启动 MySQL Cluster Manager 客户端会话时遇到问题,因为客户端无法连接,请参阅 无法连接到 [本地] MySQL 服务器,了解可能发生这种情况的某些原因,以及一些可能的解决方案的建议。
要结束客户端会话,请使用exit
or
quit
命令(缩写形式:)
\q
。这些命令都不需要分隔符或终止符。
有关详细信息,请参阅第 5 章,MySQL Cluster Manager 客户端命令。
使用mcm客户端连接到代理。 您可以通过调用mcm(或者,在 Windows 上, 调用mcm.exe) 来连接到 MySQL Cluster Manager 代理 。您可能还需要指定以下一个或多个命令行选项:
--host
=hostname
或-h
[ ]hostname
此选项采用要连接的主机的名称或 IP 地址。默认是(在启动mcm
localhost
客户端会话时可能无法在所有平台上识别, 即使它适用于启动mysql客户端会话)。您应该记住,mcm客户端不执行主机名解析;任何名称解析信息都来自运行客户端的主机上的操作系统。因此,通常最好为此选项使用数字 IP 地址而不是主机名。
--port
=portnumber
或-P
[ ]portnumber
此选项指定供客户端使用的 TCP/IP 端口。这必须与 MySQL Cluster Manager 代理使用的端口相同。如其他地方所述,如果在 MySQL Cluster Manager 代理配置文件(
mcmd.ini
)中未指定代理端口,则 MySQL Cluster Manager 代理默认使用的端口号为 1862,mcm也默认使用该端口号。--user
=username
或-u
[ ]username
该选项指定用于连接到代理的用户名。如果未指定该选项,则使用默认值 “
mcmd
” 。要成功连接,该选项的值必须与您要连接的代理的 mcmd配置选项 指定的值匹配,默认情况下mcmd-user
也是 “mcmd
”。--password
[=password
] 或-p
[password
]该选项指定用于连接到代理程序的密码。 如果未指定该选项,则使用默认值“
super
” 。要成功连接,该选项的值必须与您要连接的代理的mcmd配置选项 指定的值匹配,默认情况下mcmd_password
也是 “super
”。如果您使用短选项形式 (
-p
), 则此选项和密码之间不得留有空格。如果您 在命令行中省略或 选项password
后面的值 , mcm客户端会提示您输入一个。--password
-p
在命令行上指定密码应该被认为是不安全的。最好是在调用客户端时省略密码,然后在出现提示时提供密码,或者将密码放在启动脚本或配置文件中。
mcm接受额外的mysql
客户端选项,其中一些可能对 MySQL Cluster Manager 客户端会话有用。例如,
包含太多行而无法显示在单个屏幕中--pager
选项可能会有所帮助get
该
--prompt
选项可用于提供独特的提示,以帮助避免多个客户端会话之间的混淆。但是,当前手册中未显示的选项尚未使用
mcm进行广泛测试,因此不能保证(甚至根本不能)正常工作。有关
所有mysql客户端选项的完整列表和描述,mysql 客户端选项。
与mysql客户端一样,mcm
也支持\G
作为语句终止符,这会导致输出被垂直格式化。这在使用宽度限制为一定数量(通常为 80 个)字符的终端时很有用。有关示例
,请参阅
第 5 章,MySQL Cluster Manager 客户端命令。
使用mysql客户端连接到代理。 来自任何 MySQL 发行版的mysql客户端在连接到mcmd 时应该没有任何问题 。此外,由于 MySQL Cluster Manager 使用的客户端/服务器协议是平台无关的,因此您可以在 MySQL支持的任何平台上使用mysql客户端。(这意味着,例如,您可以使用 Microsoft Windows 上的 mysql客户端连接到运行在 Linux 主机上的 MySQL Cluster Manager 代理。)使用mysql客户端连接到 MySQL Cluster Manager 代理是通过调用mysql并使用以下命令行选项指定主机名、端口号、用户名和密码:
此选项采用要连接的主机的名称或 IP 地址。默认值为
localhost
。与mcm客户端一样, mysql客户端不执行主机名解析,并且依赖于主机操作系统来完成此任务。因此,通常最好为此选项使用数字 IP 地址而不是主机名。--port
=portnumber
或-P
portnumber
此选项指定供客户端使用的 TCP/IP 端口。这必须与 MySQL Cluster Manager 代理使用的端口相同。虽然 MySQL Cluster Manager 代理使用的默认端口号是 1862( mcm也默认使用),但是这个默认值不为mysql客户端所知,它使用端口 3306(MySQL 服务器的默认端口) ) 如果调用mysql时未指定此选项。
因此,您必须使用
--port
or选项使用mysql-P
客户端 连接到 MySQL Cluster Manager 代理 ,即使代理进程使用 MySQL Cluster Manager 默认端口,即使代理进程与 mysql在同一主机上运行客户。除非在启动时向其提供正确的代理端口号,否则mysql 无法连接到代理。该选项指定用于连接到代理的用户名。默认情况下,mysql客户端尝试在 Unix 系统上使用当前系统用户的名称, 在 Windows 上使用“ ODBC ” ,因此当您尝试使用mysql客户端访问 MySQL Cluster Manager 代理时 ,您必须提供此选项和用户名;否则, mysql无法连接到代理。
要成功连接,该选项的值必须与您要连接的代理 的mcmd配置选项指定的值匹配,默认情况下为“ ”。
--mcmd-user
mcmd
--password
[=password
] 或-p
[password
]该选项指定用于连接到代理程序的密码。如果在调用 mysql时不包含
--password
or 选项,则无法连接到代理。要成功连接,该选项的值必须与您要连接的代理 的mcmd配置选项 指定的值匹配,默认情况下为“ ”。-p
mcmd_password
super
如果您使用短选项形式 (
-p
), 则此选项和密码之间不得留有空格。如果您 在命令行中省略或 选项password
后面的值 , mysql客户端会提示您输入一个。--password
-p
在命令行上指定密码应该被认为是不安全的。最好是在调用客户端时省略密码,然后在出现提示时提供密码,或者将密码放在启动脚本或配置文件中。
此外,您可以使用该
--prompt
选项来设置
mysql客户端的提示。建议这样做,因为允许使用默认提示 ( mysql>
) 可能会导致 MySQL Cluster Manager 客户端会话和 MySQL 客户端会话之间的混淆。
因此,您可以通过以类似于此处显示的方式从系统 shell 调用同一台机器上 的mysql客户端 来连接到 MySQL Cluster Manager 代理 。
$> mysql -h127.0.0.1 -P1862 -umcmd -p --prompt='mcm> '
为方便起见,在mcm本身不可用的系统上,您甚至可能希望将此调用放在启动脚本中。在 Linux 或类似系统上,此脚本可能被命名为mcm-client.sh
,其内容类似于此处显示的内容:
#!/bin/sh
/usr/local/mysql/bin/mysql -h127.0.0.1 -P1862 -umcmd -p --prompt='mcm> '
在这种情况下,您可以在系统 shell 中使用如下内容启动 MySQL Cluster Manager 客户端会话:
$> ./mcm-client
在 Windows 上,您可以创建一个批处理文件,其名称包括
mcm-client.bat
如下内容:
C:\mysql\bin\mysql.exe -umcmd -psuper -h localhost -P 1862 --prompt="mcm> "
(根据需要调整mysql.exe客户端可执行文件的路径以匹配其在系统上的位置。)
如果将此文件保存到方便的位置,例如 Windows 桌面,只需双击桌面上(或 Windows 资源管理器中)的相应文件图标即可启动 MySQL Cluster Manager 客户端会话;客户端会话在新的 cmd.exe (DOS) 窗口中打开。