MySQL文档存储快速入门指南

• 创建一个新条目（插入或添加）
• 阅读条目（查询）
• 更新条目
• 删除条目

PS：如果你接触过MongoDB，那么文档和集合的概念对你来说就很容易理解了，MongoDB就是一个文档数据库。

3）X插件

使用X协议实现通信的MySQL服务器插件，支持实现X DevAPI的客户端，使您可以使用MySQL存储文档。

4）X协议

与运行X插件的MySQL服务器通信的协议，X协议支持CRUD和SQL操作，通过SASL的身份验证允许命令的流式传输（流水线），并且可以在协议和消息层上扩展。

二、MySQL X插件安装

本节介绍如何安装X插件，使MySQL Server能够使用X协议，并使用MySQL Shell作为服务器的客户端。

使用MySQL作为文档存储的先决条件是实现X协议的X插件。X插件随MySQL一起提供 – 安装它不涉及单独的下载。

将MySQL设置为文档存储，遵循以下步骤：

1）安装MySQL 8或从MySQL 5.7.12或更低版本升级

完成安装或升级后，启动服务器。

注意：MySQL安装程序使您能够同时执行此操作和下一步（安装X插件），以在Microsoft Windows上进行新的安装。在插件和扩展屏幕中，勾选启用X协议/ MySQL作为文档存储复选框。安装完成后，请确认X插件已安装。

2）安装X插件

• 使用MySQL Shell

需要先安装MySQL-shell工具，下面会介绍。

• 使用MySQL客户端

在Linux系统上，只要该MySQL帐户具有安装插件INSERT的特权mysql.plugin表即可。

关于Windows系统自行看官方文档。

3）验证X插件是否已安装

• MySQL Shell命令

• MySQL客户端程序命令

4）mysqlxsys@localhost用户帐号

安装X插件创建一个 mysqlxsys@localhost用户帐户。如果由于某种原因造成用户帐户失败，X插件安装也会失败。这是关于 mysqlxsys@localhost用户帐户是什么以及创建失败时该做什么的说明。

X插件安装过程使用MySQL的root用户为用户创建一个内部帐户 mysqlxsys@localhost。该 mysqlxsys@localhost帐户被X插件用于外部用户对MySQL帐户系统的身份验证，以及在特权用户请求时杀死会话。该mysqlxsys@localhost帐户被创建为已锁定，因此不能用于外部用户登录。如果由于某些原因MySQL的root帐户不可用，在开始X插件安装之前，您必须通过在mysql命令行客户端中发出以下语句来手动创建用户：

5）卸载X插件

如果您想要卸载（停用）X插件，请在mysql命令行客户机中发出以下语句：

此外，卸载插件会删除mysqlxsys用户。

更多关于X插件的使用指南看官方文档：X Plugin

三、MySQL Shell用户指南

• X Session：使用此会话类型进行新的应用程序开发。它提供与MySQL服务器的最佳集成，因此默认情况下使用它。SQL执行不受支持，因此与MySQL Shell的SQL模式不兼容。
• Node Session：在启用X协议的MySQL服务器上使用此会话类型进行SQL执行。SQL执行可用于此会话类型，因此可以在MySQL Shell的SQL模式中使用。只有当直接连接到启用X协议的MySQL服务器时，才能使用该会话类型 。
• Classic Session：使用此会话类型与未启用X协议的MySQL服务器进行交互。SQL执行可用于此会话类型，因此可以在MySQL Shell的SQL模式中使用。可用于此类型会话的开发API非常有限。例如，没有CRUD操作，不支持集合处理，并且不支持绑定。

• 用户默认为当前系统用户名。
• 主机默认为localhost。
• 端口在使用X会话时默认为X插件端口33060，当使用传统会话时默认为端口3306。

• dbuser：指定要用于身份验证过程的MySQL用户帐户。
• dbpassword：指定要用于身份验证过程的dbuser密码。
• host：指定会话对象连接到的主机。如果未指定， 则默认使用localhost。
• port：指定目标MySQL服务器正在侦听连接的端口。如果未指定，则默认情况下，对于启用了X协议的会话使用33060，而3306是传统MySQL协议会话的默认值。
• schema：表示建立会话时要设置为默认的数据库。

如果没有使用URI指定密码（建议使用），则会提示输入密码。

连接X会话（默认）

连接节点会话（端口33060）

连接经典会话

虽然不建议使用无密码帐号，但您可以:在用户名后面指定一个没有密码 的用户，例如：

除了手动指定URI之外，还可以使用存储的会话。

• \connect URI：创建XSession。
• \connect -n URI：创建节点会话。
• \connect -c URI：创建一个经典会话。

使用URI参数配置连接，该参数遵循与--uri 命令行选项相同的语法。例如：

• session 代表全局会话，如果已经建立。
• db 如果已经定义了一个模式，例如通过一个URI定义了一个模式。

• 尝试使用未定义的session全局变量。
• 尝试使用不存在的模式检索 session。
• 尝试使用未定义的db全局变量。

• 通过MySQL Shell命令。
• 通过可用于JavaScript和Python的内置对象。

表和集合

