Remove catalog function currtid()
authorMichael Paquier <michael@paquier.xyz>
Wed, 25 Nov 2020 03:18:26 +0000 (12:18 +0900)
committerMichael Paquier <michael@paquier.xyz>
Wed, 25 Nov 2020 03:18:26 +0000 (12:18 +0900)
commit7b94e999606e2e2e10d68d544d49fc5a5d5785ac
tree935a8f986797796649c47f4be94d11b3d34d5d9c
parent660b89928d18386de7755565c008439ae75d1218
Remove catalog function currtid()

currtid() and currtid2() are an undocumented set of functions whose sole
known user is the Postgres ODBC driver, able to retrieve the latest TID
version for a tuple given by the caller of those functions.

As used by Postgres ODBC, currtid() is a shortcut able to retrieve the
last TID loaded into a backend by passing an OID of 0 (magic value)
after a tuple insertion.  This is removed in this commit, as it became
obsolete after the driver began using "RETURNING ctid" with inserts, a
clause supported since Postgres 8.2 (using RETURNING is better for
performance anyway as it reduces the number of round-trips to the
backend).

currtid2() is still used by the driver, so this remains around for now.
Note that this function is kept in its original shape for backward
compatibility reasons.

Per discussion with many people, including Andres Freund, Peter
Eisentraut, Álvaro Herrera, Hiroshi Inoue, Tom Lane and myself.

Bump catalog version.

Discussion: https://postgr.es/m/20200603021448.GB89559@paquier.xyz
src/backend/executor/nodeModifyTable.c
src/backend/utils/adt/tid.c
src/include/access/heapam.h
src/include/catalog/catversion.h
src/include/catalog/pg_proc.dat
src/test/regress/expected/tid.out
src/test/regress/sql/tid.sql