]> granicus.if.org Git - postgresql/commit
Allow avoiding tuple copy within tuplesort_gettupleslot().
authorAndres Freund <andres@anarazel.de>
Thu, 6 Apr 2017 21:48:59 +0000 (14:48 -0700)
committerAndres Freund <andres@anarazel.de>
Thu, 6 Apr 2017 21:48:59 +0000 (14:48 -0700)
commitfa117ee40330db401da776e7b003f047098a7d4c
treed145a528de8e9c8d085a300a026f33cd6ff8e55b
parentaf8a94d18d70ca226a12057ad4b3d17f27d8ff13
Allow avoiding tuple copy within tuplesort_gettupleslot().

Add a "copy" argument to make it optional to receive a copy of caller
tuple that is safe to use following a subsequent manipulating of
tuplesort's state.  This is a performance optimization.  Most existing
tuplesort_gettupleslot() callers are made to opt out of copying.
Existing callers that happen to rely on the validity of tuple memory
beyond subsequent manipulations of the tuplesort request their own
copy.

This brings tuplesort_gettupleslot() in line with
tuplestore_gettupleslot().  In the future, a "copy"
tuplesort_getdatum() argument may be added, that similarly allows
callers to opt out of receiving their own copy of tuple.

In passing, clarify assumptions that callers of other tuplesort fetch
routines may make about tuple memory validity, per gripe from Tom
Lane.

Author: Peter Geoghegan
Discussion: CAM3SWZQWZZ_N=DmmL7tKy_OUjGH_5mN=N=A6h7kHyyDvEhg2DA@mail.gmail.com
src/backend/executor/nodeAgg.c
src/backend/executor/nodeSort.c
src/backend/utils/adt/orderedsetaggs.c
src/backend/utils/sort/tuplesort.c
src/include/utils/tuplesort.h