split()

语法

db.collectionspace.collection.split(<source group>,<target group>,<percent(0~100)|condition>, [endcondition])

在至少存在两个分区组的环境下，将数据记录按指定的条件切分到不同的分区组中。该操作为同步操作，直到数据切分完成才返回。

参数描述

Note:

• 范围切分

  1、Range 分区使用精确条件，而 Hash 分区使用 Partition（分区数）条件。结束条件不选时默认为切分源当前包含的最大数据范围。

  2、如果指定分区键字段为降序时，如：{groupingKey:{<字段1>:<-1>}，condition（或 Partition）中的起始条件中的范围应该大于终止条件中的范围。Hash 分区使用的 Partition（分区数）必须为整形，不能为其他的类型。

• 百分比切分

  百分比切分时，需要注意：

  1、Range分区需要保证源分区组中含有数据，即集合不为空；

  2、百分比不能为0。

返回值

无返回值，出错抛异常，并输出错误信息，可以通过getLastErrMsg()获取错误信息或通过getLastError()获取错误信息码。

错误

错误码

示例

• Hash 分区范围切分

  > db.foo.bar.split( "group1",  "group2", { Partition: 10 }, { Partition: 20 } )

• Range 分区范围切分

  > db.foo.bar.split( "group1",  "group2", { a: 10 },  { a: 10000 } )

• 百分比切分

  > db.foo.bar.split( "group1",  "group2",  50 )