inserir evento

Resumo

insert: Um evento insert ocorre quando uma operação adiciona documentos a uma collection.

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. O campo `collectionUUID` só é incluído se o fluxo de alteração for criado com o campo `showExpandedEvents` definido como `true`. Para obter detalhes, consulte showExpandedEvents.
`documentKey`	documento	Documento que contém o valor `_id` do documento criado ou modificado pela operação CRUD. Para coleções fragmentadas, este campo também exibe a chave de fragmentação completa do documento. O campo `_id` não se repete se já fizer parte da chave fragmentada.
`fullDocument`	documento	O documento criado pela operação. Alterado na versão 6.0. A partir do MongoDB 6.0, se você definir a opção `changeStreamPreAndPostImages` usando `db.createCollection()`, `create` ou `collMod`, o campo `fullDocument` mostrará o documento depois que ele foi inserido, substituído ou atualizado (o documento pós-imagem). `fullDocument` é sempre incluído para eventos `insert`.
`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.coll`	string	O nome da coleção onde o evento ocorreu.
`ns.db`	string	O nome do banco de dados onde ocorreu o evento.
`operationType`	string	O tipo de operação que os relatórios de notificação de alteração. Retorna um valor de `insert` para estes eventos de alteraçã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

Atualizar operações

O comando update pode produzir diferentes eventos de alteração (não apenas update), dependendo das alterações reais feitas na collection.

Alterar evento	Descrição
`update`	A operação de atualização modificou um documento existente .
`replace`	A operação de atualização substituiu o documento ou gerou um diff mais verboso do que o documento original , fazendo com que o MongoDB o substituísse.
`insert`	A operação de atualização tentou atualizar um documento que não existe e, em vez disso, adicionou o documento à coleção. Isto ocorre somente quando a atualização é executada com a opção `upsert` habilitada.

Exemplo

O exemplo seguinte ilustra um evento insert:

{
   "_id": { <Resume Token> },
   "operationType": "insert",
   "clusterTime": <Timestamp>,
   "wallTime": <ISODate>,
   "ns": {
      "db": "engineering",
      "coll": "users"
   },
   "documentKey": {
      "userName": "alice123",
      "_id": ObjectId("599af247bb69cd89961c986d")
   },
   "fullDocument": {
      "_id": ObjectId("599af247bb69cd89961c986d"),
      "userName": "alice123",
      "name": "Alice"
   }
}

O campo documentKey inclui o campo _id e userName . Isso indica que a collection engineering.users está fragmentada, com uma chave de shard em userName e _id.

O documento fullDocument representa a versão do documento no momento da inserção.

Voltar

dropIndexes

invalidate