(没有版本信息可用,可能只存在于 Git 中)
Collection::modify — 修改集合文档
修改集合中满足特定搜索条件的文档。允许使用多个操作,并支持参数绑定。
search_condition
必须是有效的 SQL 表达式,用于匹配要修改的文档。此表达式可以像true
一样简单,它匹配所有文档,或者它可以使用函数和运算符,例如'CAST(_id AS SIGNED) >= 10'
、'age MOD 2 = 0 OR age MOD 3 = 0'
或'_id IN ["2","5","7","10"]'
。
如果操作未执行,则函数将返回一个 Modify 对象,该对象可用于添加其他修改操作。
如果修改操作已执行,则返回的对象将包含操作的结果。
示例 #1 mysql_xdevapi\Collection::modify() 示例
<?php
$session = mysql_xdevapi\getSession("mysqlx://user:password@localhost");
$session->sql("DROP DATABASE IF EXISTS addressbook")->execute();
$session->sql("CREATE DATABASE addressbook")->execute();
$schema = $session->getSchema("addressbook");
$collection = $schema->createCollection("people");
$collection->add('{"name": "Alfred", "age": 18, "job": "Butler"}')->execute();
$collection->add('{"name": "Bob", "age": 19, "job": "Painter"}')->execute();
// 为所有 Painter 添加两个新的工作:Artist 和 Crafter
$collection
->modify("job in ('Butler', 'Painter')")
->arrayAppend('job', 'Artist')
->arrayAppend('job', 'Crafter')
->execute();
// 从所有年龄为 21 的文档中删除 'beer' 字段
$collection
->modify('age < 21')
->unset(['beer'])
->execute();
?>