Important

The SingleStore 9.0 release candidate (RC) gives you the opportunity to preview, evaluate, and provide feedback on new and upcoming features prior to their general availability. In the interim, SingleStore 8.9 is recommended for production workloads, which can later be upgraded to SingleStore 9.0.

BSON_EXTRACT_ALL_BSON

Syntax

BSON_EXTRACT_ALL_BSON(<input> [, path_key_1, path_key_2,.., path_key_n])

Arguments

input: A valid BSON document or an expression that evaluates to a valid BSON document.
path: A comma-separated list of dictionary keys or array positions (zero-based index).

Return Type

A BSON value.

Remarks

If the path_key argument is not specified, the top-level document or value is returned.
If the specified path_key does not exist, returns NULL.

Examples

Note: The following examples explicitly cast string to BSON for clarity. Similarly, the output is cast to JSON.

Returns values for all the matching keys in the BSON document:

SQL

SELECT 
BSON_EXTRACT_ALL_BSON('{"c":[{"a":[{"b":1},{"b":2},{"b":3},{"b":4}]}]}':>BSON, 'c', 'a', 'b'):>JSON AS Result;

+-------------+
| Result      |
+-------------+
| [[1,2,3,4]] |
+-------------+

SQL

SELECT 
BSON_EXTRACT_ALL_BSON('{"a":[{"b":[1,2]},{"b":[3,4]},{"b":[5,6]},{"b":[7,8]}]}':>BSON, 'a', 'b'):>JSON AS Result;

+---------------------------+
| Result                    |
+---------------------------+
| [[1,2],[3,4],[5,6],[7,8]] |
+---------------------------+

Returns the top-level document because the path is not specified:

SQL

SELECT 
BSON_EXTRACT_ALL_BSON('{"c":[{"a":[{"b":1},{"b":2},{"b":3},{"b":4}]}]}':>BSON):>JSON AS Result;

+-------------------------------------------------+
| Result                                          |
+-------------------------------------------------+
| {"c":[{"a":[{"b":1},{"b":2},{"b":3},{"b":4}]}]} |
+-------------------------------------------------+

Returns NULL because the specified path does not exist in the BSON document:

SQL

SELECT 
BSON_EXTRACT_ALL_BSON('{"c":[{"a":[{"b":1},{"b":2},{"b":3},{"b":4}]}]}':>BSON, 'c', 'd'):>JSON AS Result;

+--------+
| Result |
+--------+
| NULL   |
+--------+