assertAppendOnly
The assertAppendOnly
method returns a copy of the source table or the source table itself if it is already an append-only table, with the append-only attribute set.
The source table's update pattern must already conform to append-only semantics. If it produces an update that does not conform to append-only semantics, then the returned table will notify of an error and cease updating.
If the engine can identify a table as append only, then some query operations may be optimized (for example, a lastBy operation need only track the current last row per-group rather than all of the rows in a group). In formulas, the i
(for the current row position), ii
(for the current row position), and k
(for the current row key) variables can be used safely.
Syntax
table.assertAppendOnly()
Parameters
This method takes no arguments.
Returns
A new Table with the append-only attribute set.