Coleções de Time Series

Visão geral

Neste guia, você aprenderá a usar a integração com o Laravel 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:

Crie uma coleção de séries temporais

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, crie uma classe de migração e adicione uma função up() para especificar a configuração da coleção. Na função up(), passe o nome da nova collection e a opção timeseries para o método Schema::create().

Ao configurar a opção timeseries, 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'.

<?php
declare(strict_types=1);
use Illuminate\Database\Migrations\Migration;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
    protected $connection = 'mongodb';
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        $options = [
            'timeseries' => [
                'timeField' => 'timestamp',
                'metaField' => 'location',
                'granularity' => 'minutes',
            ],
        ];
        Schema::create('precipitation', null, $options);
    }
    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::drop('precipitation');
    }
};

$result = Schema::hasCollection('precipitation');
echo $result;

Inserir dados de série temporal

Você pode inserir dados em uma coleção de séries temporais passando seus documentos para o método insert() e especificando a medida, o carimbo de data/hora e os metadados em cada documento inserido.

$data = [
    [
        'precipitation_mm' => 0.5,
        'location' => 'New York City',
        'timestamp' => new UTCDateTime(Carbon::create(2023, 9, 12, 0, 0, 0, 'CET')),
    ],
    [
        'precipitation_mm' => 2.8,
        'location' => 'New York City',
        'timestamp' => new UTCDateTime(Carbon::create(2023, 9, 17, 0, 0, 0, 'CET')),
    ],
];
$result = DB::table('precipitation')
    ->insert($data);

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 de manual do MongoDB Server :

• 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 consultar dados, consulte o guia Construtor de queries.

Para saber mais sobre como executar operações de agregação , consulte o guia Construtor de agregações.