rename事件
概括
rename
4.0.1版本中的新增功能。
rename重命名集合时会发生事件。
描述
| Field | 类型 | 描述 | |
|---|---|---|---|
_id |
Document | 一个BSON对象，用作更改流事件的标识符。该值用作恢复更改流时的参数resumeToken 。resumeAfter该_id对象具有以下形式：`{ "_data" : <BinData |
hex string>}该_data类型取决于 MongoDB 版本，在某些情况下，还取决于更改流打开或恢复时的[功能兼容性版本 (fCV) 。](https://www.mongodb.com/docs/manual/reference/command/setFeatureCompatibilityVersion/#std-label-view-fcv)有关类型的完整列表，请参阅[恢复令牌](https://www.mongodb.com/docs/manual/changeStreams/#std-label-change-stream-resume-token)_data。有关通过 恢复更改流的示例resumeToken`，请参阅 恢复更改流。 |
clusterTime |
Timestamp | 与事件关联的 oplog 条目的时间戳。与 多文档事务关联的更改流事件通知 都具有相同的clusterTime值：提交事务的时间。在分片集群上，具有相同事件的事件clusterTime可能并不都与同一事务相关。有些事件与交易根本无关。要识别单个事务的事件，您可以在变更流事件文档中使用lsid和的组合。txnNumber4.0版本中的新功能。 |
|
collectionUUID |
UUID | UUID标识发生更改的集合。6.0版本中的新内容。 | |
lsid |
document | 与事务关联的会话的标识符。仅当操作是多文档事务的一部分时才出现。4.0版本中的新功能。 | |
ns |
document | 受事件影响的命名空间（数据库和/或集合）。 | |
ns.db |
string | 发生事件的数据库的名称。 | |
ns.coll |
string | 发生事件的集合的名称。 | |
operationDescription |
document | 有关更改操作的附加信息。仅当更改流使用 扩展事件时，此文档及其子字段才会出现。6.0版本中的新内容。 | |
operationDescription.``dropTarget |
UUID | 在重命名操作中删除的集合的UUID 。6.0版本中的新内容。 | |
operationDescription.``to |
document | 重命名后集合的新命名空间。6.0版本中的新内容。 | |
operationDescription.``to.coll |
document | 重命名后集合的新名称。6.0版本中的新内容。 | |
operationDescription.``to.db |
document | 重命名后数据库的新名称。6.0版本中的新内容。 | |
operationType |
string | 更改通知报告的操作类型。rename返回这些更改事件的值。 |
|
to |
document | 重命名后集合的新命名空间。 | |
to.coll |
document | 重命名后集合的新名称。 | |
to.db |
document | 重命名后数据库的新名称。 | |
txnNumber |
NumberLong | 与LSID，一个有助于唯一标识交易的数字。仅当操作是多文档事务的一部分时才出现。4.0版本中的新功能。 | |
wallTime |
ISODate | 数据库操作的服务器日期和时间。wallTime 不同之处clusterTime在于，clusterTime时间戳是从与数据库操作事件关联的 oplog 条目中获取的。6.0版本中的新内容。 |
行为
扩展活动信息
在6.0版本中进行了更改。
从 MongoDB 6.0 开始，当更改流的showExpandedEvents选项设置为时，事件包含一个文档。本文档提供了一个显示更改的数据库和集合的字段，以及一个指示 操作是否在重命名之前删除集合的字段。true``rename``operationDescription``to``dropTarget``rename
例子
以下示例说明了一个rename事件：
{
"_id": { <Resume Token> },
"operationType": "rename",
"clusterTime": <Timestamp>,
"wallTime": <ISODate>,
"ns": {
"db": "engineering",
"coll": "users"
},
"to": {
"db": "engineering",
"coll": "people"
},
"operationDescription": {
"to": {
"db": "engineering",
"coll": "people"
}
}
}
事件rename会导致 针对其集合或集合打开的更改流的无效事件。ns``to
参见
原文 - rename Event