要显示分配给模式变量的值，请发出：

MySQL的-JS> db

如果架构值不是Schema:world_x，则db通过发出以下命令设置变量：

MySQL的-JS> \use world_x

要在现有模式中创建新集合，请使用该 db对象的 createCollection()方法。以下示例创建flags 在world_x数据库中调用的集合。

MySQL的-JS> db.createCollection("flags")

该方法返回一个集合对象。

<收集：标志>

要显示world_x 数据库中的所有集合，请使用db对象的 getCollections()方法。您当前连接的服务器返回的集合显示在括号中。

MySQL的-JS> db.getCollections()
[
    <收集：countryinfo>
    <收集：标志>
]

要从数据库中删除现有集合，请使用该 db对象的 dropCollection()方法。例如，要从world_x 数据库中删除flags集合，请键入：

MySQL的-JS> db.dropCollection("flags")

该dropCollection()方法还在MySQL Shell中用于从数据库中删除关系表。

将以下文档插入countryinfo集合中。由于这是多行内容，请按 两次Enter键以插入文档。

MySQL的-JS> db.countryinfo.add(
 {
    GNP: .6,
    IndepYear: 1967,
    Name: "Sealand",
    demographics: {
        LifeExpectancy: 79,
        Population: 27
    },
    geography: {
        Continent: "Europe",
        Region: "British Islands",
        SurfaceArea: 193
    },
    government: {
        GovernmentForm: "Monarchy",
        HeadOfState: "Michael Bates"
    }
  }
)

该方法返回操作的状态。

每个文件需要所谓的标识符字段 _id。该_id字段的值 在同一集合中的所有文档中必须是唯一的。在MySQL 8.0.11及更高版本中，文档ID由服务器而不是客户端生成，因此MySQL Shell不会自动设置 _id值。_id如果文档不包含该_id字段，则8.0.11或更高版本的MySQL服务器会设置一个值。在早期8.0版本或5.7版本的MySQL服务器_id在这种情况下不设置 值，因此您必须明确指定它。如果不这样做，MySQL Shell将返回错误5115 Document缺少必填字段。

要返回集合中的所有文档，请使用该 find()方法而不指定搜索条件。例如，以下操作将返回countryinfo集合中的所有文档。

MySQL的-JS> db.countryinfo.find()
[
     {
          “GNP”：828，
          “IndepYear”：null，
          “名称”：“阿鲁巴”，
          “_id”：“ABW”，
          “人口统计资料”：{
              “LifeExpectancy”：78.4000015258789，
              “人口”：103000
          }，
          “地理”：{
              “大陆”：“北美”，
              “地区”：“加勒比”，
              “SurfaceArea”：193
          }，
          “政府”： {
              “政府表格”：“荷兰非都会领土”，
              “HeadOfState”：“Beatrix”
          }
          ...
      }
 ]
240套文件（0.00秒）

除了集合中的所有文档之外，该方法还生成包含操作信息的结果。

空集（无匹配文档）返回以下信息：

空集（0.00秒） 

您可以使用该find()方法包含搜索条件 。形成搜索条件的表达式的语法与传统MySQL 第12章，函数和运算符的语法相同。您必须将所有表达式括在引号中。

本节中的所有示例都使用world_x数据库中的countryinfo集合。为简洁起见，一些示例不显示输出。

简单的搜索条件可以包括 Name字段和我们知道的文档中的值。以下示例返回单个文档：

MySQL的-JS> db.countryinfo.find("Name = 'Australia'")
[
    {
        “GNP”：351182，
        “IndepYear”：1901年，
        “名称”：“澳大利亚”，
        “_id”：“AUS”，
        “人口统计资料”：{
            “LifeExpectancy”：79.80000305175781，
            “人口”：18886000
        }，
        “地理”：{
            “大陆”：“大洋洲”，
            “地区”：“澳大利亚和新西兰”，
            “SurfaceArea”：7741220
        }，
        “政府”： {
            “政府形式”：“君主立宪制，联邦”，
            “HeadOfState”：“伊丽莎白二世”
        }
    }
]

以下示例搜索GNP高于5000亿美元的所有国家/地区。countryinfo集合以百万为单位测量GNP。

mysql-js> db.countryinfo.find("GNP > 500000")
... [ 输出已删除 ]
10套文件（0.00秒）

以下查询中的“人口”字段嵌入在人口统计信息对象中。要访问嵌入字段，请使用人口统计信息和人口统计之间的时间段来确定关系。文档和字段名称区分大小写。

mysql-js> db.countryinfo.find("GNP > 500000 and demographics.Population < 100000000")
... [ 输出已删除 ]
6套文件（0.00秒）

