[fix] correct typos / wrong descriptions / stray markdown in SQL data-type and aggregate-function docs

docs/sql-manual/basic-element/sql-data-types/semi-structured/JSON.md

@@ -310,8 +310,7 @@ mysql> SELECT cast('[1,                 2]' as json);
 ```
 
 ### Key Differences and Notes:
-- CAST(string AS JSON): Used to parse strings that conform to JSON syntax.
-- CAST(string AS JSON): For Number types, it will only parse Int8, Int16, Int32, Int64, Int128, and Double types, not Decimal type.
+- CAST(string AS JSON): Used to parse strings that conform to JSON syntax. For Number types, it will only parse Int8, Int16, Int32, Int64, Int128, and Double types, not Decimal type.
 - Unlike most other JSON implementations, Doris's JSONB type supports up to Int128 precision. Numbers exceeding Int128 precision may overflow.
 - If the input number string is 12.34, it will be parsed as a Double; if there's no decimal point, it will be parsed as an integer (if the size exceeds Int128 range, it will be converted to Double but with precision loss)
 

docs/sql-manual/basic-element/sql-data-types/string-type/STRING.md

@@ -2,13 +2,12 @@
 {
     "title": "STRING",
     "language": "en",
-    "description": "STRING (M) A variable length string. Default support is 1048576 bytes (1M), adjustable up to 2147483643 bytes (2G),"
+    "description": "A variable length string. Default support is 1048576 bytes (1M), adjustable up to 2147483643 bytes (2G),"
 }
 ---
 
 ## STRING
 ### Description
-STRING (M)
 A variable length string. Default support is 1048576 bytes (1M), adjustable up to 2147483643 bytes (2G),and the length of the String type is also limited by the configuration string_type_length_soft_limit_bytes(a soft limit of string type length) of be. the String type can only be used in the value column, not in the key column and the partition and bucket columns
 
 Note: Variable length strings are stored in UTF-8 encoding, so usually English characters occupies 1 byte, and Chinese characters occupies 3 bytes.

docs/sql-manual/basic-element/variables.md

@@ -109,7 +109,7 @@ User-defined variables are a mechanism for temporarily storing data within a ses
     | allow_partition_column_nullable                            | true                                  | true                                  | 0       |
     | analyze_timeout                                           | 43200                                 | 43200                                 | 0       |
     | version                                                      | 5.7.99                                | 5.7.99                                | 0       |
-    | version_comment                                                | Doris version doris0.0.0--de61c5823 | Doris version doris-0.0--de61c5823 | 0       |
+    | version_comment                                                | Doris version doris-0.0.0--de61c58223 | Doris version doris-0.0.0--de61c58223 | 0       |
     | wait_full_block_schedule_times                                 | 2                                     | 2                                     | 0       |
     | wait_timeout                                               | 28800                                 | 28800                                 | 0       |
     | workload_group                                                 |                                       |                                       | 0       |

docs/sql-manual/sql-functions/aggregate-functions/ai-agg.md

@@ -107,7 +107,7 @@ INSERT INTO product_reviews VALUES
 
 Using AI_AGG to summarize and evaluate:
 ```sql
