Skip to content
Snippets Groups Projects
usage.rst 1.04 KiB

How this does work?

Note

This is about fixed length data time series.

Data is stored in so called chunks. A chunk's last page can be actively appended to, or a chunk is immutable.

When there is a request to fetch some data, a chunk is loaded into memory. It will not be automatically unloaded, to do this, you must periodically call :meth:`~tempsdb.series.TimeSeries.close_chunks`.

Usage

Start off by instantiating an object

You can create new databases via

Then you can create and retrieve particular series:

You retrieve their data via Iterators:

Appending the data is done via :meth:`~tempsdb.series.TimeSeries.append`. Since time series are allocated in entire pages, so your files will be padded to a page in size. This makes writes quite fast, as in 99.9% cases it is just a memory operation.