split()

语法

db.collectionspace.collection.split( , , )
db.collectionspace.collection.split( , , , [endcondition] )

在至少存在两个分区组的环境下，将数据记录按指定的条件切分到不同的分区组中，目标分区组必须属于集合空间所属的域。该操作为同步操作，直到数据切分完成才返回。

参数描述

范围切分

db.collectionspace.collection.split( , , , [endcondition] )

参数名参数类型描述是否必填
source groupstring源分区组。是
target groupstring目标分区组。是
conditionJson 对象范围切分条件。是
endconditionJson 对象结束范围条件。可选

Note:

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

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

百分比切分

db.collectionspace.collection.split( , , )

参数名参数类型描述是否必填
source groupstring源分区组。是
target groupstring目标分区组。是
percentdouble百分比切分条件，取值：(0, 100]是

Note:

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

  2. 百分比不能为0.

返回值

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

错误

错误码

示例

  • Hash 分区范围切分

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

  • Range 分区范围切分

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

  • 百分比切分

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