Docs Menu
Docs Home
/ /

Crear y ejecutar un query en una colección de series de tiempo

Esta página muestra cómo crear y consultar una colección de series de tiempo. Los ejemplos de código proporcionados crean y trabajan con datos meteorológicos de muestra que contienen datos de tiempo, temperatura y sensores.

Importante

Requisito de compatibilidad de características entre versiones

Solo se pueden crear colecciones de series temporales en un sistema con featureCompatibilityVersion establecida 5.0 en o mayor.

Una colección de series de tiempo incluye los siguientes campos:

Campo
Tipo
Descripción

timeseries.timeField

string

Requerido. El nombre del campo que contiene la fecha en cada documento de serie de tiempo. Los documentos en una colección de series de tiempo deben tener una fecha BSON válida como valor para el timeField.

timeseries.metaField

string

Opcional. El nombre del campo que contiene los metadatos en cada documento de serie de tiempo. Los metadatos del campo especificado deben ser datos que se utilicen para etiquetar una serie única de documentos. Los metadatos difícilmente cambien. El nombre del campo especificado no puede ser _id ni el mismo que el timeseries.timeField. El campo puede ser de cualquier tipo de dato.

Aunque el campo metaField es opcional, el uso de metadatos puede mejorar la optimización de query. Por ejemplo, MongoDB crea un índice compuesto automáticamente en los campos metaField y timeField para las nuevas colecciones. Si no proporcionas un valor para este campo, los datos se agrupan únicamente en función del tiempo.

timeseries.granularity

entero

Opcional. No utilice si se configuran bucketRoundingSeconds y bucketMaxSpanSeconds.

Los valores posibles son seconds (por defecto), minutes y hours.

Configure granularity al valor que más se asemeje al intervalo de tiempo entre las marcas de tiempo entrantes consecutivas. Esto mejora el rendimiento al optimizar cómo MongoDB almacena los datos en la colección.

Para obtener más información sobre la granularidad y los intervalos de agrupación, consulta Configurar granularidad para datos de series de tiempo.

timeseries.bucketMaxSpanSeconds

entero

Opcional. Utilice con bucketRoundingSeconds como alternativa a granularity. Establece el tiempo máximo entre marcas de tiempo en el mismo bucket.

Los valores posibles son de 1 a 31536000.

Nuevo en la versión 6.3.

timeseries.bucketRoundingSeconds

entero

Opcional. Utilice con bucketMaxSpanSeconds como alternativa a granularity. Debe ser igual a bucketMaxSpanSeconds.

Cuando un documento requiere un nuevo bucket, MongoDB redondea hacia abajo el valor de la marca de tiempo del documento según este intervalo para establecer el tiempo mínimo para el bucket.

Nuevo en la versión 6.3.

expireAfterSeconds

entero

Opcional. Activa la eliminación automática de los documentos en una colección de series de tiempo y especifica la cantidad de segundos tras los cuales caducan los documentos. MongoDB borra automáticamente los documentos caducados. Consulta Configurar la eliminación automática para las colecciones de series de tiempo (TTL) para obtener más información.

Estas son otras opciones permitidas que no son específicas de las colecciones de series de tiempo:

  • storageEngine

  • indexOptionDefaults

  • collation

  • writeConcern

  • comment

Volver

Crear y Configurar

En esta página