PostgreSQL Source Code  git master
Data Structures | Typedefs | Functions
fdwapi.h File Reference
#include "access/parallel.h"
#include "nodes/execnodes.h"
#include "nodes/pathnodes.h"
Include dependency graph for fdwapi.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  FdwRoutine
 

Typedefs

typedef void(* GetForeignRelSize_function) (PlannerInfo *root, RelOptInfo *baserel, Oid foreigntableid)
 
typedef void(* GetForeignPaths_function) (PlannerInfo *root, RelOptInfo *baserel, Oid foreigntableid)
 
typedef ForeignScan *(* GetForeignPlan_function) (PlannerInfo *root, RelOptInfo *baserel, Oid foreigntableid, ForeignPath *best_path, List *tlist, List *scan_clauses, Plan *outer_plan)
 
typedef void(* BeginForeignScan_function) (ForeignScanState *node, int eflags)
 
typedef TupleTableSlot *(* IterateForeignScan_function) (ForeignScanState *node)
 
typedef bool(* RecheckForeignScan_function) (ForeignScanState *node, TupleTableSlot *slot)
 
typedef void(* ReScanForeignScan_function) (ForeignScanState *node)
 
typedef void(* EndForeignScan_function) (ForeignScanState *node)
 
typedef void(* GetForeignJoinPaths_function) (PlannerInfo *root, RelOptInfo *joinrel, RelOptInfo *outerrel, RelOptInfo *innerrel, JoinType jointype, JoinPathExtraData *extra)
 
typedef void(* GetForeignUpperPaths_function) (PlannerInfo *root, UpperRelationKind stage, RelOptInfo *input_rel, RelOptInfo *output_rel, void *extra)
 
typedef void(* AddForeignUpdateTargets_function) (PlannerInfo *root, Index rtindex, RangeTblEntry *target_rte, Relation target_relation)
 
typedef List *(* PlanForeignModify_function) (PlannerInfo *root, ModifyTable *plan, Index resultRelation, int subplan_index)
 
typedef void(* BeginForeignModify_function) (ModifyTableState *mtstate, ResultRelInfo *rinfo, List *fdw_private, int subplan_index, int eflags)
 
typedef TupleTableSlot *(* ExecForeignInsert_function) (EState *estate, ResultRelInfo *rinfo, TupleTableSlot *slot, TupleTableSlot *planSlot)
 
typedef TupleTableSlot **(* ExecForeignBatchInsert_function) (EState *estate, ResultRelInfo *rinfo, TupleTableSlot **slots, TupleTableSlot **planSlots, int *numSlots)
 
typedef int(* GetForeignModifyBatchSize_function) (ResultRelInfo *rinfo)
 
typedef TupleTableSlot *(* ExecForeignUpdate_function) (EState *estate, ResultRelInfo *rinfo, TupleTableSlot *slot, TupleTableSlot *planSlot)
 
typedef TupleTableSlot *(* ExecForeignDelete_function) (EState *estate, ResultRelInfo *rinfo, TupleTableSlot *slot, TupleTableSlot *planSlot)
 
typedef void(* EndForeignModify_function) (EState *estate, ResultRelInfo *rinfo)
 
typedef void(* BeginForeignInsert_function) (ModifyTableState *mtstate, ResultRelInfo *rinfo)
 
typedef void(* EndForeignInsert_function) (EState *estate, ResultRelInfo *rinfo)
 
typedef int(* IsForeignRelUpdatable_function) (Relation rel)
 
typedef bool(* PlanDirectModify_function) (PlannerInfo *root, ModifyTable *plan, Index resultRelation, int subplan_index)
 
typedef void(* BeginDirectModify_function) (ForeignScanState *node, int eflags)
 
typedef TupleTableSlot *(* IterateDirectModify_function) (ForeignScanState *node)
 
typedef void(* EndDirectModify_function) (ForeignScanState *node)
 
typedef RowMarkType(* GetForeignRowMarkType_function) (RangeTblEntry *rte, LockClauseStrength strength)
 
typedef void(* RefetchForeignRow_function) (EState *estate, ExecRowMark *erm, Datum rowid, TupleTableSlot *slot, bool *updated)
 
