update json_extract_xxx (#2629)

## Versions 

- [x] dev
- [ ] 3.0
- [ ] 2.1
- [ ] 2.0

## Languages

- [x] Chinese
- [x] English

Author: mrhhsg

docs/sql-manual/sql-functions/scalar-functions/json-functions/get-json-bigint.md

@@ -7,73 +7,4 @@
 
 ## Description
 
-Parses and obtains the integer (BIGINT) content of the specified path within the json string.
-
-## Syntax
-
-```sql
-GET_JSON_BIGINT( <json_str>, <json_path>)
-```
-
-## Required Parameters
-| parameters| described|
-|------|------|
-| `<json_str>`| The JSON string from which to extract data is needed. |
-| `<json_path>`| JSON path, specifying the location of the field. Paths can be denoted in dot notation. |
-
-
-## Return Value
-- Returns the BIGINT value of the field pointed to by the path.
-- Returns NULL if no corresponding field is found in the specified path, or the field value cannot be converted to type BIGINT.
-
-## Usage Notes
-
-Where `<json_str>` `must start with the $symbol and use. As a path splitter. If the path contains. , you can use double quotes to enclose it.
-Use [ ] to represent the array index, starting from 0.
-The content of path cannot contain ", [and].
-Returns NULL if the <json_str>format is incorrect, or the <json_path>format is incorrect, or a match cannot be found.
-In addition, it is recommended to use the jsonb type and the jsonb_extract_XXX function to achieve the same functionality.
-Special circumstances will be handled as follows:
-- Returns <json_path>NULL if the specified field does not exist in JSON
-- If <json_path>the actual type of the specified field in JSON is inconsistent with the type specified by json_extract_t, the specified type t will be returned if it can be losslessly converted to the specified type, and NULL will be returned if it cannot.
-
-## Examples
-
-1. Get the value with key as "k1"
-```sql
-SELECT get_json_bigint('{"k1":1, "k2":"2"}', "$.k1");
-```
-
-```sql
-+-----------------------------------------------+
-| get_json_bigint('{"k1":1, "k2":"2"}', '$.k1') |
-+-----------------------------------------------+
-|                                             1 |
-+-----------------------------------------------+
-```
-2. Gets the second element in the array with key "my.key"
-```sql
-SELECT get_json_bigint('{"k1":"v1", "my.key":[1, 1678708107000, 3]}', '$. "my.key"[1]');
-```
-
-```sql
-+---------------------------------------------------------------------------------+
-| get_json_bigint('{"k1":"v1", "my.key":[1, 1678708107000, 3]}', '$. "my.key"[1]') |
-+---------------------------------------------------------------------------------+
-|                                                                   1678708107000 |
-+---------------------------------------------------------------------------------+
-```
-3. Gets the first element in an array with secondary path k1.key -&gt; k2
-```sql
-SELECT get_json_bigint('{"k1.key":{"k2":[1678708107000, 2]}}', '$. "k1.key".k2[0]');
-```
-
-```sql
-
-+-----------------------------------------------------------------------------+
-| get_json_bigint('{"k1.key":{"k2":[1678708107000, 2]}}', '$."k1.key".k2[0]') |
-+-----------------------------------------------------------------------------+
-|                                                               1678708107000 |
-+-----------------------------------------------------------------------------+
-
-```
+Alias of function [`JSON_EXTRACT_BIGINT`](./json-extract-bigint.md).

docs/sql-manual/sql-functions/scalar-functions/json-functions/get-json-double.md

@@ -7,75 +7,4 @@
 
 ## Description
 
-Function is used to extract the value of a field from a JSON document and convert it to the DOUBLE type. This function returns the value of the field on the specified path, or returns NULL if the value cannot be converted to type DOUBLE or the field pointed to by the path does not exist.
-
-## Syntax
-
-```sql
-GET_JSON_DOUBLE( <json_str>, <json_path>)
-```
-
-## Required Parameters
-
-| parameters| described|
-|------|------|
-| `<json_str>`| The JSON string from which to extract data is needed. |
-| `<json_path>`| JSON path, specifying the location of the field. Paths can be denoted in dot notation. |
-
-## Return Value
-
-- Returns the DOUBLE value of the field pointed to by the path.
-- Returns NULL if no corresponding field is found in the specified path, or the field value cannot be converted to type DOUBLE.
-
-## Usage Notes
-
-Parses and obtains the floating point content of the specified path within the json string.
-Where `<json_path>` `must start with the $symbol and use. As a path splitter. If the path contains. , you can use double quotes to enclose it.
-Use [ ] to represent the array index, starting from 0.
-The content of path cannot contain ", [and].
-Returns NULL if `<json_str>` is incorrectly formatted, or json_path is incorrectly formatted, or a match cannot be found.
-In addition, it is recommended to use the jsonb type and the jsonb_extract_XXX function to achieve the same functionality.
-Special circumstances will be handled as follows:
-- Returns NULL if the field specified by json_path does not exist in JSON
-- If the actual type of the field specified by json_path in JSON is inconsistent with the type specified by json_extract_t, the specified type t is returned if it can be losslessly converted to the specified type, and NULL is returned if it cannot.
-
-## Examples
-
-1. Get the value with key as "k1"
-
-```sql
-SELECT get_json_double('{"k1":1.3, "k2":"2"}', "$.k1");
-```
-
-```sql
-+-------------------------------------------------+
-| get_json_double('{"k1":1.3, "k2":"2"}', '$.k1') |
-+-------------------------------------------------+
-|                                             1.3 |
-+-------------------------------------------------+
-```
-2. Gets the second element in the array with key "my.key"
-
-```sql
-SELECT get_json_double('{"k1":"v1", "my.key":[1.1, 2.2, 3.3]}', '$. "my.key"[1]');
-```
-
-```sql
-+---------------------------------------------------------------------------+
-| get_json_double('{"k1":"v1", "my.key":[1.1, 2.2, 3.3]}', '$."my.key"[1]') |
-+---------------------------------------------------------------------------+
-|                                                                       2.2 |
-+---------------------------------------------------------------------------+
-```
-
-3. Gets the first element in an array with secondary path k1.key -&gt; k2
-```sql
-SELECT get_json_double('{"k1.key":{"k2":[1.1, 2.2]}}', '$."k1.key".k2[0]');
-```
-```sql
-+---------------------------------------------------------------------+
-| get_json_double('{"k1.key":{"k2":[1.1, 2.2]}}', '$."k1.key".k2[0]') |
-+---------------------------------------------------------------------+
-|                                                                 1.1 |
-+---------------------------------------------------------------------+
-```
+Alias of function [`JSON_EXTRACT_DOUBLE`](./json-extract-double.md).

docs/sql-manual/sql-functions/scalar-functions/json-functions/get-json-int.md

@@ -7,73 +7,4 @@
 
 ## Description
 
-Function is used to extract the value of a field from a JSON document and convert it to type INT. This function returns the value of the field on the specified path, or returns NULL if the value cannot be converted to type INT or the field pointed to by the path does not exist.
-
-## Syntax
-
-```sql
-GET_JSON_INT( <json_str>, <json_path>)
-```
-
-## Required Parameters
-
-| parameters| described|
-|------|------|
-| `<json_str>`| The JSON string from which to extract data is needed. |
-| `<json_path>`| JSON path, specifying the location of the field. Paths can be denoted in dot notation. |
-
-## Usage Notes
-
-Parses and obtains the integer content of the specified path within the json string.
-Where `<json_path>` `must start with the $symbol and use. As a path splitter. If the path contains. , you can use double quotes to enclose it.
-Use [ ] to represent the array index, starting from 0.
-The content of path cannot contain ", [and].
-Returns NULL if the <json_str>format is incorrect, or the <json_path>format is incorrect, or a match cannot be found.
-In addition, it is recommended to use the jsonb type and the jsonb_extract_XXX function to achieve the same functionality.
-Special circumstances will be handled as follows:
-- Returns <json_path>NULL if the specified field does not exist in JSON
-- If <json_path>the actual type of the specified field in JSON is inconsistent with the type specified by json_extract_t, the specified type t will be returned if it can be losslessly converted to the specified type, and NULL will be returned if it cannot.
-
-## Examples
-
-1. Get the value with key as "k1"
-
-```sql
-SELECT get_json_int('{"k1":1, "k2":"2"}', "$.k1");
-```
-
-```sql
-
-+--------------------------------------------+
-| get_json_int('{"k1":1, "k2":"2"}', '$.k1') |
-+--------------------------------------------+
-|                                          1 |
-+--------------------------------------------+
-```
-
-2. Gets the second element in the array with key "my.key"
-
-```sql
-SELECT get_json_int('{"k1":"v1", "my.key":[1, 2, 3]}', '$."my.key"[1]');
-```
-
-```sql
-+------------------------------------------------------------------+
-| get_json_int('{"k1":"v1", "my.key":[1, 2, 3]}', '$."my.key"[1]') |
-+------------------------------------------------------------------+
-|                                                                2 |
-+------------------------------------------------------------------+
-
-3. Gets the first element in an array with secondary path k1.key -> k2
-
-```sql
- SELECT get_json_int('{"k1.key":{"k2":[1, 2]}}', '$."k1.key".k2[0]');
- ```
-
- ```sql
-+--------------------------------------------------------------+
-| get_json_int('{"k1.key":{"k2":[1, 2]}}', '$."k1.key".k2[0]') |
-+--------------------------------------------------------------+
-|                                                            1 |
-+--------------------------------------------------------------+
-```
+Alias of function [`JSON_EXTRACT_INT`](./json-extract-int.md).

docs/sql-manual/sql-functions/scalar-functions/json-functions/get-json-string.md

@@ -7,83 +7,4 @@
 
 ## Description
 
-This function is used to extract a field's value from a JSON document and convert it to `STRING` type. It returns the field value at the specified path. If the value cannot be converted to a string, or if the field at the specified path does not exist, it returns `NULL`.
-
-## Syntax
-
-```sql
-GET_JSON_STRING( <json_str>, <json_path>)
-```
-
-## Required Parameters
-
-| Parameter   | Description                                           |
-|-------------|-------------------------------------------------------|
-| `<json_str>` | The JSON string from which data needs to be extracted. |
-| `<json_path>` | JSON path that specifies the field's location. The path can use dot notation. |
-
-## Return Value
-It returns the `STRING` value of the field at the specified path.
-If the specified path does not point to a valid field or the field value cannot be converted to a `STRING` type, it returns `NULL`.
-
-## Usage Notes
-
-Parses and retrieves the string content of the specified path in the JSON string.
-The `<json_path>` must start with the `$` symbol, using `.` as the path delimiter. If the path contains a `.`, it should be enclosed in double quotes.
-Use `[ ]` to indicate array indices, starting from 0.
-The path should not contain `", [`, and `]`.
-If the `<json_str>` format is incorrect, or if the `<json_path>` format is invalid, or if no matching field is found, `NULL` is returned.
-
-Additionally, it is recommended to use the `jsonb` type and `jsonb_extract_XXX` functions to achieve the same functionality.
-
-Special case handling as follows:
-- If the field specified by `<json_path>` does not exist in the JSON, return `NULL`.
-- If the actual type of the field specified by `<json_path>` differs from the type expected by `json_extract_t`, if it can be losslessly converted to the expected type, it will return the specified type. Otherwise, it will return `NULL`.
-
-## Examples
-
-1. Get the value for key "k1"
-
-```sql
-
-SELECT get_json_string('{"k1":"v1", "k2":"v2"}', "$.k1");
-```
-
-```sql
-+---------------------------------------------------+
-| get_json_string('{"k1":"v1", "k2":"v2"}', '$.k1') |
-+---------------------------------------------------+
-| v1                                                |
-+---------------------------------------------------+
-```
-2. Get the second element of the array for key "my.key"
-
-``` sql
-SELECT get_json_string('{"k1":"v1", "my.key":["e1", "e2", "e3"]}', '$."my.key"[1]');
-
-```
-```sql
-+------------------------------------------------------------------------------+
-| get_json_string('{"k1":"v1", "my.key":["e1", "e2", "e3"]}', '$."my.key"[1]') |
-+------------------------------------------------------------------------------+
-| e2                                                                           |
-+------------------------------------------------------------------------------+
-
-```
-3. Get the first element of the array in the secondary path k1.key -> k2
-
-
-```sql
- SELECT get_json_string('{"k1.key":{"k2":["v1", "v2"]}}', '$."k1.key".k2[0]');
-
-```
-
-```sql
-
-+-----------------------------------------------------------------------+
-| get_json_string('{"k1.key":{"k2":["v1", "v2"]}}', '$."k1.key".k2[0]') |
-+-----------------------------------------------------------------------+
-| v1                                                                    |
-+-----------------------------------------------------------------------+
-
-```
+Alias of function [`JSON_EXTRACT_STRING`](./json-extract-string.md).

docs/sql-manual/sql-functions/scalar-functions/json-functions/json-extract-bigint.md

@@ -5,3 +5,82 @@
 }
 ---
 
