Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Fluxos de alterações
/
Alterar eventos

modify Evento

Nesta página

  • Resumo
  • Descrição
  • Exemplo

Resumo

modify

Novidades na versão 6.0.

Um evento modify ocorre quando uma collection é modificada, como quando o comando collMod adiciona ou remove opções de uma collection ou visualização. Esse evento será recebido somente se o change stream tiver a opção showExpandedEvents definida como true.

Observação

Desambiguação

Para saber mais sobre eventos que ocorrem quando documentos individuais são atualizados, consulte o evento update.

Descrição

Campo
Tipo
Descrição

_id

Documento

Um objeto BSON que serve como um identificador para o evento de fluxo de alterações. Este valor é utilizado como resumeToken para o parâmetro resumeAfter ao retomar um fluxo de alteração. O objeto _id tem o seguinte formulário:

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

O _data tipo de depende 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.Consulte Tokens de currículo para obter a lista completa de _data tipos.

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.

Em clusters fragmentados, 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.

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.

collectionUUID

UUID

Se a alteração ocorreu em uma collection, collectionUUID indica o UUID do da collection. Se a alteração ocorreu em uma visualização, collectionUUID não existe.

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.
index

documento

O índice que foi modificado.

Novidades na versão 6.0.

operationDescription.
indexes

array

Uma array de documentos que lista os índices que foram alterados pela operação.

operationType

string

O tipo de operação que os relatórios de notificação de alteração.

Retorna um valor de modify para estes eventos de alteração.

stateBeforeChange

documento

O documento mostra as opções de coleção e índice antes que a operação as alterasse.

stateBeforeChange.
collectionOptions

documento

O documento mostra as opções de coleta antes que a operação as alterasse.

stateBeforeChange.
indexOptions

documento

O documento mostrava as opções de índice antes que a operação as alterasse.

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.

Exemplo

O exemplo a seguir mostra um evento do modify :

{
   "_id": { <ResumeToken> },
   "operationType": "modify",
   "clusterTime": Timestamp({ t: 1654878543, i: 1 }),
   "collectionUUID": UUID("47d6baac-eeaa-488b-98ae-893f3abaaf25"),
   "wallTime": ISODate("2022-06-10T16:29:03.704Z"),
   "ns": {
      "db": "test",
      "coll": "authors" },
   "operationDescription": {
      "index": {
         "name": "age_1",
         "hidden": true
      }
   },
   "stateBeforeChange": {
      "collectionOptions": {
          "uuid": UUID("47d6baac-eeaa-488b-98ae-893f3abaaf25")
      },
      "indexOptions": {
         "hidden": false
      }
   }
}

Voltar

invalidate

Próximo

refineCollectionShardKey