typedef void(* ExplainForeignScan_function) (ForeignScanState *node, struct ExplainState *es)
 
typedef void(* ExplainForeignModify_function) (ModifyTableState *mtstate, ResultRelInfo *rinfo, List *fdw_private, int subplan_index, struct ExplainState *es)
 
typedef void(* ExplainDirectModify_function) (ForeignScanState *node, struct ExplainState *es)
 
typedef int(* AcquireSampleRowsFunc) (Relation relation, int elevel, HeapTuple *rows, int targrows, double *totalrows, double *totaldeadrows)
 
typedef bool(* AnalyzeForeignTable_function) (Relation relation, AcquireSampleRowsFunc *func, BlockNumber *totalpages)
 
typedef List *(* ImportForeignSchema_function) (ImportForeignSchemaStmt *stmt, Oid serverOid)
 
typedef void(* ExecForeignTruncate_function) (List *rels, DropBehavior behavior, bool restart_seqs)
 
typedef Size(* EstimateDSMForeignScan_function) (ForeignScanState *node, ParallelContext *pcxt)
 
typedef void(* InitializeDSMForeignScan_function) (ForeignScanState *node, ParallelContext *pcxt, void *coordinate)
 
typedef void(* ReInitializeDSMForeignScan_function) (ForeignScanState *node, ParallelContext *pcxt, void *coordinate)
 
typedef void(* InitializeWorkerForeignScan_function) (ForeignScanState *node, shm_toc *toc, void *coordinate)
 
typedef void(* ShutdownForeignScan_function) (ForeignScanState *node)
 
typedef bool(* IsForeignScanParallelSafe_function) (PlannerInfo *root, RelOptInfo *rel, RangeTblEntry *rte)
 
typedef List *(* ReparameterizeForeignPathByChild_function) (PlannerInfo *root, List *fdw_private, RelOptInfo *child_rel)
 
typedef bool(* IsForeignPathAsyncCapable_function) (ForeignPath *path)
 
typedef void(* ForeignAsyncRequest_function) (AsyncRequest *areq)
 
typedef void(* ForeignAsyncConfigureWait_function) (AsyncRequest *areq)
 
typedef void(* ForeignAsyncNotify_function) (AsyncRequest *areq)
 
typedef struct FdwRoutine FdwRoutine
 

Functions

FdwRoutine * GetFdwRoutine (Oid fdwhandler)
 
Oid GetForeignServerIdByRelId (Oid relid)
 
FdwRoutine * GetFdwRoutineByServerId (Oid serverid)
 
FdwRoutine * GetFdwRoutineByRelId (Oid relid)
 
FdwRoutine * GetFdwRoutineForRelation (Relation relation, bool makecopy)
 
bool IsImportableForeignTable (const char *tablename, ImportForeignSchemaStmt *stmt)
 
Path * GetExistingLocalJoinPath (RelOptInfo *joinrel)
 

Typedef Documentation

◆ AcquireSampleRowsFunc

typedef int(* AcquireSampleRowsFunc) (Relation relation, int elevel, HeapTuple *rows, int targrows, double *totalrows, double *totaldeadrows)

Definition at line 151 of file fdwapi.h.

◆ AddForeignUpdateTargets_function

typedef void(* AddForeignUpdateTargets_function) (PlannerInfo *root, Index rtindex, RangeTblEntry *target_rte, Relation target_relation)

Definition at line 68 of file fdwapi.h.

◆ AnalyzeForeignTable_function

typedef bool(* AnalyzeForeignTable_function) (Relation relation, AcquireSampleRowsFunc *func, BlockNumber *totalpages)

Definition at line 156 of file fdwapi.h.

◆ BeginDirectModify_function

typedef void(* BeginDirectModify_function) (ForeignScanState *node, int eflags)

Definition at line 123 of file fdwapi.h.

◆ BeginForeignInsert_function

typedef void(* BeginForeignInsert_function) (ModifyTableState *mtstate, ResultRelInfo *rinfo)

Definition at line 110 of file fdwapi.h.

◆ BeginForeignModify_function

typedef void(* BeginForeignModify_function) (ModifyTableState *mtstate, ResultRelInfo *rinfo, List *fdw_private, int subplan_index, int eflags)

