Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB
Capped collections
Nesta página
A coleção limitada são collection de tamanho fixo que inserem e recuperam documento com base na ordem de inserção. A coleção limitada funcionam de forma semelhante aos buffers circulares: uma vez que uma collection preenche seu espaço alocado, ela abre espaço para novos documento substituindo os documento mais antigos da collection.
Restrições
A coleção limitada não pode ser fragmentada.
Não é possível criar capped collections em instâncias sem servidor.
Capped collections não são aceitas na Stable API V1.
Não é possível escrever em coleção limitada em transação.
O estágio do pipeline de agregação
$outnão pode gravar resultados em uma capped collection.Não é possível usar referência de leitura
"snapshot"ao ler em uma coleção limitada.
Sintaxe do comando
O exemplo a seguir cria uma coleção limitada chamada log com um tamanho máximo de 100,000 bytes.
db.createCollection( "log", { capped: true, size: 100000 } )
Para obter mais informações sobre como criar coleção limitada, consulte createCollection() ou create.
Casos de uso
Geralmente, TTL oferecem melhor desempenho e mais flexibilidade do que as coleção limitada. TTL expiram e removem dados de collection normais com base no valor de um campo digitado por data e um valor TTL para o índice.
As coleção limitada serializam inserções e, portanto, têm pior desempenho de inserção simultânea do que as collection. Antes de criar uma collection limitada, confira se você pode usar um índice TTL.
O caso de uso mais comum de uma capped collection é armazenar informações de registro. Quando a coleção limitada atinge seu tamanho máximo, as entradas de registro antigas são automaticamente substituídas por novas entradas.
Começar
Para criar e query coleção limitada, consulte estas páginas:
Detalhes
Considere estes detalhes comportamentais para coleção limitada.
Coleta de registros
A collection oplog.rs que armazena um registro das operações em um conjunto de réplicas utiliza uma capped collection.
Diferente de outras capped collections, o oplog pode ultrapassar o limite de tamanho configurado para evitar a exclusão do majority commit point.
Observação
O MongoDB arredonda o tamanho limitado do oplog para o número inteiro mais próximo que seja múltiplo de 256, em bytes.
Índice _id
As coletas mapeadas têm um campo _id e um índice no campo _id por padrão.
Atualizações
Evite atualizar dados em uma coleção limitada. Como as collection são de tamanho fixo, as atualizações podem fazer com que seus dados se expandam além do espaço alocado da collection, o que pode causar um comportamento inesperado.
Eficiência da query
Use a ordem natural para recuperar os elementos inseridos mais recentemente da collection de forma eficiente. Isto é semelhante ao uso do comando tail em um arquivo de log.
Cursor atualizado
Você pode usar um cursor tailable com coleções limitadas. Semelhante ao comando Unix tail -f , o cursor tailable "tails" o final de uma coleção limitada. À medida que novos documentos são inseridos na coleção limitada, você pode usar o cursor tailable para continuar recuperando documentos.
Para obter informações sobre como criar um cursor persistente, consulte cursor persistente.
Várias gravações simultâneas
Se houver gravadores simultâneos em uma collection, o MongoDB não garante que os documento sejam devolvidos na ordem de inserção.