以下表达式中的算术运算符用于查询人均GNP高于$ 30000的国家/地区。搜索条件可以包括算术运算符和大多数MySQL函数。

mysql-js> db.countryinfo.find("GNP*1000000/demographics.Population > 30000")
... [ 输出已删除 ]
9套文件，7条警告（0.00秒）
警告（代码1365）：除以0
警告（代码1365）：除以0
警告（代码1365）：除以0
警告（代码1365）：除以0
警告（代码1365）：除以0
警告（代码1365）：除以0
警告（代码1365）：除以0

您可以使用该bind()方法将值与搜索条件分开。例如，不是将硬编码的国家/地区名称指定为条件，而是替换命名的占位符，该占位符由冒号后跟以字母开头的名称组成，例如 country。然后使用 如下方法： bind(placeholder, value)

MySQL的-JS> db.countryinfo.find("Name = :country").bind("country", "Italy")
[
    {
        “GNP”：1161755，
        “IndepYear”：1861年，
        “名称”：“意大利”，
        “_id”：“ITA”，
        “人口统计资料”：{
            “LifeExpectancy”：79，
            “人口”：57680000
        }，
        “地理”：{
            “大陆”：“欧洲”，
            “地区”：“南欧”，
            “SurfaceArea”：301316
        }，
        “政府”： {
            “政府表格”：“共和国”，
            “HeadOfState”：“Carlo Azeglio Ciampi”
        }
    }
]
1套文件（0.01秒）

您可以使用占位符和bind() 方法创建已保存的搜索，然后可以使用不同的值调用这些搜索。例如，为国家/地区创建已保存的搜索：

mysql-js> var myFind = db.countryinfo.find("Name = :country")
mysql-js>myFind.bind('country', 'France')
[
    {
        “GNP”：1424285，
        “IndepYear”：843，
        “名字”：“法国”，
        “_id”：“FRA”，
        “人口统计资料”：{
            “LifeExpectancy”：78.80000305175781，
            “人口”：59225700
        }，
        “地理”：{
            “大陆”：“欧洲”，
            “地区”：“西欧”，
            “SurfaceArea”：551500
        }，
        “政府”： {
            “政府表格”：“共和国”，
            “HeadOfState”：“Jacques Chirac”
        }
    }
]
1套文件（0.0028秒）

MySQL的-JS> myFind.bind('country', 'Germany')
[
    {
        “GNP”：2133367， 
        “IndepYear”：1955年， 
        “名字”：“德国”， 
        “_id”：“DEU”， 
        “人口统计资料”：{
            “LifeExpectancy”：77.4000015258789， 
            “人口”：82164700
        }， 
        “地理”：{
            “大陆”：“欧洲”， 
            “地区”：“西欧”， 
            “SurfaceArea”：357022
        }， 
        “政府”： {
            “政府表格”：“联邦共和国”， 
            “HeadOfState”：“Johannes Rau”
        }
    }
]
1套文件（0.0026秒）

您可以返回文档的特定字段，而不是返回所有字段。以下示例返回countryinfo集合中与搜索条件匹配的所有文档的GNP和Name字段。

使用该fields()方法传递要返回的字段列表。

MySQL的-JS> db.countryinfo.find("GNP > 5000000").fields(["GNP", "Name"])
[
    {
        “GNP”：8510700，
        “名字”：“美国”
    }
]
1套文件（0.00秒）
 

此外，您可以使用描述要返回的文档的表达式更改返回的文档 - 添加，重命名，嵌套甚至计算新字段值。例如，使用以下表达式更改字段的名称以仅返回两个文档。

MySQL的-JS> db.countryinfo.find().
fields(mysqlx.expr('{"Name": upper(Name), "GNPPerCapita": GNP*1000000/demographics.Population}')).
limit(2)
[
    {
        “GNPPerCapita”：8038.834951456311，
        “名字”：“ARUBA”
    }，
    {
        “GNPPerCapita”：263.0281690140845，
        “名字”：“阿富汗”
    }
]
2套文件（0.00秒）

您可以应用limit()， sort()和skip() 方法来管理由返回文档的数量和顺序find()的方法。

要指定结果集中包含的文档数，请将limit()方法附加值附加到find()方法中。以下查询返回countryinfo集合中的前五个文档。

mysql-js> db.countryinfo.find().limit(5)
... [ 输出已删除 ]
5套文件（0.00秒）

要指定结果的顺序，请将sort()方法附加 到 find()方法。将sort()一个或多个字段的列表传递给方法，以便根据 需要进行排序，并可选择地使用descending（desc）或ascending（asc）属性。升序是默认订单类型。

例如，以下查询按IndepYear字段对所有文档进行排序，然后按降序返回前八个文档。

