文档首页
MySQL 8.4 参考手册
相关文档 下载本手册
PDF (美国信纸) - 39.9Mb
PDF (A4) - 40.0Mb
手册页 (TGZ) - 258.5Kb
手册页 (Zip) - 365.5Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


22.4.3.4 修改文档

您可以使用 modify() 方法更新集合中的一个或多个文档。X DevAPI 提供了与 modify() 方法一起使用以

  • 设置和取消设置文档中的字段。

  • 追加、插入和删除数组。

  • 绑定、限制和排序要修改的文档。

设置和取消设置文档字段

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

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

mysql-py> db.countryinfo.modify("Code = 'SEA'").set(
"demographics", {"LifeExpectancy": 78, "Population": 28})

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

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

mysql-py> db.countryinfo.modify("Name = 'Sealand'").unset("GNP")

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

mysql-py> db.countryinfo.find("Name = 'Sealand'")
{
    "_id": "00005e2ff4af00000000000000f4",
    "Name": "Sealand",
    "Code:": "SEA",
    "IndepYear": 1967,
    "geography": {
        "Region": "British Islands",
        "Continent": "Europe",
        "SurfaceArea": 193
    },
    "government": {
        "HeadOfState": "Michael Bates",
        "GovernmentForm": "Monarchy"
    },
    "demographics": {
        "Population": 27,
        "LifeExpectancy": 79
    }
}
追加、插入和删除数组

若要将元素追加到数组字段,或在数组中插入或删除元素,请使用 array_append()array_insert()array_delete() 方法。以下示例修改 countryinfo 集合以启用国际机场的跟踪。

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

注意

修改文档时,请勿指定搜索条件,因为这样做会修改集合中的所有文档。

mysql-py> db.countryinfo.modify("true").set("Airports", [])

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

mysql-py> db.countryinfo.modify("Name = 'France'").array_append("$.Airports", "ORY")

使用 find() 查看更改。

mysql-py> db.countryinfo.find("Name = 'France'")
{
    "GNP": 1424285,
    "_id": "00005de917d80000000000000048",
    "Code": "FRA",
    "Name": "France",
    "Airports": [
        "ORY"
    ],
    "IndepYear": 843,
    "geography": {
        "Region": "Western Europe",
        "Continent": "Europe",
        "SurfaceArea": 551500
    },
    "government": {
        "HeadOfState": "Jacques Chirac",
        "GovernmentForm": "Republic"
    },
    "demographics": {
        "Population": 59225700,
        "LifeExpectancy": 78.80000305175781
    }
}

若要在数组中以不同位置插入元素,请使用 array_insert() 方法指定路径表达式中要插入的索引。在本例中,索引为 0,即数组中的第一个元素。

mysql-py> db.countryinfo.modify("Name = 'France'").array_insert("$.Airports[0]", "CDG")

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

mysql-py> db.countryinfo.modify("Name = 'France'").array_delete("$.Airports[1]")
相关信息