文件首頁
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

無論使用 SQL、JavaScript 或 Python 作為作用中的語言,\connect (或 \c) 命令都有效。

shell.connect() 方法適用於 Python 和 JavaScript,可用於 MySQL Shell 中,作為 \connect 命令的替代方案來建立工作階段全域物件。此連線方法可以使用類似 URI 的連線字串,其中選取的通訊協定指定為配置元素。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 預設為目前的系統使用者名稱。

  • port 在使用 X 通訊協定連線時,預設為 X 外掛程式連接埠 33060,而在使用傳統 MySQL 通訊協定連線時,預設為連接埠 3306

您必須至少提供 host

您也可以指定要使用的結構描述

例如,若要讓使用者 demo-user 連線至在 localhost 上執行、接聽連接埠 3306 以供傳統 MySQL 通訊協定使用、使用結構描述 world 的 MySQL Server,並使用 \connect 命令,請輸入

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

例如,若要讓使用者 demo-user 連線至在 localhost 上執行、接聽連接埠 3306 以供傳統 MySQL 通訊協定使用、使用結構描述 world 的 MySQL Server,並使用 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 來關閉工作階段索引標籤。