mysql-js> db.countryinfo.find().sort(["IndepYear desc"]).limit(8)
... [ 输出已删除 ]
8套文件（0.00秒）

默认情况下，该limit()方法从集合中的第一个文档开始。您可以使用该 skip()方法更改起始文档。例如，要忽略第一个文档并返回与条件匹配的下八个文档，请将skip()值传递给 方法1。

mysql-js> db.countryinfo.find().sort(["IndepYear desc"]).limit(8).skip(1)
... [ 输出已删除 ]
8套文件（0.00秒）

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

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

MySQL的-JS> db.countryinfo.modify("_id = 'SEA'").\
set("demographics", {LifeExpectancy: 78, Population: 28})
查询OK，1项受影响（0.04秒）

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

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

MySQL的-JS> db.countryinfo.modify("Name = 'Sealand'").unset("GNP")
查询OK，1项受影响（0.01秒）   

使用该find()方法验证更改。

MySQL的-JS> db.countryinfo.find("Name = 'Sealand'")
[
    {
        “IndepYear”：1967年，
        “名字”：“西兰”，
        “_id”：“SEA”，
        “人口统计资料”：{
            “LifeExpectancy”：78，
            “人口”：28
        }，
        “地理”：{
            “大陆”：“欧洲”，
            “地区”：“英属群岛”，
            “SurfaceArea”：193
        }，
        “政府”： {
            “政府形式”：“君主制”，
            “HeadOfState”：“Michael Bates”
        }
    }
]
1套文件（0.00秒）

在数组中的元素附加到阵列字段，或插入，或删除单元，使用 arrayAppend()， arrayInsert()或 arrayDelete()方法。以下示例修改countryinfo集合以启用对国际机场的跟踪。

第一个示例使用modify()和 set()方法在所有文档中创建新的Airports字段。

MySQL的-JS> db.countryinfo.modify("true").set("Airports", [])
查询OK，受影响的240件（0.07秒）

添加机场字段后，下一个示例使用该 arrayAppend()方法将新机场添加到其中一个文档。以下示例中的$ .Airports表示当前文档的Airports字段。

MySQL的-JS> db.countryinfo.modify("Name = 'France'").arrayAppend("$.Airports", "ORY")
查询OK，1项受影响（0.02秒）

使用db.countryinfo.find("Name = 'France'")查看更改。

要在数组中的不同位置插入元素，请使用该arrayInsert()方法指定要在路径表达式中插入的索引。在这种情况下，索引是0，或者是数组中的第一个元素。

MySQL的-JS> db.countryinfo.modify("Name = 'France'").arrayInsert("$.Airports[0]", "CDG")
查询OK，1项受影响（0.04秒）

要从数组中删除元素，必须将要删除的元素arrayDelete()的索引传递给 方法。

MySQL的-JS> db.countryinfo.modify("Name = 'France'").arrayDelete("$.Airports[1]")
查询OK，1项受影响（0.03秒）

下面的示例将搜索条件传递给 remove()方法。符合条件的所有文档都将从countryinfo集合中删除。在此示例中，一个文档与条件匹配。

MySQL的-JS> db.countryinfo.remove("_id = 'SEA'")
查询OK，1项受影响（0.02秒）

要删除countryinfo集合中的第一个文档，请使用limit()值为1 的方法。

MySQL的-JS> db.countryinfo.remove("true").limit(1)
查询OK，1项受影响（0.03秒）

以下示例按国家/地区名称删除countryinfo集合中的最后一个文档。

MySQL的-JS> db.countryinfo.remove("true").sort(["Name desc"]).limit(1)
查询OK，1项受影响（0.02秒）

您可以删除集合中的所有文档。为此，请使用该remove("true")方法而不指定任何搜索条件。

要创建非唯一索引，请将createIndex()方法名称传递给 方法。禁止复制索引名称。

在以下示例中，方法的第一个参数 field()指定人口统计信息对象内的人口字段，下一个参数指示该字段应编入索引为整数数值。最后一个参数指示字段是否应该要求NOT NULL约束。如果值为 false，则该字段可以包含 NULL值。

MySQL的-JS> db.countryinfo.createIndex("pop").
field("demographics.Population", "INTEGER", false).execute()
查询正常（0.04秒）

要创建唯一索引，请将createIndex()方法名称和mysqlx.IndexType.UNIQUE类型传递给 方法 。Country "Name"是countryinfo集合中索引的另一个常见字段。在以下示例中， "Text(40)"表示要索引的字符数，并true指示该字段不能包含任何NULL值。

MySQL的-JS> db.countryinfo.createIndex("name", mysqlx.IndexType.UNIQUE).
field("Name", "TEXT(40)", true).execute()
查询正常（0.04秒）

