Limitações de coleta de séries temporais

Recursos Não Suportados

Os recursos a seguir não são compatíveis com coleções de séries temporais:

• Atlas Search

• Change stream

• Criptografia no nível de campo do cliente

• Gatilhos de banco de dados

• API GraphQL (obsoleto)

• Regras de validação do esquema

• reIndex

• renameCollection

Em coleções de séries temporais que usam o Atlas Data Ingest, o suporte do Atlas Device Sync é limitado.

Aggregation $out e $merge

Você não pode usar os estágios do aggregation pipeline $out ou $merge para adicionar dados de outra collection a uma coleção de séries temporais.

Comando distinto

Devido à estrutura de dados única das coleções de séries temporais, o MongoDB não pode indexá-las de forma eficiente para valores diferentes. Evite usar o comando distinct ou método assistente db.collection.distinct() em coleções de séries temporais. Em vez disso, use uma agregação $group para agrupar documentos por valores distintos.

Por exemplo, para consultar valores meta.type diferentes em documentos onde meta.project = 10, em vez de:

db.foo.distinct("meta.type", {"meta.project": 10})

Usar:

db.foo.createIndex({"meta.project":1, "meta.type":1})
db.foo.aggregate([{$match: {"meta.project": 10}},
                  {$group: {_id: "$meta.type"}}])

Isso funciona da seguinte maneira:

1. Criando um índice composto em meta.project e meta.type e é compatível com a agregação.

2. O estágio $match filtra documentos onde meta.project = 10.

3. O estágio $group usa meta.type como a chave de grupo para gerar um documento por valor exclusivo.

Tamanho do documento

O tamanho máximo dos documentos em uma coleção de séries temporais é 4 MB.

Atualizações e exclusões

A partir do MongoDB 5.1, você pode executar algumas operações de exclusão e atualização.

Os comandos de exclusão devem atender aos seguintes requisitos:

• Você só pode corresponder em valores de campo metaField .

• Seu comando de exclusão não deve limitar o número de documentos a serem excluídos. Defina justOne: false ou use o método deleteMany() .

Se uma coleção de séries temporais contiver documentos com timeField registros de data e hora anteriores a 1970-01-01T00:00:00.000Z ou posteriores a 2038-01-19T03:14:07.000Z, nenhum documento será excluído da coleção pelo recurso TTL "time to live".

Para obter detalhes sobre exclusões de TTL, consulte Expirar dados de collections configurando TTL.

Os comandos de atualização devem atender aos seguintes requisitos:

• Você só pode combinar metaField ao valor do campo.

• Você só pode modificar o valor do campo metaField.

• Seu documento de atualização só pode conter expressões de operador de atualização.

• Seu comando de atualização não deve limitar o número de documentos a serem atualizados. Defina multi: true ou use o método updateMany() .

• Seu comando de atualização não deve definir upsert: true.

No MongoDB 5.0, as coleções de séries temporais suportam somente inserir operações e ler consultas. Atualizações e operações manuais de exclusão resultam em um erro.

Para excluir dados antigos automaticamente, configure a remoção automática (TTL).

Para remover todos os documentos de uma collection, use o método drop() para soltar a collection.

Índices Secundários da Série Temporal

Há um suporte aprimorado para índices secundários no MongoDB 6.0.

Capped collections

Você não pode criar uma coleção de séries temporais como uma capped collection.

Modificação do Tipo de Coleção

Você só pode definir o tipo de collection ao criar uma collection:

• Uma coleção existente não pode ser convertida em uma coleção de séries temporais.

• Uma coleção de séries temporais não pode ser convertida em um tipo de coleção diferente.

Para mover dados de uma coleção existente para uma coleção de séries temporais, migre os dados para uma coleção de séries temporais.

Modificação do timeField e do metaField

Você só pode definir os parâmetros timeField e metaField de uma collection ao criá-la. Você não poderá modificar esses parâmetros posteriormente.

Modificação de granularity

Depois de definir o granularity, você só pode aumentá-lo um nível de cada vez. O granularity pode mudar de "seconds" para "minutes" ou de "minutes" para "hours". Outras alterações não são permitidas.

Para alterar o granularity de "seconds" para "hours", primeiro aumente o granularity para "minutes" e depois para "hours".

Fragmentação

A partir do MongoDB 5.1 (e 5.0.6), você pode criar coleções de séries temporais fragmentadas.

Em versões anteriores ao MongoDB 5.0.6, você não pode mostrar coleções de séries temporais.

Transações

Não é possível escrever em coleções de séries temporais em transações.

Limitações de visualização

As coleção de séries temporais são visualizações não materializadas graváveis. As limitações das visualizações se aplicam à coleção de séries temporais.

• Você não pode criar uma visualização a partir de um namespace de collection de série temporal (ou seja, uma collection prefixada com system.buckets).

Isolamento de snapshot

As operações de leitura em coleções de séries temporais com preocupação de leitura "snapshot" garantem o isolamento do snapshot somente na ausência de operações simultâneas de remoção ou renomeação de coleções na operação de leitura. A recriação de uma coleção de séries temporais no mesmo namespace com configuração de granularidade diferente não produz isolamento total do snapshot.