Menu Docs
Página inicial do Docs
/
Línguas
/
PHP
/
Manual da Biblioteca PHP
/
Bancos de dados e coleções

Coleções de Time Series

Nesta página

  • Visão geral
  • Crie uma coleção de séries temporais
  • Inserir dados de série temporal
  • Coleções de séries temporais de query
  • Informações adicionais

Visão geral

Neste guia, você pode aprender a usar a biblioteca PHP do MongoDB para criar e interagir com coleções de séries temporais. Essas collections armazenam dados de série temporal, que são compostos pelos seguintes componentes:

  • Quantidade medida

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

  • Metadados que descrevem a medição

A tabela a seguir descreve situações de exemplo para as quais você pode armazenar dados de série temporal:

Situação
Quantidade medida
Metadata
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

Crie uma coleção de séries temporais

Importante

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

Para criar e interagir com coleções de séries temporais, você deve estar conectado a uma implantação executando o MongoDB Server 5.0 ou posterior.

Você pode criar uma coleção de séries temporais para armazenar dados de séries temporais. Para criar uma coleção de séries temporais, passe uma array de opções para o método MongoDB\Database::createCollection() que define a opção timeseries . Ao definir esta opção, inclua os seguintes campos:

  • timeField: especifica o campo que armazena um carimbo de data/hora em cada documento de série temporal.

  • metaField: especifica o campo que armazena metadados em cada documento de série temporal .

  • granularity: especifica o tempo aproximado entre carimbos de data/hora consecutivos. Os valores possíveis são 'seconds', 'minutes' e 'hours'.

Exemplo

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

  • timeField está definido para 'timestamp'

  • metaField está definido para 'location'

  • granularity está definido para 'minutes'

$db = $client->precipitation;
$options = [
    'timeseries' => [
        'timeField' => 'timestamp',
        'metaField' => 'location',
        'granularity' => 'minutes',
    ]
];
$collection = $db->createCollection('sept2023', $options);

Para verificar se você criou com sucesso a coleção de séries temporais, chame o método MongoDB\Database::listCollections() no banco de banco de dados e imprima os resultados:

$cursor = $db->listCollections();
foreach ($cursor as $collectionInfo) {
    print_r($collectionInfo) . PHP_EOL;
}

Observação

O MongoDB armazena dados do sistema associados a coleções de séries temporais no namespace <database>.system.buckets . Para obter mais informações, consulte banco de dados.system.buckets no manual do MongoDB Server .

Inserir dados de série temporal

Você pode inserir dados em uma coleção de séries temporais usando os métodos MongoDB\Collection::insertOne() ou MongoDB\Collection::insertMany() e especificando a medida, o carimbo de data/hora e os metadados em cada documento inserido.

Dica

Para saber mais sobre como inserir documentos em uma collection, consulte o guia Inserir documentos .

Exemplo

Este exemplo insere dados de precipitação da cidade de Nova York na coleção de séries temporais sept2023 criada no exemplo Criar uma coleção de séries temporais. Cada documento contém os seguintes campos:

  • precipitation_mm, que armazena medições de precipitação em milímetros

  • location, que armazena metadados de localização

  • timestamp, que armazena o tempo da coleta de medição

$collection = $db->sept2023;
$result = $collection->insertMany(
    [
        [
            'precipitation_mm' => 0.5,
            'location' => 'New York City',
            'timestamp' => new MongoDB\BSON\UTCDateTime(1694829060000),
        ],
        [
            'precipitation_mm' => 2.8,
            'location' => 'New York City',
            'timestamp' => new MongoDB\BSON\UTCDateTime(1695594780000),
        ],
    ]
);

Coleções de séries temporais de query

Você pode usar a mesma sintaxe e convenções para consultar os dados armazenados em uma coleção de séries temporais que você usa ao 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:

Para saber mais sobre como realizar operações de leitura, consulte Ler dados do MongoDB.

Para saber mais sobre como realizar operações de agregação, consulte o guia Transforme seus dados com agregação .

Documentação da API

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

Voltar

Bancos de dados e coleções