`rename` Evento

Resumo

rename: Um evento rename ocorre quando uma collection é renomeada.

Descrição

Campo	Tipo	Descrição
`_id`	Documento	Um objetoBSON , que serve como identificador para o evento de fluxo de alterações . Este valor é utilizado como `resumeToken` para o `resumeAfter` parâmetro ao retomar um fluxo de alteração. Os campos dentro do `_id` objeto dependem das versões do MongoDB e, em alguns casos, da versão de compatibilidade do recurso (FCV) no momento da abertura ou retomada do fluxo de alterações. Para obter um exemplo de como retomar um fluxo de alterações por `resumeToken`, consulte Retomar um fluxo de alterações.
`clusterTime`	Timestamp	`clusterTime` é o registro de data/hora da entrada de registro opcional associada ao evento. Devido aos limites de tamanho do oplog , transações com vários documentos podem criar várias entradas no oplog. Em uma transação, os eventos de change stream encenados em uma determinada entrada do oplog compartilham o mesmo `clusterTime`. Eventos com o mesmo `clusterTime` podem não estar relacionados à mesma transação. Alguns eventos não estão nem um pouco relacionados a uma transação. A partir do MongoDB 8.0, isso pode ser verdade para eventos em qualquer sistema. Nas versões anteriores, este comportamento era possível apenas para eventos em um cluster fragmentado. Para identificar eventos para uma única transação, você pode usar a combinação de `lsid` e `txnNumber` no documento de eventos do fluxo de alterações. Alterado na versão 8.0.
`collectionUUID`	UUID	UUID identificando a coleção onde ocorreu a alteração. Novidades na versão 6.0.
`lsid`	documento	O identificador da sessão associada à transação. Somente presente se a operação fizer parte de uma transação de vários documentos.
`ns`	documento	O namespace (banco de dados e/ou coleção) afetado pelo evento.
`ns.db`	string	O nome do banco de dados onde ocorreu o evento.
`ns.coll`	string	O nome da coleção onde o evento ocorreu.
`operationDescription`	documento	Informações adicionais sobre a operação de alteração. Esse documento e seus subcampos só aparecem quando o fluxo de alterações usa eventos expandidos. Novidades na versão 6.0.
`operationDescription.` `dropTarget`	UUID	UUID da collection que foi descartado na operação de renomeação. Novidades na versão 6.0.
`operationDescription.` `to`	documento	O novo namespace da collection após a renomeação. Novidades na versão 6.0.
`operationDescription.` `to.coll`	documento	O novo nome da collection após a renomeação. Novidades na versão 6.0.
`operationDescription.` `to.db`	documento	O novo nome do reconhecimento de data center após a renomeação. Novidades na versão 6.0.
`operationType`	string	O tipo de operação que os relatórios de notificação de alteração. Retorna um valor de `rename` para estes eventos de alteração.
`to`	documento	O novo namespace da collection após a renomeação.
`to.coll`	documento	O novo nome da collection após a renomeação.
`to.db`	documento	O novo nome do reconhecimento de data center após a renomeação.
`txnNumber`	Número longo	Juntamente com o lsid, um número que ajuda a identificar exclusivamente uma transação. Somente presente se a operação fizer parte de uma transação de vários documentos.
`wallTime`	Data ISO	A data e hora do servidor da operação do banco de dados. `wallTime` difere de `clusterTime` em que `clusterTime` é um carimbo de data/hora obtido da entrada oplog associada ao evento de operação do banco de dados. Novidades na versão 6.0.

Comportamento

Informações Expandidas do evento

Alterado na versão 6.0.

A partir do MongoDB 6.0, quando a opção showExpandedEvents é definida como true para o change stream, o evento rename inclui um documento operationDescription . Esse documento fornece um campo to que mostra o banco de dados e a collection alterados e um campo dropTarget que indica se a operação rename removeu a collection antes da renomeação.

Exemplo

O exemplo seguinte ilustra um evento 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"
      }
   }
}

Um evento rename leva a um evento de invalidação para change streams abertos em sua collection ns ou collection to .

Voltar

refineCollectionShardKey

replace