文档主页
面向 VS Code 的 MySQL Shell


面向 VS Code 的 MySQL Shell  /  MySQL Shell 控制台  /  连接到 MySQL Shell 会话

公开预览版前:2024-07-17

5.4 连接到 MySQL Shell 会话

以下类型的会话对象可用

  • Session:使用此会话对象类型进行新的应用程序开发,以便与可以使用 X 协议的 MySQL Server 实例进行通信。X 协议提供与 MySQL Server 的最佳集成。为了使 X 协议可用,必须在 MySQL Server 实例上安装并启用 X 插件,默认情况下已启用。X 插件监听 mysqlx_port 指定的端口(默认为 33060),因此使用会话的连接要指定此端口。

  • ClassicSession:使用此会话对象类型与不可用 X 协议的 MySQL Server 实例进行交互。使用此会话对象可以使用经典 MySQL 协议针对服务器运行 SQL。

使用 MySQL Shell 的 \connect 命令或 shell.connect() 方法来启动连接并创建会话全局对象。本节中相关的连接主题包括

使用 X 协议启动 MySQL Shell 会话的最基本语法是

\connect mysqlx://<user>@{<{host name> | <IPv4 address> | <IPv6 address>}:<port>

在本例中,要将用户 demo-user 连接到使用经典会话监听端口 33060 的 MySQL Shell localhost,请键入

\connect mysqlx://demo-user@localhost:33060

使用经典 MySQL 协议启动 MySQL Shell 会话的最基本语法是

\connect mysql://<user>@{<{host name> | <IPv4 address> | <IPv6 address>}:<port>

在本例中,要将用户 demo-user 连接到使用经典会话监听端口 3306 的 MySQL Server localhost,请键入

\connect mysql://demo-user@localhost:3306

\connect(或 \c)命令在活动语言为 SQL、JavaScript 或 Python 时均有效。

Python 和 JavaScript 中可用的 shell.connect() 方法可以在 MySQL Shell 中用作 \connect 命令的替代方法来创建会话全局对象。此连接方法可以使用类似 URI 的连接字符串,其中选定的协议指定为 scheme 元素。shell.connect 方法的基本语法是

shell.connect(<user>@{<{host name> | <IPv4 address> | <IPv6 address>}:<port>)

在本例中,要将用户 demo-user 连接到使用经典会话监听端口 3306 的 MySQL Server localhost,请键入

shell.connect('demo-user@localhost:3306')

shell.connect 方法对 JavaScript 和 Python 均有效。

重要

请务必注意端口号的区别:X 协议的端口为 33060,经典 MySQL 协议的端口为 3306。

例如

  • shell.connect('demo-user@localhost:3306') 将连接到经典 MySQL 协议。

  • shell.connect('demo-user@localhost:33060') 将连接到 X 协议。

有关更多信息,请参见 MySQL Shell 会话

连接参数

启动 MySQL Shell 时,可以使用每个值的单独命令选项(例如用户名、主机和端口)来指定连接参数。

如果未指定连接参数,则使用以下默认值

  • user 默认为当前系统用户名。

  • 使用 X 协议连接时,port 默认为 X 插件端口 33060;使用经典 MySQL 协议连接时,port 默认为端口 3306

必须至少提供 host

您还可以指定要使用的架构

例如,要使用户 demo-user 连接到在 localhost 上运行的 MySQL Server,该服务器使用架构 world 监听经典 MySQL 协议的端口 3306,并使用 \connect 命令,请输入

\connect mysql://demo-user@localhost:3306/world

例如,要使用户 demo-user 连接到在 localhost 上运行的 MySQL Server,该服务器使用架构 world 监听经典 MySQL 协议的端口 3306,并使用 shell.connect 方法,请输入

shell.connect('root@localhost:3306/world')

密码存储

使用首选连接方法后,将打开“在 Shell 会话中打开 MySQL 连接”对话框。

输入密码,然后单击 确定

将打开“请求反馈”对话框,您可以选择保存实例的密码,选项如下

  • Y:是

  • N:否

  • v:从不

默认值为

输入所需的值,然后单击 确定

关闭 MySQL Shell 会话

要关闭并退出 MySQL Shell 会话,请键入

\quit

或者,键入

\q
注意

当活动语言为以下语言时,可以运行这些命令

  • Python:py>

  • JavaScript:js>

  • SQL:sql>

这些命令将关闭 MySQL Shell GUI 控制台会话和选项卡。

您还可以通过单击打开的选项卡上的 X 或使用 Ctrl+F4 来关闭会话选项卡。