Merge branch 'main' into gt-e6c16b36-c06c-4066-b6de-cd578443f15d

databendlabs · Feb 24, 2025 · 01ed703 · 01ed703
2 parents 6e732cd + cc14b73
commit 01ed703
Show file tree

Hide file tree

Showing 3 changed files with 15 additions and 6 deletions.
diff --git a/docs/en/sql-reference/20-sql-functions/08-window-functions/first-value.md b/docs/en/sql-reference/20-sql-functions/08-window-functions/first-value.md
@@ -4,7 +4,7 @@ title: FIRST_VALUE
 
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="Introduced or updated: v1.2.568"/>
+<FunctionDescription description="Introduced or updated: v1.2.697"/>
 
 Returns the first value in the window frame.
 
@@ -19,7 +19,10 @@ See also:
 FIRST_VALUE (expression) [ { IGNORE | RESPECT } NULLS ] OVER ([PARTITION BY partition_expression] ORDER BY order_expression [window_frame])
 ```
 
-- `[ { IGNORE | RESPECT } NULLS ]`: This option controls how NULL values are handled within the window function. By default, `RESPECT NULLS` is used, meaning NULL values are included in the calculation and affect the result. When set to `IGNORE NULLS`, NULL values are excluded from consideration, and the function operates only on non-NULL values.
+- `[ { IGNORE | RESPECT } NULLS ]`: Controls how NULL values are handled within the window function. 
+  - By default, `RESPECT NULLS` is used, meaning NULL values are included in the calculation and affect the result. 
+  - When set to `IGNORE NULLS`, NULL values are excluded from consideration, and the function operates only on non-NULL values.
+  - If all values in the window frame are NULL, the function returns NULL even when `IGNORE NULLS` is specified.
 
 - For the syntax of window frame, see [Window Frame Syntax](index.md#window-frame-syntax).
 

diff --git a/docs/en/sql-reference/20-sql-functions/08-window-functions/last-value.md b/docs/en/sql-reference/20-sql-functions/08-window-functions/last-value.md
@@ -4,7 +4,7 @@ title: LAST_VALUE
 
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="Introduced or updated: v1.2.568"/>
+<FunctionDescription description="Introduced or updated: v1.2.697"/>
 
 Returns the last value in the window frame.
 
@@ -19,7 +19,10 @@ See also:
 LAST_VALUE (expression) [ { IGNORE | RESPECT } NULLS ] OVER ([PARTITION BY partition_expression] ORDER BY order_expression [window_frame])
 ```
 
-- `[ { IGNORE | RESPECT } NULLS ]`: This option controls how NULL values are handled within the window function. By default, `RESPECT NULLS` is used, meaning NULL values are included in the calculation and affect the result. When set to `IGNORE NULLS`, NULL values are excluded from consideration, and the function operates only on non-NULL values.
+- `[ { IGNORE | RESPECT } NULLS ]`: Controls how NULL values are handled within the window function. 
+  - By default, `RESPECT NULLS` is used, meaning NULL values are included in the calculation and affect the result. 
+  - When set to `IGNORE NULLS`, NULL values are excluded from consideration, and the function operates only on non-NULL values.
+  - If all values in the window frame are NULL, the function returns NULL even when `IGNORE NULLS` is specified.
 
 - For the syntax of window frame, see [Window Frame Syntax](index.md#window-frame-syntax).
 

diff --git a/docs/en/sql-reference/20-sql-functions/08-window-functions/nth-value.md b/docs/en/sql-reference/20-sql-functions/08-window-functions/nth-value.md
@@ -4,7 +4,7 @@ title: NTH_VALUE
 
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="Introduced or updated: v1.2.568"/>
+<FunctionDescription description="Introduced or updated: v1.2.697"/>
 
 Returns the value at the `N`-th position within the window frame, where `N` is a specified integer that determines the exact position of the value.
 
@@ -19,7 +19,10 @@ See also:
 NTH_VALUE (expression, n) [ { IGNORE | RESPECT } NULLS ] OVER ([PARTITION BY partition_expression] ORDER BY order_expression [window_frame])
 ```
 
-- `[ { IGNORE | RESPECT } NULLS ]`: This option controls how NULL values are handled within the window function. By default, `RESPECT NULLS` is used, meaning NULL values are included in the calculation and affect the result. When set to `IGNORE NULLS`, NULL values are excluded from consideration, and the function operates only on non-NULL values.
+- `[ { IGNORE | RESPECT } NULLS ]`: Controls how NULL values are handled within the window function. 
+  - By default, `RESPECT NULLS` is used, meaning NULL values are included in the calculation and affect the result. 
+  - When set to `IGNORE NULLS`, NULL values are excluded from consideration, and the function operates only on non-NULL values.
+  - If all values in the window frame are NULL, the function returns NULL even when `IGNORE NULLS` is specified.
 
 - For the syntax of window frame, see [Window Frame Syntax](index.md#window-frame-syntax).