STRINGSETQ data type

STRINGSETQ is a FeatureBase datatype used to associate multiple TIMESTAMP values with string values within a single row.

Syntax

STRINGSETQ [TIMEQUANTUM {value} [TTL '{value}']]

Arguments

Additional information

STRINGSETQ properties

The STRINGSETQ data type:

• has a keyed set internal datatype
• one standard view by default unless a timeQuantum is set.
• is used when:
  • grouping by
  • searching for discrete values

TIMEQUANTUM

TIMEQUANTUM creates a view of your data based on the specified time. This allows for lower latency queries at the cost of increased storage. For example, set TIMEQUANTUM to:

• MD for queries that include a range of months
• D for queries that include a small number of days

NOTE: Queries run on mismatched time granularities are slower but will function correctly. For example: Querying days on a IDSET or STRINGSET column with TIMEQUANTUM set to YM.

You can omit but not skip time granularity.

• YM is valid
• YH is invalid

TIMEQUANTUM is used when:

• times need to be associated with column data for query purposes
• database space is not at a premium

Valid Timequantum constraint values

IDSETQ() and STRINGSETQ() Timequantum constraints store integer value UNIX-epoch timestamps which are associated with specific values.

• Learn more about Timestamps

TTL (Time To Live)

NOTE: FeatureBase recommends using a TTL of 1h or more to improve results.

• TTL enables the deletion of time views where a time range exceeds the stated Time To Live.
• The default TTL of 0s indicates TIMEQUANTUM views will not be deleted.
• TTL runs:
  • when FeatureBase starts and every hour to make view deletion consistent
  • are not guaranteed to run at a specific time

• error: unknown unit is generated if an incorrect value is used (e.g., TTL is set to 60second)

• TTL should not be used if you require complete and consistent historical data.

TTL order of events

This example demonstrates the deletion dates of three column views where TTL is set to 30d

TIMEQUANTUM values and TUPLE() function

When the TUPLE() function is used in SELECT and BULK INSERT statements, the following values are returned:

• Tuple() function

Examples

CREATE TABLE with SETQ Timequantum

CREATE TABLE timeq (
_id id,
stringsetcolq stringsetq timequantum 'YMD',
idsetcolq idsetq timequantum 'YMD'
);

CREATE TABLE segments (
    _id id,
    segment stringsetq timequantum 'YMDH'
);

INSERT INTO table with SETQ Timequantum

insert into segments(_id,segment)
   VALUES (1, {1789864485,['green', 'yellow']}),
          (2, {1889763885,['green']}),
          (3, {1589763885, ['green', 'red']});