要删除索引，请将要删除的索引dropIndex() 的名称传递给方法。例如，您可以删除“ pop ”索引，如下所示：

MySQL的-JS> db.countryinfo.dropIndex("pop").execute()
查询正常（0.58秒）

要插入完整记录，请将insert()表中的所有列传递给 方法。然后将values()表中每列的一个值传递给方法。例如，要将新记录添加到world_x数据库中的城市表，请插入以下记录并按 两次Enter键。

MySQL的-JS> db.city.insert("ID", "Name", "CountryCode", "District", "Info").
values(null, "Olympia", "USA", "Washington", '{"Population": 5000}')
查询OK，1项受影响（0.01秒）

city表有五列：ID，Name，CountryCode，District和Info。每个值必须与其表示的列的数据类型匹配。

以下示例将值插入到city表的ID，Name和CountryCode列中。

MySQL的-JS> db.city.insert("ID", "Name", "CountryCode").
values(null, "Little Falls", "USA").values(null, "Happy Valley", "USA")
查询OK，2项受影响（0.03秒）

使用该insert() 方法指定列时，值的数量必须与列数匹配。在上一个示例中，您必须提供三个值以匹配指定的三个列。

要发出返回现有表中所有记录的查询，请使用该select()方法而不指定搜索条件。以下示例选择world_x数据库中city表中的所有记录 。

MySQL的-JS> db.city.select()
+ ------ + ------------ + ------------- + ------------ +  - ----------------------- +
| ID | 名称| CountryCode | 区| 信息|
+ ------ + ------------ + ------------- + ------------ +  - ----------------------- +
| 1 | 喀布尔| AFG | Kabol | {“人口”：1780000} |
| 2 | 坎大哈| AFG | 坎大哈| {“人口”：237500} |
| 3 | 赫拉特| AFG | 赫拉特| {“人口”：186800} |
...... ...... ......
| 4079 | 拉法| PSE | 拉法| {“人口”：92020} |
+ ------ + ------- ---- + ------------- + ------------ + --- ---------------------- +
4082行（0.01秒）

空集（无匹配记录）返回以下信息：

空集（0.00秒）

要发出返回一组表列的查询，请使用该 select()方法并指定要在方括号之间返回的列。此查询返回city表中的Name和CountryCode列。

MySQL的-JS> db.city.select(["Name", "CountryCode"])
+ ------------------- + ------------- +
| 名称| CountryCode |
+ ------------------- + ------------- +
| 喀布尔| AFG |
| 坎大哈| AFG |
| 赫拉特| AFG |
| Mazar-e-Sharif | AFG |
| Amsterdam | NLD |
......
| 拉法| PSE |
| 奥林匹亚| 美国|
| 小瀑布| 美国|
| 欢乐谷| 美国|
+ ------------------- + ------------- +
4082行（0.00秒）

要发出返回与特定搜索条件匹配的行的查询，请使用该where()方法包含这些条件。例如，以下示例返回以字母Z开头的城市的名称和国家/地区代码。

MySQL的-JS> db.city.select(["Name", "CountryCode"]).where("Name like 'Z%'")
+ ------------------- + ------------- +
| 名称| CountryCode |
+ ------------------- + ------------- +
| 赞斯塔德| NLD |
| Zoetermeer | NLD |
| 兹沃勒| NLD |
| Zenica | BIH |
| Zagazig | EGY |
| 萨拉戈萨| ESP |
| 三宝颜| PHL |
| Zahedan | IRN |
| 赞詹| IRN |
| Zabol | IRN |
| Zama | JPN |
| Zhezqazghan | KAZ |
| 郑州| CHN |
......
| Zeleznogorsk | RUS |
+ ------------------- + ------------- +
59行（0.00秒）

您可以使用该bind()方法将值与搜索条件分开。例如，不是使用“Name ='Z％'”作为条件，而是替换一个命名的占位符，该占位符由冒号后跟一个以字母开头的名称组成，例如name。然后在bind()方法中包含占位符和值， 如下所示：

MySQL的-JS> db.city.select(["Name", "CountryCode"]).
              where("Name like :name").bind("name", "Z%")

要使用AND 运算符发出查询，请在where()方法中的搜索条件之间添加运算符 。

MySQL的-JS> db.city.select(["Name", "CountryCode"]).
               where("Name like 'Z%' and CountryCode = 'CHN'")
+ ---------------- + ------------- +
| 名称| CountryCode |
+ ---------------- + ------------- +
| 郑州| CHN |
| 淄博| CHN |
| 张家口| CHN |
| 株洲| CHN |
| 张江| CHN |
| 自贡| CHN |
| 枣庄| CHN |
......
| 张家港| CHN |
+ ---------------- + ------------- +
22行（0.01秒）

