MySQL Shell API8.0.31
MySQL产品的统一开发接口
方法|全体成员名单
添加类引用

类上添加文档的处理程序集合更多…

方法

CollectionAdd 添加(DocDefinition document[, DocDefinition document,…])
存储要添加到集合中的文档。更多…
结果 执行()
执行添加操作,文档将被添加到目标集合。更多…

详细描述

类上添加文档的处理程序集合

该对象提供了向集合中添加文档所需的函数。

该对象只能通过调用将要添加文档的集合对象上的任何add函数来创建。

另请参阅
集合

成员功能文档10bet官方网站

add ()

CollectionAdd添加 DocDefinition 文档[, DocDefinition文档,…]

存储要添加到集合中的文档。

返回
CollectionAdd对象。

此函数接收一个或多个要添加到集合中的文档定义。文档缓存在内部列表中,并在execute ()方法。

文档定义可以通过两种方式提供:

  • 使用包含文档字段的字典。
  • 使用JSON字符串作为文档表达式。

添加多个文档有三种方法:

  • 将几个参数传递给函数,每个参数应该是一个文档定义。
  • 传递文档定义列表。
  • 在调用之前多次调用此函数execute ()

要添加,每个文档必须有一个名为“_id”的字符串属性,最好是一个通用唯一标识符(UUID)作为值。如果'_id'属性缺失,它将自动设置为内部生成的UUID。

方法链接

此方法可以被多次调用,每次调用时,接收到的文档将被缓存到一个内部列表中。集合中的实际添加只会发生在execute ()方法。

另请参阅
使用例子execute ()

execute ()

结果执行

执行添加操作,文档将被添加到目标集合。

返回
一个结果对象。

方法链接

此函数可以在以下情况下调用一次:

例子

使用文档列表

使用现有文档列表添加文档

Var result = collection。添加([{ "name": 'my sexth', "passed": 'again', "count": 5 }, mysqlx.expr('{"name": "my senevth", "passed": "yep again", "count": 5}')]).execute();
print("受影响的行混合列表:",结果。affectedItemsCount,“\ n”);

多个参数

在一次调用中为每个文档使用单独的参数来添加文档,以add(…)

Var result = collection。添加({ "name": 'my eigth', "passed": 'yep', "count": 6 }, mysqlx.expr('{"name": "my nineth", "passed": "yep again", "count": 6}')).execute();
print("受影响的行多个参数:",结果。affectedItemsCount,“\ n”);

链接添加

使用链接调用add(…)添加文档

Var result = collection。添加({ name: 'my fourth', passed: 'again', count: 4 }).add({ name: 'my fifth', passed: 'once again', count: 5 }).execute();
print("受影响的行链:",结果。affectedItemsCount,“\ n”);

JSON作为文档表达式

文档可以用JSON表达式表示,如下所示:

Var result = collect .add(mysqlx. exe)expr('{“名称”:“我的第五”、“通过”:“文件”、“数”:1}”)). execute ();
print("受影响的行单表达式:",结果。affectedItemsCount,“\ n”);