update function files

ritvibhatt · ritvibhatt · commit e4f01a00d42e · 2025-10-20T11:07:35.000-07:00
Signed-off-by: Ritvi Bhatt &lt;ribhatt@amazon.com&gt;
diff --git a/docs/user/ppl/functions/condition.rst b/docs/user/ppl/functions/condition.rst
@@ -14,9 +14,9 @@ ISNULL
 Description
 >>>>>>>>>>>
 
-Usage: isnull(field) return true if field is null.
+Usage: isnull(field) returns true if field is null.
 
-Argument type: all the supported data type.
+Argument type: all the supported data types.
 
 Return type: BOOLEAN
 
@@ -39,9 +39,9 @@ ISNOTNULL
 Description
 >>>>>>>>>>>
 
-Usage: isnotnull(field) return true if field is not null.
+Usage: isnotnull(field) returns true if field is not null.
 
-Argument type: all the supported data type.
+Argument type: all the supported data types.
 
 Return type: BOOLEAN
 
@@ -60,7 +60,7 @@ Example::
 EXISTS
 ------
 
-`Because OpenSearch doesn't differentiate null and missing <https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-exists-query.html>`_. so we can't provide function like ismissing/isnotmissing to test field exist or not. But you can still use isnull/isnotnull for such purpose.
+`Since OpenSearch doesn't differentiate null and missing <https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-exists-query.html>`_, we can't provide functions like ismissing/isnotmissing to test if a field exists or not. But you can still use isnull/isnotnull for such purpose.
 
 Example, the account 13 doesn't have email field::
 
@@ -78,9 +78,9 @@ IFNULL
 Description
 >>>>>>>>>>>
 
-Usage: ifnull(field1, field2) return field2 if field1 is null.
+Usage: ifnull(field1, field2) returns field2 if field1 is null.
 
-Argument type: all the supported data type, (NOTE : if two parameters has different type, you will fail semantic check.)
+Argument type: all the supported data types (NOTE : if two parameters have different types, you will fail semantic check).
 
 Return type: any
 
@@ -123,9 +123,9 @@ NULLIF
 Description
 >>>>>>>>>>>
 
-Usage: nullif(field1, field2) return null if two parameters are same, otherwise return field1.
+Usage: nullif(field1, field2) returns null if two parameters are same, otherwise returns field1.
 
-Argument type: all the supported data type, (NOTE : if two parameters has different type, if two parameters has different type, you will fail semantic check)
+Argument type: all the supported data types (NOTE : if two parameters have different types, you will fail semantic check).
 
 Return type: any
 
@@ -149,9 +149,9 @@ ISNULL
 Description
 >>>>>>>>>>>
 
-Usage: isnull(field1, field2) return null if two parameters are same, otherwise return field1.
+Usage: isnull(field1, field2) returns null if two parameters are same, otherwise returns field1.
 
-Argument type: all the supported data type
+Argument type: all the supported data types.
 
 Return type: any
 
@@ -174,9 +174,9 @@ IF
 Description
 >>>>>>>>>>>
 
-Usage: if(condition, expr1, expr2) return expr1 if condition is true, otherwise return expr2.
+Usage: if(condition, expr1, expr2) returns expr1 if condition is true, otherwise returns expr2.
 
