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.