MySQL Cluster Manager 8.0.31 用户手册  / 第 4 章使用 MySQL 集群管理器  /  4.3 启动MySQL Cluster Manager客户端

4.3 启动MySQL Cluster Manager客户端

本节介绍启动 MySQL Cluster Manager 客户端和连接到 MySQL Cluster Manager 代理。

MySQL Cluster Manager 8.0.31 包含一个命令行客户端 mcm,位于安装 bin目录中。可以使用下表中显示的任何一个选项调用mcm (有关某些选项的详细说明, 请参阅使用mcm客户端连接到代理):

表 4.3 mcm 选项

长表 简写 描述
--help -? 显示mcm客户端选项
--host=<hostname> -h <hostname> 连接到mcmd时使用的主机
--user=<username> -u <username> 连接代理的用户名
--password[=<password>] -p[<password>] 连接代理的密码
--port=<portnum> -P <portnum> 连接到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 服务器,了解可能发生这种情况的某些原因,以及一些可能的解决方案的建议。

要结束客户端会话,请使用exitor quit命令(缩写形式:) \q。这些命令都不需要分隔符或终止符。

有关详细信息,请参阅第 5 章,MySQL Cluster Manager 客户端命令

使用mcm客户端连接到代理。  您可以通过调用mcm(或者,在 Windows 上, 调用mcm.exe) 来连接到 MySQL Cluster Manager 代理 。您可能还需要指定以下一个或多个命令行选项:

  • --host=hostname-h[ ]hostname

    此选项采用要连接的主机的名称或 IP 地址。默认是(在启动mcmlocalhost客户端会话时可能无法在所有平台上识别, 即使它适用于启动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并使用以下命令行选项指定主机名、端口号、用户名和密码:

  • --host=hostname-h hostname

    此选项采用要连接的主机的名称或 IP 地址。默认值为localhost。与mcm客户端一样, mysql客户端不执行主机名解析,并且依赖于主机操作系统来完成此任务。因此,通常最好为此选项使用数字 IP 地址而不是主机名。

  • --port=portnumber-P portnumber

    此选项指定供客户端使用的 TCP/IP 端口。这必须与 MySQL Cluster Manager 代理使用的端口相同。虽然 MySQL Cluster Manager 代理使用的默认端口号是 1862( mcm也默认使用),但是这个默认值不为mysql客户端所知,它使用端口 3306(MySQL 服务器的默认端口) ) 如果调用mysql时未指定此选项。

    因此,您必须使用 --portor选项使用mysql-P客户端 连接到 MySQL Cluster Manager 代理 ,即使代理进程使用 MySQL Cluster Manager 默认端口,即使代理进程与 mysql在同一主机上运行客户。除非在启动时向其提供正确的代理端口号,否则mysql 无法连接到代理。

  • --user=username-u username

    该选项指定用于连接到代理的用户名。默认情况下,mysql客户端尝试在 Unix 系统上使用当前系统用户的名称, 在 Windows 上使用ODBC ” ,因此当您尝试使用mysql客户端访问 MySQL Cluster Manager 代理时 ,您必须提供此选项和用户名;否则, mysql无法连接到代理。

    要成功连接,该选项的值必须与您要连接的代理 的mcmd配置选项指定的值匹配,默认情况下为--mcmd-usermcmd

  • --password[= password] 或 -p[ password]

    该选项指定用于连接到代理程序的密码。如果在调用 mysql时不包含 --passwordor 选项,则无法连接到代理。要成功连接,该选项的值必须与您要连接的代理 的mcmd配置选项 指定的值匹配,默认情况下为-pmcmd_passwordsuper

    如果您使用短选项形式 ( -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) 窗口中打开。