Definition at line 78 of file fdwapi.h.

◆ BeginForeignScan_function

typedef void(* BeginForeignScan_function) (ForeignScanState *node, int eflags)

Definition at line 43 of file fdwapi.h.

◆ EndDirectModify_function

typedef void(* EndDirectModify_function) (ForeignScanState *node)

Definition at line 128 of file fdwapi.h.

◆ EndForeignInsert_function

typedef void(* EndForeignInsert_function) (EState *estate, ResultRelInfo *rinfo)

Definition at line 113 of file fdwapi.h.

◆ EndForeignModify_function

typedef void(* EndForeignModify_function) (EState *estate, ResultRelInfo *rinfo)

Definition at line 107 of file fdwapi.h.

◆ EndForeignScan_function

typedef void(* EndForeignScan_function) (ForeignScanState *node)

Definition at line 53 of file fdwapi.h.

◆ EstimateDSMForeignScan_function

typedef Size(* EstimateDSMForeignScan_function) (ForeignScanState *node, ParallelContext *pcxt)

Definition at line 167 of file fdwapi.h.

◆ ExecForeignBatchInsert_function

typedef TupleTableSlot**(* ExecForeignBatchInsert_function) (EState *estate, ResultRelInfo *rinfo, TupleTableSlot **slots, TupleTableSlot **planSlots, int *numSlots)

Definition at line 89 of file fdwapi.h.

◆ ExecForeignDelete_function

typedef TupleTableSlot*(* ExecForeignDelete_function) (EState *estate, ResultRelInfo *rinfo, TupleTableSlot *slot, TupleTableSlot *planSlot)

Definition at line 102 of file fdwapi.h.

◆ ExecForeignInsert_function

typedef TupleTableSlot*(* ExecForeignInsert_function) (EState *estate, ResultRelInfo *rinfo, TupleTableSlot *slot, TupleTableSlot *planSlot)

Definition at line 84 of file fdwapi.h.

◆ ExecForeignTruncate_function

typedef void(* ExecForeignTruncate_function) (List *rels, DropBehavior behavior, bool restart_seqs)

Definition at line 163 of file fdwapi.h.

◆ ExecForeignUpdate_function

typedef TupleTableSlot*(* ExecForeignUpdate_function) (EState *estate, ResultRelInfo *rinfo, TupleTableSlot *slot, TupleTableSlot *planSlot)

Definition at line 97 of file fdwapi.h.

◆ ExplainDirectModify_function

typedef void(* ExplainDirectModify_function) (ForeignScanState *node, struct ExplainState *es)

Definition at line 148 of file fdwapi.h.

◆ ExplainForeignModify_function

typedef void(* ExplainForeignModify_function) (ModifyTableState *mtstate, ResultRelInfo *rinfo, List *fdw_private, int subplan_index, struct ExplainState *es)

Definition at line 142 of file fdwapi.h.

◆ ExplainForeignScan_function

typedef void(* ExplainForeignScan_function) (ForeignScanState *node, struct ExplainState *es)

Definition at line 139 of file fdwapi.h.

◆ FdwRoutine

typedef struct FdwRoutine FdwRoutine

◆ ForeignAsyncConfigureWait_function

typedef void(* ForeignAsyncConfigureWait_function) (AsyncRequest *areq)

Definition at line 190 of file fdwapi.h.

◆ ForeignAsyncNotify_function

typedef void(* ForeignAsyncNotify_function) (AsyncRequest *areq)

Definition at line 192 of file fdwapi.h.

◆ ForeignAsyncRequest_function

typedef void(* ForeignAsyncRequest_function) (AsyncRequest *areq)

Definition at line 188 of file fdwapi.h.

◆ GetForeignJoinPaths_function

typedef void(* GetForeignJoinPaths_function) (PlannerInfo *root, RelOptInfo *joinrel, RelOptInfo *outerrel, RelOptInfo *innerrel, JoinType jointype, JoinPathExtraData *extra)

Definition at line 55 of file fdwapi.h.

◆ GetForeignModifyBatchSize_function

