Important

Self-managed SingleStore will soon transition from version 9.1 RC to version 10. This new semantic versioning scheme will provide SingleStore with finer control over engine and feature releases that were not possible with the current versioning scheme.

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 prior to its general availability. Ahead of this transition, SingleStore 9.0 is recommended for production workloads, which can later be upgraded to SingleStore 10.

BSON_UPDATE

Syntax

BSON_UPDATE(<bson_to_update>, <update>)

Arguments

bson_to_update: A valid BSON document or an expression that evaluates to a valid BSON document to update.
update: A valid BSON document that specifies the update operation to perform.

Return Type

A BSON value.

Remarks

BSON_UPDATE() does not support the following update operators:

$pull
$rename
$setOnInsert

Examples

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

The following are examples of different update operations on a BSON document or array:

Multiply

SQL

SELECT BSON_UPDATE('{"a":100, "b":50}':>BSON, '{"a":[{"$mul":2}]}':>BSON):>JSON AS Result;

+------------------+
| Result           |
+------------------+
| {"a":200,"b":50} |
+------------------+

Increment

SQL

SELECT BSON_UPDATE('{"a":100}':>BSON, '{"a":[{"$inc":50}]}':>BSON):>JSON AS Result;

+-----------+
| Result    |
+-----------+
| {"a":150} |
+-----------+

Add a new field

SQL

SELECT BSON_UPDATE('{"a":100, "b":50}':>BSON, '{"c":[{"$set":"New field"}]}':>BSON):>JSON AS Result;

+----------------------------------+
| Result                           |
+----------------------------------+
| {"a":100,"b":50,"c":"New field"} |
+----------------------------------+

Remove a field

SQL

SELECT BSON_UPDATE('{"a":100, "b":50}':>BSON, '{"b":[{"$unset":1}]}':>BSON):>JSON AS Result;

+-----------+
| Result    |
+-----------+
| {"a":100} |
+-----------+

Add elements to an array

SQL

SELECT BSON_UPDATE('{"a":[1,2,3]}':>BSON, '{"a":[{"$addToSet":{"$each":[4,5,4]}}]}':>BSON):> JSON AS Result;

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

SQL

SELECT BSON_UPDATE('{"a":[1,2,3]}':>BSON, '{"a":[{"$push":{"$each":[4,5]}}]}':>BSON):>JSON AS Result;

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

Remove elements from an array

SQL

SELECT BSON_UPDATE('{"a":[1,2,3,4,5]}':>BSON, '{"a":[{"$pop":1}]}':>BSON):> JSON AS Result;

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

SQL

SELECT BSON_UPDATE('{"a":[1,1,2,2,3,4,4,5]}':>BSON, '{"a":[{"$pullAll":[1,4]}]}':>BSON):> JSON AS Result;

+-----------------+
| Result          |
+-----------------+
| {"a":[2,2,3,5]} |
+-----------------+