pgsql: Re-allow FDWs and custom scan providers to replace joins with ps

Re-allow FDWs and custom scan providers to replace joins with pseudoconstant quals.

This was disabled in commit 6f80a8d9c due to the lack of support for
handling of pseudoconstant quals assigned to replaced joins in
createplan.c. To re-allow it, this patch adds the support by 1)
modifying the ForeignPath and CustomPath structs so that if they
represent foreign and custom scans replacing a join with a scan, they
store the list of RestrictInfo nodes to apply to the join, as in
JoinPaths, and by 2) modifying create_scan_plan() in createplan.c so
that it uses that list in that case, instead of the baserestrictinfo
list, to get pseudoconstant quals assigned to the join, as mentioned in
the commit message for that commit.

Important item for the release notes: this is non-backwards-compatible
since it modifies the ForeignPath and CustomPath structs, as mentioned
above, and changes the argument lists for FDW helper functions
create_foreignscan_path(), create_foreign_join_path(), and
create_foreign_upper_path().

Richard Guo, with some additional changes by me, reviewed by Nishant
Sharma, Suraj Kharage, and Richard Guo.

Discussion: https://postgr.es/m/CADrsxdbcN1vejBaf8a%2BQhrZY5PXL-04mCd4GDu6qm6FigDZd6Q%40mail.gmail.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/9e9931d2bf40e2fea447d779c2e133c2c1256ef3

Modified Files
--------------
contrib/file_fdw/file_fdw.c | 1 +
contrib/postgres_fdw/expected/postgres_fdw.out | 30 +++++++++-----------------
contrib/postgres_fdw/postgres_fdw.c | 20 ++++++++++++-----
contrib/postgres_fdw/sql/postgres_fdw.sql | 2 +-
doc/src/sgml/custom-scan.sgml | 16 ++++++++++++++
doc/src/sgml/fdwhandler.sgml | 11 ++++++++++
src/backend/optimizer/path/joinpath.c | 19 ++--------------
src/backend/optimizer/plan/createplan.c | 21 +++++++++++++++++-
src/backend/optimizer/util/pathnode.c | 10 +++++++++
src/backend/optimizer/util/restrictinfo.c | 30 --------------------------
src/include/nodes/pathnodes.h | 10 +++++++++
src/include/optimizer/pathnode.h | 3 +++
src/include/optimizer/restrictinfo.h | 2 --
13 files changed, 99 insertions(+), 76 deletions(-)