typedef int(* GetForeignModifyBatchSize_function) (ResultRelInfo *rinfo)

Definition at line 95 of file fdwapi.h.

◆ GetForeignPaths_function

typedef void(* GetForeignPaths_function) (PlannerInfo *root, RelOptInfo *baserel, Oid foreigntableid)

Definition at line 31 of file fdwapi.h.

◆ GetForeignPlan_function

typedef ForeignScan*(* GetForeignPlan_function) (PlannerInfo *root, RelOptInfo *baserel, Oid foreigntableid, ForeignPath *best_path, List *tlist, List *scan_clauses, Plan *outer_plan)

Definition at line 35 of file fdwapi.h.

◆ GetForeignRelSize_function

typedef void(* GetForeignRelSize_function) (PlannerInfo *root, RelOptInfo *baserel, Oid foreigntableid)

Definition at line 27 of file fdwapi.h.

◆ GetForeignRowMarkType_function

typedef RowMarkType(* GetForeignRowMarkType_function) (RangeTblEntry *rte, LockClauseStrength strength)

Definition at line 130 of file fdwapi.h.

◆ GetForeignUpperPaths_function

typedef void(* GetForeignUpperPaths_function) (PlannerInfo *root, UpperRelationKind stage, RelOptInfo *input_rel, RelOptInfo *output_rel, void *extra)

Definition at line 62 of file fdwapi.h.

◆ ImportForeignSchema_function

typedef List*(* ImportForeignSchema_function) (ImportForeignSchemaStmt *stmt, Oid serverOid)

Definition at line 160 of file fdwapi.h.

◆ InitializeDSMForeignScan_function

typedef void(* InitializeDSMForeignScan_function) (ForeignScanState *node, ParallelContext *pcxt, void *coordinate)

Definition at line 169 of file fdwapi.h.

◆ InitializeWorkerForeignScan_function

typedef void(* InitializeWorkerForeignScan_function) (ForeignScanState *node, shm_toc *toc, void *coordinate)

Definition at line 175 of file fdwapi.h.

◆ IsForeignPathAsyncCapable_function

typedef bool(* IsForeignPathAsyncCapable_function) (ForeignPath *path)

Definition at line 186 of file fdwapi.h.

◆ IsForeignRelUpdatable_function

typedef int(* IsForeignRelUpdatable_function) (Relation rel)

Definition at line 116 of file fdwapi.h.

◆ IsForeignScanParallelSafe_function

typedef bool(* IsForeignScanParallelSafe_function) (PlannerInfo *root, RelOptInfo *rel, RangeTblEntry *rte)

Definition at line 179 of file fdwapi.h.

◆ IterateDirectModify_function

typedef TupleTableSlot*(* IterateDirectModify_function) (ForeignScanState *node)

Definition at line 126 of file fdwapi.h.

◆ IterateForeignScan_function

typedef TupleTableSlot*(* IterateForeignScan_function) (ForeignScanState *node)

Definition at line 46 of file fdwapi.h.

◆ PlanDirectModify_function

typedef bool(* PlanDirectModify_function) (PlannerInfo *root, ModifyTable *plan, Index resultRelation, int subplan_index)

Definition at line 118 of file fdwapi.h.

◆ PlanForeignModify_function

typedef List*(* PlanForeignModify_function) (PlannerInfo *root, ModifyTable *plan, Index resultRelation, int subplan_index)

Definition at line 73 of file fdwapi.h.

◆ RecheckForeignScan_function

typedef bool(* RecheckForeignScan_function) (ForeignScanState *node, TupleTableSlot *slot)

Definition at line 48 of file fdwapi.h.

◆ RefetchForeignRow_function

typedef void(* RefetchForeignRow_function) (EState *estate, ExecRowMark *erm, Datum rowid, TupleTableSlot *slot, bool *updated)

Definition at line 133 of file fdwapi.h.

◆ ReInitializeDSMForeignScan_function

typedef void(* ReInitializeDSMForeignScan_function) (ForeignScanState *node, ParallelContext *pcxt, void *coordinate)

Definition at line 172 of file fdwapi.h.

◆ ReparameterizeForeignPathByChild_function

