Planning for creating a time series

When you create a time series, you define a set of properties.

You can perform the necessary tasks for creating a time series in the following ways:

  • Running SQL commands
  • Writing an application with the time series Java™ class library
  • Writing an application with the REST API or the MongoDB API that runs through a wire listener

The following table lists the properties of a time series.

Table 1. Properties of a time series
Time series property Description How to define
Timepoint size For a regular time series, how long a timepoint lasts. Define a calendar pattern.
When timepoints are valid The times when elements can be accepted. Define a calendar pattern.
Data in the time series The time stamp and the other data that is collected for each time stamp. Create a TimeSeries data type.
Time series table The table that contains the TimeSeries data type column. Create a table with a TimeSeries column.
Location Where the time series data is stored Create one or more containers.
Origin The earliest timestamp of any element Create a time series.
Regularity Whether the timepoints are evenly spaced or arbitrarily spaced. Create a regular or an irregular time series.
Metadata Optional information included with the time series that can be retrieved by routines. Create a time series with metadata.
Hertz The data is recorded at a regularly spaced subsecond frequency. Create an irregular time series with a hertz value
Compression Optional compression of time series data that is only numeric. Create an irregular time series with compression definitions