-SET default_ai_resoure = 'ai_resource_name';
+SET default_ai_resource = 'ai_resource_name';
 SELECT
     product_id,
     AI_AGG(

docs/sql-manual/sql-functions/aggregate-functions/array-agg.md

@@ -67,6 +67,3 @@ select array_agg(c2) from test_doris_array_agg where c1 is null;
 | []            |
 +---------------+
 ```
-|    1 | ["a","b"]       |
-
-

docs/sql-manual/sql-functions/aggregate-functions/bitmap-intersect.md

@@ -28,8 +28,6 @@ Returns a value of Bitmap type. If there is no valid data in the group, returns
 
 ## Example
 
-## Example
-
 ```sql
 -- setup
 CREATE TABLE user_tags (

docs/sql-manual/sql-functions/aggregate-functions/bool-or.md

@@ -28,7 +28,7 @@ BOOL_OR(<expr>)
 
 ## Return Value
 
-The return value is BOOLEAN. It returns TRUE when all non-NULL values exist, otherwise it returns FALSE.
+The return value is BOOLEAN. It returns TRUE when at least one non-NULL value is TRUE, otherwise it returns FALSE.
 
 If all values of the expression are NULL or the expression is empty, the function returns NULL.
 

docs/sql-manual/sql-functions/aggregate-functions/covar-samp.md

@@ -74,7 +74,3 @@ select id, covar_samp(x, y) from baseall group by id;
 |    5 |             NULL |
 +------+------------------+
 ```
-|    4 |             NULL |
-|    5 |             NULL |
-+------+------------------+
-```

docs/sql-manual/sql-functions/aggregate-functions/histogram.md

@@ -126,8 +126,8 @@ Query result description:
 Field description:
 - num_buckets: The number of buckets
 - buckets: All buckets
-    - lower: Upper bound of the bucket
-    - upper: Lower bound of the bucket
+    - lower: Lower bound of the bucket
+    - upper: Upper bound of the bucket
     - count: The number of elements contained in the bucket
     - pre_sum: The total number of elements in the front bucket
     - ndv: The number of different values in the bucket

docs/sql-manual/sql-functions/aggregate-functions/percentile_reservoir.md

@@ -76,14 +76,14 @@ FROM sales_data;
 ```
 
 ```sql
-select percentile(sale_price, NULL) from sales_data;
+select percentile_reservoir(sale_price, NULL) from sales_data;
 ```
 
 If all input values are NULL, returns NULL.
 
 ```text
 +------------------------------+
-| percentile(sale_price, NULL) |
+| percentile_reservoir(sale_price, NULL) |
 +------------------------------+
 |                         NULL |
 +------------------------------+

versioned_docs/version-2.1/sql-manual/basic-element/sql-data-types/string-type/STRING.md

@@ -2,13 +2,12 @@
 {
     "title": "STRING",
     "language": "en",
-    "description": "STRING (M) A variable length string. Default support is 1048576 bytes (1M), adjustable up to 2147483643 bytes (2G),"
+    "description": "A variable length string. Default support is 1048576 bytes (1M), adjustable up to 2147483643 bytes (2G),"
 }
 ---
 
 ## STRING
 ### Description
-STRING (M)
 A variable length string. Default support is 1048576 bytes (1M), adjustable up to 2147483643 bytes (2G),and the length of the String type is also limited by the configuration string_type_length_soft_limit_bytes(a soft limit of string type length) of be. the String type can only be used in the value column, not in the key column and the partition and bucket columns
 
 Note: Variable length strings are stored in UTF-8 encoding, so usually English characters occupies 1 byte, and Chinese characters occupies 3 bytes.

versioned_docs/version-2.1/sql-manual/basic-element/variables.md

@@ -109,7 +109,7 @@ User-defined variables are a mechanism for temporarily storing data within a ses
     | allow_partition_column_nullable                            | true                                  | true                                  | 0       |
     | analyze_timeout                                           | 43200                                 | 43200                                 | 0       |
     | version                                                      | 5.7.99                                | 5.7.99                                | 0       |
-    | version_comment                                                | Doris version doris0.0.0--de61c5823 | Doris version doris-0.0--de61c5823 | 0       |
+    | version_comment                                                | Doris version doris-0.0.0--de61c58223 | Doris version doris-0.0.0--de61c58223 | 0       |
     | wait_full_block_schedule_times                                 | 2                                     | 2                                     | 0       |
     | wait_timeout                                               | 28800                                 | 28800                                 | 0       |
     | workload_group                                                 |                                       |                                       | 0       |

versioned_docs/version-3.x/sql-manual/basic-element/sql-data-types/string-type/STRING.md

@@ -1,14 +1,13 @@
 ---
 {
     "title": "STRING",
     "language": "en",
-    "description": "STRING (M) A variable length string. Default support is 1048576 bytes (1M), adjustable up to 2147483643 bytes (2G),"
+    "description": "A variable length string. Default support is 1048576 bytes (1M), adjustable up to 2147483643 bytes (2G),"
 }
 ---
 
 ## STRING
 ### Description
-STRING (M)
 A variable length string. Default support is 1048576 bytes (1M), adjustable up to 2147483643 bytes (2G),and the length of the String type is also limited by the configuration string_type_length_soft_limit_bytes(a soft limit of string type length) of be. the String type can only be used in the value column, not in the key column and the partition and bucket columns
 
 Note: Variable length strings are stored in UTF-8 encoding, so usually English characters occupies 1 byte, and Chinese characters occupies 3 bytes.

versioned_docs/version-3.x/sql-manual/basic-element/variables.md

@@ -1,4 +1,4 @@
 ---
 {
     "title": "Variables",
     "language": "en",
@@ -109,7 +109,7 @@
     | allow_partition_column_nullable                            | true                                  | true                                  | 0       |
     | analyze_timeout                                           | 43200                                 | 43200                                 | 0       |
     | version                                                      | 5.7.99                                | 5.7.99                                | 0       |
-    | version_comment                                                | Doris version doris0.0.0--de61c5823 | Doris version doris-0.0--de61c5823 | 0       |
+    | version_comment                                                | Doris version doris-0.0.0--de61c58223 | Doris version doris-0.0.0--de61c58223 | 0       |
     | wait_full_block_schedule_times                                 | 2                                     | 2                                     | 0       |
     | wait_timeout                                               | 28800                                 | 28800                                 | 0       |
     | workload_group                                                 |                                       |                                       | 0       |

versioned_docs/version-4.x/sql-manual/basic-element/sql-data-types/semi-structured/JSON.md

@@ -1,4 +1,4 @@
 ---
 {
     "title": "JSON | Semi Structured",
     "language": "en",
@@ -11,7 +11,7 @@
 
 ## JSON Introduction
 
 JSON (JavaScript Object Notation) is an open standard file format and data interchange format that uses human-readable text to store and transmit data. According to the official specification [RFC7159](https://datatracker.ietf.org/doc/html/rfc7159), JSON supports the following basic types:
 - Bool
 - Null
 - Number
@@ -19,7 +19,7 @@
 - Array
 - Object
 
 The JSON data type stores [JSON](https://www.rfc-editor.org/rfc/rfc8785) data efficiently in a binary format and allows access to its internal fields through JSON functions.
 
 By default, it supports up to 1048576 bytes (1MB), and can be increased up to 2147483643 bytes (2GB). This can be adjusted via the `string_type_length_soft_limit_bytes` configuration.
 
@@ -219,7 +219,7 @@
 ```sql
 json_column_name JSON
 ```
 
 **Insertion:**
 - Using `INSERT INTO VALUES` with the format as a string surrounded by quotes. For example:
 ```sql
@@ -310,8 +310,7 @@
 ```
 
 ### Key Differences and Notes:
-- CAST(string AS JSON): Used to parse strings that conform to JSON syntax.
-- CAST(string AS JSON): For Number types, it will only parse Int8, Int16, Int32, Int64, Int128, and Double types, not Decimal type.
+- CAST(string AS JSON): Used to parse strings that conform to JSON syntax. For Number types, it will only parse Int8, Int16, Int32, Int64, Int128, and Double types, not Decimal type.
 - Unlike most other JSON implementations, Doris's JSONB type supports up to Int128 precision. Numbers exceeding Int128 precision may overflow.
 - If the input number string is 12.34, it will be parsed as a Double; if there's no decimal point, it will be parsed as an integer (if the size exceeds Int128 range, it will be converted to Double but with precision loss)
 
@@ -392,19 +391,19 @@
 7. Nested structure handling:
    - Objects and arrays support unlimited nesting levels
    - Each nesting level processed recursively using the same rules
 
 ## Number Precision Issues
 
 When converting Doris internal types to JSONB using to_json, no precision loss occurs.
 When using Doris internal JSON functions, if the return value is also a JSONB type, no precision loss occurs.
 However, converting Doris JSONB to plain text and then back to JSONB can cause precision loss.
 
 Example: Doris JSON type object
 ```
 Object{
     "a": (Decimal 18446744073709551616.123)
 }
 ```
 
 Converted to plain text:
 ```
@@ -419,9 +418,9 @@
 ```
 
 ## Configuration and Limitations
 - JSON supports 1,048,576 bytes (1 MB) by default
 - Size limit can be adjusted via the BE configuration parameter string_type_length_soft_limit_bytes
 - Maximum adjustment up to 2,147,483,643 bytes (approximately 2 GB)
 - In Doris JSON type Objects, key length cannot exceed 255 bytes
 
 ## Usage Example
@@ -443,7 +442,7 @@
 PROPERTIES("replication_num" = "1");
 ```
 
 #### Load data
 
 ##### stream load test_json.csv test data
 
@@ -473,7 +472,7 @@
 19	''
 20	'abc'
 21	abc
 22	100x
 23	6.a8
 24	{x
 25	[123, abc]
@@ -497,7 +496,7 @@
     "LoadTimeMs": 48,
     "BeginTxnTimeMs": 0,
     "StreamLoadPutTimeMs": 1,
     "ReadDataTimeMs": 0,
     "WriteDataTimeMs": 45,
     "CommitAndPublishTimeMs": 0,
     "ErrorURL": "http://172.21.0.5:8840/api/_load_error_log?file=__shard_2/error_log_insert_stmt_95435c4bf5f156df-426735082a9296af_95435c4bf5f156df_426735082a9296af"
@@ -522,7 +521,7 @@
     "BeginTxnTimeMs": 0,
     "StreamLoadPutTimeMs": 2,
     "ReadDataTimeMs": 0,
     "WriteDataTimeMs": 45,
     "CommitAndPublishTimeMs": 19,
     "ErrorURL": "http://172.21.0.5:8840/api/_load_error_log?file=__shard_0/error_log_insert_stmt_a1463f98a7b15caf-c79399b920f5bfa3_a1463f98a7b15caf_c79399b920f5bfa3"
 }

versioned_docs/version-4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.md

@@ -1,14 +1,13 @@
 ---
 {
     "title": "STRING",
     "language": "en",
-    "description": "STRING (M) A variable length string. Default support is 1048576 bytes (1M), adjustable up to 2147483643 bytes (2G),"
+    "description": "A variable length string. Default support is 1048576 bytes (1M), adjustable up to 2147483643 bytes (2G),"
 }
 ---
 
 ## STRING
 ### Description
-STRING (M)
 A variable length string. Default support is 1048576 bytes (1M), adjustable up to 2147483643 bytes (2G),and the length of the String type is also limited by the configuration string_type_length_soft_limit_bytes(a soft limit of string type length) of be. the String type can only be used in the value column, not in the key column and the partition and bucket columns
 
 Note: Variable length strings are stored in UTF-8 encoding, so usually English characters occupies 1 byte, and Chinese characters occupies 3 bytes.

versioned_docs/version-4.x/sql-manual/basic-element/variables.md

@@ -109,7 +109,7 @@ User-defined variables are a mechanism for temporarily storing data within a ses
     | allow_partition_column_nullable                            | true                                  | true                                  | 0       |
     | analyze_timeout                                           | 43200                                 | 43200                                 | 0       |
     | version                                                      | 5.7.99                                | 5.7.99                                | 0       |
-    | version_comment                                                | Doris version doris0.0.0--de61c5823 | Doris version doris-0.0--de61c5823 | 0       |
+    | version_comment                                                | Doris version doris-0.0.0--de61c58223 | Doris version doris-0.0.0--de61c58223 | 0       |
     | wait_full_block_schedule_times                                 | 2                                     | 2                                     | 0       |
     | wait_timeout                                               | 28800                                 | 28800                                 | 0       |
     | workload_group                                                 |                                       |                                       | 0       |

versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.md

@@ -107,7 +107,7 @@ INSERT INTO product_reviews VALUES
 
 Using AI_AGG to summarize and evaluate:
 ```sql
-SET default_ai_resoure = 'ai_resource_name';
+SET default_ai_resource = 'ai_resource_name';
 SELECT
     product_id,
     AI_AGG(

versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/array-agg.md

@@ -67,6 +67,3 @@ select array_agg(c2) from test_doris_array_agg where c1 is null;
 | []            |
 +---------------+
 ```
-|    1 | ["a","b"]       |
-
-

versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/bitmap-intersect.md

@@ -28,8 +28,6 @@ Returns a value of Bitmap type. If there is no valid data in the group, returns
 
 ## Example
 
-## Example
-
 ```sql
 -- setup
 CREATE TABLE user_tags (

versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/bool-or.md

@@ -28,7 +28,7 @@ BOOL_OR(<expr>)
 
 ## Return Value
 
-The return value is BOOLEAN. It returns TRUE when all non-NULL values exist, otherwise it returns FALSE.
+The return value is BOOLEAN. It returns TRUE when at least one non-NULL value is TRUE, otherwise it returns FALSE.
 
 If all values of the expression are NULL or the expression is empty, the function returns NULL.
 

versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/covar-samp.md

@@ -74,7 +74,3 @@ select id, covar_samp(x, y) from baseall group by id;
 |    5 |             NULL |
 +------+------------------+
 ```
-|    4 |             NULL |
-|    5 |             NULL |
-+------+------------------+
-```

versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/histogram.md

@@ -126,8 +126,8 @@ Query result description:
 Field description:
 - num_buckets: The number of buckets
 - buckets: All buckets
-    - lower: Upper bound of the bucket
-    - upper: Lower bound of the bucket
+    - lower: Lower bound of the bucket
+    - upper: Upper bound of the bucket
     - count: The number of elements contained in the bucket
     - pre_sum: The total number of elements in the front bucket
     - ndv: The number of different values in the bucket

versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/percentile_reservoir.md

@@ -8,7 +8,7 @@
 
 ## Description
 
 This function applies [reservoir sampling](https://en.wikipedia.org/wiki/Reservoir_sampling) with a reservoir size up to 8192 and a random number generator for sampling. This used to calculate approximate percentiles at position `p`.
 The value of `p` is between `0` and `1`.
 Note that this is not the average of the two numbers.
 
@@ -76,14 +76,14 @@
 ```
 
 ```sql
-select percentile(sale_price, NULL) from sales_data;
+select percentile_reservoir(sale_price, NULL) from sales_data;
 ```
 
 If all input values are NULL, returns NULL.
 
 ```text
 +------------------------------+
-| percentile(sale_price, NULL) |
+| percentile_reservoir(sale_price, NULL) |
 +------------------------------+
 |                         NULL |
 +------------------------------+