typedef List*(* ReparameterizeForeignPathByChild_function) (PlannerInfo *root, List *fdw_private, RelOptInfo *child_rel)

Definition at line 182 of file fdwapi.h.

◆ ReScanForeignScan_function

typedef void(* ReScanForeignScan_function) (ForeignScanState *node)

Definition at line 51 of file fdwapi.h.

◆ ShutdownForeignScan_function

typedef void(* ShutdownForeignScan_function) (ForeignScanState *node)

Definition at line 178 of file fdwapi.h.

Function Documentation

◆ GetExistingLocalJoinPath()

Path* GetExistingLocalJoinPath ( RelOptInfo *  joinrel)

Definition at line 741 of file foreign.c.

742 {
743  ListCell *lc;
744 
745  Assert(IS_JOIN_REL(joinrel));
746 
747  foreach(lc, joinrel->pathlist)
748  {
749  Path *path = (Path *) lfirst(lc);
750  JoinPath *joinpath = NULL;
751 
752  /* Skip parameterized paths. */
753  if (path->param_info != NULL)
754  continue;
755 
756  switch (path->pathtype)
757  {
758  case T_HashJoin:
759  {
760  HashPath *hash_path = makeNode(HashPath);
761 
762  memcpy(hash_path, path, sizeof(HashPath));
763  joinpath = (JoinPath *) hash_path;
764  }
765  break;
766 
767  case T_NestLoop:
768  {
769  NestPath *nest_path = makeNode(NestPath);
770 
771  memcpy(nest_path, path, sizeof(NestPath));
772  joinpath = (JoinPath *) nest_path;
773  }
774  break;
775 
776  case T_MergeJoin:
777  {
778  MergePath *merge_path = makeNode(MergePath);
779 
780  memcpy(merge_path, path, sizeof(MergePath));
781  joinpath = (JoinPath *) merge_path;
782  }
783  break;
784 
785  default:
786 
787  /*
788  * Just skip anything else. We don't know if corresponding
789  * plan would build the output row from whole-row references
790  * of base relations and execute the EPQ checks.
791  */
792  break;
793  }
794 
795  /* This path isn't good for us, check next. */
796  if (!joinpath)
797  continue;
798 
799  /*
800  * If either inner or outer path is a ForeignPath corresponding to a
801  * pushed down join, replace it with the fdw_outerpath, so that we
802  * maintain path for EPQ checks built entirely of local join
803  * strategies.
804  */
805  if (IsA(joinpath->outerjoinpath, ForeignPath))
806  {
807  ForeignPath *foreign_path;
808 
809  foreign_path = (ForeignPath *) joinpath->outerjoinpath;
810  if (IS_JOIN_REL(foreign_path->path.parent))
811  joinpath->outerjoinpath = foreign_path->fdw_outerpath;
812  }
813 
814  if (IsA(joinpath->innerjoinpath, ForeignPath))
815  {
816  ForeignPath *foreign_path;
817 
818  foreign_path = (ForeignPath *) joinpath->innerjoinpath;
819  if (IS_JOIN_REL(foreign_path->path.parent))
820  joinpath->innerjoinpath = foreign_path->fdw_outerpath;
821  }
822 
823  return (Path *) joinpath;
824  }
825  return NULL;
826 }
Assert
#define Assert(condition)
Definition: c.h:858
if
if(TABLE==NULL||TABLE_index==NULL)
Definition: isn.c:77
IsA
#define IsA(nodeptr, _type_)
Definition: nodes.h:158
makeNode
#define makeNode(_type_)
Definition: nodes.h:155
IS_JOIN_REL
#define IS_JOIN_REL(rel)
Definition: pathnodes.h:838
lfirst
#define lfirst(lc)
Definition: pg_list.h:172
ForeignPath::fdw_outerpath
Path * fdw_outerpath
Definition: pathnodes.h:1871
JoinPath::outerjoinpath
Path * outerjoinpath
Definition: pathnodes.h:2075
JoinPath::innerjoinpath
Path * innerjoinpath
Definition: pathnodes.h:2076
Path::pathtype
NodeTag pathtype
Definition: pathnodes.h:1626
RelOptInfo::pathlist
List * pathlist
Definition: pathnodes.h:892

