Coleções de Time Series

Visão geral

Neste guia, você verá como usar o driver Rust para criar e interagir com coleções de séries temporais . As coleções de séries temporais armazenam de forma eficiente sequências cronológicas de medições durante um período de tempo. Cada documento em uma coleção de séries temporais contém as seguintes informações:

• Quantidade que está sendo medida ao longo do tempo

• Metadados que descrevem a medição

• Carimbo de data/hora para a medição

A tabela a seguir descreve algumas situações de exemplo para as quais os dados podem ser armazenados em uma coleção de séries temporais. Cada linha descreve a situação, a quantidade medida e os metadados em cada documento:

Este guia inclui as seguintes seções:

• Criar uma coleção de séries temporais descreve a sintaxe para criar uma coleção de séries temporais e fornece código de exemplo

• Consulte uma Coleção de séries temporais descreve como executar operações em coleções de séries temporais

• Informações adicionais fornecem links para recursos e documentação da API para os tipos e métodos mencionados neste guia

Crie uma coleção de séries temporais

Para criar uma coleção de séries temporais, execute as seguintes ações:

1. Crie uma instância do TimeseriesOptions que especifique propriedades da sua coleção de séries temporais.

2. Chame o método create_collection() e passe o nome da coleção como um parâmetro.

3. Encadeie o método timeseries() ao método create_collection() . Passe sua instância do TimeseriesOptions como um parâmetro para timeseries().

let db = client.database("precipitation");
let ts_opts = TimeseriesOptions::builder()
    .time_field("precipitation_mm".to_string())
    .meta_field(Some("location".to_string()))
    .granularity(Some(TimeseriesGranularity::Minutes))
    .build();
db.create_collection("sept2023")
    .timeseries(ts_opts)
    .await?;

let mut coll_list = db.list_collections().await?;
while let Some(c) = coll_list.try_next().await? {
    println!("{:#?}", c);
}

CollectionSpecification {
    name: "sept2023",
    collection_type: Timeseries,
    options: CreateCollectionOptions {
        ...
        timeseries: Some(
            TimeseriesOptions {
                time_field: "precipitation_mm",
                meta_field: Some(
                    "location",
                ),
                granularity: Some(
                    Minutes,
                ),
            },
        ),
        ...
    },
    ...
}

Consultar uma Coleta de Seqüência Temporal

Você pode usar a mesma sintaxe e convenções para consultar uma coleção de séries temporais do que para executar operações de leitura ou agregação em outras collections. Para encontrar mais informações sobre essas operações, consulte a seção Informações adicionais .

Informações adicionais

Para saber mais sobre os conceitos mencionados neste guia, consulte as seguintes entradas manuais do servidor:

• Séries temporais

• Criar e consultar uma coleção de séries temporais

• Definir granularidade para dados de série temporal

Para saber mais sobre como criar coleções, consulte o guia sobre Bancos de dados e coleções.

Para saber mais sobre como realizar operações de leitura, consulte os guias na categoria Operações de leitura .