Important

The SingleStore 9.1 release candidate (RC) is available now. It will be promoted to general availability (GA) soon and at that time it will be renamed to SingleStore 10.

In the interim, SingleStore 9.1 RC can be used to preview, evaluate, and provide feedback on the new and upcoming features in SingleStore 10, while SingleStore 9.0 is recommended for production workloads.

BSON_ARRAY_PUSH

Syntax

BSON_ARRAY_PUSH(<array>, <value>)

Arguments

<array>: A valid BSON array or an expression that evaluates to a BSON array.
<value>: A BSON value to be appended to the input array.

Return Type

A BSON array.

Remarks

If NULL is specified as the input array, it is considered as an empty BSON array.
If NULL is specified as the value to append, it is considered as the BSON NULL type.

Examples

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

SQL

SELECT BSON_ARRAY_PUSH('[1, true, null, [7,8,9], "abc"]':>BSON, '{"a":{"b":9}}':>BSON):>JSON AS Result;

+-------------------------------------------+
| Result                                    |
+-------------------------------------------+
| [1,true,null,[7,8,9],"abc",{"a":{"b":9}}] |
+-------------------------------------------+

SQL

SELECT BSON_ARRAY_PUSH('[]':>BSON, '"abc"':>BSON):>JSON AS Result;

+---------+
| Result  |
+---------+
| ["abc"] |
+---------+

SQL

SELECT BSON_ARRAY_PUSH('[1,2,3,4]':>BSON, 'null':>BSON):>JSON AS Result;

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