Important

Helios features are now enabled during weekly update windows and are no longer directly tied to SingleStore engine releases. Refer to the release notes to view the latest features available in your Helios cluster.

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 |
+--------+

BSON_COMPARE

On this page

Syntax

Arguments

Return Type

Remarks

Examples

Was this article helpful?

On this page

Was this article helpful?