要指定多个条件运算符，可以将搜索条件括在括号中以更改运算符优先级。下面的示例演示的布局AND和 OR运营商。

MySQL的-JS> db.city.select(["Name", "CountryCode"]).
where("Name like 'Z%' and (CountryCode = 'CHN' or CountryCode = 'RUS')")
+ ------------------- + ------------- +
| 名称| CountryCode |
+ ------------------- + ------------- +
| 郑州| CHN |
| 淄博| CHN |
| 张家口| CHN |
| 株洲| CHN |
......
| Zeleznogorsk | RUS |
+ ------------------- + ------------- +
29行（0.01秒）

您可以应用limit()， orderBy()和offSet() 方法来管理由返回的记录的数量和顺序select()的方法。

要指定结果集中包含的记录数，请将limit()方法附加值附加到select()方法中。例如，以下查询返回国家/地区表中的前五个记录。

MySQL的-JS> db.country.select(["Code", "Name"]).limit(5)
+ ------ + ------------- +
| 代码| 名称|
+ ------ + ------------- +
| ABW | 阿鲁巴|
| AFG | 阿富汗|
| AGO | 安哥拉|
| 友邦保险| 安圭拉|
| ALB | 阿尔巴尼亚|
+ ------ + ------------- +
5行（0.00秒）

要指定结果的顺序，请将orderBy()方法附加 到 select()方法。将orderBy()一个或多个列的列表传递给方法以进行排序，并根据需要将descending（desc）或ascending（asc）属性（可选）传递给它 。升序是默认订单类型。

例如，以下查询按名称列对所有记录进行排序，然后按降序返回前三个记录。

MySQL的-JS> db.country.select(["Code", "Name"]).orderBy(["Name desc"]).limit(3)
+ ------ + ------------ +
| 代码| 名称|
+ ------ + ------------ +
| ZWE | 津巴布韦|
| ZMB | 赞比亚|
| YUG | 南斯拉夫|
+ ------ + ------------ +
3组（0.00秒）

默认情况下，该limit()方法从表中的第一个记录开始。您可以使用该 offset()方法更改起始记录。例如，要忽略第一个记录并返回与条件匹配的下三个记录，请将offset()值传递给 方法1。

MySQL的-JS> db.country.select(["Code", "Name"]).orderBy(["Name desc"]).limit(3).offset(1)
+ ------ + ------------ +
| 代码| 名称|
+ ------ + ------------ +
| ZMB | 赞比亚|
| YUG | 南斯拉夫|
| YEM | 也门|
+ ------ + ------------ +
3组（0.00秒）

下面的示例将搜索条件传递给 delete()方法。符合条件的所有记录都将从city表中删除。在此示例中，一条记录与条件匹配。

MySQL的-JS> db.city.delete().where("Name = 'Olympia'")
查询OK，1项受影响（0.01秒）

要删除city表中的第一条记录，请使用limit()值为1 的 方法。

MySQL的-JS> db.city.delete().limit(1)
查询OK，1项受影响（0.02秒）

您可以删除表中的所有记录。为此，请在delete()不指定搜索条件的情况下使用该 方法。

该dropCollection()方法还在MySQL Shell中用于从数据库中删除关系表。例如，要从world_x数据库中删除citytest表 ，请键入：

MySQL的-JS> session.dropCollection("world_x", "citytest")
查询正常（0.04秒）

要显示分配给模式变量的值，请发出：

MySQL的-PY> db

如果架构值不是Schema:world_x，则设置db通过发出以下命令变量：

MySQL的-PY> \use world_x

要在现有模式中创建新集合，请使用该 db对象的 createCollection()方法。以下示例创建flags 在world_x数据库中调用的集合。

MySQL的-PY> db.create_collection("flags")

该方法返回一个集合对象。

<收集：标志>

要显示world_x 数据库中的所有集合，请使用db对象的 get_collections()方法。您当前连接的服务器返回的集合显示在括号中。

MySQL的-PY> db.get_collections()
[
    <Collection:countryinfo>,
    <Collection:flags>
]

要从数据库中删除现有集合，请使用该 db对象的 drop_collection()方法。例如，要从world_x 数据库中删除flags集合，请键入：

MySQL的-PY> session.drop_collection("world_x", "flags")

该drop_collection()方法还在MySQL Shell中用于从数据库中删除关系表。

将以下文档插入countryinfo集合中。由于这是多行内容，请按 两次Enter键以插入文档。

