Re: Table rewrite supporting functions for event triggers
Michael Paquier <michael@paquier.xyz>
From: Michael Paquier <michael@paquier.xyz>
To: Greg Sabino Mullane <htamfids@gmail.com>
Cc: Laurenz Albe <laurenz.albe@cybertec.at>, pgsql-docs <pgsql-docs@lists.postgresql.org>
Date: 2024-09-12T03:17:28Z
Lists: pgsql-docs
On Wed, Sep 11, 2024 at 10:14:27AM -0400, Greg Sabino Mullane wrote: > I dunno - so would we smush them together and return something like: > > "ALTER_PERSISTENCE and COLUMN_REWRITE" If multiple are set, let's just make it text[], then. > That would be a step backwards for anyone possibly using that integer > programatically to (for example) give a pretty user-facing message about > why the event was triggered. I don't know either how much people are relying on these numbers in applications. If this is like what we do in the regression tests and print it in notice messages within a PL/pgSQL function, that's not going to matter. Or just have a separate function.. Do you have a comment about mentioning the variables or the header in the docs for the stable branches? I'm aware that this is a rare practice, but so is this function's design. My argument is greppability between the code and the docs, mainly, to not miss an update of the docs if more reasons are added. That would be unlikely, but a backpatch of a reason is not impossible ABI-wise. -- Michael
Commits
-
doc: Add better description for rewrite functions in event triggers
- 93a596c73517 13.17 landed
- bca802600c7f 14.14 landed
- 14440d3b07af 15.9 landed
- a1b859c6893a 16.5 landed
- 709ce29b1656 17.1 landed
- 4b7bba49e712 18.0 landed