diff --git a/docs/querying/math-expr.md b/docs/querying/math-expr.md index 01f9fe95d32a..3f8e1f16f512 100644 --- a/docs/querying/math-expr.md +++ b/docs/querying/math-expr.md @@ -192,7 +192,7 @@ See javadoc of java.lang.Math for detailed explanation for each function. | array_set_add_all(arr1,arr2) | combines the unique set of elements of 2 arrays, the resulting array type determined by the type of the first array | | array_slice(arr,start,end) | return the subarray of arr from the 0 based index start(inclusive) to end(exclusive), or `null`, if start is less than 0, greater than length of arr or less than end| | array_to_string(arr,str) | joins all elements of arr by the delimiter specified by str | -| string_to_array(str1,str2) | splits str1 into an array on the delimiter specified by str2 | +| string_to_array(str1,str2) | splits str1 into an array on the delimiter specified by str2, which is a regular expression | ## Apply functions diff --git a/docs/querying/sql-functions.md b/docs/querying/sql-functions.md index 40fabb8a6ed2..d2c86b49d4a7 100644 --- a/docs/querying/sql-functions.md +++ b/docs/querying/sql-functions.md @@ -827,6 +827,14 @@ Returns an array of all paths which refer to literal values in `expr` in JSONPat Extracts a `COMPLEX` value from `expr`, at the specified `path`. +## JSON_QUERY_ARRAY + +**Function type:** [JSON](sql-json-functions.md) + +`JSON_QUERY_ARRAY(expr, path)` + +Extracts an `ARRAY>` value from `expr`, at the specified `path`. If value is not an `ARRAY`, it will be translated into a single element `ARRAY` containing the value at `path`. The primary use of this function is to allow extracting arrays of objects to use as inputs to other [array functions](./sql-array-functions.md). + ## JSON_VALUE **Function type:** [JSON](sql-json-functions.md) @@ -1283,7 +1291,7 @@ Returns a string formatted in accordance to Java's String.format method. **Function type:** [Multi-value string](sql-multivalue-string-functions.md) -Converts a string into an array, split by the given delimiter. +Splits `str1` into an multi-value string on the delimiter specified by `str2`, which is a regular expression. ## STRLEN diff --git a/docs/querying/sql-json-functions.md b/docs/querying/sql-json-functions.md index d499fef5087f..4af4f96a319f 100644 --- a/docs/querying/sql-json-functions.md +++ b/docs/querying/sql-json-functions.md @@ -40,7 +40,7 @@ You can use the following JSON functions to extract, transform, and create `COMP |`JSON_OBJECT(KEY expr1 VALUE expr2[, KEY expr3 VALUE expr4, ...])` | Constructs a new `COMPLEX` object. The `KEY` expressions must evaluate to string types. The `VALUE` expressions can be composed of any input type, including other `COMPLEX` values. `JSON_OBJECT` can accept colon-separated key-value pairs. The following syntax is equivalent: `JSON_OBJECT(expr1:expr2[, expr3:expr4, ...])`.| |`JSON_PATHS(expr)`| Returns an array of all paths which refer to literal values in `expr` in JSONPath format. | |`JSON_QUERY(expr, path)`| Extracts a `COMPLEX` value from `expr`, at the specified `path`. | -|`JSON_QUERY_ARRAY(expr, path)`| Extracts an `ARRAY>` value from `expr`, at the specified `path`. If value is not an `ARRAY`, it will be translated into a single element `ARRAY` containing the value at `path`.| +|`JSON_QUERY_ARRAY(expr, path)`| Extracts an `ARRAY>` value from `expr`, at the specified `path`. If value is not an `ARRAY`, it will be translated into a single element `ARRAY` containing the value at `path`. The primary use of this function is to allow extracting arrays of objects to use as inputs to other [array functions](./sql-array-functions.md)| |`JSON_VALUE(expr, path [RETURNING sqlType])`| Extracts a literal value from `expr` at the specified `path`. If you specify `RETURNING` and an SQL type name (such as `VARCHAR`, `BIGINT`, `DOUBLE`, etc) the function plans the query using the suggested type. Otherwise, it attempts to infer the type based on the context. If it can't infer the type, it defaults to `VARCHAR`.| |`PARSE_JSON(expr)`|Parses `expr` into a `COMPLEX` object. This operator deserializes JSON values when processing them, translating stringified JSON into a nested structure. If the input is not a `VARCHAR` or it is invalid JSON, this function will result in an error.| |`TRY_PARSE_JSON(expr)`|Parses `expr` into a `COMPLEX` object. This operator deserializes JSON values when processing them, translating stringified JSON into a nested structure. If the input is not a `VARCHAR` or it is invalid JSON, this function will result in a `NULL` value.|