docs: function alias (#2106)

* Update 01-ddl-create_task.md

* iff

* greatest & least

* add var_pop, variance_pop alias for function covar_pop

* add var_samp, variance_samp alias for function covar_samp

* insert overwrite into

* Update dml-insert-multi.md

---------

Co-authored-by: z <[email protected]>

Author: soyeric128

docs/en/sql-reference/10-sql-commands/00-ddl/04-task/01-ddl-create_task.md

@@ -5,7 +5,7 @@ sidebar_position: 1
 
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="Introduced or updated: v1.2.371"/>
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
 
 The CREATE TASK statement is used to define a new task that executes a specified SQL statement on a scheduled basis or dag based task graph.
 
@@ -14,7 +14,7 @@ The CREATE TASK statement is used to define a new task that executes a specified
 ## Syntax
 
 ```sql
-CREATE TASK [ IF NOT EXISTS ] <name>
+CREATE [ OR REPLACE ] TASK [ IF NOT EXISTS ] <name>
  WAREHOUSE = <string>
  SCHEDULE = { <num> MINUTE | <num> SECOND | USING CRON <expr> <time_zone> }
  [ AFTER <string> [ , <string> , ... ]]

docs/en/sql-reference/10-sql-commands/10-dml/dml-insert-multi.md

@@ -50,13 +50,12 @@ SELECT ...
 
 | Parameter                                | Description                                                                                                                                                                                                                                                                                                                                           |
 | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| OVERWRITE                                | Indicates whether existing data should be truncated before insertion.                                                                                                                                                                                                                                                                                 |
+| `OVERWRITE`                              | Indicates whether existing data should be truncated before insertion.                                                                                                                                                                                                                                                                                 |
 | `( <target_col_name> [ , ... ] )`        | Specifies the column names in the target table where data will be inserted.<br/>- If omitted, data will be inserted into all columns in the target table.                                                                                                                                                                                             |
-| VALUES `( <source_col_name> [ , ... ] )` | Specifies the source column names from which data will be inserted into the target table.<br/>- If omitted, all columns returned by the subquery will be inserted into the target table.<br/>- The data types of the columns listed in `<source_col_name>` must match or be compatible with those specified in `<target_col_name>`.                   |
-| SELECT ...                               | A subquery that provides the data to be inserted into the target table(s).<br/>- You have the option to explicitly assign aliases to columns within the subquery. This allows you to reference the columns by their aliases within WHEN clauses and VALUES clauses.                                                                                   |
-| WHEN                                     | Conditional statement to determine when to insert data into specific target tables.<br/>- A conditional multi-table insert requires at least one WHEN clause.<br/>- A WHEN clause can include multiple INTO clauses, and these INTO clauses can target the same table.<br/>- To unconditionally execute a WHEN clause, you can use `WHEN 1 THEN ...`. |
-| ELSE                                     | Specifies the action to take if none of the conditions specified in the WHEN clauses are met.                                                                                                                                                                                                                                                         |
-
+| `VALUES ( <source_col_name> [ , ... ] )` | Specifies the source column names from which data will be inserted into the target table.<br/>- If omitted, all columns returned by the subquery will be inserted into the target table.<br/>- The data types of the columns listed in `<source_col_name>` must match or be compatible with those specified in `<target_col_name>`.                   |
+| `SELECT ...`                             | A subquery that provides the data to be inserted into the target table(s).<br/>- You have the option to explicitly assign aliases to columns within the subquery. This allows you to reference the columns by their aliases within WHEN clauses and VALUES clauses.                                                                                   |
+| `WHEN`                                   | Conditional statement to determine when to insert data into specific target tables.<br/>- A conditional multi-table insert requires at least one WHEN clause.<br/>- A WHEN clause can include multiple INTO clauses, and these INTO clauses can target the same table.<br/>- To unconditionally execute a WHEN clause, you can use `WHEN 1 THEN ...`. |
+| `ELSE`                                   | Specifies the action to take if none of the conditions specified in the WHEN clauses are met.                                                                                                                                                                                                                                                        |
 ## Important Notes
 
 - Aggregate functions, external UDFs, and window functions are not allowed in the `VALUES(...)` expressions.

docs/en/sql-reference/10-sql-commands/10-dml/dml-insert.md

@@ -1,6 +1,9 @@
 ---
 title: INSERT
 ---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
 
 Inserts one or more rows into a table.
 
@@ -13,7 +16,7 @@ See also: [INSERT (multi-table)](dml-insert-multi.md)
 ## Syntax
 
 ```sql
-INSERT { OVERWRITE | INTO } <table>
+INSERT { OVERWRITE [ INTO ] | INTO } <table>
     -- Optionally specify the columns to insert into
     ( <column> [ , ... ] )
     -- Insertion options:
@@ -25,10 +28,10 @@ INSERT { OVERWRITE | INTO } <table>
     }
 ```
 
-| Parameter | Description                                                                      |
-|-----------|----------------------------------------------------------------------------------|
-| OVERWRITE | Indicates whether existing data should be truncated before insertion.            |
-| VALUES    | Allows direct insertion of specific values or the default values of the columns. |
+| Parameter          | Description                                                                      |
+|--------------------|----------------------------------------------------------------------------------|
+| `OVERWRITE [INTO]` | Indicates whether existing data should be truncated before insertion.            |
+| `VALUES`           | Allows direct insertion of specific values or the default values of the columns. |
 
 ## Important Notes
 

docs/en/sql-reference/20-sql-functions/03-conditional-functions/greatest-ignore-nulls.md

@@ -0,0 +1,30 @@
+---
+title: GREATEST_IGNORE_NULLS
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
+
+Returns the maximum value from a set of values, ignoring any NULL values.
+
+See also: [GREATEST](greatest.md)
+
+## Syntax
+
+```sql
+GREATEST_IGNORE_NULLS(<value1>, <value2> ...)
+```
+
+## Examples
+
+```sql
+SELECT GREATEST_IGNORE_NULLS(5, 9, 4), GREATEST_IGNORE_NULLS(5, 9, null);
+```
+
+```sql
+┌────────────────────────────────────────────────────────────────────┐
+│ greatest_ignore_nulls(5, 9, 4) │ greatest_ignore_nulls(5, 9, NULL) │
+├────────────────────────────────┼───────────────────────────────────┤
+│                              9 │                                 9 │
+└────────────────────────────────────────────────────────────────────┘
+```

docs/en/sql-reference/20-sql-functions/03-conditional-functions/greatest.md

@@ -1,8 +1,13 @@
 ---
 title: GREATEST
 ---
+import FunctionDescription from '@site/src/components/FunctionDescription';
 
-Returns the maximum value from a set of values.
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
+
+Returns the maximum value from a set of values. If any value in the set is `NULL`, the function returns `NULL`.
+
+See also: [GREATEST_IGNORE_NULLS](greatest-ignore-nulls.md)
 
 ## Syntax
 
@@ -13,11 +18,13 @@ GREATEST(<value1>, <value2> ...)
 ## Examples
 
 ```sql