MySQL的-PY> db.countryinfo.add(
 {
    GNP: .6,
    IndepYear: 1967,
    Name: "Sealand",
    demographics: {
        LifeExpectancy: 79,
        Population: 27
    },
    geography: {
        Continent: "Europe",
        Region: "British Islands",
        SurfaceArea: 193
    },
    government: {
        GovernmentForm: "Monarchy",
        HeadOfState: "Michael Bates"
    }
  }
)

该方法返回操作的状态。

每个文件需要所谓的标识符字段 _id。该_id字段的值 在同一集合中的所有文档中必须是唯一的。在MySQL 8.0.11及更高版本中，文档ID由服务器而不是客户端生成，因此MySQL Shell不会自动设置 _id值。_id如果文档不包含该_id字段，则8.0.11或更高版本的MySQL服务器会设置一个值。在早期8.0版本或5.7版本的MySQL服务器_id在这种情况下不设置 值，因此您必须明确指定它。如果不这样做，MySQL Shell将返回错误5115 Document缺少必填字段。

要返回集合中的所有文档，请使用该 find()方法而不指定搜索条件。例如，以下操作将返回countryinfo集合中的所有文档。

MySQL的-PY> db.countryinfo.find()
[
     {
          “GNP”：828，
          “IndepYear”：null，
          “名称”：“阿鲁巴”，
          “_id”：“ABW”，
          “人口统计资料”：{
              “LifeExpectancy”：78.4000015258789，
              “人口”：103000
          }，
          “地理”：{
              “大陆”：“北美”，
              “地区”：“加勒比”，
              “SurfaceArea”：193
          }，
          “政府”： {
              “政府表格”：“荷兰非都会领土”，
              “HeadOfState”：“Beatrix”
          }
          ...
      }
 ]
240套文件（0.00秒）

除了集合中的所有文档之外，该方法还生成包含操作信息的结果。

空集（无匹配文档）返回以下信息：

空集（0.00秒） 

您可以使用该find()方法包含搜索条件 。形成搜索条件的表达式的语法与传统MySQL 第12章，函数和运算符的语法相同。您必须将所有表达式括在引号中。

本节中的所有示例都使用world_x数据库中的countryinfo集合。为简洁起见，一些示例不显示输出。

简单的搜索条件可以包括 Name字段和我们知道的文档中的值。以下示例返回单个文档：

MySQL的-PY> db.countryinfo.find("Name = 'Australia'")
[
    {
        “GNP”：351182，
        “IndepYear”：1901年，
        “名称”：“澳大利亚”，
        “_id”：“AUS”，
        “人口统计资料”：{
            “LifeExpectancy”：79.80000305175781，
            “人口”：18886000
        }，
        “地理”：{
            “大陆”：“大洋洲”，
            “地区”：“澳大利亚和新西兰”，
            “SurfaceArea”：7741220
        }，
        “政府”： {
            “政府形式”：“君主立宪制，联邦”，
            “HeadOfState”：“伊丽莎白二世”
        }
    }
]

以下示例搜索GNP高于5000亿美元的所有国家/地区。countryinfo集合以百万为单位测量GNP。

mysql-py> db.countryinfo.find("GNP > 500000")
... [ 输出已删除 ]
10套文件（0.00秒）

以下查询中的“人口”字段嵌入在人口统计信息对象中。要访问嵌入字段，请使用人口统计信息和人口统计之间的时间段来确定关系。文档和字段名称区分大小写。

mysql-py> db.countryinfo.find("GNP > 500000 and demographics.Population < 100000000")
... [ 输出已删除 ]
6套文件（0.00秒）

以下表达式中的算术运算符用于查询人均GNP高于$ 30000的国家/地区。搜索条件可以包括算术运算符和大多数MySQL函数。

mysql-py> db.countryinfo.find("GNP*1000000/demographics.Population > 30000")
... [ 输出已删除 ]
9套文件，7条警告（0.00秒）
警告（代码1365）：除以0
警告（代码1365）：除以0
警告（代码1365）：除以0
警告（代码1365）：除以0
警告（代码1365）：除以0
警告（代码1365）：除以0
警告（代码1365）：除以0

您可以使用该bind()方法将值与搜索条件分开。例如，不是将硬编码的国家/地区名称指定为条件，而是替换命名的占位符，该占位符由冒号后跟以字母开头的名称组成，例如 country。然后使用 如下方法： bind(placeholder, value)

MySQL的-PY> db.countryinfo.find("Name = :country").bind("country", "Italy")
[
    {
        “GNP”：1161755，
        “IndepYear”：1861年，
        “名称”：“意大利”，
        “_id”：“ITA”，
        “人口统计资料”：{
            “LifeExpectancy”：79，
            “人口”：57680000
        }，
        “地理”：{
            “大陆”：“欧洲”，
            “地区”：“南欧”，
            “SurfaceArea”：301316
        }，
        “政府”： {
            “政府表格”：“共和国”，
            “HeadOfState”：“Carlo Azeglio Ciampi”
        }
    }
]
1套文件（0.01秒）