+## Description
+`JSON_EXTRACT_BIGINT` extracts the field specified by `<json_path>` from a JSON object and converts it to [`BIGINT`](../../../basic-element/sql-data-types/numeric/BIGINT.md) type.
+
+## Syntax
+```sql
+JSON_EXTRACT_BIGINT(<json_object>, <json_path>)
+```
+
+## Parameters
+- `<json_object>`: JSON type, the target parameter to extract from.
+- `<json_path>`: String type, the JSON path to extract the target element from the target JSON.
+
+## Return Value
+`Nullable(BIGINT)` Returns the extracted BIGINT value, returns NULL in some cases
+
+## Usage Notes
+1. If `<json_object>` or `<json_path>` is NULL, returns NULL.
+2. If the element specified by `<json_path>` does not exist, returns NULL.
+3. If the element specified by `<json_path>` cannot be converted to BIGINT, returns NULL.
+4. Its behavior is consistent with "cast + json_extract", which is equivalent to:
+    ```sql
+    CAST(JSON_EXTRACT(<json_object>, <json_path>) as BIGINT)
+    ```
+
+## Examples
+1. Normal parameters
+    ```sql
+    SELECT json_extract_bigint('{"id": 122222222222223, "name": "doris"}', '$.id');
+    ```
+    ```text
+    +-------------------------------------------------------------------------+
+    | json_extract_bigint('{"id": 122222222222223, "name": "doris"}', '$.id') |
+    +-------------------------------------------------------------------------+
+    |                                                         122222222222223 |
+    +-------------------------------------------------------------------------+
+    ```
+2. Case where path does not exist
+    ```sql
+    SELECT json_extract_bigint('{"id": 122222222222223, "name": "doris"}', '$.id2');
+    ```
+    ```text
+    +--------------------------------------------------------------------------+
+    | json_extract_bigint('{"id": 122222222222223, "name": "doris"}', '$.id2') |
+    +--------------------------------------------------------------------------+
+    |                                                                     NULL |
+    +--------------------------------------------------------------------------+
+    ```
+3. NULL parameters
+    ```sql
+    SELECT json_extract_bigint('{"id": 122222222222223, "name": "doris"}', NULl);
+    ```
+    ```text
+    +-----------------------------------------------------------------------+
+    | json_extract_bigint('{"id": 122222222222223, "name": "doris"}', NULl) |
+    +-----------------------------------------------------------------------+
+    |                                                                  NULL |
+    +-----------------------------------------------------------------------+
+    ```
+    ```sql
+    SELECT json_extract_bigint(NULL, '$.id2');
+    ```
+    ```text
+    +------------------------------------+
+    | json_extract_bigint(NULL, '$.id2') |
+    +------------------------------------+
+    |                               NULL |
+    +------------------------------------+
+    ```
+4. Case where conversion to BIGINT is not possible
+    ```sql
+    SELECT json_extract_bigint('{"id": 123, "name": "doris"}','$.name');
+    ```
+    ```text
+    +--------------------------------------------------------------+
+    | json_extract_bigint('{"id": 123, "name": "doris"}','$.name') |
+    +--------------------------------------------------------------+
+    |                                                         NULL |
+    +--------------------------------------------------------------+
+    ```