Datasets

Read the row set of a pinned Dataset Snapshot

Resolves the Dataset's MVCC history at row-level version and returns one page of live rows. Alternatively, write_version W resolves to the highest row version among rows whose write version is at or below W; write versions and row versions are separate counters. Omitting both reads the current Snapshot. The response's snapshotVersion is always a row-level pin key: use it as the Experiment's datasetVersion. Existing pins and version reads retain their original semantics.

get/api/{org_id}/datasets/{dataset_id}/rows

Request

Path parameters

org_idstring required

Organization name

dataset_idstring required

Dataset ID

Query parameters

versioninteger

Row-level Snapshot/pin key. When both this and write_version are omitted, reads the Dataset's current row version.

write_versioninteger

Displayed write version W to pin. Resolves to the highest row version among rows whose write version is at or below W (labels and row versions are separate counters); cannot be combined with version. Use the returned snapshotVersion as the Experiment's datasetVersion.

frominteger

Zero-based result offset. Defaults to 0.

sizeinteger

Page size from 1 through 100. Defaults to 20.

Response

frominteger required
hasMoreboolean required
sizeinteger required
snapshotVersioninteger required

The version actually resolved, which a caller that omitted version needs in order to pin the same Snapshot again.

totalinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.