Docs 菜单
Docs 主页
/
MongoDB Manual
/
Change Streams
/
变更事件

reshardCollection 事件

在此页面上

  • 总结
  • 说明
  • 例子

总结

reshardCollection

版本 6.1 中的新功能：（也适用于 6.0.14）

在以下情况下会发生reshardCollection事件：

  • 集合的分片键和数据分布已更改，并且

  • 变更流已将 showExpandedEvents设立为true 。

说明

字段
类型
说明

_id

文档

一个 BSON 对象，用作变更流事件的标识符。恢复变更流时，此值用作 resumeAfter 参数的 resumeToken。_id 对象具有以下形式：

{
   "_data" : <BinData|hex string>
}

_data 类型取决于 MongoDB 版本，在某些情况下，还取决于变更流打开或恢复时的特征兼容性版本 (fCV)。有关 _data 类型的完整列表，请参阅恢复令牌。

有关通过 resumeToken 恢复变更流的示例，请参阅恢复变更流。

clusterTime

时间戳

clusterTime 是来自与该事件关联的oplog条目的时间戳。

由于oplog大小限制，多文档事务可能会创建多个oplog条目。在ACID 事务中，给定oplog条目中暂存的变更流事件股票相同的clusterTime 。

具有相同clusterTime的事件可能并不都与同一ACID 事务相关。 有些事件与ACID 事务完全无关。 从MongoDB 8.0开始，任何部署上的事件都可能如此。 在以前的版本中，这种行为只适用于分分片集群上的事件。

要标识单个事务的事件，您可以在变更流事件文档中结合使用 lsid 和 txnNumber。

在版本8.0中进行了更改。

collectionUUID

UUID

标识发生更改的集合的 UUID。

6.0 版本中的新功能。

ns

文档

受事件影响的命名空间（数据库和/或集合）。

ns.coll

字符串

发生事件的集合的名称。

ns.db

字符串

发生事件的数据库的名称。

operationDescription

文档

有关变更操作的其他信息。

仅当变更流使用扩展事件时，此文档及其子字段才会出现。

6.0 版本中的新功能。

operationDescription.
reshardUUID

UUID

标识重新分片操作的UUID 。

6.1 版本新增内容。

operationDescription. | shardKey

文档

发生更改的collection的分片键。

6.0 版本中的新功能。

operationDescription. | oldShardKey

文档

已更改collection的分片键。

6.1 版本新增内容。

operationDescription. | unique

布尔

如果使用唯一的分片键对collection进行分片，则其值为 true。

6.0 版本中的新功能。

operationDescription. | numInitialChunks

NumberLong

在shardCollection操作期间在每个分片上创建的数据块数量。

6.0 版本中的新功能。

operationDescription.
collation

文档

用于分片键索引的排序规则文档。

6.1 版本新增内容。

operationDescription.
zones

阵列

为新分片键添加的区域。

6.1 版本新增内容。

例子

以下示例说明了 reshardCollection 事件：

{
   "_id": { <ResumeToken> },
   "operationType": "reshardCollection",
   "collectionUUID": 0,
   "ns": {"db": "reshard_collection_event", "coll": "coll"},
   "operationDescription": {
     "reshardUUID": 0,
     "shardKey": {"newKey": 1},
     "oldShardKey": {"_id": 1},
     "unique": false,
     "numInitialChunks": NumberLong(1),
     "collation": {"locale": "simple"},
     "zones": [
         {"zone": "zone1", "min": {"newKey": {"$minKey": 1}}, "max": {"newKey": {"$maxKey": 1}}}
     ]
   }
}

后退

替换

来年

shardCollection

在此页面上