Menu Docs
Página inicial do Docs
/ / /
Driver Rust
/

Coleções de Time Series

Nesta página

  • Visão geral
  • Crie uma coleção de séries temporais
  • Exemplo
  • Consultar uma Coleta de Seqüência Temporal
  • Informações adicionais
  • Documentação da API

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:

Situação
Quantidade medida
Metadados
Registro de vendas mensais por setor
receita em dólares
Empresa, país
Rastreando mudanças no tempo
Nível de precipitação
Localização, tipo de sensor
Registro de flutuações nos preços da casa própria
Preço do aluguel mensal
Localização, moeda

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

Importante

Versão do servidor para coleção de séries temporais

Para criar e interagir com coleção de séries temporais, você deve estar conectado a um deployment executando o MongoDB 5.0 ou posterior.

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().

Este exemplo cria a coleção de séries temporais sept2023 no banco de dados precipitation com a seguinte configuração:

  • time_field está definido para "precipitation_mm"

  • meta_field está definido para "location"

  • granularity está definido para minutos

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?;

Para verificar se você criou com sucesso a time-series collection, execute o método list_collections() no reconhecimento de data center e imprima os resultados:

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

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 .

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

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 .

Para saber mais sobre os métodos e tipos mencionados neste guia, consulte a documentação da API abaixo:

Voltar

Transações

Próximo

Rastreamento e log de atividades