您可以使用占位符和bind() 方法创建已保存的搜索，然后可以使用不同的值调用这些搜索。例如，为国家/地区创建已保存的搜索：

mysql-py> myFind = db.countryinfo.find("Name = :country")
mysql-py>myFind.bind('country', 'France')
[
    {
        “GNP”：1424285，
        “IndepYear”：843，
        “名字”：“法国”，
        “_id”：“FRA”，
        “人口统计资料”：{
            “LifeExpectancy”：78.80000305175781，
            “人口”：59225700
        }，
        “地理”：{
            “大陆”：“欧洲”，
            “地区”：“西欧”，
            “SurfaceArea”：551500
        }，
        “政府”： {
            “政府表格”：“共和国”，
            “HeadOfState”：“Jacques Chirac”
        }
    }
]
1套文件（0.0028秒）

MySQL的-PY> myFind.bind('country', 'Germany')
[
    {
        “GNP”：2133367， 
        “IndepYear”：1955年， 
        “名字”：“德国”， 
        “_id”：“DEU”， 
        “人口统计资料”：{
            “LifeExpectancy”：77.4000015258789， 
            “人口”：82164700
        }， 
        “地理”：{
            “大陆”：“欧洲”， 
            “地区”：“西欧”， 
            “SurfaceArea”：357022
        }， 
        “政府”： {
            “政府表格”：“联邦共和国”， 
            “HeadOfState”：“Johannes Rau”
        }
    }
]
1套文件（0.0026秒）

您可以返回文档的特定字段，而不是返回所有字段。以下示例返回countryinfo集合中与搜索条件匹配的所有文档的GNP和Name字段。

使用该fields()方法传递要返回的字段列表。

MySQL的-PY> db.countryinfo.find("GNP > 5000000").fields(["GNP", "Name"])
[
    {
        “GNP”：8510700，
        “名字”：“美国”
    }
]
1套文件（0.00秒）
 

此外，您可以使用描述要返回的文档的表达式更改返回的文档 - 添加，重命名，嵌套甚至计算新字段值。例如，使用以下表达式更改字段的名称以仅返回两个文档。

MySQL的-PY> db.countryinfo.find().\
fields(mysqlx.expr('{"Name": upper(Name), "GNPPerCapita": GNP*1000000/demographics.Population}')).\
limit(2)
[
    {
        “GNPPerCapita”：8038.834951456311，
        “名字”：“ARUBA”
    }，
    {
        “GNPPerCapita”：263.0281690140845，
        “名字”：“阿富汗”
    }
]
2套文件（0.00秒）

您可以应用limit()， sort()和skip() 方法来管理由返回文档的数量和顺序find()的方法。

要指定结果集中包含的文档数，请将limit()方法附加值附加到find()方法中。以下查询返回countryinfo集合中的前五个文档。

mysql-py> db.countryinfo.find().limit(5)
... [ 输出已删除 ]
5套文件（0.00秒）

要指定结果的顺序，请将sort()方法附加 到 find()方法。将sort()一个或多个字段的列表传递给方法，以便根据 需要进行排序，并可选择地使用descending（desc）或ascending（asc）属性。升序是默认订单类型。

例如，以下查询按IndepYear字段对所有文档进行排序，然后按降序返回前八个文档。

mysql-py> db.countryinfo.find().sort(["IndepYear desc"]).limit(8)
... [ 输出已删除 ]
8套文件（0.00秒）

默认情况下，该limit()方法从集合中的第一个文档开始。您可以使用该 skip()方法更改起始文档。例如，要忽略第一个文档并返回与条件匹配的下八个文档，请将skip()值传递给 方法1。

mysql-py> db.countryinfo.find().sort(["IndepYear desc"]).limit(8).skip(1)
... [ 输出已删除 ]
8套文件（0.00秒）

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

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

MySQL的-PY> db.countryinfo.modify("_id = 'SEA'").\
set("demographics", {"LifeExpectancy": 78, "Population": 28})
查询OK，1项受影响（0.04秒）

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

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

MySQL的-PY> db.countryinfo.modify("Name = 'Sealand'").unset("GNP")
查询OK，1项受影响（0.01秒）   

使用该find()方法验证更改。