• Collection
  • countryinfo：关于世界各国的信息。

  mysql-sql> desc countryinfo; +-------+-------------+------+-----+---------+------------------+ | Field | Type | Null | Key | Default | Extra | +-------+-------------+------+-----+---------+------------------+ | doc | json | YES | | null | | | _id | varchar(32) | NO | PRI | null | STORED GENERATED | +-------+-------------+------+-----+---------+------------------+ 2 rows in set (0.00 sec)

  1 2 3 4 5 6 7 8

  mysql-sql> desc countryinfo; +-------+-------------+------+-----+---------+------------------+ | Field | Type        | Null | Key | Default | Extra            | +-------+-------------+------+-----+---------+------------------+ | doc   | json        | YES  |     | null    |                  | | _id   | varchar(32) | NO   | PRI | null    | STORED GENERATED | +-------+-------------+------+-----+---------+------------------+ 2 rows in set (0.00 sec)

• Tables
  • country：关于世界各国的基本信息。

  mysql-sql> desc country; +---------+----------+------+-----+---------+-------+ | Field | Type | Null | Key | Default | Extra | +---------+----------+------+-----+---------+-------+ | Code | char(3) | NO | PRI | | | | Name | char(52) | NO | | | | | Capital | int(11) | YES | | null | | | Code2 | char(2) | NO | | | | +---------+----------+------+-----+---------+-------+ 4 rows in set (0.00 sec)

  1 2 3 4 5 6 7 8 9 10

  mysql-sql> desc country; +---------+----------+------+-----+---------+-------+ | Field   | Type     | Null | Key | Default | Extra | +---------+----------+------+-----+---------+-------+ | Code    | char(3)  | NO   | PRI |         |       | | Name    | char(52) | NO   |     |         |       | | Capital | int(11)  | YES  |     | null    |       | | Code2   | char(2)  | NO   |     |         |       | +---------+----------+------+-----+---------+-------+ 4 rows in set (0.00 sec)

  • city：这些国家的一些城市的信息。

  mysql-sql> desc city; +-------------+----------+------+-----+---------+----------------+ | Field | Type | Null | Key | Default | Extra | +-------------+----------+------+-----+---------+----------------+ | ID | int(11) | NO | PRI | null | auto_increment | | Name | char(35) | NO | | | | | CountryCode | char(3) | NO | | | | | District | char(20) | NO | | | | | Info | json | YES | | null | | +-------------+----------+------+-----+---------+----------------+ 5 rows in set (0.00 sec)

  1 2 3 4 5 6 7 8 9 10 11

  mysql-sql> desc city; +-------------+----------+------+-----+---------+----------------+ | Field       | Type     | Null | Key | Default | Extra          | +-------------+----------+------+-----+---------+----------------+ | ID          | int(11)  | NO   | PRI | null    | auto_increment | | Name        | char(35) | NO   |     |         |                | | CountryCode | char(3)  | NO   |     |         |                | | District    | char(20) | NO   |     |         |                | | Info        | json     | YES  |     | null    |                | +-------------+----------+------+-----+---------+----------------+ 5 rows in set (0.00 sec)

  • countrylanguage：每个国家使用的语言。

  mysql-sql> desc countrylanguage; +-------------+---------------+------+-----+---------+-------+ | Field | Type | Null | Key | Default | Extra | +-------------+---------------+------+-----+---------+-------+ | CountryCode | char(3) | NO | PRI | | | | Language | char(30) | NO | PRI | | | | IsOfficial | enum('T','F') | NO | | F | | | Percentage | float(4,1) | NO | | 0.0 | | +-------------+---------------+------+-----+---------+-------+ 4 rows in set (0.00 sec)

  1 2 3 4 5 6 7 8 9 10

  mysql-sql> desc countrylanguage; +-------------+---------------+------+-----+---------+-------+ | Field       | Type          | Null | Key | Default | Extra | +-------------+---------------+------+-----+---------+-------+ | CountryCode | char(3)       | NO   | PRI |         |       | | Language    | char(30)      | NO   | PRI |         |       | | IsOfficial  | enum('T','F') | NO   |     | F       |       | | Percentage  | float(4,1)    | NO   |     | 0.0     |       | +-------------+---------------+------+-----+---------+-------+ 4 rows in set (0.00 sec)

• root代表您的MySQL帐户的用户名。
• MySQL Shell提示您输入密码。
• 此会话的默认模式是world_x数据库。
• 该mysql-js>提示表示此会话的活动语言是JavaScript。

• 数字（整数和浮点数）
• 字符串
• 布尔值（false和true）
• 空值
• 数组或更多的JSON值
• 嵌套（或嵌入）更多JSON值的对象

• 在文档中设置和取消设置字段。
• 追加，插入和删除数组。
• 绑定，限制和排序要修改的文档。

该modify()方法通过过滤集合以仅包括要修改的文档，然后将您指定的操作应用于这些文档。

在以下示例中，该modify() 方法使用搜索条件来标识要更改的文档，然后该set()方法将替换嵌套的人口统计对象中的两个值。

修改文档后，使用该find()方法验证更改。

要从文档中删除内容，请使用 modify()和unset() 方法。例如，以下查询从符合搜索条件的文档中删除GNP。