MySQL Shell 9.0  /  ...  /  在启动 MySQL Shell 时创建会话全局对象

4.2.1 在启动 MySQL Shell 时创建 Session 全局对象

从命令行启动 MySQL Shell 时,可以使用单独的命令选项为每个值指定连接参数,例如用户名、主机和端口。有关以这种方式启动 MySQL Shell 并连接到 MySQL Server 实例的说明和示例,请参阅第 4.3.1 节“使用单个参数连接”。使用此连接方法时,可以添加以下选项之一,以选择在启动时创建的会话对象类型作为 session 全局对象

  • --mysqlx (--mx) 创建一个 Session 对象,该对象使用 X 协议连接到 MySQL Server 实例。

  • --mysql (--mc) 创建一个 ClassicSession 对象,该对象使用经典 MySQL 协议连接到 MySQL Server 实例。

例如,此命令启动 MySQL Shell 并建立到侦听端口 33060 的本地 MySQL Server 实例的 X 协议连接

$> mysqlsh --mysqlx -u user -h localhost -P 33060

如果要在 SQL 模式下启动 MySQL Shell,则 --sqlx--sqlc 选项包括会话对象类型的选择,因此您可以指定其中之一以使 MySQL Shell 将 X 协议或经典 MySQL 协议用于连接。有关所有 mysqlsh 命令行选项的参考,请参阅第 A.1 节“mysqlsh — MySQL Shell”

作为使用单个选项指定连接参数的替代方法,可以使用类似 URI 的连接字符串指定它们。可以从命令行启动 MySQL Shell 时传入此字符串,使用或不使用可选的 --uri 命令行选项。使用此连接方法时,可以在类似 URI 的连接字符串的开头包含 scheme 元素,以选择要创建的会话对象类型。mysqlx 使用 X 协议创建一个 Session 对象,或 mysql 使用经典 MySQL 协议创建一个 ClassicSession 对象。例如,以下任一命令都使用类似 URI 的连接字符串来启动 MySQL Shell 并创建到侦听端口 3306 的本地 MySQL Server 实例的经典 MySQL 协议连接

$> mysqlsh --uri mysql://user@localhost:3306
$> mysqlsh mysql://user@localhost:3306

您也可以将连接协议指定为选项,而不是作为类似 URI 的连接字符串的一部分,例如

$> mysqlsh --mysql --uri user@localhost:3306

有关以这种方式连接到 MySQL Server 实例的说明和示例,请参阅使用类似 URI 的字符串或键值对连接到服务器

您可以省略连接协议,并让 MySQL Shell 根据您的其他连接参数自动检测它。例如,如果您指定端口 33060 并且没有说明连接协议的选项,则 MySQL Shell 将尝试使用 X 协议建立连接。如果您的连接参数未指明协议,则 MySQL Shell 首先尝试使用经典 MySQL 协议建立连接,如果失败,则尝试使用 X 协议建立连接。