MySQL的-PY> db.countryinfo.find("Name = 'Sealand'")
[
    {
        “IndepYear”：1967年，
        “名字”：“西兰”，
        “_id”：“SEA”，
        “人口统计资料”：{
            “LifeExpectancy”：78，
            “人口”：28
        }，
        “地理”：{
            “大陆”：“欧洲”，
            “地区”：“英属群岛”，
            “SurfaceArea”：193
        }，
        “政府”： {
            “政府形式”：“君主制”，
            “HeadOfState”：“Michael Bates”
        }
    }
]
1套文件（0.00秒）

在数组中的元素附加到阵列字段，或插入，或删除单元，使用 array_append()， array_insert()或 array_delete()方法。以下示例修改countryinfo集合以启用对国际机场的跟踪。

第一个示例使用modify()和 set()方法在所有文档中创建新的Airports字段。

MySQL的-PY> db.countryinfo.modify(True).set("Airports", [])
查询OK，受影响的240件（0.07秒）

添加机场字段后，下一个示例使用该 array_append()方法将新机场添加到其中一个文档。以下示例中的$ .Airports表示当前文档的Airports字段。

MySQL的-PY> db.countryinfo.modify("Name = 'France'").array_append("$.Airports", "ORY")
查询OK，1项受影响（0.02秒）

使用db.countryinfo.find("Name = 'France'")查看更改。

要在数组中的不同位置插入元素，请使用该array_insert()方法指定要在路径表达式中插入的索引。在这种情况下，索引是0，或者是数组中的第一个元素。

MySQL的-PY> db.countryinfo.modify("Name = 'France'").array_insert("$.Airports[0]", "CDG")
查询OK，1项受影响（0.04秒）

要从数组中删除元素，必须将要删除的元素array_delete()的索引传递给 方法。

MySQL的-PY> db.countryinfo.modify("Name = 'France'").array_delete("$.Airports[1]")
查询OK，1项受影响（0.03秒）

下面的示例将搜索条件传递给 remove()方法。符合条件的所有文档都将从countryinfo集合中删除。在此示例中，一个文档与条件匹配。

MySQL的-PY> db.countryinfo.remove("_id = 'SEA'")
查询OK，1项受影响（0.02秒）

要删除countryinfo集合中的第一个文档，请使用limit()值为1 的方法。

MySQL的-PY> db.countryinfo.remove(True).limit(1)
查询OK，1项受影响（0.03秒）

以下示例按国家/地区名称删除countryinfo集合中的最后一个文档。

MySQL的-PY> db.countryinfo.remove(True).sort(["Name desc"]).limit(1)
查询OK，1项受影响（0.02秒）

您可以删除集合中的所有文档。为此，请在remove(True)不指定搜索条件的情况下使用该方法。

要创建非唯一索引，请将create_index()方法名称传递给 方法。禁止复制索引名称。

在以下示例中，方法的第一个参数 field()指定人口统计信息对象内的人口字段，下一个参数指示该字段应编入索引为整数数值。最后一个参数指示字段是否应该要求NOT NULL约束。如果值为 False，则该字段可以包含 NULL值。

MySQL的-JS> db.countryinfo.create_index("pop").\
field("demographics.Population", "INTEGER", False).execute()
查询正常（0.04秒）

要创建唯一索引，请将create_index()方法名称和mysqlx.IndexType.UNIQUE类型传递给 方法 。Country "Name"是countryinfo集合中索引的另一个常见字段。在以下示例中， "Text(40)"表示要索引的字符数，并True指示该字段不能包含任何NULL值。

MySQL的-JS> db.countryinfo.create_index("name", mysqlx.IndexType.UNIQUE).\
field("Name", "TEXT(40)", True).execute()
查询正常（0.04秒）

要删除索引，请将要删除的索引drop_index() 的名称传递给方法。例如，您可以删除“ pop ”索引，如下所示：

MySQL的-JS> db.countryinfo.drop_index("pop").execute()
查询正常（0.58秒）

要插入完整记录，请将insert()表中的所有列传递给 方法。然后将values()每列的方法传递给方法一个值。例如，要将新记录添加到world_x数据库中的城市表，请插入以下记录并按两次Enter键。

MySQL的-PY> db.city.insert("ID", "Name", "CountryCode", "District", "Info").\
values(None, "Olympia", "USA", "Washington", '{"Population": 5000}')
查询OK，1项受影响（0.01秒）

city表有五列：ID，Name，CountryCode，District和Info。每个值必须与其表示的列的数据类型匹配。

以下示例将值插入到city表的ID，Name和CountryCode列中。

MySQL的-PY> db.city.insert("ID", "Name", "CountryCode").\
values(None, "Little Falls", "USA").values(None, "Happy Valley", "USA")
查询OK，2项受影响（0.03秒）

使用该insert() 方法指定列时，值的数量必须与列数匹配。在上一个示例中，您必须提供三个值以匹配指定的三个列。