builtins: add jsonb_path_match

This commit adds the `jsonb_path_match` function, which returns a
boolean that evaluates the predicate query, and returns null if the
query result isn't a predicate.

Release note (sql change): Add the `jsonb_path_match` function, which
returns the result of a predicate query.

Author: normanchenn

docs/generated/sql/functions.md

@@ -1280,6 +1280,29 @@ argument is true, the function suppresses the following errors:
 missing object field or array element, unexpected JSON item type,
 datetime and numeric errors.</p>
 </span></td><td>Immutable</td></tr>
+<tr><td><a name="jsonb_path_match"></a><code>jsonb_path_match(target: jsonb, path: jsonpath) &rarr; <a href="bool.html">bool</a></code></td><td><span class="funcdesc"><p>Returns the SQL boolean result of a JSON path predicate check
+for the specified JSON value. (This is useful only with predicate check
+expressions, not SQL-standard JSON path expressions, since it will
+either fail or return NULL if the path result is not a single boolean
+value.)</p>
+</span></td><td>Immutable</td></tr>
+<tr><td><a name="jsonb_path_match"></a><code>jsonb_path_match(target: jsonb, path: jsonpath, vars: jsonb) &rarr; <a href="bool.html">bool</a></code></td><td><span class="funcdesc"><p>Returns the SQL boolean result of a JSON path predicate check
+for the specified JSON value. (This is useful only with predicate check
+expressions, not SQL-standard JSON path expressions, since it will
+either fail or return NULL if the path result is not a single boolean
+value.) The vars argument must be a JSON object, and its fields provide
+named values to be substituted into the jsonpath expression.</p>
+</span></td><td>Immutable</td></tr>
+<tr><td><a name="jsonb_path_match"></a><code>jsonb_path_match(target: jsonb, path: jsonpath, vars: jsonb, silent: <a href="bool.html">bool</a>) &rarr; <a href="bool.html">bool</a></code></td><td><span class="funcdesc"><p>Returns the SQL boolean result of a JSON path predicate check
+for the specified JSON value. (This is useful only with predicate check
+expressions, not SQL-standard JSON path expressions, since it will
+either fail or return NULL if the path result is not a single boolean
+value.) The vars argument must be a JSON object, and its fields provide
+named values to be substituted into the jsonpath expression. If the
+silent argument is true, the function suppresses the following errors:
+missing object field or array element, unexpected JSON item type,
+datetime and numeric errors.</p>
+</span></td><td>Immutable</td></tr>
 <tr><td><a name="jsonb_path_query"></a><code>jsonb_path_query(target: jsonb, path: jsonpath) &rarr; jsonb</code></td><td><span class="funcdesc"><p>Returns all JSON items returned by the JSON path for the specified JSON value.</p>
 </span></td><td>Immutable</td></tr>
 <tr><td><a name="jsonb_path_query"></a><code>jsonb_path_query(target: jsonb, path: jsonpath, vars: jsonb) &rarr; jsonb</code></td><td><span class="funcdesc"><p>Returns all JSON items returned by the JSON path for the specified JSON value.

pkg/ccl/logictestccl/tests/3node-tenant/generated_test.go

@@ -0,0 +1,27 @@
+# LogicTest: !local-mixed-24.3 !local-mixed-25.1
+
+query B
+SELECT jsonb_path_match('{}', '1 + 1 == 2');
+----
+true
+
+query B
+SELECT jsonb_path_match('{}', '"abc" starts with "b"');
+----
+false
+
+query T
+SELECT jsonb_path_match('{}', 'strict $', '{}', true);
+----
+NULL
+
+statement error pgcode 22038 pq: jsonb_path_match\(\): single boolean result is expected
+SELECT jsonb_path_match('{}', 'strict $', '{}', false);
+
+query T
+SELECT jsonb_path_match('{}', '$', '{}', true);
+----
+NULL
+
+statement error pgcode 22038 pq: jsonb_path_match\(\): single boolean result is expected
+SELECT jsonb_path_match('{}', '$', '{}', false);