-SELECT GREATEST(5, 9, 4);
+SELECT GREATEST(5, 9, 4), GREATEST(5, 9, null);
+```
 
-┌───────────────────┐
-│ greatest(5, 9, 4) │
-├───────────────────┤
-│                 9 │
-└───────────────────┘
+```sql
+┌──────────────────────────────────────────┐
+│ greatest(5, 9, 4) │ greatest(5, 9, NULL) │
+├───────────────────┼──────────────────────┤
+│                 9 │ NULL                 │
+└──────────────────────────────────────────┘
 ```

docs/en/sql-reference/20-sql-functions/03-conditional-functions/if.md

@@ -1,6 +1,9 @@
 ---
 title: IF
 ---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
 
 If `<cond1>` is TRUE, it returns `<expr1>`. Otherwise if `<cond2>` is TRUE, it returns `<expr2>`, and so on.
 
@@ -10,6 +13,10 @@ If `<cond1>` is TRUE, it returns `<expr1>`. Otherwise if `<cond2>` is TRUE, it r
 IF(<cond1>, <expr1>, [<cond2>, <expr2> ...], <expr_else>)
 ```
 
+## Aliases
+
+- [IFF](iff.md)
+
 ## Examples
 
 ```sql

docs/en/sql-reference/20-sql-functions/03-conditional-functions/iff.md

@@ -0,0 +1,8 @@
+---
+title: IFF
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
+
+Alias for [IF](if.md).

docs/en/sql-reference/20-sql-functions/03-conditional-functions/least-ignore-nulls.md

@@ -0,0 +1,30 @@
+---
+title: LEAST_IGNORE_NULLS
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
+
+Returns the maximum value from a set of values, ignoring any NULL values.
+
+See also: [LEAST](least.md)
+
+## Syntax
+
+```sql
+LEAST_IGNORE_NULLS(<value1>, <value2> ...)
+```
+
+## Examples
+
+```sql
+SELECT LEAST_IGNORE_NULLS(5, 9, 4), LEAST_IGNORE_NULLS(5, 9, null);
+```
+
+```sql
+┌──────────────────────────────────────────────────────────────┐
+│ least_ignore_nulls(5, 9, 4) │ least_ignore_nulls(5, 9, NULL) │
+├─────────────────────────────┼────────────────────────────────┤
+│                           4 │                              5 │
+└──────────────────────────────────────────────────────────────┘
+```

docs/en/sql-reference/20-sql-functions/03-conditional-functions/least.md

@@ -1,8 +1,13 @@
 ---
 title: LEAST
 ---
+import FunctionDescription from '@site/src/components/FunctionDescription';
 
-Returns the minimum value from a set of values.
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
+
+Returns the minimum value from a set of values. If any value in the set is `NULL`, the function returns `NULL`.
+
+See also: [LEAST_IGNORE_NULLS](least-ignore-nulls.md)
 
 ## Syntax
 
@@ -13,11 +18,13 @@ LEAST(<value1>, <value2> ...)
 ## Examples
 
 ```sql
