Skip to main content

Module slice

Module slice 

Source
Expand description

GET /slice/<call with *>: the members of a stored function’s slice as of an instant, as an Arrow IPC stream or as JSON pages, paginated by key.

Members come from the store’s slice_values (values, hashes and cells, no receipt bytes), in SPEC 15.13 key order. A slice read as of an instant at or before now is kept in a small memory cache (its members cannot change, the store being append-only), so repeated reads of it are warm. A latest read (no asof) reuses the cached members of its slice while no member changed after the cached instant, and its next links pin that instant.

JSON: a page envelope (SPEC 5.6, spec-0.4.2): {"outcome": "ok", "slice", "members", "next"?, "fn_hash"}, members the members’ ok envelopes ascending by key, next the URL of the following page (limit= and after= the last key, hex of its JCS bytes), absent on the last page. Pages are of limit members (default 1,000, at most 10,000), all with the asof of the first page.

Arrow (Accept: application/vnd.apache.arrow.stream): one stream, record batches of up to 65,536 rows, a column per open argument and value, type, receipt, tx, asof (UTF-8: lexical forms, so no number is rounded), schema metadata slice_id, asof, function. The whole slice (up to the configured bound) in one stream.

Constants§

ARROW
The media type of Arrow IPC streams.