postgresql/src/include/parser
Tatsuo Ishii 25a30bbd42 Add IGNORE NULLS/RESPECT NULLS option to Window functions.
Add IGNORE NULLS/RESPECT NULLS option (null treatment clause) to lead,
lag, first_value, last_value and nth_value window functions.  If
unspecified, the default is RESPECT NULLS which includes NULL values
in any result calculation. IGNORE NULLS ignores NULL values.

Built-in window functions are modified to call new API
WinCheckAndInitializeNullTreatment() to indicate whether they accept
IGNORE NULLS/RESPECT NULLS option or not (the API can be called by
user defined window functions as well).  If WinGetFuncArgInPartition's
allowNullTreatment argument is true and IGNORE NULLS option is given,
WinGetFuncArgInPartition() or WinGetFuncArgInFrame() will return
evaluated function's argument expression on specified non NULL row (if
it exists) in the partition or the frame.

When IGNORE NULLS option is given, window functions need to visit and
evaluate same rows over and over again to look for non null rows. To
mitigate the issue, 2-bit not null information array is created while
executing window functions to remember whether the row has been
already evaluated to NULL or NOT NULL. If already evaluated, we could
skip the evaluation work, thus we could get better performance.

Author: Oliver Ford <ojford@gmail.com>
Co-authored-by: Tatsuo Ishii <ishii@postgresql.org>
Reviewed-by: Krasiyan Andreev <krasiyan@gmail.com>
Reviewed-by: Andrew Gierth <andrew@tao11.riddles.org.uk>
Reviewed-by: Tom Lane <tgl@sss.pgh.pa.us>
Reviewed-by: David Fetter <david@fetter.org>
Reviewed-by: Vik Fearing <vik@postgresfriends.org>
Reviewed-by: "David G. Johnston" <david.g.johnston@gmail.com>
Reviewed-by: Chao Li <lic@highgo.com>
Discussion: https://postgr.es/m/flat/CAGMVOdsbtRwE_4+v8zjH1d9xfovDeQAGLkP_B6k69_VoFEgX-A@mail.gmail.com
2025-10-03 09:47:36 +09:00
..
analyze.h Change SQL-language functions to use the plan cache. 2025-04-02 14:06:02 -04:00
kwlist.h Add IGNORE NULLS/RESPECT NULLS option to Window functions. 2025-10-03 09:47:36 +09:00
parse_agg.h Update copyright for 2025 2025-01-01 11:21:55 -05:00
parse_clause.h Add GROUP BY ALL. 2025-09-29 16:55:17 -04:00
parse_coerce.h Handle default NULL insertion a little better. 2025-01-29 15:31:55 -05:00
parse_collate.h Update copyright for 2025 2025-01-01 11:21:55 -05:00
parse_cte.h Update copyright for 2025 2025-01-01 11:21:55 -05:00
parse_enr.h Update copyright for 2025 2025-01-01 11:21:55 -05:00
parse_expr.h Update copyright for 2025 2025-01-01 11:21:55 -05:00
parse_func.h Provide more-specific error details/hints for function lookup failures. 2025-09-16 12:17:02 -04:00
parse_merge.h Update copyright for 2025 2025-01-01 11:21:55 -05:00
parse_node.h Revert support for improved tracking of nested queries 2025-06-12 10:08:55 +09:00
parse_oper.h Update copyright for 2025 2025-01-01 11:21:55 -05:00
parse_param.h Update copyright for 2025 2025-01-01 11:21:55 -05:00
parse_relation.h pg_noreturn to replace pg_attribute_noreturn() 2025-03-13 12:37:26 +01:00
parse_target.h Update copyright for 2025 2025-01-01 11:21:55 -05:00
parse_type.h Update copyright for 2025 2025-01-01 11:21:55 -05:00
parse_utilcmd.h Update various forward declarations to use typedef 2025-09-15 11:04:10 +02:00
parser.h Update copyright for 2025 2025-01-01 11:21:55 -05:00
parsetree.h Update copyright for 2025 2025-01-01 11:21:55 -05:00
scanner.h pg_noreturn to replace pg_attribute_noreturn() 2025-03-13 12:37:26 +01:00
scansup.h Update copyright for 2025 2025-01-01 11:21:55 -05:00