-Argument type: all the supported data type, (NOTE : if expr1 and expr2 are different type,  you will fail semantic check
+Argument type: all the supported data types (NOTE : if expr1 and expr2 are different types, you will fail semantic check).
 
 Return type: any
 
@@ -221,9 +221,9 @@ CASE
 Description
 >>>>>>>>>>>
 
-Usage: case(condition1, expr1, condition2, expr2, ... conditionN, exprN else default) return expr1 if condition1 is true, or return expr2 if condition2 is true, ... if no condition is true, then return the value of ELSE clause. If the ELSE clause is not defined, it returns NULL.
+Usage: case(condition1, expr1, condition2, expr2, ... conditionN, exprN else default) returns expr1 if condition1 is true, or returns expr2 if condition2 is true, ... if no condition is true, then returns the value of ELSE clause. If the ELSE clause is not defined, returns NULL.
 
-Argument type: all the supported data type, (NOTE : there is no comma before "else")
+Argument type: all the supported data types (NOTE : there is no comma before "else").
 
 Return type: any
 
@@ -266,11 +266,9 @@ COALESCE
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
+Usage: coalesce(field1, field2, ...) returns the first non-null, non-missing value in the argument list.
 
-Usage: coalesce(field1, field2, ...) return the first non-null, non-missing value in the argument list.
-
-Argument type: all the supported data type. Supports mixed data types with automatic type coercion.
+Argument type: all the supported data types. Supports mixed data types with automatic type coercion.
 
 Return type: determined by the least restrictive common type among all arguments, with fallback to string if no common type can be determined
 
@@ -364,11 +362,9 @@ ISPRESENT
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Usage: ispresent(field) return true if the field exists.
+Usage: ispresent(field) returns true if the field exists.
 
-Argument type: all the supported data type.
+Argument type: all the supported data types.
 
 Return type: BOOLEAN
 
@@ -392,11 +388,9 @@ ISBLANK
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
 Usage: isblank(field) returns true if the field is null, an empty string, or contains only white space.
 
-Argument type: all the supported data type.
+Argument type: all the supported data types.
 
 Return type: BOOLEAN
 
@@ -420,11 +414,9 @@ ISEMPTY
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
 Usage: isempty(field) returns true if the field is null or is an empty string.
 
-Argument type: all the supported data type.
+Argument type: all the supported data types.
 
 Return type: BOOLEAN
 
@@ -447,9 +439,7 @@ EARLIEST
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Usage: earliest(relative_string, field) returns true if the value of field is after the timestamp derived from relative_string relative to the current time. Otherwise, return false.
+Usage: earliest(relative_string, field) returns true if the value of field is after the timestamp derived from relative_string relative to the current time. Otherwise, returns false.
 
 relative_string: 
 The relative string can be one of the following formats:
@@ -503,9 +493,7 @@ LATEST
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Usage: latest(relative_string, field) returns true if the value of field is before the timestamp derived from relative_string relative to the current time. Otherwise, return false.
+Usage: latest(relative_string, field) returns true if the value of field is before the timestamp derived from relative_string relative to the current time. Otherwise, returns false.
 
 Argument type: relative_string:STRING, field: TIMESTAMP
 
@@ -535,8 +523,6 @@ REGEX_MATCH
 Description
 >>>>>>>>>>>
 
-Version: 3.3.0
-
 Usage: regex_match(string, pattern) returns true if the regular expression pattern finds a match against any substring of the string value, otherwise returns false.
 
 The function uses Java regular expression syntax for the pattern.
diff --git a/docs/user/ppl/functions/json.rst b/docs/user/ppl/functions/json.rst
@@ -39,10 +39,6 @@ JSON
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Limitation: Only works when plugins.calcite.enabled=true
-
 Usage: `json(value)` Evaluates whether a string can be parsed as a json-encoded string. Returns the value if valid, null otherwise.
 
 Argument type: STRING
@@ -68,10 +64,6 @@ JSON_OBJECT
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Limitation: Only works when plugins.calcite.enabled=true
-
 Usage: `json_object(key1, value1, key2, value2...)` create a json object string with key value pairs. The key must be string.
 
 Argument type: key1: STRING, value1: ANY, key2: STRING, value2: ANY ...
@@ -94,10 +86,6 @@ JSON_ARRAY
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Limitation: Only works when plugins.calcite.enabled=true
-
 Usage: `json_array(element1, element2, ...)` create a json array string with elements.
 
 Argument type: element1: ANY, element2: ANY ...
@@ -120,10 +108,6 @@ JSON_ARRAY_LENGTH
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Limitation: Only works when plugins.calcite.enabled=true
-
 Usage: `json_array_length(value)` parse the string to json array and return size,, null is returned in case of any other valid JSON string, null or an invalid JSON.
 
 Argument type: value: A JSON STRING
@@ -154,10 +138,6 @@ JSON_EXTRACT
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Limitation: Only works when plugins.calcite.enabled=true
-
 Usage: `json_extract(json_string, path1, path2, ...)` Extracts values using the specified JSON paths. If only one path is provided, it returns a single value. If multiple paths are provided, it returns a JSON Array in the order of the paths. If one path cannot find value, return null as the result for this path. The path use "{<index>}" to represent index for array, "{}" means "{*}".
 
 Argument type: json_string: STRING, path1: STRING, path2: STRING ...
@@ -188,10 +168,6 @@ JSON_DELETE
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Limitation: Only works when plugins.calcite.enabled=true
-
 Usage: `json_delete(json_string, path1, path2, ...)` Delete values using the specified JSON paths. Return the json string after deleting. If one path cannot find value, do nothing.
 
 Argument type: json_string: STRING, path1: STRING, path2: STRING ...
@@ -230,10 +206,6 @@ JSON_SET
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Limitation: Only works when plugins.calcite.enabled=true
-
 Usage: `json_set(json_string, path1, value1,  path2, value2...)` Set values to corresponding paths using the specified JSON paths. If one path's parent node is not a json object, skip the path. Return the json string after setting.
 
 Argument type: json_string: STRING, path1: STRING, value1: ANY, path2: STRING, value2: ANY ...
@@ -264,10 +236,6 @@ JSON_APPEND
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Limitation: Only works when plugins.calcite.enabled=true
-
 Usage: `json_append(json_string, path1, value1,  path2, value2...)` Append values to corresponding paths using the specified JSON paths. If one path's target node is not an array, skip the path. Return the json string after setting.
 
 Argument type: json_string: STRING, path1: STRING, value1: ANY, path2: STRING, value2: ANY ...
@@ -306,10 +274,6 @@ JSON_EXTEND
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Limitation: Only works when plugins.calcite.enabled=true
-
 Usage: `json_extend(json_string, path1, value1,  path2, value2...)` Extend values to corresponding paths using the specified JSON paths. If one path's target node is not an array, skip the path. The function will try to parse the value as an array. If it can be parsed, extend it to the target array. Otherwise, regard the value a single one. Return the json string after setting.
 
 Argument type: json_string: STRING, path1: STRING, value1: ANY, path2: STRING, value2: ANY ...
@@ -348,10 +312,6 @@ JSON_KEYS
 Description
 >>>>>>>>>>>
 
-Version: 3.1.0
-
-Limitation: Only works when plugins.calcite.enabled=true
-
 Usage: `json_keys(json_string)` Return the key list of the Json object as a Json array. Otherwise, return null.
 
 Argument type: json_string: A JSON STRING
diff --git a/docs/user/ppl/functions/statistical.rst b/docs/user/ppl/functions/statistical.rst
@@ -17,7 +17,7 @@ Description
 
 Usage: max(x, y, ...) returns the maximum value from all provided arguments. Strings are treated as greater than numbers, so if provided both strings and numbers, it will return the maximum string value (lexicographically ordered)
 
-Note: This function is only available in the eval command context and requires Calcite engine to be enabled.
+Note: This function is only available in the eval command context.
 
 Argument type: Variable number of INTEGER/LONG/FLOAT/DOUBLE/STRING arguments
 
@@ -67,7 +67,7 @@ Description
 
 Usage: min(x, y, ...) returns the minimum value from all provided arguments. Strings are treated as greater than numbers, so if provided both strings and numbers, it will return the minimum numeric value.
 
-Note: This function is only available in the eval command context and requires Calcite engine to be enabled.
+Note: This function is only available in the eval command context.
 
 Argument type: Variable number of INTEGER/LONG/FLOAT/DOUBLE/STRING arguments
 