-SELECT LEAST(5, 9, 4);
+SELECT LEAST(5, 9, 4), LEAST(5, 9, null);
+```
 
-┌────────────────┐
-│ least(5, 9, 4) │
-├────────────────┤
-│              4 │
-└────────────────┘
+```
+┌────────────────────────────────────┐
+│ least(5, 9, 4) │ least(5, 9, NULL) │
+├────────────────┼───────────────────┤
+│              4 │ NULL              │
+└────────────────────────────────────┘
 ```

docs/en/sql-reference/20-sql-functions/07-aggregate-functions/aggregate-covar-pop.md

@@ -1,8 +1,11 @@
 ---
 title: COVAR_POP
 ---
+import FunctionDescription from '@site/src/components/FunctionDescription';
 
-COVAR_POP returns the population covariance of a set of number pairs. 
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
+
+Returns the population covariance of a set of number pairs. 
 
 ## Syntax
 
@@ -17,6 +20,11 @@ COVAR_POP(<expr1>, <expr2>)
 | `<expr1>` | Any numerical expression |
 | `<expr2>` | Any numerical expression |
 
+## Aliases
+
+- [VAR_POP](aggregate-var-pop.md)
+- [VARIANCE_POP](aggregate-variance-pop.md)
+
 ## Return Type
 
 float64

docs/en/sql-reference/20-sql-functions/07-aggregate-functions/aggregate-covar-samp.md

@@ -2,9 +2,11 @@
 title: COVAR_SAMP
 ---
 
-Aggregate function.
+import FunctionDescription from '@site/src/components/FunctionDescription';
 
-The covar_samp() function returns the sample covariance (Σ((x - x̅)(y - y̅)) / (n - 1)) of two data columns.
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
+
+Returns the sample covariance (Σ((x - x̅)(y - y̅)) / (n - 1)) of two data columns.
 
 :::caution
 NULL values are not counted.
@@ -23,6 +25,11 @@ COVAR_SAMP(<expr1>, <expr2>)
 | `<expr1>` | Any numerical expression |
 | `<expr2>` | Any numerical expression |
 
+## Aliases
+
+- [VAR_SAMP](aggregate-var-samp.md)
+- [VARIANCE_SAMP](aggregate-variance-samp.md)
+
 ## Return Type
 
 float64, when `n <= 1`, returns +∞.

docs/en/sql-reference/20-sql-functions/07-aggregate-functions/aggregate-var-pop.md

@@ -0,0 +1,8 @@
+---
+title: VAR_POP
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
+
+Alias for [COVAR_POP](aggregate-covar-pop.md).

docs/en/sql-reference/20-sql-functions/07-aggregate-functions/aggregate-var-samp.md

@@ -0,0 +1,9 @@
+---
+title: VAR_SAMP
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
+
+Alias for [COVAR_SAMP](aggregate-covar-samp.md).

docs/en/sql-reference/20-sql-functions/07-aggregate-functions/aggregate-variance-pop.md

@@ -0,0 +1,8 @@
+---
+title: VARIANCE_POP
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
+
+Alias for [COVAR_POP](aggregate-covar-pop.md).

docs/en/sql-reference/20-sql-functions/07-aggregate-functions/aggregate-variance-samp.md

@@ -0,0 +1,9 @@
+---
+title: VARIANCE_SAMP
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.738"/>
+
+Alias for [COVAR_SAMP](aggregate-covar-samp.md).