Operations: Get Incremental Time Series



GetTimeSeriesOperation

Use GetTimeSeriesOperation to retrieve the distinct values stored per-node for the requested entries.


Syntax

  • GetTimeSeriesOperation Definition:

    public GetTimeSeriesOperation(
        string docId, string timeseries, DateTime? @from = null,
        DateTime? to = null, int start = 0, int pageSize = int.MaxValue, 
        bool returnFullResults = false)
  • Parameters

    Parameters Type Description
    docId string Document ID
    timeseries string Time series name
    from (optional) DateTime? Range start
    Default: DateTime.Min
    to (optional) DateTime? Range end
    Default: DateTime.Max
    start int Start of first Page
    pageSize int Size of each page, counted in entries with unique timestamps
    returnFullResults bool If true, retrieve the values stored per-node.
    If false, return null in TimeSeriesEntry.NodeValues.
  • Return Value: TimeSeriesRangeResult<TimeSeriesEntry>

    public class TimeSeriesRangeResult 
        {
            public DateTime From, To;
            public TimeSeriesEntry[] Entries;
            
            // The actual number of values
            public long? TotalResults;
    public class TimeSeriesEntry 
        {
            public DateTime Timestamp { get; set; }
            public double[] Values { get; set; }
            public string Tag { get; set; }
            public bool IsRollup { get; set; }
            
            // The nodes distribution per each entry
            public Dictionary<string, double[]> NodeValues { get; set; }

    • Requesting a time series that doesn't exist will return null.
    • Requesting an entries range that doesn't exist will return a TimeSeriesRangeResult object with an empty Entries property.

  • Exceptions
    Exceptions are not generated.


Usage Sample

  • In this sample we retrieve 50 entries from an incremental time series that contains two per-node values in each entry.
    We then calculate where the next Get operation should start, and run another Get operation starting there.
    int pageSize = 100;
    var entries = store.Operations
                      .Send(new GetTimeSeriesOperation("users/ayende",
                       "INC:Downloads", start: 0, pageSize: pageSize, 
                       returnFullResults: true));
    
    //load another page, starting with the first entry that wasn't read yet
    int nextStart = entries.Entries.Length;
    entries = store.Operations
                      .Send(new GetTimeSeriesOperation("users/ayende",
                       "INC:Downloads", start: nextStart, pageSize: pageSize, 
                       returnFullResults: true));

GetMultipleTimeSeriesOperation

To retrieve data from multiple time series, use GetMultipleTimeSeriesOperation.