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_COMPARE

Syntax

BSON_COMPARE(<input1>, <input2>)

Arguments

<input1>, <input2>: Any valid BSON value or an expression that evaluates to a valid BSON value.

Return Type

BSON_COMPARE() returns the following values:

Comparison	Output
`<input1>` equals `<input2>`	0
`<input1>` is less than `<input2>`	-1
`<input1>` is greater than `<input2>`	1

Remarks

BSON_COMPARE() returns NULL for cross-type comparisons.

Examples

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

Here are a few examples of valid BSON value comparisons:

SQL

SELECT BSON_COMPARE('"string"':>BSON,'"string"':>BSON) AS Result;

+--------+
| Result |
+--------+
|      0 |
+--------+

SQL

SELECT BSON_COMPARE('{"$oid":"641044fd4542e7dc53758df9"}':>BSON,'{"$oid":"641044fd4542e7dc53758df9"}':>BSON) AS Result;

+--------+
| Result |
+--------+
|      0 |
+--------+

SQL

SELECT BSON_COMPARE('{"$numberLong":"99991241"}':>BSON, 99991241:>BSON) AS Result;

+--------+
| Result |
+--------+
|      0 |
+--------+

SQL

SELECT BSON_COMPARE('{"$numberLong":"99991241"}':>BSON, '{"$numberDecimal":"211"}':>BSON) AS Result;

+--------+
| Result |
+--------+
|      1 |
+--------+

SQL

SELECT BSON_COMPARE('null':>BSON,'null':>BSON) AS Result;

+--------+
| Result |
+--------+
|      0 |
+--------+

The following examples return NULL because of cross-type value comparisons:

SQL

SELECT BSON_COMPARE('{"$numberLong":"99991241"}':>BSON, '"99991241"':>BSON) AS Result;

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

SQL

SELECT BSON_COMPARE('{"$date":"2023-03-14T09:48:10.720Z"}':>BSON, '"2023-03-14T09:48:10.720Z"':>BSON) AS Result;

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