json
batch_get
Read multiple JSON values by document and path.
db.json.get_many(entries: 'Any') -> 'list[Any]'wire json_batch_get
Reads several document/path entries and returns positional item results. Each item records whether the value was found and includes version 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.
To see the complete help for this command, run:
help(db.json.get_many)
Example
Read many documents at once.
_ = db.json.set_many([{"key": "a", "path": "$", "value": {"v": 1}}, {"key": "b", "path": "$", "value": {"v": 2}}])db.json.get_many([{"key": "a", "path": "$"}, {"key": "b", "path": "$"}])
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| entries | array | yes | Entries to read. |
| branch | string or null | no | Target branch. Defaults to the executor handle branch. |
| space | string or null | no | Target product space. Defaults to `"default"`. |
Returns
BatchResult<Maybe<JsonValue>>
- dataBatchResult4
- typestring
Errors
Recover by code. Retry policy and commit outcome come from the shipped error registry.
| Code | Retry | Commit outcome |
|---|---|---|
| failed_precondition.engine.runtime_closed | never | not_started |
| not_found.engine.branch | never | not_applicable |
| invalid_argument.engine.product_space | never | not_started |
| invalid_argument.engine.json_document_id | never | not_started |
| invalid_argument.engine.json_path | never | not_started |
| invalid_argument.engine.json_path_too_long | never | not_started |