References Assert, ForeignPath::fdw_outerpath, if(), JoinPath::innerjoinpath, IS_JOIN_REL, IsA, lfirst, makeNode, JoinPath::outerjoinpath, ForeignPath::path, RelOptInfo::pathlist, and Path::pathtype.

Referenced by postgresGetForeignJoinPaths().

◆ GetFdwRoutine()

FdwRoutine* GetFdwRoutine ( Oid  fdwhandler)

Definition at line 325 of file foreign.c.

326 {
327  Datum datum;
328  FdwRoutine *routine;
329 
330  /* Check if the access to foreign tables is restricted */
331  if (unlikely((restrict_nonsystem_relation_kind & RESTRICT_RELKIND_FOREIGN_TABLE) != 0))
332  {
333  /* there must not be built-in FDW handler */
334  ereport(ERROR,
335  (errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
336  errmsg("access to non-system foreign table is restricted")));
337  }
338 
339  datum = OidFunctionCall0(fdwhandler);
340  routine = (FdwRoutine *) DatumGetPointer(datum);
341 
342  if (routine == NULL || !IsA(routine, FdwRoutine))
343  elog(ERROR, "foreign-data wrapper handler function %u did not return an FdwRoutine struct",
344  fdwhandler);
345 
346  return routine;
347 }
unlikely
#define unlikely(x)
Definition: c.h:311
errcode
int errcode(int sqlerrcode)
Definition: elog.c:853
errmsg
int errmsg(const char *fmt,...)
Definition: elog.c:1070
ERROR
#define ERROR
Definition: elog.h:39
elog
#define elog(elevel,...)
Definition: elog.h:225
ereport
#define ereport(elevel,...)
Definition: elog.h:149
OidFunctionCall0
#define OidFunctionCall0(functionId)
Definition: fmgr.h:677
restrict_nonsystem_relation_kind
int restrict_nonsystem_relation_kind
Definition: postgres.c:108
Datum
uintptr_t Datum
Definition: postgres.h:64
DatumGetPointer
static Pointer DatumGetPointer(Datum X)
Definition: postgres.h:312
RESTRICT_RELKIND_FOREIGN_TABLE
#define RESTRICT_RELKIND_FOREIGN_TABLE
Definition: tcopprot.h:48

References DatumGetPointer(), elog, ereport, errcode(), errmsg(), ERROR, IsA, OidFunctionCall0, restrict_nonsystem_relation_kind, RESTRICT_RELKIND_FOREIGN_TABLE, and unlikely.

Referenced by GetFdwRoutineByServerId(), and ImportForeignSchema().

◆ GetFdwRoutineByRelId()

FdwRoutine* GetFdwRoutineByRelId ( Oid  relid)

Definition at line 419 of file foreign.c.

420 {
421  Oid serverid;
422 
423  /* Get server OID for the foreign table. */
424  serverid = GetForeignServerIdByRelId(relid);
425 
426  /* Now retrieve server's FdwRoutine struct. */
427  return GetFdwRoutineByServerId(serverid);
428 }
GetForeignServerIdByRelId
Oid GetForeignServerIdByRelId(Oid relid)
Definition: foreign.c:355
GetFdwRoutineByServerId
FdwRoutine * GetFdwRoutineByServerId(Oid serverid)
Definition: foreign.c:377
Oid
unsigned int Oid
Definition: postgres_ext.h:31

References GetFdwRoutineByServerId(), and GetForeignServerIdByRelId().

Referenced by GetFdwRoutineForRelation(), make_modifytable(), and select_rowmark_type().

◆ GetFdwRoutineByServerId()

FdwRoutine* GetFdwRoutineByServerId ( Oid  serverid)

Definition at line 377 of file foreign.c.

