state_timeline()

Returns the timeline of states in a timeline aggregate.

state_timeline(
    agg TimelineAgg
) RETURNS (TEXT, TIMESTAMPTZ, TIMESTAMPTZ)
state_int_timeline(
    agg TimelineAgg
) RETURNS (BIGINT, TIMESTAMPTZ, TIMESTAMPTZ)

warning

Experimental features could have bugs. They might not be backwards compatible, and could be removed in future releases. Use these features at your own risk, and do not use any experimental features in production.

Required arguments

Returns

Sample usage

Getting the history of states in a timeline aggregate:

SELECT state, start_time, end_time FROM toolkit_experimental.state_timeline(
     (SELECT toolkit_experimental.timeline_agg(ts, state) FROM states_test));

Example output:

state |       start_time       |        end_time
-------+------------------------+------------------------
 START | 2020-01-01 00:00:00+00 | 2020-01-01 00:00:11+00
 OK    | 2020-01-01 00:00:11+00 | 2020-01-01 00:01:00+00
 ERROR | 2020-01-01 00:01:00+00 | 2020-01-01 00:01:03+00
 OK    | 2020-01-01 00:01:03+00 | 2020-01-01 00:02:00+00
 STOP  | 2020-01-01 00:02:00+00 | 2020-01-01 00:02:00+00