JavaScript快速入门指南：文档存储的MySQL Shell

该快速入门指南提供了说明，以开始与MySQL Shell交互地对文档存储应用程序进行原型制作。该指南包括以下主题：

MySQL功能，MySQL Shell和world_x示例架构简介。
用于管理集合和文档的操作。
管理关系表的操作。
适用于表中文档的操作。

要遵循此快速入门指南，您需要安装了X插件的MySQL服务器，默认8.0版本的MySQL服务器以及用作客户端的MySQL Shell。MySQL Shell 8.0（MySQL 8.0的一部分）提供了有关MySQL Shell的更深入的信息。使用X DevAPI访问文档存储，并且MySQL Shell在JavaScript和Python中都提供了此API。

MySQL Shell

本快速入门指南假定您对MySQL Shell有所了解。以下部分是高级概述，有关更多信息，请参见MySQL Shell文档。MySQL Shell是MySQL Server的统一脚本接口。它支持JavaScript和Python中的脚本编写。JavaScript是默认处理模式。

启动MySQL Shell

安装并启动MySQL服务器后，将MySQL Shell连接到服务器实例。您需要知道计划连接的MySQL服务器实例的地址。为了能够将该实例用作文档存储，服务器实例必须安装了X插件，并且您应该使用X协议连接到服务器。例如，ds1.example.com使用网络字符串连接到默认X协议端口33060上的实例user@ds1.example.com:33060。

注意

如果使用经典MySQL协议（例如，使用默认值port3306而不是）连接到实例mysqlx_port，则不能使用本教程中显示的文档存储功能。例如，db未填充全局对象。要使用文档存储，请始终使用X协议进行连接。

如果MySQL Shell尚未运行，请打开终端窗口并发出：

mysqlsh user@ds1.example.com:33060/world_x

或者，如果MySQL Shell已经在运行，则\connect通过发出以下命令来使用该命令：

\connect user@ds1.example.com:33060/world_x

您需要指定要将MySQL Shell连接到的MySQL服务器实例的地址。例如，在前面的示例中：

user代表您的MySQL帐户的用户名。
ds1.example.com是运行MySQL的服务器实例的主机名。将其替换为用作文档存储的MySQL服务器实例的主机名。
此会话的默认架构为world_x。有关设置world_x模式的说明，

有关更多信息，请参见“使用类似URI的字符串或键值对连接到服务器”。

MySQL Shell打开后，mysql-js>提示指示此会话的活动语言是JavaScript。

mysql-js>

MySQL Shell支持输入行编辑，如下所示：

左箭头键和右箭头键在当前输入行中水平移动。
上箭头键和下箭头键在一组先前输入的行中上下移动。
Backspace删除光标之前的字符，并键入新字符在光标位置输入它们。
Enter将当前输入行发送到服务器。

获取有关MySQL Shell的帮助

在命令解释器的提示符下键入mysqlsh --help以获得命令行选项列表。

mysqlsh --help

键入\help在MySQL的壳牌提示可用的命令及其说明的列表。

mysql-js> \help

键入，\help后跟命令名称，以获取有关单个MySQL Shell命令的详细帮助。例如，要参见有关该\connect命令的帮助，请发出：

mysql-js> \help \connect

退出MySQL Shell

要退出MySQL Shell，请发出以下命令：

mysql-js> \quit

下载和导入world_x数据库

作为本快速入门指南的一部分，提供了一个示例架构，称为world_x架构。许多示例都使用此模式演示了文档存储功能。启动MySQL服务器，以便您可以加载world_x架构，然后执行以下步骤：

下载 world_x-db.zip。
将安装档案解压缩到一个临时位置，例如/tmp/。解压缩存档会得到一个名为的文件world_x.sql。
将world_x.sql文件导入到您的服务器。您可以：
- 以SQL模式启动MySQL Shell，并通过发出以下命令导入文件：
```
mysqlsh -u root --sql --file /tmp/world_x-db/world_x.sql
Enter password: ****
```
- 在运行时将MySQL Shell设置为SQL模式，并通过发出以下命令来获取模式文件：
```
\sql
Switching to SQL mode... Commands end with ;
\source /tmp/world_x-db/world_x.sql
```
替换/tmp/为world_x.sql系统上文件的路径。如果有提示，请输入密码。可以使用非root用户帐户，只要该帐户具有创建新架构的权限即可。

world_x模式

该world_x示例模式包含以下JSON收集和关系表：

采集
- countryinfo：有关世界各国的信息。
桌子
- country：关于世界各国的最少信息。
- city：有关这些国家/地区中某些城市的信息。
- countrylanguage：每个国家/地区使用的语言。

JavaScript快速入门指南：文档存储的MySQL Shell

相关信息

MySQL Shell

启动MySQL Shell

获取有关MySQL Shell的帮助

退出MySQL Shell

相关信息

下载和导入world_x数据库

world_x模式

相关信息