378 {
379  HeapTuple tp;
380  Form_pg_foreign_data_wrapper fdwform;
381  Form_pg_foreign_server serverform;
382  Oid fdwid;
383  Oid fdwhandler;
384 
385  /* Get foreign-data wrapper OID for the server. */
386  tp = SearchSysCache1(FOREIGNSERVEROID, ObjectIdGetDatum(serverid));
387  if (!HeapTupleIsValid(tp))
388  elog(ERROR, "cache lookup failed for foreign server %u", serverid);
389  serverform = (Form_pg_foreign_server) GETSTRUCT(tp);
390  fdwid = serverform->srvfdw;
391  ReleaseSysCache(tp);
392 
393  /* Get handler function OID for the FDW. */
394  tp = SearchSysCache1(FOREIGNDATAWRAPPEROID, ObjectIdGetDatum(fdwid));
395  if (!HeapTupleIsValid(tp))
396  elog(ERROR, "cache lookup failed for foreign-data wrapper %u", fdwid);
397  fdwform = (Form_pg_foreign_data_wrapper) GETSTRUCT(tp);
398  fdwhandler = fdwform->fdwhandler;
399 
400  /* Complain if FDW has been set to NO HANDLER. */
401  if (!OidIsValid(fdwhandler))
402  ereport(ERROR,
403  (errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
404  errmsg("foreign-data wrapper \"%s\" has no handler",
405  NameStr(fdwform->fdwname))));
406 
407  ReleaseSysCache(tp);
408 
409  /* And finally, call the handler function. */
410  return GetFdwRoutine(fdwhandler);
411 }
NameStr
#define NameStr(name)
Definition: c.h:746
OidIsValid
#define OidIsValid(objectId)
Definition: c.h:775
GetFdwRoutine
FdwRoutine * GetFdwRoutine(Oid fdwhandler)
Definition: foreign.c:325
HeapTupleIsValid
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
GETSTRUCT
#define GETSTRUCT(TUP)
Definition: htup_details.h:653
Form_pg_foreign_data_wrapper
FormData_pg_foreign_data_wrapper * Form_pg_foreign_data_wrapper
Definition: pg_foreign_data_wrapper.h:51
Form_pg_foreign_server
FormData_pg_foreign_server * Form_pg_foreign_server
Definition: pg_foreign_server.h:48
ObjectIdGetDatum
static Datum ObjectIdGetDatum(Oid X)
Definition: postgres.h:252
ReleaseSysCache
void ReleaseSysCache(HeapTuple tuple)
Definition: syscache.c:266
SearchSysCache1
HeapTuple SearchSysCache1(int cacheId, Datum key1)
Definition: syscache.c:218

References elog, ereport, errcode(), errmsg(), ERROR, GetFdwRoutine(), GETSTRUCT, HeapTupleIsValid, NameStr, ObjectIdGetDatum(), OidIsValid, ReleaseSysCache(), and SearchSysCache1().

Referenced by ExecInitForeignScan(), ExecuteTruncateGuts(), GetFdwRoutineByRelId(), and truncate_check_rel().

◆ GetFdwRoutineForRelation()

FdwRoutine* GetFdwRoutineForRelation ( Relation  relation,
bool  makecopy 
)

Definition at line 442 of file foreign.c.

443 {
444  FdwRoutine *fdwroutine;
445  FdwRoutine *cfdwroutine;
446 
447  if (relation->rd_fdwroutine == NULL)
448  {
449  /* Get the info by consulting the catalogs and the FDW code */
450  fdwroutine = GetFdwRoutineByRelId(RelationGetRelid(relation));
451 
452  /* Save the data for later reuse in CacheMemoryContext */
453  cfdwroutine = (FdwRoutine *) MemoryContextAlloc(CacheMemoryContext,
454  sizeof(FdwRoutine));
455  memcpy(cfdwroutine, fdwroutine, sizeof(FdwRoutine));
456  relation->rd_fdwroutine = cfdwroutine;
457 
458  /* Give back the locally palloc'd copy regardless of makecopy */
459  return fdwroutine;
460  }
461 
462  /* We have valid cached data --- does the caller want a copy? */
463  if (makecopy)
464  {
465  fdwroutine = (FdwRoutine *) palloc(sizeof(FdwRoutine));
466  memcpy(fdwroutine, relation->rd_fdwroutine, sizeof(FdwRoutine));
467  return fdwroutine;
468  }
469 
470  /* Only a short-lived reference is needed, so just hand back cached copy */
471  return relation->rd_fdwroutine;
472 }
GetFdwRoutineByRelId
FdwRoutine * GetFdwRoutineByRelId(Oid relid)
Definition: foreign.c:419
MemoryContextAlloc
void * MemoryContextAlloc(MemoryContext context, Size size)
Definition: mcxt.c:1181
CacheMemoryContext
MemoryContext CacheMemoryContext
Definition: mcxt.c:152
palloc
void * palloc(Size size)
Definition: mcxt.c:1317
RelationGetRelid
#define RelationGetRelid(relation)
Definition: rel.h:505
RelationData::rd_fdwroutine
struct FdwRoutine * rd_fdwroutine
Definition: rel.h:240

