Menu Docs

Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB

invalidar, invalidar

Nesta página

  • Resumo
  • Descrição
  • Exemplo

Resumo

invalidate

Um evento invalidate ocorre quando uma operação renderiza o fluxo de alteração inválido. Por exemplo, um fluxo de alteração aberto em uma coleção que mais tarde foi descartada ou renomeada causaria um evento invalidate .

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 tipo de _data depende das versões do MongoDB e, em alguns casos, da versão de compatibilidade de recursos (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

O carimbo de data/hora da entrada de registro opcional associada ao evento.

Todas as notificações de eventos do fluxo de alterações associadas a uma transação com vários documentos têm o mesmo valor clusterTime: a hora em que a transação foi confirmada.

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.

Novidades na versão 4.0.

operationType
string

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

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

Exemplo

O exemplo seguinte ilustra um evento invalidate:

{
   "_id": { <Resume Token> },
   "operationType": "invalidate",
   "clusterTime": <Timestamp>,
}

Os fluxos de alteração abertos em coleções geram um evento invalidate quando ocorre uma operação de descarte, renomeação ou dropDatabase que afeta a coleção assistida.

Os fluxos de alteração abertos em bancos de dados geram um evento invalidate quando ocorre um evento dropDatabase que afeta o banco de dados assistido.

invalidate eventos fecham o cursor do change stream.

Não é possível usar resumeAfter para retomar um fluxo de alterações depois que umevento de invalidação (por exemplo, uma queda ou renomeação de coleção) fechar o fluxo. A partir do MongoDB 4.2, você pode usar startAfter para iniciar um novo fluxo de alterações após um evento de invalidação.

← inserir
rename Evento →

Nesta página