The flags argument values
The time series SQL functions that insert data have a flags argument to determine how elements are inserted.
The value of the flags argument is
the sum of the flag values that you want to use.
Flag | Value | Meaning | Restrictions |
---|---|---|---|
TSOPEN_RDWRITE | 0 | (Default) Indicates that the time series can be read and written to. | |
TSOPEN_READ_HIDDEN | 1 | Indicates that hidden elements are treated as if they are not hidden. | Cannot be used in combination with the following
flag values:
|
TSOPEN_WRITE_HIDDEN | 2 | Allows hidden elements to be written to without first revealing them. The element remains hidden afterward. | Cannot be used in combination with the following
flag values:
|
TSOPEN_WRITE_AND_HIDE | 4 | Marks as hidden any elements that are written to a time series. | Cannot be used in combination with the following
flag values:
|
TSWRITE_AND_REVEAL | 8 | Reveals any hidden element that is written to. | |
TSOPEN_NO_NULLS | 32 | Prevents elements that were never allocated (TS_NULL_NOTALLOCATED) from being returned as NULL. By default, if an element is not allocated, it is returned as NULL. If this flag is set, an element that has each column set to NULL is returned instead. | |
TS_PUTELEM_NO_DUPS | 64 | Prevents duplicate elements. By default, the function adds elements with the PutElem function If this flag is set, the function uses the PutElemNoDups function. | Can be used only in the following functions:
|
TSOPEN_REDUCED_LOG | 256 | Reduces how many log records are generated when you insert data. By default, every element that you insert generates two log records: one for the inserted element and one for the page header update. If this flag is set, page header updates are logged per transaction instead of per element, which improves performance. | Can be used only in the following functions:
Functions that include this flag must be run within a transaction. The transaction can include other functions that use this flag. The transaction cannot include functions that do not use this flag or other SQL statements. The elements that are inserted are not visible by dirty reads until after the transaction commits. |