References CacheMemoryContext, GetFdwRoutineByRelId(), MemoryContextAlloc(), palloc(), RelationData::rd_fdwroutine, and RelationGetRelid.

Referenced by acquire_inherited_sample_rows(), add_row_identity_columns(), analyze_rel(), CheckValidRowMarkRel(), EvalPlanQualFetchRowMark(), ExecInitForeignScan(), ExecLockRows(), get_relation_info(), InitResultRelInfo(), and relation_is_updatable().

◆ GetForeignServerIdByRelId()

Oid GetForeignServerIdByRelId ( Oid  relid)

Definition at line 355 of file foreign.c.

356 {
357  HeapTuple tp;
358  Form_pg_foreign_table tableform;
359  Oid serverid;
360 
361  tp = SearchSysCache1(FOREIGNTABLEREL, ObjectIdGetDatum(relid));
362  if (!HeapTupleIsValid(tp))
363  elog(ERROR, "cache lookup failed for foreign table %u", relid);
364  tableform = (Form_pg_foreign_table) GETSTRUCT(tp);
365  serverid = tableform->ftserver;
366  ReleaseSysCache(tp);
367 
368  return serverid;
369 }
Form_pg_foreign_table
FormData_pg_foreign_table * Form_pg_foreign_table
Definition: pg_foreign_table.h:43

References elog, ERROR, GETSTRUCT, HeapTupleIsValid, ObjectIdGetDatum(), ReleaseSysCache(), and SearchSysCache1().

Referenced by ExecuteTruncateGuts(), get_relation_info(), GetFdwRoutineByRelId(), and truncate_check_rel().

◆ IsImportableForeignTable()

bool IsImportableForeignTable ( const char *  tablename,
ImportForeignSchemaStmt *  stmt 
)

Definition at line 482 of file foreign.c.

484 {
485  ListCell *lc;
486 
487  switch (stmt->list_type)
488  {
489  case FDW_IMPORT_SCHEMA_ALL:
490  return true;
491 
492  case FDW_IMPORT_SCHEMA_LIMIT_TO:
493  foreach(lc, stmt->table_list)
494  {
495  RangeVar *rv = (RangeVar *) lfirst(lc);
496 
497  if (strcmp(tablename, rv->relname) == 0)
498  return true;
499  }
500  return false;
501 
502  case FDW_IMPORT_SCHEMA_EXCEPT:
503  foreach(lc, stmt->table_list)
504  {
505  RangeVar *rv = (RangeVar *) lfirst(lc);
506 
507  if (strcmp(tablename, rv->relname) == 0)
508  return false;
509  }
510  return true;
511  }
512  return false; /* shouldn't get here */
513 }
stmt
#define stmt
Definition: indent_codes.h:59
FDW_IMPORT_SCHEMA_LIMIT_TO
@ FDW_IMPORT_SCHEMA_LIMIT_TO
Definition: parsenodes.h:2930
FDW_IMPORT_SCHEMA_ALL
@ FDW_IMPORT_SCHEMA_ALL
Definition: parsenodes.h:2929
FDW_IMPORT_SCHEMA_EXCEPT
@ FDW_IMPORT_SCHEMA_EXCEPT
Definition: parsenodes.h:2931
RangeVar::relname
char * relname
Definition: primnodes.h:82

References FDW_IMPORT_SCHEMA_ALL, FDW_IMPORT_SCHEMA_EXCEPT, FDW_IMPORT_SCHEMA_LIMIT_TO, lfirst, RangeVar::relname, and stmt.

Referenced by ImportForeignSchema().