Reads several KV keys and returns positional item results. Each item records whether the corresponding key was found and includes value metadata when present.
Itemwise batches return one positional item result per input item. The outer batch status summarizes whether all, some, or none of the items succeeded.
Examples
Read many keys at once; a missing key comes back as null.
CLI
$ strata command run --command-json '{"entries":[{"key":"YQ==","value":"MQ=="},{"key":"Yg==","value":"Mg=="}],"type":"kv_batch_put"}'
$ strata command run --command-json '{"keys":["YQ==","Yg==","bWlzc2luZw=="],"type":"kv_batch_get"}'Wire
{"entries":[{"key":"YQ==","value":"MQ=="},{"key":"Yg==","value":"Mg=="}],"type":"kv_batch_put"}
{"keys":["YQ==","Yg==","bWlzc2luZw=="],"type":"kv_batch_get"}Parameters
| Name | Type | Required | Description |
|---|---|---|---|
keys | Bytes[] | yes | Keys to read. |
Plus the optional scope: branch and space (default to the session branch and the "default" space).
Returns
BatchResult<Maybe<Bytes>>.
Errors
failed_precondition.engine.runtime_closednot_found.engine.branchinvalid_argument.engine.product_spaceinvalid_argument.engine.kv_keyinvalid_argument.engine.kv_batch
Invocation
- CLI: via
strata command run(no dedicated verb) - Wire type:
kv_batch_get