`shardCollection` Evento

Nesta página

Resumo

Descrição
Exemplo

Resumo

shardCollection: Novidades na versão 6.0.
Um evento shardCollection ocorre quando uma collection é fragmentada.

Descrição

Campo

Tipo

Descrição

_id

Documento

Um objetoBSON 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.

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.

Novidades na versão 4.0.

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.

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.

numInitialChunks

longo

Número de chunks criados em cada shard durante uma operação shardCollection .

Novidades na versão 6.0.

operationDescription.

presplitHashedZones

booleano

Indica se as partes do shard foram divisão de acordo com a zona quando a collection se tornou fragmentada.

Novidades na versão 6.0.

operationDescription.

shardKey

documento

A chave de fragmento da coleção onde ocorreu a alteração.

Novidades na versão 6.0.

operationDescription.

unique

booleano

Tem o valor de true se a collection foi fragmentada com uma chave de shard exclusiva.

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

Novidades na versão 4.0.

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 shardCollection :

{
   "_id": { <ResumeToken> },
   "operationType": "shardCollection",
   "clusterTime": Timestamp({ t: 1654894852, i: 52 }),
   "collectionUUID": UUID("98046a1a-b649-4e5b-9c75-67594221ce19"),
   "wallTime": ISODate("2022-06-10T21:00:52.854Z"),
   "ns": {
      "db": "test",
      "coll": "authors"
   },
   "operationDescription": {
      "shardKey": { "age": "hashed" },
      "unique": false,
      "numInitialChunks": Long("0"),
      "presplitHashedZones": false
   }
}

← reshardCollection

update →