Limitações de coleta de séries temporais

Recursos Não Suportados

O MongoDB não oferece suporte aos seguintes recursos 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

Aggregation $merge

Você não pode usar o estágio de agregação $merge para adicionar dados de outra collection a uma coleção de séries temporais. Use o estágio de agregação $out para gravar documentos em uma coleção de séries temporais.

Você pode usar $merge para mover dados de uma coleção de séries temporais para outra collection.

comando distinto

Devido à estrutura de dados exclusiva das coleções de séries temporais, o MongoDB não pode indexá-las com eficiência para valores distintos. Evite usar o comando distinct ou o 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 fazer query de valores meta.type distintos 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 forma:

1. Cria um índice composto em meta.project e meta.type e oferece suporte à agregação.

2. Os filtros de estágio $match para documentos onde meta.project = 10.

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

Consultas geoespaciais

As coleções de séries temporais suportam apenas o estágio de agregação $geoNear para classificar dados geoespaciais de queries em relação a 2índices dsphere . Você não pode usar operadores $near e $nearSphere em coleções de séries temporais

Tamanho do documento

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

Intervalo de datas estendido

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.

Se sua coleção de séries temporais contiver documentos com registros de data e hora timeField antes 1970-01-01T00:00:00.000Z ou depois 2038-01-19T03:14:07.000Z, crie um índice no timeField para otimizar as queries.

Updates

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.

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

Índices Secundários da Série Temporal

O MongoDB suporta parcialmente os seguintes índices em coleções de séries temporais:

• Você só pode criar índices de múltiplas chaves no metaField.

• Você só pode criar índices2d no metaField.

• Você só pode criar índices esparsos no metaField.

O MongoDB não é compatível com os seguintes tipos de índice em coleções de séries temporais:

• Índices de texto

• Unique indexes

Se houver coleções de séries temporais e você precisar fazer downgrade da versão de compatibilidade de recursos (fCV), primeiro descartará todos os índices secundários que são incompatíveis com o fCV rebaixado. Para mais informações, consulte setFeatureCompatibilityVersion.

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:

• Você não pode converter uma coleção existente em uma coleção de séries temporais.

• Você não pode converter uma coleção de séries temporais 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 de timeField e 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.

Granularidade

db.runCommand({
   collMod: "timeseries",
   timeseries: { bucketMaxSpanSeconds: 3600, bucketRoundingSeconds: 3600 }
})

Fragmentação

As coleções de séries temporais estão sujeitas a várias limitações de fragmentação.

Transações

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

Visualizações

• As coleções de séries temporais são visualizações não materializadas graváveis. As limitações das visualizações se aplicam às coleções 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.