PostgreSQL Source Code  git master
parse_relation.h File Reference
Include dependency graph for parse_relation.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions

ParseNamespaceItemrefnameNamespaceItem (ParseState *pstate, const char *schemaname, const char *refname, int location, int *sublevels_up)
 
CommonTableExprscanNameSpaceForCTE (ParseState *pstate, const char *refname, Index *ctelevelsup)
 
bool scanNameSpaceForENR (ParseState *pstate, const char *refname)
 
void checkNameSpaceConflicts (ParseState *pstate, List *namespace1, List *namespace2)
 
ParseNamespaceItemGetNSItemByRangeTablePosn (ParseState *pstate, int varno, int sublevels_up)
 
RangeTblEntryGetRTEByRangeTablePosn (ParseState *pstate, int varno, int sublevels_up)
 
CommonTableExprGetCTEForRTE (ParseState *pstate, RangeTblEntry *rte, int rtelevelsup)
 
NodescanNSItemForColumn (ParseState *pstate, ParseNamespaceItem *nsitem, int sublevels_up, const char *colname, int location)
 
NodecolNameToVar (ParseState *pstate, const char *colname, bool localonly, int location)
 
void markNullableIfNeeded (ParseState *pstate, Var *var)
 
void markVarForSelectPriv (ParseState *pstate, Var *var)
 
Relation parserOpenTable (ParseState *pstate, const RangeVar *relation, int lockmode)
 
ParseNamespaceItemaddRangeTableEntry (ParseState *pstate, RangeVar *relation, Alias *alias, bool inh, bool inFromCl)
 
ParseNamespaceItemaddRangeTableEntryForRelation (ParseState *pstate, Relation rel, int lockmode, Alias *alias, bool inh, bool inFromCl)
 
ParseNamespaceItemaddRangeTableEntryForSubquery (ParseState *pstate, Query *subquery, Alias *alias, bool lateral, bool inFromCl)
 
ParseNamespaceItemaddRangeTableEntryForFunction (ParseState *pstate, List *funcnames, List *funcexprs, List *coldeflists, RangeFunction *rangefunc, bool lateral, bool inFromCl)
 
ParseNamespaceItemaddRangeTableEntryForValues (ParseState *pstate, List *exprs, List *coltypes, List *coltypmods, List *colcollations, Alias *alias, bool lateral, bool inFromCl)
 
ParseNamespaceItemaddRangeTableEntryForTableFunc (ParseState *pstate, TableFunc *tf, Alias *alias, bool lateral, bool inFromCl)
 
ParseNamespaceItemaddRangeTableEntryForJoin (ParseState *pstate, List *colnames, ParseNamespaceColumn *nscolumns, JoinType jointype, int nummergedcols, List *aliasvars, List *leftcols, List *rightcols, Alias *join_using_alias, Alias *alias, bool inFromCl)
 
ParseNamespaceItemaddRangeTableEntryForCTE (ParseState *pstate, CommonTableExpr *cte, Index levelsup, RangeVar *rv, bool inFromCl)
 
ParseNamespaceItemaddRangeTableEntryForENR (ParseState *pstate, RangeVar *rv, bool inFromCl)
 
ParseNamespaceItemaddRangeTableEntryForGroup (ParseState *pstate, List *groupClauses)
 
RTEPermissionInfoaddRTEPermissionInfo (List **rteperminfos, RangeTblEntry *rte)
 
RTEPermissionInfogetRTEPermissionInfo (List *rteperminfos, RangeTblEntry *rte)
 
bool isLockedRefname (ParseState *pstate, const char *refname)
 
void addNSItemToQuery (ParseState *pstate, ParseNamespaceItem *nsitem, bool addToJoinList, bool addToRelNameSpace, bool addToVarNameSpace)
 
void errorMissingRTE (ParseState *pstate, RangeVar *relation) pg_attribute_noreturn()
 
void errorMissingColumn (ParseState *pstate, const char *relname, const char *colname, int location) pg_attribute_noreturn()
 
void expandRTE (RangeTblEntry *rte, int rtindex, int sublevels_up, int location, bool include_dropped, List **colnames, List **colvars)
 
ListexpandNSItemVars (ParseState *pstate, ParseNamespaceItem *nsitem, int sublevels_up, int location, List **colnames)
 
ListexpandNSItemAttrs (ParseState *pstate, ParseNamespaceItem *nsitem, int sublevels_up, bool require_col_privs, int location)
 
int attnameAttNum (Relation rd, const char *attname, bool sysColOK)
 
const NameDataattnumAttName (Relation rd, int attid)
 
Oid attnumTypeId (Relation rd, int attid)
 
Oid attnumCollationId (Relation rd, int attid)
 
bool isQueryUsingTempRelation (Query *query)
 

Function Documentation

◆ addNSItemToQuery()

void addNSItemToQuery ( ParseState pstate,
ParseNamespaceItem nsitem,
bool  addToJoinList,
bool  addToRelNameSpace,
bool  addToVarNameSpace 
)

Definition at line 2692 of file parse_relation.c.

2695 {
2696  if (addToJoinList)
2697  {
2699 
2700  rtr->rtindex = nsitem->p_rtindex;
2701  pstate->p_joinlist = lappend(pstate->p_joinlist, rtr);
2702  }
2703  if (addToRelNameSpace || addToVarNameSpace)
2704  {
2705  /* Set the new nsitem's visibility flags correctly */
2706  nsitem->p_rel_visible = addToRelNameSpace;
2707  nsitem->p_cols_visible = addToVarNameSpace;
2708  nsitem->p_lateral_only = false;
2709  nsitem->p_lateral_ok = true;
2710  pstate->p_namespace = lappend(pstate->p_namespace, nsitem);
2711  }
2712 }
List * lappend(List *list, void *datum)
Definition: list.c:339
#define makeNode(_type_)
Definition: nodes.h:155
List * p_namespace
Definition: parse_node.h:219
List * p_joinlist
Definition: parse_node.h:217

References lappend(), makeNode, ParseNamespaceItem::p_cols_visible, ParseState::p_joinlist, ParseNamespaceItem::p_lateral_ok, ParseNamespaceItem::p_lateral_only, ParseState::p_namespace, ParseNamespaceItem::p_rel_visible, ParseNamespaceItem::p_rtindex, and RangeTblRef::rtindex.

Referenced by AddRelationNewConstraints(), AlterPolicy(), CreatePolicy(), CreateTriggerFiringOn(), DefineRelation(), DoCopy(), setTargetTable(), test_rls_hooks_permissive(), test_rls_hooks_restrictive(), transformAlterTableStmt(), transformIndexStmt(), transformInsertStmt(), transformMergeStmt(), transformOnConflictClause(), transformPartitionSpec(), TransformPubWhereClauses(), transformRuleStmt(), transformSetOperationStmt(), transformStatsStmt(), and transformValuesClause().

◆ addRangeTableEntry()

ParseNamespaceItem* addRangeTableEntry ( ParseState pstate,
RangeVar relation,
Alias alias,
bool  inh,
bool  inFromCl 
)

Definition at line 1470 of file parse_relation.c.

1475 {
1477  RTEPermissionInfo *perminfo;
1478  char *refname = alias ? alias->aliasname : relation->relname;
1479  LOCKMODE lockmode;
1480  Relation rel;
1481  ParseNamespaceItem *nsitem;
1482 
1483  Assert(pstate != NULL);
1484 
1485  rte->rtekind = RTE_RELATION;
1486  rte->alias = alias;
1487 
1488  /*
1489  * Identify the type of lock we'll need on this relation. It's not the
1490  * query's target table (that case is handled elsewhere), so we need
1491  * either RowShareLock if it's locked by FOR UPDATE/SHARE, or plain
1492  * AccessShareLock otherwise.
1493  */
1494  lockmode = isLockedRefname(pstate, refname) ? RowShareLock : AccessShareLock;
1495 
1496  /*
1497  * Get the rel's OID. This access also ensures that we have an up-to-date
1498  * relcache entry for the rel. Since this is typically the first access
1499  * to a rel in a statement, we must open the rel with the proper lockmode.
1500  */
1501  rel = parserOpenTable(pstate, relation, lockmode);
1502  rte->relid = RelationGetRelid(rel);
1503  rte->inh = inh;
1504  rte->relkind = rel->rd_rel->relkind;
1505  rte->rellockmode = lockmode;
1506 
1507  /*
1508  * Build the list of effective column names using user-supplied aliases
1509  * and/or actual column names.
1510  */
1511  rte->eref = makeAlias(refname, NIL);
1512  buildRelationAliases(rel->rd_att, alias, rte->eref);
1513 
1514  /*
1515  * Set flags and initialize access permissions.
1516  *
1517  * The initial default on access checks is always check-for-READ-access,
1518  * which is the right thing for all except target tables.
1519  */
1520  rte->lateral = false;
1521  rte->inFromCl = inFromCl;
1522 
1523  perminfo = addRTEPermissionInfo(&pstate->p_rteperminfos, rte);
1524  perminfo->requiredPerms = ACL_SELECT;
1525 
1526  /*
1527  * Add completed RTE to pstate's range table list, so that we know its
1528  * index. But we don't add it to the join list --- caller must do that if
1529  * appropriate.
1530  */
1531  pstate->p_rtable = lappend(pstate->p_rtable, rte);
1532 
1533  /*
1534  * Build a ParseNamespaceItem, but don't add it to the pstate's namespace
1535  * list --- caller must do that if appropriate.
1536  */
1537  nsitem = buildNSItemFromTupleDesc(rte, list_length(pstate->p_rtable),
1538  perminfo, rel->rd_att);
1539 
1540  /*
1541  * Drop the rel refcount, but keep the access lock till end of transaction
1542  * so that the table can't be deleted or have its schema modified
1543  * underneath us.
1544  */
1545  table_close(rel, NoLock);
1546 
1547  return nsitem;
1548 }
#define Assert(condition)
Definition: c.h:861
int LOCKMODE
Definition: lockdefs.h:26
#define NoLock
Definition: lockdefs.h:34
#define AccessShareLock
Definition: lockdefs.h:36
#define RowShareLock
Definition: lockdefs.h:37
Alias * makeAlias(const char *aliasname, List *colnames)
Definition: makefuncs.c:389
RTEPermissionInfo * addRTEPermissionInfo(List **rteperminfos, RangeTblEntry *rte)
Relation parserOpenTable(ParseState *pstate, const RangeVar *relation, int lockmode)
static ParseNamespaceItem * buildNSItemFromTupleDesc(RangeTblEntry *rte, Index rtindex, RTEPermissionInfo *perminfo, TupleDesc tupdesc)
bool isLockedRefname(ParseState *pstate, const char *refname)
static void buildRelationAliases(TupleDesc tupdesc, Alias *alias, Alias *eref)
@ RTE_RELATION
Definition: parsenodes.h:1017
#define ACL_SELECT
Definition: parsenodes.h:77
static int list_length(const List *l)
Definition: pg_list.h:152
#define NIL
Definition: pg_list.h:68
#define RelationGetRelid(relation)
Definition: rel.h:505
char * aliasname
Definition: primnodes.h:50
List * p_rteperminfos
Definition: parse_node.h:213
List * p_rtable
Definition: parse_node.h:212
AclMode requiredPerms
Definition: parsenodes.h:1291
RTEKind rtekind
Definition: parsenodes.h:1047
char * relname
Definition: primnodes.h:82
TupleDesc rd_att
Definition: rel.h:112
Form_pg_class rd_rel
Definition: rel.h:111
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:126

References AccessShareLock, ACL_SELECT, addRTEPermissionInfo(), Alias::aliasname, Assert, buildNSItemFromTupleDesc(), buildRelationAliases(), RangeTblEntry::inh, isLockedRefname(), lappend(), list_length(), makeAlias(), makeNode, NIL, NoLock, ParseState::p_rtable, ParseState::p_rteperminfos, parserOpenTable(), RelationData::rd_att, RelationData::rd_rel, RelationGetRelid, RangeTblEntry::relid, RangeVar::relname, RTEPermissionInfo::requiredPerms, RowShareLock, RTE_RELATION, RangeTblEntry::rtekind, and table_close().

Referenced by transformTableEntry().

◆ addRangeTableEntryForCTE()

ParseNamespaceItem* addRangeTableEntryForCTE ( ParseState pstate,
CommonTableExpr cte,
Index  levelsup,
RangeVar rv,
bool  inFromCl 
)

Definition at line 2314 of file parse_relation.c.

2319 {
2321  Alias *alias = rv->alias;
2322  char *refname = alias ? alias->aliasname : cte->ctename;
2323  Alias *eref;
2324  int numaliases;
2325  int varattno;
2326  ListCell *lc;
2327  int n_dontexpand_columns = 0;
2328  ParseNamespaceItem *psi;
2329 
2330  Assert(pstate != NULL);
2331 
2332  rte->rtekind = RTE_CTE;
2333  rte->ctename = cte->ctename;
2334  rte->ctelevelsup = levelsup;
2335 
2336  /* Self-reference if and only if CTE's parse analysis isn't completed */
2337  rte->self_reference = !IsA(cte->ctequery, Query);
2338  Assert(cte->cterecursive || !rte->self_reference);
2339  /* Bump the CTE's refcount if this isn't a self-reference */
2340  if (!rte->self_reference)
2341  cte->cterefcount++;
2342 
2343  /*
2344  * We throw error if the CTE is INSERT/UPDATE/DELETE/MERGE without
2345  * RETURNING. This won't get checked in case of a self-reference, but
2346  * that's OK because data-modifying CTEs aren't allowed to be recursive
2347  * anyhow.
2348  */
2349  if (IsA(cte->ctequery, Query))
2350  {
2351  Query *ctequery = (Query *) cte->ctequery;
2352 
2353  if (ctequery->commandType != CMD_SELECT &&
2354  ctequery->returningList == NIL)
2355  ereport(ERROR,
2356  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
2357  errmsg("WITH query \"%s\" does not have a RETURNING clause",
2358  cte->ctename),
2359  parser_errposition(pstate, rv->location)));
2360  }
2361 
2362  rte->coltypes = list_copy(cte->ctecoltypes);
2363  rte->coltypmods = list_copy(cte->ctecoltypmods);
2364  rte->colcollations = list_copy(cte->ctecolcollations);
2365 
2366  rte->alias = alias;
2367  if (alias)
2368  eref = copyObject(alias);
2369  else
2370  eref = makeAlias(refname, NIL);
2371  numaliases = list_length(eref->colnames);
2372 
2373  /* fill in any unspecified alias columns */
2374  varattno = 0;
2375  foreach(lc, cte->ctecolnames)
2376  {
2377  varattno++;
2378  if (varattno > numaliases)
2379  eref->colnames = lappend(eref->colnames, lfirst(lc));
2380  }
2381  if (varattno < numaliases)
2382  ereport(ERROR,
2383  (errcode(ERRCODE_INVALID_COLUMN_REFERENCE),
2384  errmsg("table \"%s\" has %d columns available but %d columns specified",
2385  refname, varattno, numaliases)));
2386 
2387  rte->eref = eref;
2388 
2389  if (cte->search_clause)
2390  {
2391  rte->eref->colnames = lappend(rte->eref->colnames, makeString(cte->search_clause->search_seq_column));
2392  if (cte->search_clause->search_breadth_first)
2393  rte->coltypes = lappend_oid(rte->coltypes, RECORDOID);
2394  else
2395  rte->coltypes = lappend_oid(rte->coltypes, RECORDARRAYOID);
2396  rte->coltypmods = lappend_int(rte->coltypmods, -1);
2397  rte->colcollations = lappend_oid(rte->colcollations, InvalidOid);
2398 
2399  n_dontexpand_columns += 1;
2400  }
2401 
2402  if (cte->cycle_clause)
2403  {
2404  rte->eref->colnames = lappend(rte->eref->colnames, makeString(cte->cycle_clause->cycle_mark_column));
2405  rte->coltypes = lappend_oid(rte->coltypes, cte->cycle_clause->cycle_mark_type);
2406  rte->coltypmods = lappend_int(rte->coltypmods, cte->cycle_clause->cycle_mark_typmod);
2407  rte->colcollations = lappend_oid(rte->colcollations, cte->cycle_clause->cycle_mark_collation);
2408 
2409  rte->eref->colnames = lappend(rte->eref->colnames, makeString(cte->cycle_clause->cycle_path_column));
2410  rte->coltypes = lappend_oid(rte->coltypes, RECORDARRAYOID);
2411  rte->coltypmods = lappend_int(rte->coltypmods, -1);
2412  rte->colcollations = lappend_oid(rte->colcollations, InvalidOid);
2413 
2414  n_dontexpand_columns += 2;
2415  }
2416 
2417  /*
2418  * Set flags and access permissions.
2419  *
2420  * Subqueries are never checked for access rights, so no need to perform
2421  * addRTEPermissionInfo().
2422  */
2423  rte->lateral = false;
2424  rte->inFromCl = inFromCl;
2425 
2426  /*
2427  * Add completed RTE to pstate's range table list, so that we know its
2428  * index. But we don't add it to the join list --- caller must do that if
2429  * appropriate.
2430  */
2431  pstate->p_rtable = lappend(pstate->p_rtable, rte);
2432 
2433  /*
2434  * Build a ParseNamespaceItem, but don't add it to the pstate's namespace
2435  * list --- caller must do that if appropriate.
2436  */
2437  psi = buildNSItemFromLists(rte, list_length(pstate->p_rtable),
2438  rte->coltypes, rte->coltypmods,
2439  rte->colcollations);
2440 
2441  /*
2442  * The columns added by search and cycle clauses are not included in star
2443  * expansion in queries contained in the CTE.
2444  */
2445  if (rte->ctelevelsup > 0)
2446  for (int i = 0; i < n_dontexpand_columns; i++)
2447  psi->p_nscolumns[list_length(psi->p_names->colnames) - 1 - i].p_dontexpand = true;
2448 
2449  return psi;
2450 }
int errcode(int sqlerrcode)
Definition: elog.c:853
int errmsg(const char *fmt,...)
Definition: elog.c:1070
#define ERROR
Definition: elog.h:39
#define ereport(elevel,...)
Definition: elog.h:149
int i
Definition: isn.c:72
if(TABLE==NULL||TABLE_index==NULL)
Definition: isn.c:76
List * lappend_int(List *list, int datum)
Definition: list.c:357
List * lappend_oid(List *list, Oid datum)
Definition: list.c:375
List * list_copy(const List *oldlist)
Definition: list.c:1573
#define IsA(nodeptr, _type_)
Definition: nodes.h:158
#define copyObject(obj)
Definition: nodes.h:224
@ CMD_SELECT
Definition: nodes.h:265
int parser_errposition(ParseState *pstate, int location)
Definition: parse_node.c:106
static ParseNamespaceItem * buildNSItemFromLists(RangeTblEntry *rte, Index rtindex, List *coltypes, List *coltypmods, List *colcollations)
@ RTE_CTE
Definition: parsenodes.h:1023
#define lfirst(lc)
Definition: pg_list.h:172
#define InvalidOid
Definition: postgres_ext.h:36
List * colnames
Definition: primnodes.h:51
ParseNamespaceColumn * p_nscolumns
Definition: parse_node.h:310
List * returningList
Definition: parsenodes.h:200
CmdType commandType
Definition: parsenodes.h:121
char * ctename
Definition: parsenodes.h:1196
Index ctelevelsup
Definition: parsenodes.h:1198
Alias * alias
Definition: primnodes.h:91
ParseLoc location
Definition: primnodes.h:94
String * makeString(char *str)
Definition: value.c:63

References RangeVar::alias, Alias::aliasname, Assert, buildNSItemFromLists(), CMD_SELECT, Alias::colnames, Query::commandType, copyObject, RangeTblEntry::ctelevelsup, RangeTblEntry::ctename, CommonTableExpr::ctename, CommonTableExpr::ctequery, ereport, errcode(), errmsg(), ERROR, i, if(), InvalidOid, IsA, lappend(), lappend_int(), lappend_oid(), lfirst, list_copy(), list_length(), RangeVar::location, makeAlias(), makeNode, makeString(), NIL, ParseNamespaceColumn::p_dontexpand, ParseNamespaceItem::p_names, ParseNamespaceItem::p_nscolumns, ParseState::p_rtable, parser_errposition(), Query::returningList, RTE_CTE, and RangeTblEntry::rtekind.

Referenced by getNSItemForSpecialRelationTypes().

◆ addRangeTableEntryForENR()

ParseNamespaceItem* addRangeTableEntryForENR ( ParseState pstate,
RangeVar rv,
bool  inFromCl 
)

Definition at line 2466 of file parse_relation.c.

2469 {
2471  Alias *alias = rv->alias;
2472  char *refname = alias ? alias->aliasname : rv->relname;
2474  TupleDesc tupdesc;
2475  int attno;
2476 
2477  Assert(pstate != NULL);
2478  enrmd = get_visible_ENR(pstate, rv->relname);
2479  Assert(enrmd != NULL);
2480 
2481  switch (enrmd->enrtype)
2482  {
2483  case ENR_NAMED_TUPLESTORE:
2485  break;
2486 
2487  default:
2488  elog(ERROR, "unexpected enrtype: %d", enrmd->enrtype);
2489  return NULL; /* for fussy compilers */
2490  }
2491 
2492  /*
2493  * Record dependency on a relation. This allows plans to be invalidated
2494  * if they access transition tables linked to a table that is altered.
2495  */
2496  rte->relid = enrmd->reliddesc;
2497 
2498  /*
2499  * Build the list of effective column names using user-supplied aliases
2500  * and/or actual column names.
2501  */
2502  tupdesc = ENRMetadataGetTupDesc(enrmd);
2503  rte->eref = makeAlias(refname, NIL);
2504  buildRelationAliases(tupdesc, alias, rte->eref);
2505 
2506  /* Record additional data for ENR, including column type info */
2507  rte->enrname = enrmd->name;
2508  rte->enrtuples = enrmd->enrtuples;
2509  rte->coltypes = NIL;
2510  rte->coltypmods = NIL;
2511  rte->colcollations = NIL;
2512  for (attno = 1; attno <= tupdesc->natts; ++attno)
2513  {
2514  Form_pg_attribute att = TupleDescAttr(tupdesc, attno - 1);
2515 
2516  if (att->attisdropped)
2517  {
2518  /* Record zeroes for a dropped column */
2519  rte->coltypes = lappend_oid(rte->coltypes, InvalidOid);
2520  rte->coltypmods = lappend_int(rte->coltypmods, 0);
2521  rte->colcollations = lappend_oid(rte->colcollations, InvalidOid);
2522  }
2523  else
2524  {
2525  /* Let's just make sure we can tell this isn't dropped */
2526  if (att->atttypid == InvalidOid)
2527  elog(ERROR, "atttypid is invalid for non-dropped column in \"%s\"",
2528  rv->relname);
2529  rte->coltypes = lappend_oid(rte->coltypes, att->atttypid);
2530  rte->coltypmods = lappend_int(rte->coltypmods, att->atttypmod);
2531  rte->colcollations = lappend_oid(rte->colcollations,
2532  att->attcollation);
2533  }
2534  }
2535 
2536  /*
2537  * Set flags and access permissions.
2538  *
2539  * ENRs are never checked for access rights, so no need to perform
2540  * addRTEPermissionInfo().
2541  */
2542  rte->lateral = false;
2543  rte->inFromCl = inFromCl;
2544 
2545  /*
2546  * Add completed RTE to pstate's range table list, so that we know its
2547  * index. But we don't add it to the join list --- caller must do that if
2548  * appropriate.
2549  */
2550  pstate->p_rtable = lappend(pstate->p_rtable, rte);
2551 
2552  /*
2553  * Build a ParseNamespaceItem, but don't add it to the pstate's namespace
2554  * list --- caller must do that if appropriate.
2555  */
2556  return buildNSItemFromTupleDesc(rte, list_length(pstate->p_rtable), NULL,
2557  tupdesc);
2558 }
#define elog(elevel,...)
Definition: elog.h:225
EphemeralNamedRelationMetadata get_visible_ENR(ParseState *pstate, const char *refname)
Definition: parse_enr.c:26
@ RTE_NAMEDTUPLESTORE
Definition: parsenodes.h:1024
FormData_pg_attribute * Form_pg_attribute
Definition: pg_attribute.h:209
TupleDesc ENRMetadataGetTupDesc(EphemeralNamedRelationMetadata enrmd)
@ ENR_NAMED_TUPLESTORE
EphemeralNameRelationType enrtype
char * enrname
Definition: parsenodes.h:1231
#define TupleDescAttr(tupdesc, i)
Definition: tupdesc.h:92

References RangeVar::alias, Alias::aliasname, Assert, buildNSItemFromTupleDesc(), buildRelationAliases(), elog, ENR_NAMED_TUPLESTORE, ENRMetadataGetTupDesc(), RangeTblEntry::enrname, EphemeralNamedRelationMetadataData::enrtuples, EphemeralNamedRelationMetadataData::enrtype, ERROR, get_visible_ENR(), InvalidOid, lappend(), lappend_int(), lappend_oid(), list_length(), makeAlias(), makeNode, EphemeralNamedRelationMetadataData::name, TupleDescData::natts, NIL, ParseState::p_rtable, RangeTblEntry::relid, EphemeralNamedRelationMetadataData::reliddesc, RangeVar::relname, RTE_NAMEDTUPLESTORE, RangeTblEntry::rtekind, and TupleDescAttr.

Referenced by getNSItemForSpecialRelationTypes().

◆ addRangeTableEntryForFunction()

ParseNamespaceItem* addRangeTableEntryForFunction ( ParseState pstate,
List funcnames,
List funcexprs,
List coldeflists,
RangeFunction rangefunc,
bool  lateral,
bool  inFromCl 
)

Definition at line 1734 of file parse_relation.c.

1741 {
1743  Alias *alias = rangefunc->alias;
1744  Alias *eref;
1745  char *aliasname;
1746  int nfuncs = list_length(funcexprs);
1747  TupleDesc *functupdescs;
1748  TupleDesc tupdesc;
1749  ListCell *lc1,
1750  *lc2,
1751  *lc3;
1752  int i;
1753  int j;
1754  int funcno;
1755  int natts,
1756  totalatts;
1757 
1758  Assert(pstate != NULL);
1759 
1760  rte->rtekind = RTE_FUNCTION;
1761  rte->relid = InvalidOid;
1762  rte->subquery = NULL;
1763  rte->functions = NIL; /* we'll fill this list below */
1764  rte->funcordinality = rangefunc->ordinality;
1765  rte->alias = alias;
1766 
1767  /*
1768  * Choose the RTE alias name. We default to using the first function's
1769  * name even when there's more than one; which is maybe arguable but beats
1770  * using something constant like "table".
1771  */
1772  if (alias)
1773  aliasname = alias->aliasname;
1774  else
1775  aliasname = linitial(funcnames);
1776 
1777  eref = makeAlias(aliasname, NIL);
1778  rte->eref = eref;
1779 
1780  /* Process each function ... */
1781  functupdescs = (TupleDesc *) palloc(nfuncs * sizeof(TupleDesc));
1782 
1783  totalatts = 0;
1784  funcno = 0;
1785  forthree(lc1, funcexprs, lc2, funcnames, lc3, coldeflists)
1786  {
1787  Node *funcexpr = (Node *) lfirst(lc1);
1788  char *funcname = (char *) lfirst(lc2);
1789  List *coldeflist = (List *) lfirst(lc3);
1791  TypeFuncClass functypclass;
1792  Oid funcrettype;
1793 
1794  /* Initialize RangeTblFunction node */
1795  rtfunc->funcexpr = funcexpr;
1796  rtfunc->funccolnames = NIL;
1797  rtfunc->funccoltypes = NIL;
1798  rtfunc->funccoltypmods = NIL;
1799  rtfunc->funccolcollations = NIL;
1800  rtfunc->funcparams = NULL; /* not set until planning */
1801 
1802  /*
1803  * Now determine if the function returns a simple or composite type.
1804  */
1805  functypclass = get_expr_result_type(funcexpr,
1806  &funcrettype,
1807  &tupdesc);
1808 
1809  /*
1810  * A coldeflist is required if the function returns RECORD and hasn't
1811  * got a predetermined record type, and is prohibited otherwise. This
1812  * can be a bit confusing, so we expend some effort on delivering a
1813  * relevant error message.
1814  */
1815  if (coldeflist != NIL)
1816  {
1817  switch (functypclass)
1818  {
1819  case TYPEFUNC_RECORD:
1820  /* ok */
1821  break;
1822  case TYPEFUNC_COMPOSITE:
1824 
1825  /*
1826  * If the function's raw result type is RECORD, we must
1827  * have resolved it using its OUT parameters. Otherwise,
1828  * it must have a named composite type.
1829  */
1830  if (exprType(funcexpr) == RECORDOID)
1831  ereport(ERROR,
1832  (errcode(ERRCODE_SYNTAX_ERROR),
1833  errmsg("a column definition list is redundant for a function with OUT parameters"),
1834  parser_errposition(pstate,
1835  exprLocation((Node *) coldeflist))));
1836  else
1837  ereport(ERROR,
1838  (errcode(ERRCODE_SYNTAX_ERROR),
1839  errmsg("a column definition list is redundant for a function returning a named composite type"),
1840  parser_errposition(pstate,
1841  exprLocation((Node *) coldeflist))));
1842  break;
1843  default:
1844  ereport(ERROR,
1845  (errcode(ERRCODE_SYNTAX_ERROR),
1846  errmsg("a column definition list is only allowed for functions returning \"record\""),
1847  parser_errposition(pstate,
1848  exprLocation((Node *) coldeflist))));
1849  break;
1850  }
1851  }
1852  else
1853  {
1854  if (functypclass == TYPEFUNC_RECORD)
1855  ereport(ERROR,
1856  (errcode(ERRCODE_SYNTAX_ERROR),
1857  errmsg("a column definition list is required for functions returning \"record\""),
1858  parser_errposition(pstate, exprLocation(funcexpr))));
1859  }
1860 
1861  if (functypclass == TYPEFUNC_COMPOSITE ||
1862  functypclass == TYPEFUNC_COMPOSITE_DOMAIN)
1863  {
1864  /* Composite data type, e.g. a table's row type */
1865  Assert(tupdesc);
1866  }
1867  else if (functypclass == TYPEFUNC_SCALAR)
1868  {
1869  /* Base data type, i.e. scalar */
1870  tupdesc = CreateTemplateTupleDesc(1);
1871  TupleDescInitEntry(tupdesc,
1872  (AttrNumber) 1,
1874  alias, nfuncs),
1875  funcrettype,
1876  exprTypmod(funcexpr),
1877  0);
1879  (AttrNumber) 1,
1880  exprCollation(funcexpr));
1881  }
1882  else if (functypclass == TYPEFUNC_RECORD)
1883  {
1884  ListCell *col;
1885 
1886  /*
1887  * Use the column definition list to construct a tupdesc and fill
1888  * in the RangeTblFunction's lists. Limit number of columns to
1889  * MaxHeapAttributeNumber, because CheckAttributeNamesTypes will.
1890  */
1891  if (list_length(coldeflist) > MaxHeapAttributeNumber)
1892  ereport(ERROR,
1893  (errcode(ERRCODE_TOO_MANY_COLUMNS),
1894  errmsg("column definition lists can have at most %d entries",
1896  parser_errposition(pstate,
1897  exprLocation((Node *) coldeflist))));
1898  tupdesc = CreateTemplateTupleDesc(list_length(coldeflist));
1899  i = 1;
1900  foreach(col, coldeflist)
1901  {
1902  ColumnDef *n = (ColumnDef *) lfirst(col);
1903  char *attrname;
1904  Oid attrtype;
1905  int32 attrtypmod;
1906  Oid attrcollation;
1907 
1908  attrname = n->colname;
1909  if (n->typeName->setof)
1910  ereport(ERROR,
1911  (errcode(ERRCODE_INVALID_TABLE_DEFINITION),
1912  errmsg("column \"%s\" cannot be declared SETOF",
1913  attrname),
1914  parser_errposition(pstate, n->location)));
1915  typenameTypeIdAndMod(pstate, n->typeName,
1916  &attrtype, &attrtypmod);
1917  attrcollation = GetColumnDefCollation(pstate, n, attrtype);
1918  TupleDescInitEntry(tupdesc,
1919  (AttrNumber) i,
1920  attrname,
1921  attrtype,
1922  attrtypmod,
1923  0);
1925  (AttrNumber) i,
1926  attrcollation);
1927  rtfunc->funccolnames = lappend(rtfunc->funccolnames,
1928  makeString(pstrdup(attrname)));
1929  rtfunc->funccoltypes = lappend_oid(rtfunc->funccoltypes,
1930  attrtype);
1931  rtfunc->funccoltypmods = lappend_int(rtfunc->funccoltypmods,
1932  attrtypmod);
1933  rtfunc->funccolcollations = lappend_oid(rtfunc->funccolcollations,
1934  attrcollation);
1935 
1936  i++;
1937  }
1938 
1939  /*
1940  * Ensure that the coldeflist defines a legal set of names (no
1941  * duplicates, but we needn't worry about system column names) and
1942  * datatypes. Although we mostly can't allow pseudo-types, it
1943  * seems safe to allow RECORD and RECORD[], since values within
1944  * those type classes are self-identifying at runtime, and the
1945  * coldeflist doesn't represent anything that will be visible to
1946  * other sessions.
1947  */
1948  CheckAttributeNamesTypes(tupdesc, RELKIND_COMPOSITE_TYPE,
1950  }
1951  else
1952  ereport(ERROR,
1953  (errcode(ERRCODE_DATATYPE_MISMATCH),
1954  errmsg("function \"%s\" in FROM has unsupported return type %s",
1955  funcname, format_type_be(funcrettype)),
1956  parser_errposition(pstate, exprLocation(funcexpr))));
1957 
1958  /* Finish off the RangeTblFunction and add it to the RTE's list */
1959  rtfunc->funccolcount = tupdesc->natts;
1960  rte->functions = lappend(rte->functions, rtfunc);
1961 
1962  /* Save the tupdesc for use below */
1963  functupdescs[funcno] = tupdesc;
1964  totalatts += tupdesc->natts;
1965  funcno++;
1966  }
1967 
1968  /*
1969  * If there's more than one function, or we want an ordinality column, we
1970  * have to produce a merged tupdesc.
1971  */
1972  if (nfuncs > 1 || rangefunc->ordinality)
1973  {
1974  if (rangefunc->ordinality)
1975  totalatts++;
1976 
1977  /* Disallow more columns than will fit in a tuple */
1978  if (totalatts > MaxTupleAttributeNumber)
1979  ereport(ERROR,
1980  (errcode(ERRCODE_TOO_MANY_COLUMNS),
1981  errmsg("functions in FROM can return at most %d columns",
1983  parser_errposition(pstate,
1984  exprLocation((Node *) funcexprs))));
1985 
1986  /* Merge the tuple descs of each function into a composite one */
1987  tupdesc = CreateTemplateTupleDesc(totalatts);
1988  natts = 0;
1989  for (i = 0; i < nfuncs; i++)
1990  {
1991  for (j = 1; j <= functupdescs[i]->natts; j++)
1992  TupleDescCopyEntry(tupdesc, ++natts, functupdescs[i], j);
1993  }
1994 
1995  /* Add the ordinality column if needed */
1996  if (rangefunc->ordinality)
1997  {
1998  TupleDescInitEntry(tupdesc,
1999  (AttrNumber) ++natts,
2000  "ordinality",
2001  INT8OID,
2002  -1,
2003  0);
2004  /* no need to set collation */
2005  }
2006 
2007  Assert(natts == totalatts);
2008  }
2009  else
2010  {
2011  /* We can just use the single function's tupdesc as-is */
2012  tupdesc = functupdescs[0];
2013  }
2014 
2015  /* Use the tupdesc while assigning column aliases for the RTE */
2016  buildRelationAliases(tupdesc, alias, eref);
2017 
2018  /*
2019  * Set flags and access permissions.
2020  *
2021  * Functions are never checked for access rights (at least, not by
2022  * ExecCheckPermissions()), so no need to perform addRTEPermissionInfo().
2023  */
2024  rte->lateral = lateral;
2025  rte->inFromCl = inFromCl;
2026 
2027  /*
2028  * Add completed RTE to pstate's range table list, so that we know its
2029  * index. But we don't add it to the join list --- caller must do that if
2030  * appropriate.
2031  */
2032  pstate->p_rtable = lappend(pstate->p_rtable, rte);
2033 
2034  /*
2035  * Build a ParseNamespaceItem, but don't add it to the pstate's namespace
2036  * list --- caller must do that if appropriate.
2037  */
2038  return buildNSItemFromTupleDesc(rte, list_length(pstate->p_rtable), NULL,
2039  tupdesc);
2040 }
int16 AttrNumber
Definition: attnum.h:21
signed int int32
Definition: c.h:508
char * format_type_be(Oid type_oid)
Definition: format_type.c:343
TypeFuncClass get_expr_result_type(Node *expr, Oid *resultTypeId, TupleDesc *resultTupleDesc)
Definition: funcapi.c:299
TypeFuncClass
Definition: funcapi.h:147
@ TYPEFUNC_SCALAR
Definition: funcapi.h:148
@ TYPEFUNC_COMPOSITE
Definition: funcapi.h:149
@ TYPEFUNC_RECORD
Definition: funcapi.h:151
@ TYPEFUNC_COMPOSITE_DOMAIN
Definition: funcapi.h:150
void CheckAttributeNamesTypes(TupleDesc tupdesc, char relkind, int flags)
Definition: heap.c:456
#define CHKATYPE_ANYRECORD
Definition: heap.h:24
#define MaxTupleAttributeNumber
Definition: htup_details.h:34
#define MaxHeapAttributeNumber
Definition: htup_details.h:48
#define funcname
Definition: indent_codes.h:69
int j
Definition: isn.c:73
char * pstrdup(const char *in)
Definition: mcxt.c:1696
void * palloc(Size size)
Definition: mcxt.c:1317
Oid exprType(const Node *expr)
Definition: nodeFuncs.c:42
int32 exprTypmod(const Node *expr)
Definition: nodeFuncs.c:298
Oid exprCollation(const Node *expr)
Definition: nodeFuncs.c:816
int exprLocation(const Node *expr)
Definition: nodeFuncs.c:1380
static char * chooseScalarFunctionAlias(Node *funcexpr, char *funcname, Alias *alias, int nfuncs)
void typenameTypeIdAndMod(ParseState *pstate, const TypeName *typeName, Oid *typeid_p, int32 *typmod_p)
Definition: parse_type.c:310
Oid GetColumnDefCollation(ParseState *pstate, const ColumnDef *coldef, Oid typeOid)
Definition: parse_type.c:540
@ RTE_FUNCTION
Definition: parsenodes.h:1020
#define forthree(cell1, list1, cell2, list2, cell3, list3)
Definition: pg_list.h:563
#define linitial(l)
Definition: pg_list.h:178
unsigned int Oid
Definition: postgres_ext.h:31
char * colname
Definition: parsenodes.h:728
TypeName * typeName
Definition: parsenodes.h:729
ParseLoc location
Definition: parsenodes.h:747
Definition: pg_list.h:54
Definition: nodes.h:129
Alias * alias
Definition: parsenodes.h:646
bool funcordinality
Definition: parsenodes.h:1179
Query * subquery
Definition: parsenodes.h:1104
List * functions
Definition: parsenodes.h:1177
bool setof
Definition: parsenodes.h:272
TupleDesc CreateTemplateTupleDesc(int natts)
Definition: tupdesc.c:67
void TupleDescInitEntryCollation(TupleDesc desc, AttrNumber attributeNumber, Oid collationid)
Definition: tupdesc.c:833
void TupleDescInitEntry(TupleDesc desc, AttrNumber attributeNumber, const char *attributeName, Oid oidtypeid, int32 typmod, int attdim)
Definition: tupdesc.c:651
void TupleDescCopyEntry(TupleDesc dst, AttrNumber dstAttno, TupleDesc src, AttrNumber srcAttno)
Definition: tupdesc.c:289

References RangeFunction::alias, Alias::aliasname, Assert, buildNSItemFromTupleDesc(), buildRelationAliases(), CheckAttributeNamesTypes(), CHKATYPE_ANYRECORD, chooseScalarFunctionAlias(), ColumnDef::colname, CreateTemplateTupleDesc(), ereport, errcode(), errmsg(), ERROR, exprCollation(), exprLocation(), exprType(), exprTypmod(), format_type_be(), forthree, RangeTblFunction::funcexpr, funcname, RangeTblEntry::funcordinality, RangeTblEntry::functions, get_expr_result_type(), GetColumnDefCollation(), i, InvalidOid, j, lappend(), lappend_int(), lappend_oid(), lfirst, linitial, list_length(), ColumnDef::location, makeAlias(), makeNode, makeString(), MaxHeapAttributeNumber, MaxTupleAttributeNumber, TupleDescData::natts, NIL, RangeFunction::ordinality, ParseState::p_rtable, palloc(), parser_errposition(), pstrdup(), RangeTblEntry::relid, RTE_FUNCTION, RangeTblEntry::rtekind, TypeName::setof, RangeTblEntry::subquery, TupleDescCopyEntry(), TupleDescInitEntry(), TupleDescInitEntryCollation(), TYPEFUNC_COMPOSITE, TYPEFUNC_COMPOSITE_DOMAIN, TYPEFUNC_RECORD, TYPEFUNC_SCALAR, ColumnDef::typeName, and typenameTypeIdAndMod().

Referenced by transformRangeFunction().

◆ addRangeTableEntryForGroup()

ParseNamespaceItem* addRangeTableEntryForGroup ( ParseState pstate,
List groupClauses 
)

Definition at line 2565 of file parse_relation.c.

2567 {
2569  Alias *eref;
2570  List *groupexprs;
2571  List *coltypes,
2572  *coltypmods,
2573  *colcollations;
2574  ListCell *lc;
2575  ParseNamespaceItem *nsitem;
2576 
2577  Assert(pstate != NULL);
2578 
2579  rte->rtekind = RTE_GROUP;
2580  rte->alias = NULL;
2581 
2582  eref = makeAlias("*GROUP*", NIL);
2583 
2584  /* fill in any unspecified alias columns, and extract column type info */
2585  groupexprs = NIL;
2586  coltypes = coltypmods = colcollations = NIL;
2587  foreach(lc, groupClauses)
2588  {
2589  TargetEntry *te = (TargetEntry *) lfirst(lc);
2590  char *colname = te->resname ? pstrdup(te->resname) : "?column?";
2591 
2592  eref->colnames = lappend(eref->colnames, makeString(colname));
2593 
2594  groupexprs = lappend(groupexprs, copyObject(te->expr));
2595 
2596  coltypes = lappend_oid(coltypes,
2597  exprType((Node *) te->expr));
2598  coltypmods = lappend_int(coltypmods,
2599  exprTypmod((Node *) te->expr));
2600  colcollations = lappend_oid(colcollations,
2601  exprCollation((Node *) te->expr));
2602  }
2603 
2604  rte->eref = eref;
2605  rte->groupexprs = groupexprs;
2606 
2607  /*
2608  * Set flags.
2609  *
2610  * The grouping step is never checked for access rights, so no need to
2611  * perform addRTEPermissionInfo().
2612  */
2613  rte->lateral = false;
2614  rte->inFromCl = false;
2615 
2616  /*
2617  * Add completed RTE to pstate's range table list, so that we know its
2618  * index. But we don't add it to the join list --- caller must do that if
2619  * appropriate.
2620  */
2621  pstate->p_rtable = lappend(pstate->p_rtable, rte);
2622 
2623  /*
2624  * Build a ParseNamespaceItem, but don't add it to the pstate's namespace
2625  * list --- caller must do that if appropriate.
2626  */
2627  nsitem = buildNSItemFromLists(rte, list_length(pstate->p_rtable),
2628  coltypes, coltypmods, colcollations);
2629 
2630  return nsitem;
2631 }
@ RTE_GROUP
Definition: parsenodes.h:1028
Expr * expr
Definition: primnodes.h:2190

References Assert, buildNSItemFromLists(), Alias::colnames, copyObject, TargetEntry::expr, exprCollation(), exprType(), exprTypmod(), lappend(), lappend_int(), lappend_oid(), lfirst, list_length(), makeAlias(), makeNode, makeString(), NIL, ParseState::p_rtable, pstrdup(), RTE_GROUP, and RangeTblEntry::rtekind.

Referenced by parseCheckAggregates().

◆ addRangeTableEntryForJoin()

ParseNamespaceItem* addRangeTableEntryForJoin ( ParseState pstate,
List colnames,
ParseNamespaceColumn nscolumns,
JoinType  jointype,
int  nummergedcols,
List aliasvars,
List leftcols,
List rightcols,
Alias join_using_alias,
Alias alias,
bool  inFromCl 
)

Definition at line 2216 of file parse_relation.c.

2227 {
2229  Alias *eref;
2230  int numaliases;
2231  ParseNamespaceItem *nsitem;
2232 
2233  Assert(pstate != NULL);
2234 
2235  /*
2236  * Fail if join has too many columns --- we must be able to reference any
2237  * of the columns with an AttrNumber.
2238  */
2239  if (list_length(aliasvars) > MaxAttrNumber)
2240  ereport(ERROR,
2241  (errcode(ERRCODE_PROGRAM_LIMIT_EXCEEDED),
2242  errmsg("joins can have at most %d columns",
2243  MaxAttrNumber)));
2244 
2245  rte->rtekind = RTE_JOIN;
2246  rte->relid = InvalidOid;
2247  rte->subquery = NULL;
2248  rte->jointype = jointype;
2249  rte->joinmergedcols = nummergedcols;
2250  rte->joinaliasvars = aliasvars;
2251  rte->joinleftcols = leftcols;
2252  rte->joinrightcols = rightcols;
2253  rte->join_using_alias = join_using_alias;
2254  rte->alias = alias;
2255 
2256  eref = alias ? copyObject(alias) : makeAlias("unnamed_join", NIL);
2257  numaliases = list_length(eref->colnames);
2258 
2259  /* fill in any unspecified alias columns */
2260  if (numaliases < list_length(colnames))
2261  eref->colnames = list_concat(eref->colnames,
2262  list_copy_tail(colnames, numaliases));
2263 
2264  if (numaliases > list_length(colnames))
2265  ereport(ERROR,
2266  (errcode(ERRCODE_INVALID_COLUMN_REFERENCE),
2267  errmsg("join expression \"%s\" has %d columns available but %d columns specified",
2268  eref->aliasname, list_length(colnames), numaliases)));
2269 
2270  rte->eref = eref;
2271 
2272  /*
2273  * Set flags and access permissions.
2274  *
2275  * Joins are never checked for access rights, so no need to perform
2276  * addRTEPermissionInfo().
2277  */
2278  rte->lateral = false;
2279  rte->inFromCl = inFromCl;
2280 
2281  /*
2282  * Add completed RTE to pstate's range table list, so that we know its
2283  * index. But we don't add it to the join list --- caller must do that if
2284  * appropriate.
2285  */
2286  pstate->p_rtable = lappend(pstate->p_rtable, rte);
2287 
2288  /*
2289  * Build a ParseNamespaceItem, but don't add it to the pstate's namespace
2290  * list --- caller must do that if appropriate.
2291  */
2292  nsitem = (ParseNamespaceItem *) palloc(sizeof(ParseNamespaceItem));
2293  nsitem->p_names = rte->eref;
2294  nsitem->p_rte = rte;
2295  nsitem->p_perminfo = NULL;
2296  nsitem->p_rtindex = list_length(pstate->p_rtable);
2297  nsitem->p_nscolumns = nscolumns;
2298  /* set default visibility flags; might get changed later */
2299  nsitem->p_rel_visible = true;
2300  nsitem->p_cols_visible = true;
2301  nsitem->p_lateral_only = false;
2302  nsitem->p_lateral_ok = true;
2303 
2304  return nsitem;
2305 }
#define MaxAttrNumber
Definition: attnum.h:24
List * list_copy_tail(const List *oldlist, int nskip)
Definition: list.c:1613
List * list_concat(List *list1, const List *list2)
Definition: list.c:561
@ RTE_JOIN
Definition: parsenodes.h:1019
RangeTblEntry * p_rte
Definition: parse_node.h:306
RTEPermissionInfo * p_perminfo
Definition: parse_node.h:308
JoinType jointype
Definition: parsenodes.h:1151

References Alias::aliasname, Assert, Alias::colnames, copyObject, ereport, errcode(), errmsg(), ERROR, InvalidOid, RangeTblEntry::jointype, lappend(), list_concat(), list_copy_tail(), list_length(), makeAlias(), makeNode, MaxAttrNumber, NIL, ParseNamespaceItem::p_cols_visible, ParseNamespaceItem::p_lateral_ok, ParseNamespaceItem::p_lateral_only, ParseNamespaceItem::p_names, ParseNamespaceItem::p_nscolumns, ParseNamespaceItem::p_perminfo, ParseNamespaceItem::p_rel_visible, ParseState::p_rtable, ParseNamespaceItem::p_rte, ParseNamespaceItem::p_rtindex, palloc(), RangeTblEntry::relid, RTE_JOIN, RangeTblEntry::rtekind, and RangeTblEntry::subquery.

Referenced by transformFromClauseItem(), and transformSetOperationStmt().

◆ addRangeTableEntryForRelation()

ParseNamespaceItem* addRangeTableEntryForRelation ( ParseState pstate,
Relation  rel,
int  lockmode,
Alias alias,
bool  inh,
bool  inFromCl 
)

Definition at line 1567 of file parse_relation.c.

1573 {
1575  RTEPermissionInfo *perminfo;
1576  char *refname = alias ? alias->aliasname : RelationGetRelationName(rel);
1577 
1578  Assert(pstate != NULL);
1579 
1580  Assert(lockmode == AccessShareLock ||
1581  lockmode == RowShareLock ||
1582  lockmode == RowExclusiveLock);
1583  Assert(CheckRelationLockedByMe(rel, lockmode, true));
1584 
1585  rte->rtekind = RTE_RELATION;
1586  rte->alias = alias;
1587  rte->relid = RelationGetRelid(rel);
1588  rte->inh = inh;
1589  rte->relkind = rel->rd_rel->relkind;
1590  rte->rellockmode = lockmode;
1591 
1592  /*
1593  * Build the list of effective column names using user-supplied aliases
1594  * and/or actual column names.
1595  */
1596  rte->eref = makeAlias(refname, NIL);
1597  buildRelationAliases(rel->rd_att, alias, rte->eref);
1598 
1599  /*
1600  * Set flags and initialize access permissions.
1601  *
1602  * The initial default on access checks is always check-for-READ-access,
1603  * which is the right thing for all except target tables.
1604  */
1605  rte->lateral = false;
1606  rte->inFromCl = inFromCl;
1607 
1608  perminfo = addRTEPermissionInfo(&pstate->p_rteperminfos, rte);
1609  perminfo->requiredPerms = ACL_SELECT;
1610 
1611  /*
1612  * Add completed RTE to pstate's range table list, so that we know its
1613  * index. But we don't add it to the join list --- caller must do that if
1614  * appropriate.
1615  */
1616  pstate->p_rtable = lappend(pstate->p_rtable, rte);
1617 
1618  /*
1619  * Build a ParseNamespaceItem, but don't add it to the pstate's namespace
1620  * list --- caller must do that if appropriate.
1621  */
1622  return buildNSItemFromTupleDesc(rte, list_length(pstate->p_rtable),
1623  perminfo, rel->rd_att);
1624 }
bool CheckRelationLockedByMe(Relation relation, LOCKMODE lockmode, bool orstronger)
Definition: lmgr.c:329
#define RowExclusiveLock
Definition: lockdefs.h:38
#define RelationGetRelationName(relation)
Definition: rel.h:539

References AccessShareLock, ACL_SELECT, addRTEPermissionInfo(), Alias::aliasname, Assert, buildNSItemFromTupleDesc(), buildRelationAliases(), CheckRelationLockedByMe(), RangeTblEntry::inh, lappend(), list_length(), makeAlias(), makeNode, NIL, ParseState::p_rtable, ParseState::p_rteperminfos, RelationData::rd_att, RelationData::rd_rel, RelationGetRelationName, RelationGetRelid, RangeTblEntry::relid, RTEPermissionInfo::requiredPerms, RowExclusiveLock, RowShareLock, RTE_RELATION, and RangeTblEntry::rtekind.

Referenced by AddRelationNewConstraints(), AlterPolicy(), copy_table(), CreatePolicy(), CreateTriggerFiringOn(), DefineRelation(), DoCopy(), rewriteTargetView(), setTargetTable(), test_rls_hooks_permissive(), test_rls_hooks_restrictive(), transformAlterTableStmt(), transformIndexStmt(), transformOnConflictClause(), transformPartitionSpec(), TransformPubWhereClauses(), transformRuleStmt(), and transformStatsStmt().

◆ addRangeTableEntryForSubquery()

ParseNamespaceItem* addRangeTableEntryForSubquery ( ParseState pstate,
Query subquery,
Alias alias,
bool  lateral,
bool  inFromCl 
)

Definition at line 1638 of file parse_relation.c.

1643 {
1645  Alias *eref;
1646  int numaliases;
1647  List *coltypes,
1648  *coltypmods,
1649  *colcollations;
1650  int varattno;
1651  ListCell *tlistitem;
1652  ParseNamespaceItem *nsitem;
1653 
1654  Assert(pstate != NULL);
1655 
1656  rte->rtekind = RTE_SUBQUERY;
1657  rte->subquery = subquery;
1658  rte->alias = alias;
1659 
1660  eref = alias ? copyObject(alias) : makeAlias("unnamed_subquery", NIL);
1661  numaliases = list_length(eref->colnames);
1662 
1663  /* fill in any unspecified alias columns, and extract column type info */
1664  coltypes = coltypmods = colcollations = NIL;
1665  varattno = 0;
1666  foreach(tlistitem, subquery->targetList)
1667  {
1668  TargetEntry *te = (TargetEntry *) lfirst(tlistitem);
1669 
1670  if (te->resjunk)
1671  continue;
1672  varattno++;
1673  Assert(varattno == te->resno);
1674  if (varattno > numaliases)
1675  {
1676  char *attrname;
1677 
1678  attrname = pstrdup(te->resname);
1679  eref->colnames = lappend(eref->colnames, makeString(attrname));
1680  }
1681  coltypes = lappend_oid(coltypes,
1682  exprType((Node *) te->expr));
1683  coltypmods = lappend_int(coltypmods,
1684  exprTypmod((Node *) te->expr));
1685  colcollations = lappend_oid(colcollations,
1686  exprCollation((Node *) te->expr));
1687  }
1688  if (varattno < numaliases)
1689  ereport(ERROR,
1690  (errcode(ERRCODE_INVALID_COLUMN_REFERENCE),
1691  errmsg("table \"%s\" has %d columns available but %d columns specified",
1692  eref->aliasname, varattno, numaliases)));
1693 
1694  rte->eref = eref;
1695 
1696  /*
1697  * Set flags.
1698  *
1699  * Subqueries are never checked for access rights, so no need to perform
1700  * addRTEPermissionInfo().
1701  */
1702  rte->lateral = lateral;
1703  rte->inFromCl = inFromCl;
1704 
1705  /*
1706  * Add completed RTE to pstate's range table list, so that we know its
1707  * index. But we don't add it to the join list --- caller must do that if
1708  * appropriate.
1709  */
1710  pstate->p_rtable = lappend(pstate->p_rtable, rte);
1711 
1712  /*
1713  * Build a ParseNamespaceItem, but don't add it to the pstate's namespace
1714  * list --- caller must do that if appropriate.
1715  */
1716  nsitem = buildNSItemFromLists(rte, list_length(pstate->p_rtable),
1717  coltypes, coltypmods, colcollations);
1718 
1719  /*
1720  * Mark it visible as a relation name only if it had a user-written alias.
1721  */
1722  nsitem->p_rel_visible = (alias != NULL);
1723 
1724  return nsitem;
1725 }
@ RTE_SUBQUERY
Definition: parsenodes.h:1018
List * targetList
Definition: parsenodes.h:193
AttrNumber resno
Definition: primnodes.h:2192

References Alias::aliasname, Assert, buildNSItemFromLists(), Alias::colnames, copyObject, ereport, errcode(), errmsg(), ERROR, TargetEntry::expr, exprCollation(), exprType(), exprTypmod(), lappend(), lappend_int(), lappend_oid(), lfirst, list_length(), makeAlias(), makeNode, makeString(), NIL, ParseNamespaceItem::p_rel_visible, ParseState::p_rtable, pstrdup(), TargetEntry::resno, RTE_SUBQUERY, RangeTblEntry::rtekind, RangeTblEntry::subquery, and Query::targetList.

Referenced by convert_ANY_sublink_to_join(), transformInsertStmt(), transformRangeSubselect(), and transformSetOperationTree().

◆ addRangeTableEntryForTableFunc()

ParseNamespaceItem* addRangeTableEntryForTableFunc ( ParseState pstate,
TableFunc tf,
Alias alias,
bool  lateral,
bool  inFromCl 
)

Definition at line 2049 of file parse_relation.c.

2054 {
2056  char *refname;
2057  Alias *eref;
2058  int numaliases;
2059 
2060  Assert(pstate != NULL);
2061 
2062  /* Disallow more columns than will fit in a tuple */
2063  if (list_length(tf->colnames) > MaxTupleAttributeNumber)
2064  ereport(ERROR,
2065  (errcode(ERRCODE_TOO_MANY_COLUMNS),
2066  errmsg("functions in FROM can return at most %d columns",
2068  parser_errposition(pstate,
2069  exprLocation((Node *) tf))));
2070  Assert(list_length(tf->coltypes) == list_length(tf->colnames));
2071  Assert(list_length(tf->coltypmods) == list_length(tf->colnames));
2072  Assert(list_length(tf->colcollations) == list_length(tf->colnames));
2073 
2074  rte->rtekind = RTE_TABLEFUNC;
2075  rte->relid = InvalidOid;
2076  rte->subquery = NULL;
2077  rte->tablefunc = tf;
2078  rte->coltypes = tf->coltypes;
2079  rte->coltypmods = tf->coltypmods;
2080  rte->colcollations = tf->colcollations;
2081  rte->alias = alias;
2082 
2083  refname = alias ? alias->aliasname :
2084  pstrdup(tf->functype == TFT_XMLTABLE ? "xmltable" : "json_table");
2085  eref = alias ? copyObject(alias) : makeAlias(refname, NIL);
2086  numaliases = list_length(eref->colnames);
2087 
2088  /* fill in any unspecified alias columns */
2089  if (numaliases < list_length(tf->colnames))
2090  eref->colnames = list_concat(eref->colnames,
2091  list_copy_tail(tf->colnames, numaliases));
2092 
2093  if (numaliases > list_length(tf->colnames))
2094  ereport(ERROR,
2095  (errcode(ERRCODE_INVALID_COLUMN_REFERENCE),
2096  errmsg("%s function has %d columns available but %d columns specified",
2097  tf->functype == TFT_XMLTABLE ? "XMLTABLE" : "JSON_TABLE",
2098  list_length(tf->colnames), numaliases)));
2099 
2100  rte->eref = eref;
2101 
2102  /*
2103  * Set flags and access permissions.
2104  *
2105  * Tablefuncs are never checked for access rights (at least, not by
2106  * ExecCheckPermissions()), so no need to perform addRTEPermissionInfo().
2107  */
2108  rte->lateral = lateral;
2109  rte->inFromCl = inFromCl;
2110 
2111  /*
2112  * Add completed RTE to pstate's range table list, so that we know its
2113  * index. But we don't add it to the join list --- caller must do that if
2114  * appropriate.
2115  */
2116  pstate->p_rtable = lappend(pstate->p_rtable, rte);
2117 
2118  /*
2119  * Build a ParseNamespaceItem, but don't add it to the pstate's namespace
2120  * list --- caller must do that if appropriate.
2121  */
2122  return buildNSItemFromLists(rte, list_length(pstate->p_rtable),
2123  rte->coltypes, rte->coltypmods,
2124  rte->colcollations);
2125 }
@ RTE_TABLEFUNC
Definition: parsenodes.h:1021
@ TFT_XMLTABLE
Definition: primnodes.h:99
TableFunc * tablefunc
Definition: parsenodes.h:1184
TableFuncType functype
Definition: primnodes.h:113

References Alias::aliasname, Assert, buildNSItemFromLists(), Alias::colnames, copyObject, ereport, errcode(), errmsg(), ERROR, exprLocation(), TableFunc::functype, InvalidOid, lappend(), list_concat(), list_copy_tail(), list_length(), makeAlias(), makeNode, MaxTupleAttributeNumber, NIL, ParseState::p_rtable, parser_errposition(), pstrdup(), RangeTblEntry::relid, RTE_TABLEFUNC, RangeTblEntry::rtekind, RangeTblEntry::subquery, RangeTblEntry::tablefunc, and TFT_XMLTABLE.

Referenced by transformJsonTable(), and transformRangeTableFunc().

◆ addRangeTableEntryForValues()

ParseNamespaceItem* addRangeTableEntryForValues ( ParseState pstate,
List exprs,
List coltypes,
List coltypmods,
List colcollations,
Alias alias,
bool  lateral,
bool  inFromCl 
)

Definition at line 2134 of file parse_relation.c.

2142 {
2144  char *refname = alias ? alias->aliasname : pstrdup("*VALUES*");
2145  Alias *eref;
2146  int numaliases;
2147  int numcolumns;
2148 
2149  Assert(pstate != NULL);
2150 
2151  rte->rtekind = RTE_VALUES;
2152  rte->relid = InvalidOid;
2153  rte->subquery = NULL;
2154  rte->values_lists = exprs;
2155  rte->coltypes = coltypes;
2156  rte->coltypmods = coltypmods;
2157  rte->colcollations = colcollations;
2158  rte->alias = alias;
2159 
2160  eref = alias ? copyObject(alias) : makeAlias(refname, NIL);
2161 
2162  /* fill in any unspecified alias columns */
2163  numcolumns = list_length((List *) linitial(exprs));
2164  numaliases = list_length(eref->colnames);
2165  while (numaliases < numcolumns)
2166  {
2167  char attrname[64];
2168 
2169  numaliases++;
2170  snprintf(attrname, sizeof(attrname), "column%d", numaliases);
2171  eref->colnames = lappend(eref->colnames,
2172  makeString(pstrdup(attrname)));
2173  }
2174  if (numcolumns < numaliases)
2175  ereport(ERROR,
2176  (errcode(ERRCODE_INVALID_COLUMN_REFERENCE),
2177  errmsg("VALUES lists \"%s\" have %d columns available but %d columns specified",
2178  refname, numcolumns, numaliases)));
2179 
2180  rte->eref = eref;
2181 
2182  /*
2183  * Set flags and access permissions.
2184  *
2185  * Subqueries are never checked for access rights, so no need to perform
2186  * addRTEPermissionInfo().
2187  */
2188  rte->lateral = lateral;
2189  rte->inFromCl = inFromCl;
2190 
2191  /*
2192  * Add completed RTE to pstate's range table list, so that we know its
2193  * index. But we don't add it to the join list --- caller must do that if
2194  * appropriate.
2195  */
2196  pstate->p_rtable = lappend(pstate->p_rtable, rte);
2197 
2198  /*
2199  * Build a ParseNamespaceItem, but don't add it to the pstate's namespace
2200  * list --- caller must do that if appropriate.
2201  */
2202  return buildNSItemFromLists(rte, list_length(pstate->p_rtable),
2203  rte->coltypes, rte->coltypmods,
2204  rte->colcollations);
2205 }
@ RTE_VALUES
Definition: parsenodes.h:1022
#define snprintf
Definition: port.h:238
List * values_lists
Definition: parsenodes.h:1190

References Alias::aliasname, Assert, buildNSItemFromLists(), Alias::colnames, copyObject, ereport, errcode(), errmsg(), ERROR, InvalidOid, lappend(), linitial, list_length(), makeAlias(), makeNode, makeString(), NIL, ParseState::p_rtable, pstrdup(), RangeTblEntry::relid, RTE_VALUES, RangeTblEntry::rtekind, snprintf, RangeTblEntry::subquery, and RangeTblEntry::values_lists.

Referenced by transformValuesClause().

◆ addRTEPermissionInfo()

RTEPermissionInfo* addRTEPermissionInfo ( List **  rteperminfos,
RangeTblEntry rte 
)

Definition at line 3949 of file parse_relation.c.

3950 {
3951  RTEPermissionInfo *perminfo;
3952 
3953  Assert(OidIsValid(rte->relid));
3954  Assert(rte->perminfoindex == 0);
3955 
3956  /* Nope, so make one and add to the list. */
3957  perminfo = makeNode(RTEPermissionInfo);
3958  perminfo->relid = rte->relid;
3959  perminfo->inh = rte->inh;
3960  /* Other information is set by fetching the node as and where needed. */
3961 
3962  *rteperminfos = lappend(*rteperminfos, perminfo);
3963 
3964  /* Note its index (1-based!) */
3965  rte->perminfoindex = list_length(*rteperminfos);
3966 
3967  return perminfo;
3968 }
#define OidIsValid(objectId)
Definition: c.h:778

References Assert, RangeTblEntry::inh, RTEPermissionInfo::inh, lappend(), list_length(), makeNode, OidIsValid, RangeTblEntry::relid, and RTEPermissionInfo::relid.

Referenced by add_rte_to_flat_rtable(), addRangeTableEntry(), addRangeTableEntryForRelation(), create_edata_for_relation(), create_estate_for_relation(), plan_cluster_use_sort(), plan_create_index_workers(), and rewriteTargetView().

◆ attnameAttNum()

int attnameAttNum ( Relation  rd,
const char *  attname,
bool  sysColOK 
)

Definition at line 3558 of file parse_relation.c.

3559 {
3560  int i;
3561 
3562  for (i = 0; i < RelationGetNumberOfAttributes(rd); i++)
3563  {
3565 
3566  if (namestrcmp(&(att->attname), attname) == 0 && !att->attisdropped)
3567  return i + 1;
3568  }
3569 
3570  if (sysColOK)
3571  {
3573  return i;
3574  }
3575 
3576  /* on failure */
3577  return InvalidAttrNumber;
3578 }
#define InvalidAttrNumber
Definition: attnum.h:23
int namestrcmp(Name name, const char *str)
Definition: name.c:247
static int specialAttNum(const char *attname)
NameData attname
Definition: pg_attribute.h:41
#define RelationGetNumberOfAttributes(relation)
Definition: rel.h:511

References attname, i, InvalidAttrNumber, namestrcmp(), RelationData::rd_att, RelationGetNumberOfAttributes, specialAttNum(), and TupleDescAttr.

Referenced by checkInsertTargets(), CreateTriggerFiringOn(), do_analyze_rel(), and transformUpdateTargetList().

◆ attnumAttName()

const NameData* attnumAttName ( Relation  rd,
int  attid 
)

Definition at line 3608 of file parse_relation.c.

3609 {
3610  if (attid <= 0)
3611  {
3612  const FormData_pg_attribute *sysatt;
3613 
3614  sysatt = SystemAttributeDefinition(attid);
3615  return &sysatt->attname;
3616  }
3617  if (attid > rd->rd_att->natts)
3618  elog(ERROR, "invalid attribute number %d", attid);
3619  return &TupleDescAttr(rd->rd_att, attid - 1)->attname;
3620 }
const FormData_pg_attribute * SystemAttributeDefinition(AttrNumber attno)
Definition: heap.c:240
FormData_pg_attribute
Definition: pg_attribute.h:193

References elog, ERROR, FormData_pg_attribute, TupleDescData::natts, RelationData::rd_att, SystemAttributeDefinition(), and TupleDescAttr.

Referenced by transformFkeyGetPrimaryKey().

◆ attnumCollationId()

Oid attnumCollationId ( Relation  rd,
int  attid 
)

Definition at line 3650 of file parse_relation.c.

3651 {
3652  if (attid <= 0)
3653  {
3654  /* All system attributes are of noncollatable types. */
3655  return InvalidOid;
3656  }
3657  if (attid > rd->rd_att->natts)
3658  elog(ERROR, "invalid attribute number %d", attid);
3659  return TupleDescAttr(rd->rd_att, attid - 1)->attcollation;
3660 }

References elog, ERROR, InvalidOid, TupleDescData::natts, RelationData::rd_att, and TupleDescAttr.

◆ attnumTypeId()

Oid attnumTypeId ( Relation  rd,
int  attid 
)

Definition at line 3630 of file parse_relation.c.

3631 {
3632  if (attid <= 0)
3633  {
3634  const FormData_pg_attribute *sysatt;
3635 
3636  sysatt = SystemAttributeDefinition(attid);
3637  return sysatt->atttypid;
3638  }
3639  if (attid > rd->rd_att->natts)
3640  elog(ERROR, "invalid attribute number %d", attid);
3641  return TupleDescAttr(rd->rd_att, attid - 1)->atttypid;
3642 }

References elog, ERROR, FormData_pg_attribute, TupleDescData::natts, RelationData::rd_att, SystemAttributeDefinition(), and TupleDescAttr.

Referenced by transformAssignedExpr(), and transformFkeyGetPrimaryKey().

◆ checkNameSpaceConflicts()

void checkNameSpaceConflicts ( ParseState pstate,
List namespace1,
List namespace2 
)

Definition at line 434 of file parse_relation.c.

436 {
437  ListCell *l1;
438 
439  foreach(l1, namespace1)
440  {
441  ParseNamespaceItem *nsitem1 = (ParseNamespaceItem *) lfirst(l1);
442  RangeTblEntry *rte1 = nsitem1->p_rte;
443  const char *aliasname1 = nsitem1->p_names->aliasname;
444  ListCell *l2;
445 
446  if (!nsitem1->p_rel_visible)
447  continue;
448 
449  foreach(l2, namespace2)
450  {
451  ParseNamespaceItem *nsitem2 = (ParseNamespaceItem *) lfirst(l2);
452  RangeTblEntry *rte2 = nsitem2->p_rte;
453  const char *aliasname2 = nsitem2->p_names->aliasname;
454 
455  if (!nsitem2->p_rel_visible)
456  continue;
457  if (strcmp(aliasname2, aliasname1) != 0)
458  continue; /* definitely no conflict */
459  if (rte1->rtekind == RTE_RELATION && rte1->alias == NULL &&
460  rte2->rtekind == RTE_RELATION && rte2->alias == NULL &&
461  rte1->relid != rte2->relid)
462  continue; /* no conflict per SQL rule */
463  ereport(ERROR,
464  (errcode(ERRCODE_DUPLICATE_ALIAS),
465  errmsg("table name \"%s\" specified more than once",
466  aliasname1)));
467  }
468  }
469 }

References Alias::aliasname, ereport, errcode(), errmsg(), ERROR, lfirst, ParseNamespaceItem::p_names, ParseNamespaceItem::p_rel_visible, ParseNamespaceItem::p_rte, RangeTblEntry::relid, RTE_RELATION, and RangeTblEntry::rtekind.

Referenced by transformFromClause(), and transformFromClauseItem().

◆ colNameToVar()

Node* colNameToVar ( ParseState pstate,
const char *  colname,
bool  localonly,
int  location 
)

Definition at line 883 of file parse_relation.c.

885 {
886  Node *result = NULL;
887  int sublevels_up = 0;
888  ParseState *orig_pstate = pstate;
889 
890  while (pstate != NULL)
891  {
892  ListCell *l;
893 
894  foreach(l, pstate->p_namespace)
895  {
897  Node *newresult;
898 
899  /* Ignore table-only items */
900  if (!nsitem->p_cols_visible)
901  continue;
902  /* If not inside LATERAL, ignore lateral-only items */
903  if (nsitem->p_lateral_only && !pstate->p_lateral_active)
904  continue;
905 
906  /* use orig_pstate here for consistency with other callers */
907  newresult = scanNSItemForColumn(orig_pstate, nsitem, sublevels_up,
908  colname, location);
909 
910  if (newresult)
911  {
912  if (result)
913  ereport(ERROR,
914  (errcode(ERRCODE_AMBIGUOUS_COLUMN),
915  errmsg("column reference \"%s\" is ambiguous",
916  colname),
917  parser_errposition(pstate, location)));
918  check_lateral_ref_ok(pstate, nsitem, location);
919  result = newresult;
920  }
921  }
922 
923  if (result != NULL || localonly)
924  break; /* found, or don't want to look at parent */
925 
926  pstate = pstate->parentParseState;
927  sublevels_up++;
928  }
929 
930  return result;
931 }
Node * scanNSItemForColumn(ParseState *pstate, ParseNamespaceItem *nsitem, int sublevels_up, const char *colname, int location)
static void check_lateral_ref_ok(ParseState *pstate, ParseNamespaceItem *nsitem, int location)
ParseState * parentParseState
Definition: parse_node.h:208
bool p_lateral_active
Definition: parse_node.h:221

References check_lateral_ref_ok(), ereport, errcode(), errmsg(), ERROR, lfirst, ParseNamespaceItem::p_cols_visible, ParseState::p_lateral_active, ParseNamespaceItem::p_lateral_only, ParseState::p_namespace, ParseState::parentParseState, parser_errposition(), and scanNSItemForColumn().

Referenced by findTargetlistEntrySQL92(), and transformColumnRef().

◆ errorMissingColumn()

void errorMissingColumn ( ParseState pstate,
const char *  relname,
const char *  colname,
int  location 
)

Definition at line 3740 of file parse_relation.c.

3742 {
3744 
3745  /*
3746  * Search the entire rtable looking for possible matches. If we find one,
3747  * emit a hint about it.
3748  */
3749  state = searchRangeTableForCol(pstate, relname, colname, location);
3750 
3751  /*
3752  * If there are exact match(es), they must be inaccessible for some
3753  * reason.
3754  */
3755  if (state->rexact1)
3756  {
3757  /*
3758  * We don't try too hard when there's multiple inaccessible exact
3759  * matches, but at least be sure that we don't misleadingly suggest
3760  * that there's only one.
3761  */
3762  if (state->rexact2)
3763  ereport(ERROR,
3764  (errcode(ERRCODE_UNDEFINED_COLUMN),
3765  relname ?
3766  errmsg("column %s.%s does not exist", relname, colname) :
3767  errmsg("column \"%s\" does not exist", colname),
3768  errdetail("There are columns named \"%s\", but they are in tables that cannot be referenced from this part of the query.",
3769  colname),
3770  !relname ? errhint("Try using a table-qualified name.") : 0,
3771  parser_errposition(pstate, location)));
3772  /* Single exact match, so try to determine why it's inaccessible. */
3773  ereport(ERROR,
3774  (errcode(ERRCODE_UNDEFINED_COLUMN),
3775  relname ?
3776  errmsg("column %s.%s does not exist", relname, colname) :
3777  errmsg("column \"%s\" does not exist", colname),
3778  errdetail("There is a column named \"%s\" in table \"%s\", but it cannot be referenced from this part of the query.",
3779  colname, state->rexact1->eref->aliasname),
3780  rte_visible_if_lateral(pstate, state->rexact1) ?
3781  errhint("To reference that column, you must mark this subquery with LATERAL.") :
3782  (!relname && rte_visible_if_qualified(pstate, state->rexact1)) ?
3783  errhint("To reference that column, you must use a table-qualified name.") : 0,
3784  parser_errposition(pstate, location)));
3785  }
3786 
3787  if (!state->rsecond)
3788  {
3789  /* If we found no match at all, we have little to report */
3790  if (!state->rfirst)
3791  ereport(ERROR,
3792  (errcode(ERRCODE_UNDEFINED_COLUMN),
3793  relname ?
3794  errmsg("column %s.%s does not exist", relname, colname) :
3795  errmsg("column \"%s\" does not exist", colname),
3796  parser_errposition(pstate, location)));
3797  /* Handle case where we have a single alternative spelling to offer */
3798  ereport(ERROR,
3799  (errcode(ERRCODE_UNDEFINED_COLUMN),
3800  relname ?
3801  errmsg("column %s.%s does not exist", relname, colname) :
3802  errmsg("column \"%s\" does not exist", colname),
3803  errhint("Perhaps you meant to reference the column \"%s.%s\".",
3804  state->rfirst->eref->aliasname,
3805  strVal(list_nth(state->rfirst->eref->colnames,
3806  state->first - 1))),
3807  parser_errposition(pstate, location)));
3808  }
3809  else
3810  {
3811  /* Handle case where there are two equally useful column hints */
3812  ereport(ERROR,
3813  (errcode(ERRCODE_UNDEFINED_COLUMN),
3814  relname ?
3815  errmsg("column %s.%s does not exist", relname, colname) :
3816  errmsg("column \"%s\" does not exist", colname),
3817  errhint("Perhaps you meant to reference the column \"%s.%s\" or the column \"%s.%s\".",
3818  state->rfirst->eref->aliasname,
3819  strVal(list_nth(state->rfirst->eref->colnames,
3820  state->first - 1)),
3821  state->rsecond->eref->aliasname,
3822  strVal(list_nth(state->rsecond->eref->colnames,
3823  state->second - 1))),
3824  parser_errposition(pstate, location)));
3825  }
3826 }
int errdetail(const char *fmt,...)
Definition: elog.c:1203
int errhint(const char *fmt,...)
Definition: elog.c:1317
static bool rte_visible_if_lateral(ParseState *pstate, RangeTblEntry *rte)
static FuzzyAttrMatchState * searchRangeTableForCol(ParseState *pstate, const char *alias, const char *colname, int location)
static bool rte_visible_if_qualified(ParseState *pstate, RangeTblEntry *rte)
NameData relname
Definition: pg_class.h:38
static void * list_nth(const List *list, int n)
Definition: pg_list.h:299
Definition: regguts.h:323
#define strVal(v)
Definition: value.h:82

References ereport, errcode(), errdetail(), errhint(), errmsg(), ERROR, list_nth(), parser_errposition(), relname, rte_visible_if_lateral(), rte_visible_if_qualified(), searchRangeTableForCol(), and strVal.

Referenced by transformColumnRef().

◆ errorMissingRTE()

void errorMissingRTE ( ParseState pstate,
RangeVar relation 
)

Definition at line 3669 of file parse_relation.c.

3670 {
3671  RangeTblEntry *rte;
3672  const char *badAlias = NULL;
3673 
3674  /*
3675  * Check to see if there are any potential matches in the query's
3676  * rangetable. (Note: cases involving a bad schema name in the RangeVar
3677  * will throw error immediately here. That seems OK.)
3678  */
3679  rte = searchRangeTableForRel(pstate, relation);
3680 
3681  /*
3682  * If we found a match that has an alias and the alias is visible in the
3683  * namespace, then the problem is probably use of the relation's real name
3684  * instead of its alias, ie "SELECT foo.* FROM foo f". This mistake is
3685  * common enough to justify a specific hint.
3686  *
3687  * If we found a match that doesn't meet those criteria, assume the
3688  * problem is illegal use of a relation outside its scope, as in the
3689  * MySQL-ism "SELECT ... FROM a, b LEFT JOIN c ON (a.x = c.y)".
3690  */
3691  if (rte && rte->alias &&
3692  strcmp(rte->eref->aliasname, relation->relname) != 0)
3693  {
3694  ParseNamespaceItem *nsitem;
3695  int sublevels_up;
3696 
3697  nsitem = refnameNamespaceItem(pstate, NULL, rte->eref->aliasname,
3698  relation->location,
3699  &sublevels_up);
3700  if (nsitem && nsitem->p_rte == rte)
3701  badAlias = rte->eref->aliasname;
3702  }
3703 
3704  /* If it looks like the user forgot to use an alias, hint about that */
3705  if (badAlias)
3706  ereport(ERROR,
3708  errmsg("invalid reference to FROM-clause entry for table \"%s\"",
3709  relation->relname),
3710  errhint("Perhaps you meant to reference the table alias \"%s\".",
3711  badAlias),
3712  parser_errposition(pstate, relation->location)));
3713  /* Hint about case where we found an (inaccessible) exact match */
3714  else if (rte)
3715  ereport(ERROR,
3717  errmsg("invalid reference to FROM-clause entry for table \"%s\"",
3718  relation->relname),
3719  errdetail("There is an entry for table \"%s\", but it cannot be referenced from this part of the query.",
3720  rte->eref->aliasname),
3721  rte_visible_if_lateral(pstate, rte) ?
3722  errhint("To reference that table, you must mark this subquery with LATERAL.") : 0,
3723  parser_errposition(pstate, relation->location)));
3724  /* Else, we have nothing to offer but the bald statement of error */
3725  else
3726  ereport(ERROR,
3728  errmsg("missing FROM-clause entry for table \"%s\"",
3729  relation->relname),
3730  parser_errposition(pstate, relation->location)));
3731 }
static RangeTblEntry * searchRangeTableForRel(ParseState *pstate, RangeVar *relation)
ParseNamespaceItem * refnameNamespaceItem(ParseState *pstate, const char *schemaname, const char *refname, int location, int *sublevels_up)
#define ERRCODE_UNDEFINED_TABLE
Definition: pgbench.c:78

References ereport, errcode(), ERRCODE_UNDEFINED_TABLE, errdetail(), errhint(), errmsg(), ERROR, RangeVar::location, ParseNamespaceItem::p_rte, parser_errposition(), refnameNamespaceItem(), RangeVar::relname, rte_visible_if_lateral(), and searchRangeTableForRel().

Referenced by ExpandColumnRefStar(), and transformColumnRef().

◆ expandNSItemAttrs()

List* expandNSItemAttrs ( ParseState pstate,
ParseNamespaceItem nsitem,
int  sublevels_up,
bool  require_col_privs,
int  location 
)

Definition at line 3261 of file parse_relation.c.

3263 {
3264  RangeTblEntry *rte = nsitem->p_rte;
3265  RTEPermissionInfo *perminfo = nsitem->p_perminfo;
3266  List *names,
3267  *vars;
3268  ListCell *name,
3269  *var;
3270  List *te_list = NIL;
3271 
3272  vars = expandNSItemVars(pstate, nsitem, sublevels_up, location, &names);
3273 
3274  /*
3275  * Require read access to the table. This is normally redundant with the
3276  * markVarForSelectPriv calls below, but not if the table has zero
3277  * columns. We need not do anything if the nsitem is for a join: its
3278  * component tables will have been marked ACL_SELECT when they were added
3279  * to the rangetable. (This step changes things only for the target
3280  * relation of UPDATE/DELETE, which cannot be under a join.)
3281  */
3282  if (rte->rtekind == RTE_RELATION)
3283  {
3284  Assert(perminfo != NULL);
3285  perminfo->requiredPerms |= ACL_SELECT;
3286  }
3287 
3288  forboth(name, names, var, vars)
3289  {
3290  char *label = strVal(lfirst(name));
3291  Var *varnode = (Var *) lfirst(var);
3292  TargetEntry *te;
3293 
3294  te = makeTargetEntry((Expr *) varnode,
3295  (AttrNumber) pstate->p_next_resno++,
3296  label,
3297  false);
3298  te_list = lappend(te_list, te);
3299 
3300  if (require_col_privs)
3301  {
3302  /* Require read access to each column */
3303  markVarForSelectPriv(pstate, varnode);
3304  }
3305  }
3306 
3307  Assert(name == NULL && var == NULL); /* lists not the same length? */
3308 
3309  return te_list;
3310 }
TargetEntry * makeTargetEntry(Expr *expr, AttrNumber resno, char *resname, bool resjunk)
Definition: makefuncs.c:240
void markVarForSelectPriv(ParseState *pstate, Var *var)
List * expandNSItemVars(ParseState *pstate, ParseNamespaceItem *nsitem, int sublevels_up, int location, List **colnames)
static char * label
#define forboth(cell1, list1, cell2, list2)
Definition: pg_list.h:518
int p_next_resno
Definition: parse_node.h:231
Definition: primnodes.h:248
Definition: regcomp.c:281
const char * name

References ACL_SELECT, Assert, expandNSItemVars(), forboth, label, lappend(), lfirst, makeTargetEntry(), markVarForSelectPriv(), name, NIL, ParseState::p_next_resno, ParseNamespaceItem::p_perminfo, ParseNamespaceItem::p_rte, RTEPermissionInfo::requiredPerms, RTE_RELATION, RangeTblEntry::rtekind, and strVal.

Referenced by ExpandAllTables(), ExpandSingleTable(), and transformValuesClause().

◆ expandNSItemVars()

List* expandNSItemVars ( ParseState pstate,
ParseNamespaceItem nsitem,
int  sublevels_up,
int  location,
List **  colnames 
)

Definition at line 3197 of file parse_relation.c.

3200 {
3201  List *result = NIL;
3202  int colindex;
3203  ListCell *lc;
3204 
3205  if (colnames)
3206  *colnames = NIL;
3207  colindex = 0;
3208  foreach(lc, nsitem->p_names->colnames)
3209  {
3210  String *colnameval = lfirst(lc);
3211  const char *colname = strVal(colnameval);
3212  ParseNamespaceColumn *nscol = nsitem->p_nscolumns + colindex;
3213 
3214  if (nscol->p_dontexpand)
3215  {
3216  /* skip */
3217  }
3218  else if (colname[0])
3219  {
3220  Var *var;
3221 
3222  Assert(nscol->p_varno > 0);
3223  var = makeVar(nscol->p_varno,
3224  nscol->p_varattno,
3225  nscol->p_vartype,
3226  nscol->p_vartypmod,
3227  nscol->p_varcollid,
3228  sublevels_up);
3229  /* makeVar doesn't offer parameters for these, so set by hand: */
3230  var->varnosyn = nscol->p_varnosyn;
3231  var->varattnosyn = nscol->p_varattnosyn;
3232  var->location = location;
3233 
3234  /* ... and update varnullingrels */
3235  markNullableIfNeeded(pstate, var);
3236 
3237  result = lappend(result, var);
3238  if (colnames)
3239  *colnames = lappend(*colnames, colnameval);
3240  }
3241  else
3242  {
3243  /* dropped column, ignore */
3244  Assert(nscol->p_varno == 0);
3245  }
3246  colindex++;
3247  }
3248  return result;
3249 }
Var * makeVar(int varno, AttrNumber varattno, Oid vartype, int32 vartypmod, Oid varcollid, Index varlevelsup)
Definition: makefuncs.c:66
void markNullableIfNeeded(ParseState *pstate, Var *var)
AttrNumber p_varattno
Definition: parse_node.h:341
AttrNumber p_varattnosyn
Definition: parse_node.h:346
Definition: value.h:64
ParseLoc location
Definition: primnodes.h:293

References Assert, Alias::colnames, lappend(), lfirst, Var::location, makeVar(), markNullableIfNeeded(), NIL, ParseNamespaceColumn::p_dontexpand, ParseNamespaceItem::p_names, ParseNamespaceItem::p_nscolumns, ParseNamespaceColumn::p_varattno, ParseNamespaceColumn::p_varattnosyn, ParseNamespaceColumn::p_varcollid, ParseNamespaceColumn::p_varno, ParseNamespaceColumn::p_varnosyn, ParseNamespaceColumn::p_vartype, ParseNamespaceColumn::p_vartypmod, and strVal.

Referenced by coerce_record_to_complex(), expandNSItemAttrs(), and ExpandSingleTable().

◆ expandRTE()

void expandRTE ( RangeTblEntry rte,
int  rtindex,
int  sublevels_up,
int  location,
bool  include_dropped,
List **  colnames,
List **  colvars 
)

Definition at line 2732 of file parse_relation.c.

2735 {
2736  int varattno;
2737 
2738  if (colnames)
2739  *colnames = NIL;
2740  if (colvars)
2741  *colvars = NIL;
2742 
2743  switch (rte->rtekind)
2744  {
2745  case RTE_RELATION:
2746  /* Ordinary relation RTE */
2747  expandRelation(rte->relid, rte->eref,
2748  rtindex, sublevels_up, location,
2749  include_dropped, colnames, colvars);
2750  break;
2751  case RTE_SUBQUERY:
2752  {
2753  /* Subquery RTE */
2754  ListCell *aliasp_item = list_head(rte->eref->colnames);
2755  ListCell *tlistitem;
2756 
2757  varattno = 0;
2758  foreach(tlistitem, rte->subquery->targetList)
2759  {
2760  TargetEntry *te = (TargetEntry *) lfirst(tlistitem);
2761 
2762  if (te->resjunk)
2763  continue;
2764  varattno++;
2765  Assert(varattno == te->resno);
2766 
2767  /*
2768  * Formerly it was possible for the subquery tlist to have
2769  * more non-junk entries than the colnames list does (if
2770  * this RTE has been expanded from a view that has more
2771  * columns than it did when the current query was parsed).
2772  * Now that ApplyRetrieveRule cleans up such cases, we
2773  * shouldn't see that anymore, but let's just check.
2774  */
2775  if (!aliasp_item)
2776  elog(ERROR, "too few column names for subquery %s",
2777  rte->eref->aliasname);
2778 
2779  if (colnames)
2780  {
2781  char *label = strVal(lfirst(aliasp_item));
2782 
2783  *colnames = lappend(*colnames, makeString(pstrdup(label)));
2784  }
2785 
2786  if (colvars)
2787  {
2788  Var *varnode;
2789 
2790  varnode = makeVar(rtindex, varattno,
2791  exprType((Node *) te->expr),
2792  exprTypmod((Node *) te->expr),
2793  exprCollation((Node *) te->expr),
2794  sublevels_up);
2795  varnode->location = location;
2796 
2797  *colvars = lappend(*colvars, varnode);
2798  }
2799 
2800  aliasp_item = lnext(rte->eref->colnames, aliasp_item);
2801  }
2802  }
2803  break;
2804  case RTE_FUNCTION:
2805  {
2806  /* Function RTE */
2807  int atts_done = 0;
2808  ListCell *lc;
2809 
2810  foreach(lc, rte->functions)
2811  {
2812  RangeTblFunction *rtfunc = (RangeTblFunction *) lfirst(lc);
2813  TypeFuncClass functypclass;
2814  Oid funcrettype = InvalidOid;
2815  TupleDesc tupdesc = NULL;
2816 
2817  /* If it has a coldeflist, it returns RECORD */
2818  if (rtfunc->funccolnames != NIL)
2819  functypclass = TYPEFUNC_RECORD;
2820  else
2821  functypclass = get_expr_result_type(rtfunc->funcexpr,
2822  &funcrettype,
2823  &tupdesc);
2824 
2825  if (functypclass == TYPEFUNC_COMPOSITE ||
2826  functypclass == TYPEFUNC_COMPOSITE_DOMAIN)
2827  {
2828  /* Composite data type, e.g. a table's row type */
2829  Assert(tupdesc);
2830  expandTupleDesc(tupdesc, rte->eref,
2831  rtfunc->funccolcount, atts_done,
2832  rtindex, sublevels_up, location,
2833  include_dropped, colnames, colvars);
2834  }
2835  else if (functypclass == TYPEFUNC_SCALAR)
2836  {
2837  /* Base data type, i.e. scalar */
2838  if (colnames)
2839  *colnames = lappend(*colnames,
2840  list_nth(rte->eref->colnames,
2841  atts_done));
2842 
2843  if (colvars)
2844  {
2845  Var *varnode;
2846 
2847  varnode = makeVar(rtindex, atts_done + 1,
2848  funcrettype,
2849  exprTypmod(rtfunc->funcexpr),
2850  exprCollation(rtfunc->funcexpr),
2851  sublevels_up);
2852  varnode->location = location;
2853 
2854  *colvars = lappend(*colvars, varnode);
2855  }
2856  }
2857  else if (functypclass == TYPEFUNC_RECORD)
2858  {
2859  if (colnames)
2860  {
2861  List *namelist;
2862 
2863  /* extract appropriate subset of column list */
2864  namelist = list_copy_tail(rte->eref->colnames,
2865  atts_done);
2866  namelist = list_truncate(namelist,
2867  rtfunc->funccolcount);
2868  *colnames = list_concat(*colnames, namelist);
2869  }
2870 
2871  if (colvars)
2872  {
2873  ListCell *l1;
2874  ListCell *l2;
2875  ListCell *l3;
2876  int attnum = atts_done;
2877 
2878  forthree(l1, rtfunc->funccoltypes,
2879  l2, rtfunc->funccoltypmods,
2880  l3, rtfunc->funccolcollations)
2881  {
2882  Oid attrtype = lfirst_oid(l1);
2883  int32 attrtypmod = lfirst_int(l2);
2884  Oid attrcollation = lfirst_oid(l3);
2885  Var *varnode;
2886 
2887  attnum++;
2888  varnode = makeVar(rtindex,
2889  attnum,
2890  attrtype,
2891  attrtypmod,
2892  attrcollation,
2893  sublevels_up);
2894  varnode->location = location;
2895  *colvars = lappend(*colvars, varnode);
2896  }
2897  }
2898  }
2899  else
2900  {
2901  /* addRangeTableEntryForFunction should've caught this */
2902  elog(ERROR, "function in FROM has unsupported return type");
2903  }
2904  atts_done += rtfunc->funccolcount;
2905  }
2906 
2907  /* Append the ordinality column if any */
2908  if (rte->funcordinality)
2909  {
2910  if (colnames)
2911  *colnames = lappend(*colnames,
2912  llast(rte->eref->colnames));
2913 
2914  if (colvars)
2915  {
2916  Var *varnode = makeVar(rtindex,
2917  atts_done + 1,
2918  INT8OID,
2919  -1,
2920  InvalidOid,
2921  sublevels_up);
2922 
2923  *colvars = lappend(*colvars, varnode);
2924  }
2925  }
2926  }
2927  break;
2928  case RTE_JOIN:
2929  {
2930  /* Join RTE */
2931  ListCell *colname;
2932  ListCell *aliasvar;
2933 
2934  Assert(list_length(rte->eref->colnames) == list_length(rte->joinaliasvars));
2935 
2936  varattno = 0;
2937  forboth(colname, rte->eref->colnames, aliasvar, rte->joinaliasvars)
2938  {
2939  Node *avar = (Node *) lfirst(aliasvar);
2940 
2941  varattno++;
2942 
2943  /*
2944  * During ordinary parsing, there will never be any
2945  * deleted columns in the join. While this function is
2946  * also used by the rewriter and planner, they do not
2947  * currently call it on any JOIN RTEs. Therefore, this
2948  * next bit is dead code, but it seems prudent to handle
2949  * the case correctly anyway.
2950  */
2951  if (avar == NULL)
2952  {
2953  if (include_dropped)
2954  {
2955  if (colnames)
2956  *colnames = lappend(*colnames,
2957  makeString(pstrdup("")));
2958  if (colvars)
2959  {
2960  /*
2961  * Can't use join's column type here (it might
2962  * be dropped!); but it doesn't really matter
2963  * what type the Const claims to be.
2964  */
2965  *colvars = lappend(*colvars,
2966  makeNullConst(INT4OID, -1,
2967  InvalidOid));
2968  }
2969  }
2970  continue;
2971  }
2972 
2973  if (colnames)
2974  {
2975  char *label = strVal(lfirst(colname));
2976 
2977  *colnames = lappend(*colnames,
2979  }
2980 
2981  if (colvars)
2982  {
2983  Var *varnode;
2984 
2985  /*
2986  * If the joinaliasvars entry is a simple Var, just
2987  * copy it (with adjustment of varlevelsup and
2988  * location); otherwise it is a JOIN USING column and
2989  * we must generate a join alias Var. This matches
2990  * the results that expansion of "join.*" by
2991  * expandNSItemVars would have produced, if we had
2992  * access to the ParseNamespaceItem for the join.
2993  */
2994  if (IsA(avar, Var))
2995  {
2996  varnode = copyObject((Var *) avar);
2997  varnode->varlevelsup = sublevels_up;
2998  }
2999  else
3000  varnode = makeVar(rtindex, varattno,
3001  exprType(avar),
3002  exprTypmod(avar),
3003  exprCollation(avar),
3004  sublevels_up);
3005  varnode->location = location;
3006 
3007  *colvars = lappend(*colvars, varnode);
3008  }
3009  }
3010  }
3011  break;
3012  case RTE_TABLEFUNC:
3013  case RTE_VALUES:
3014  case RTE_CTE:
3015  case RTE_NAMEDTUPLESTORE:
3016  {
3017  /* Tablefunc, Values, CTE, or ENR RTE */
3018  ListCell *aliasp_item = list_head(rte->eref->colnames);
3019  ListCell *lct;
3020  ListCell *lcm;
3021  ListCell *lcc;
3022 
3023  varattno = 0;
3024  forthree(lct, rte->coltypes,
3025  lcm, rte->coltypmods,
3026  lcc, rte->colcollations)
3027  {
3028  Oid coltype = lfirst_oid(lct);
3029  int32 coltypmod = lfirst_int(lcm);
3030  Oid colcoll = lfirst_oid(lcc);
3031 
3032  varattno++;
3033 
3034  if (colnames)
3035  {
3036  /* Assume there is one alias per output column */
3037  if (OidIsValid(coltype))
3038  {
3039  char *label = strVal(lfirst(aliasp_item));
3040 
3041  *colnames = lappend(*colnames,
3043  }
3044  else if (include_dropped)
3045  *colnames = lappend(*colnames,
3046  makeString(pstrdup("")));
3047 
3048  aliasp_item = lnext(rte->eref->colnames, aliasp_item);
3049  }
3050 
3051  if (colvars)
3052  {
3053  if (OidIsValid(coltype))
3054  {
3055  Var *varnode;
3056 
3057  varnode = makeVar(rtindex, varattno,
3058  coltype, coltypmod, colcoll,
3059  sublevels_up);
3060  varnode->location = location;
3061 
3062  *colvars = lappend(*colvars, varnode);
3063  }
3064  else if (include_dropped)
3065  {
3066  /*
3067  * It doesn't really matter what type the Const
3068  * claims to be.
3069  */
3070  *colvars = lappend(*colvars,
3071  makeNullConst(INT4OID, -1,
3072  InvalidOid));
3073  }
3074  }
3075  }
3076  }
3077  break;
3078  case RTE_RESULT:
3079  case RTE_GROUP:
3080  /* These expose no columns, so nothing to do */
3081  break;
3082  default:
3083  elog(ERROR, "unrecognized RTE kind: %d", (int) rte->rtekind);
3084  }
3085 }
List * list_truncate(List *list, int new_size)
Definition: list.c:631
Const * makeNullConst(Oid consttype, int32 consttypmod, Oid constcollid)
Definition: makefuncs.c:339
static void expandRelation(Oid relid, Alias *eref, int rtindex, int sublevels_up, int location, bool include_dropped, List **colnames, List **colvars)
static void expandTupleDesc(TupleDesc tupdesc, Alias *eref, int count, int offset, int rtindex, int sublevels_up, int location, bool include_dropped, List **colnames, List **colvars)
@ RTE_RESULT
Definition: parsenodes.h:1025
int16 attnum
Definition: pg_attribute.h:74
#define llast(l)
Definition: pg_list.h:198
#define lfirst_int(lc)
Definition: pg_list.h:173
static ListCell * list_head(const List *l)
Definition: pg_list.h:128
static ListCell * lnext(const List *l, const ListCell *c)
Definition: pg_list.h:343
#define lfirst_oid(lc)
Definition: pg_list.h:174
Index varlevelsup
Definition: primnodes.h:280

References Assert, attnum, copyObject, elog, ERROR, expandRelation(), expandTupleDesc(), TargetEntry::expr, exprCollation(), exprType(), exprTypmod(), forboth, forthree, RangeTblFunction::funcexpr, RangeTblEntry::funcordinality, RangeTblEntry::functions, get_expr_result_type(), InvalidOid, IsA, label, lappend(), lfirst, lfirst_int, lfirst_oid, list_concat(), list_copy_tail(), list_head(), list_length(), list_nth(), list_truncate(), llast, lnext(), Var::location, makeNullConst(), makeString(), makeVar(), NIL, OidIsValid, pstrdup(), RangeTblEntry::relid, TargetEntry::resno, RTE_CTE, RTE_FUNCTION, RTE_GROUP, RTE_JOIN, RTE_NAMEDTUPLESTORE, RTE_RELATION, RTE_RESULT, RTE_SUBQUERY, RTE_TABLEFUNC, RTE_VALUES, RangeTblEntry::rtekind, strVal, RangeTblEntry::subquery, Query::targetList, TYPEFUNC_COMPOSITE, TYPEFUNC_COMPOSITE_DOMAIN, TYPEFUNC_RECORD, TYPEFUNC_SCALAR, and Var::varlevelsup.

Referenced by build_physical_tlist(), expandRecordVariable(), pullup_replace_vars_callback(), ReplaceVarsFromTargetList_callback(), set_relation_column_names(), and transformWholeRowRef().

◆ GetCTEForRTE()

CommonTableExpr* GetCTEForRTE ( ParseState pstate,
RangeTblEntry rte,
int  rtelevelsup 
)

Definition at line 557 of file parse_relation.c.

558 {
559  Index levelsup;
560  ListCell *lc;
561 
562  Assert(rte->rtekind == RTE_CTE);
563  levelsup = rte->ctelevelsup + rtelevelsup;
564  while (levelsup-- > 0)
565  {
566  pstate = pstate->parentParseState;
567  if (!pstate) /* shouldn't happen */
568  elog(ERROR, "bad levelsup for CTE \"%s\"", rte->ctename);
569  }
570  foreach(lc, pstate->p_ctenamespace)
571  {
572  CommonTableExpr *cte = (CommonTableExpr *) lfirst(lc);
573 
574  if (strcmp(cte->ctename, rte->ctename) == 0)
575  return cte;
576  }
577  /* shouldn't happen */
578  elog(ERROR, "could not find CTE \"%s\"", rte->ctename);
579  return NULL; /* keep compiler quiet */
580 }
unsigned int Index
Definition: c.h:617
List * p_ctenamespace
Definition: parse_node.h:222

References Assert, RangeTblEntry::ctelevelsup, RangeTblEntry::ctename, CommonTableExpr::ctename, elog, ERROR, lfirst, ParseState::p_ctenamespace, ParseState::parentParseState, RTE_CTE, and RangeTblEntry::rtekind.

Referenced by expandRecordVariable(), and markTargetListOrigin().

◆ GetNSItemByRangeTablePosn()

ParseNamespaceItem* GetNSItemByRangeTablePosn ( ParseState pstate,
int  varno,
int  sublevels_up 
)

Definition at line 510 of file parse_relation.c.

513 {
514  ListCell *lc;
515 
516  while (sublevels_up-- > 0)
517  {
518  pstate = pstate->parentParseState;
519  Assert(pstate != NULL);
520  }
521  foreach(lc, pstate->p_namespace)
522  {
523  ParseNamespaceItem *nsitem = (ParseNamespaceItem *) lfirst(lc);
524 
525  if (nsitem->p_rtindex == varno)
526  return nsitem;
527  }
528  elog(ERROR, "nsitem not found (internal error)");
529  return NULL; /* keep compiler quiet */
530 }

References Assert, elog, ERROR, lfirst, ParseState::p_namespace, ParseNamespaceItem::p_rtindex, and ParseState::parentParseState.

Referenced by coerce_record_to_complex(), ExpandRowReference(), ParseComplexProjection(), and transformMergeStmt().

◆ GetRTEByRangeTablePosn()

RangeTblEntry* GetRTEByRangeTablePosn ( ParseState pstate,
int  varno,
int  sublevels_up 
)

Definition at line 537 of file parse_relation.c.

540 {
541  while (sublevels_up-- > 0)
542  {
543  pstate = pstate->parentParseState;
544  Assert(pstate != NULL);
545  }
546  Assert(varno > 0 && varno <= list_length(pstate->p_rtable));
547  return rt_fetch(varno, pstate->p_rtable);
548 }
#define rt_fetch(rangetable_index, rangetable)
Definition: parsetree.h:31

References Assert, list_length(), ParseState::p_rtable, ParseState::parentParseState, and rt_fetch.

Referenced by count_rowexpr_columns(), expandRecordVariable(), markTargetListOrigin(), and unknown_attribute().

◆ getRTEPermissionInfo()

RTEPermissionInfo* getRTEPermissionInfo ( List rteperminfos,
RangeTblEntry rte 
)

Definition at line 3978 of file parse_relation.c.

3979 {
3980  RTEPermissionInfo *perminfo;
3981 
3982  if (rte->perminfoindex == 0 ||
3983  rte->perminfoindex > list_length(rteperminfos))
3984  elog(ERROR, "invalid perminfoindex %u in RTE with relid %u",
3985  rte->perminfoindex, rte->relid);
3986  perminfo = list_nth_node(RTEPermissionInfo, rteperminfos,
3987  rte->perminfoindex - 1);
3988  if (perminfo->relid != rte->relid)
3989  elog(ERROR, "permission info at index %u (with relid=%u) does not match provided RTE (with relid=%u)",
3990  rte->perminfoindex, perminfo->relid, rte->relid);
3991 
3992  return perminfo;
3993 }
#define list_nth_node(type, list, n)
Definition: pg_list.h:327

References elog, ERROR, list_length(), list_nth_node, RangeTblEntry::relid, and RTEPermissionInfo::relid.

Referenced by add_rte_to_flat_rtable(), build_simple_rel(), examine_simple_variable(), ExecCheckPermissions(), expand_inherited_rtentry(), get_rel_all_updated_cols(), get_row_security_policies(), GetResultRTEPermissionInfo(), markQueryForLocking(), markRTEForSelectPriv(), rewriteTargetView(), and transformLockingClause().

◆ isLockedRefname()

bool isLockedRefname ( ParseState pstate,
const char *  refname 
)

Definition at line 2648 of file parse_relation.c.

2649 {
2650  ListCell *l;
2651 
2652  /*
2653  * If we are in a subquery specified as locked FOR UPDATE/SHARE from
2654  * parent level, then act as though there's a generic FOR UPDATE here.
2655  */
2656  if (pstate->p_locked_from_parent)
2657  return true;
2658 
2659  foreach(l, pstate->p_locking_clause)
2660  {
2661  LockingClause *lc = (LockingClause *) lfirst(l);
2662 
2663  if (lc->lockedRels == NIL)
2664  {
2665  /* all tables used in query */
2666  return true;
2667  }
2668  else if (refname != NULL)
2669  {
2670  /* just the named tables */
2671  ListCell *l2;
2672 
2673  foreach(l2, lc->lockedRels)
2674  {
2675  RangeVar *thisrel = (RangeVar *) lfirst(l2);
2676 
2677  if (strcmp(refname, thisrel->relname) == 0)
2678  return true;
2679  }
2680  }
2681  }
2682  return false;
2683 }
List * lockedRels
Definition: parsenodes.h:836
bool p_locked_from_parent
Definition: parse_node.h:234
List * p_locking_clause
Definition: parse_node.h:233

References lfirst, LockingClause::lockedRels, NIL, ParseState::p_locked_from_parent, ParseState::p_locking_clause, and RangeVar::relname.

Referenced by addRangeTableEntry(), and transformRangeSubselect().

◆ isQueryUsingTempRelation()

bool isQueryUsingTempRelation ( Query query)

Definition at line 3899 of file parse_relation.c.

3900 {
3901  return isQueryUsingTempRelation_walker((Node *) query, NULL);
3902 }
static bool isQueryUsingTempRelation_walker(Node *node, void *context)

References isQueryUsingTempRelation_walker().

Referenced by DefineView(), and transformCreateTableAsStmt().

◆ markNullableIfNeeded()

void markNullableIfNeeded ( ParseState pstate,
Var var 
)

Definition at line 1035 of file parse_relation.c.

1036 {
1037  int rtindex = var->varno;
1038  Bitmapset *relids;
1039 
1040  /* Find the appropriate pstate */
1041  for (int lv = 0; lv < var->varlevelsup; lv++)
1042  pstate = pstate->parentParseState;
1043 
1044  /* Find currently-relevant join relids for the Var's rel */
1045  if (rtindex > 0 && rtindex <= list_length(pstate->p_nullingrels))
1046  relids = (Bitmapset *) list_nth(pstate->p_nullingrels, rtindex - 1);
1047  else
1048  relids = NULL;
1049 
1050  /*
1051  * Merge with any already-declared nulling rels. (Typically there won't
1052  * be any, but let's get it right if there are.)
1053  */
1054  if (relids != NULL)
1055  var->varnullingrels = bms_union(var->varnullingrels, relids);
1056 }
Bitmapset * bms_union(const Bitmapset *a, const Bitmapset *b)
Definition: bitmapset.c:251
List * p_nullingrels
Definition: parse_node.h:216
int varno
Definition: primnodes.h:255

References bms_union(), if(), list_length(), list_nth(), ParseState::p_nullingrels, ParseState::parentParseState, Var::varlevelsup, and Var::varno.

Referenced by buildVarFromNSColumn(), expandNSItemVars(), scanNSItemForColumn(), and transformWholeRowRef().

◆ markVarForSelectPriv()

void markVarForSelectPriv ( ParseState pstate,
Var var 
)

Definition at line 1150 of file parse_relation.c.

1151 {
1152  Index lv;
1153 
1154  Assert(IsA(var, Var));
1155  /* Find the appropriate pstate if it's an uplevel Var */
1156  for (lv = 0; lv < var->varlevelsup; lv++)
1157  pstate = pstate->parentParseState;
1158  markRTEForSelectPriv(pstate, var->varno, var->varattno);
1159 }
static void markRTEForSelectPriv(ParseState *pstate, int rtindex, AttrNumber col)
AttrNumber varattno
Definition: primnodes.h:260

References Assert, IsA, markRTEForSelectPriv(), ParseState::parentParseState, Var::varattno, Var::varlevelsup, and Var::varno.

Referenced by expandNSItemAttrs(), ExpandSingleTable(), scanNSItemForColumn(), transformJoinUsingClause(), and transformWholeRowRef().

◆ parserOpenTable()

Relation parserOpenTable ( ParseState pstate,
const RangeVar relation,
int  lockmode 
)

Definition at line 1418 of file parse_relation.c.

1419 {
1420  Relation rel;
1421  ParseCallbackState pcbstate;
1422 
1423  setup_parser_errposition_callback(&pcbstate, pstate, relation->location);
1424  rel = table_openrv_extended(relation, lockmode, true);
1425  if (rel == NULL)
1426  {
1427  if (relation->schemaname)
1428  ereport(ERROR,
1430  errmsg("relation \"%s.%s\" does not exist",
1431  relation->schemaname, relation->relname)));
1432  else
1433  {
1434  /*
1435  * An unqualified name might have been meant as a reference to
1436  * some not-yet-in-scope CTE. The bare "does not exist" message
1437  * has proven remarkably unhelpful for figuring out such problems,
1438  * so we take pains to offer a specific hint.
1439  */
1440  if (isFutureCTE(pstate, relation->relname))
1441  ereport(ERROR,
1443  errmsg("relation \"%s\" does not exist",
1444  relation->relname),
1445  errdetail("There is a WITH item named \"%s\", but it cannot be referenced from this part of the query.",
1446  relation->relname),
1447  errhint("Use WITH RECURSIVE, or re-order the WITH items to remove forward references.")));
1448  else
1449  ereport(ERROR,
1451  errmsg("relation \"%s\" does not exist",
1452  relation->relname)));
1453  }
1454  }
1456  return rel;
1457 }
void cancel_parser_errposition_callback(ParseCallbackState *pcbstate)
Definition: parse_node.c:156
void setup_parser_errposition_callback(ParseCallbackState *pcbstate, ParseState *pstate, int location)
Definition: parse_node.c:140
static bool isFutureCTE(ParseState *pstate, const char *refname)
char * schemaname
Definition: primnodes.h:79
Relation table_openrv_extended(const RangeVar *relation, LOCKMODE lockmode, bool missing_ok)
Definition: table.c:103

References cancel_parser_errposition_callback(), ereport, errcode(), ERRCODE_UNDEFINED_TABLE, errdetail(), errhint(), errmsg(), ERROR, isFutureCTE(), RangeVar::location, RangeVar::relname, RangeVar::schemaname, setup_parser_errposition_callback(), and table_openrv_extended().

Referenced by addRangeTableEntry(), and setTargetTable().

◆ refnameNamespaceItem()

ParseNamespaceItem* refnameNamespaceItem ( ParseState pstate,
const char *  schemaname,
const char *  refname,
int  location,
int *  sublevels_up 
)

Definition at line 129 of file parse_relation.c.

134 {
135  Oid relId = InvalidOid;
136 
137  if (sublevels_up)
138  *sublevels_up = 0;
139 
140  if (schemaname != NULL)
141  {
142  Oid namespaceId;
143 
144  /*
145  * We can use LookupNamespaceNoError() here because we are only
146  * interested in finding existing RTEs. Checking USAGE permission on
147  * the schema is unnecessary since it would have already been checked
148  * when the RTE was made. Furthermore, we want to report "RTE not
149  * found", not "no permissions for schema", if the name happens to
150  * match a schema name the user hasn't got access to.
151  */
152  namespaceId = LookupNamespaceNoError(schemaname);
153  if (!OidIsValid(namespaceId))
154  return NULL;
155  relId = get_relname_relid(refname, namespaceId);
156  if (!OidIsValid(relId))
157  return NULL;
158  }
159 
160  while (pstate != NULL)
161  {
162  ParseNamespaceItem *result;
163 
164  if (OidIsValid(relId))
165  result = scanNameSpaceForRelid(pstate, relId, location);
166  else
167  result = scanNameSpaceForRefname(pstate, refname, location);
168 
169  if (result)
170  return result;
171 
172  if (sublevels_up)
173  (*sublevels_up)++;
174  else
175  break;
176 
177  pstate = pstate->parentParseState;
178  }
179  return NULL;
180 }
Oid get_relname_relid(const char *relname, Oid relnamespace)
Definition: lsyscache.c:1885
Oid LookupNamespaceNoError(const char *nspname)
Definition: namespace.c:3355
static ParseNamespaceItem * scanNameSpaceForRelid(ParseState *pstate, Oid relid, int location)
static ParseNamespaceItem * scanNameSpaceForRefname(ParseState *pstate, const char *refname, int location)

References get_relname_relid(), InvalidOid, LookupNamespaceNoError(), OidIsValid, ParseState::parentParseState, scanNameSpaceForRefname(), and scanNameSpaceForRelid().

Referenced by errorMissingRTE(), ExpandColumnRefStar(), and transformColumnRef().

◆ scanNameSpaceForCTE()

CommonTableExpr* scanNameSpaceForCTE ( ParseState pstate,
const char *  refname,
Index ctelevelsup 
)

Definition at line 282 of file parse_relation.c.

284 {
285  Index levelsup;
286 
287  for (levelsup = 0;
288  pstate != NULL;
289  pstate = pstate->parentParseState, levelsup++)
290  {
291  ListCell *lc;
292 
293  foreach(lc, pstate->p_ctenamespace)
294  {
295  CommonTableExpr *cte = (CommonTableExpr *) lfirst(lc);
296 
297  if (strcmp(cte->ctename, refname) == 0)
298  {
299  *ctelevelsup = levelsup;
300  return cte;
301  }
302  }
303  }
304  return NULL;
305 }

References CommonTableExpr::ctename, lfirst, ParseState::p_ctenamespace, and ParseState::parentParseState.

Referenced by getNSItemForSpecialRelationTypes(), and searchRangeTableForRel().

◆ scanNameSpaceForENR()

bool scanNameSpaceForENR ( ParseState pstate,
const char *  refname 
)

Definition at line 335 of file parse_relation.c.

336 {
337  return name_matches_visible_ENR(pstate, refname);
338 }
bool name_matches_visible_ENR(ParseState *pstate, const char *refname)
Definition: parse_enr.c:20

References name_matches_visible_ENR().

Referenced by getNSItemForSpecialRelationTypes(), searchRangeTableForRel(), and setTargetTable().

◆ scanNSItemForColumn()

Node* scanNSItemForColumn ( ParseState pstate,
ParseNamespaceItem nsitem,
int  sublevels_up,
const char *  colname,
int  location 
)

Definition at line 680 of file parse_relation.c.

682 {
683  RangeTblEntry *rte = nsitem->p_rte;
684  int attnum;
685  Var *var;
686 
687  /*
688  * Scan the nsitem's column names (or aliases) for a match. Complain if
689  * multiple matches.
690  */
691  attnum = scanRTEForColumn(pstate, rte, nsitem->p_names,
692  colname, location,
693  0, NULL);
694 
695  if (attnum == InvalidAttrNumber)
696  return NULL; /* Return NULL if no match */
697 
698  /* In constraint check, no system column is allowed except tableOid */
699  if (pstate->p_expr_kind == EXPR_KIND_CHECK_CONSTRAINT &&
701  ereport(ERROR,
702  (errcode(ERRCODE_INVALID_COLUMN_REFERENCE),
703  errmsg("system column \"%s\" reference in check constraint is invalid",
704  colname),
705  parser_errposition(pstate, location)));
706 
707  /* In generated column, no system column is allowed except tableOid */
708  if (pstate->p_expr_kind == EXPR_KIND_GENERATED_COLUMN &&
710  ereport(ERROR,
711  (errcode(ERRCODE_INVALID_COLUMN_REFERENCE),
712  errmsg("cannot use system column \"%s\" in column generation expression",
713  colname),
714  parser_errposition(pstate, location)));
715 
716  /*
717  * In a MERGE WHEN condition, no system column is allowed except tableOid
718  */
719  if (pstate->p_expr_kind == EXPR_KIND_MERGE_WHEN &&
721  ereport(ERROR,
722  (errcode(ERRCODE_INVALID_COLUMN_REFERENCE),
723  errmsg("cannot use system column \"%s\" in MERGE WHEN condition",
724  colname),
725  parser_errposition(pstate, location)));
726 
727  /* Found a valid match, so build a Var */
729  {
730  /* Get attribute data from the ParseNamespaceColumn array */
731  ParseNamespaceColumn *nscol = &nsitem->p_nscolumns[attnum - 1];
732 
733  /* Complain if dropped column. See notes in scanRTEForColumn. */
734  if (nscol->p_varno == 0)
735  ereport(ERROR,
736  (errcode(ERRCODE_UNDEFINED_COLUMN),
737  errmsg("column \"%s\" of relation \"%s\" does not exist",
738  colname,
739  nsitem->p_names->aliasname)));
740 
741  var = makeVar(nscol->p_varno,
742  nscol->p_varattno,
743  nscol->p_vartype,
744  nscol->p_vartypmod,
745  nscol->p_varcollid,
746  sublevels_up);
747  /* makeVar doesn't offer parameters for these, so set them by hand: */
748  var->varnosyn = nscol->p_varnosyn;
749  var->varattnosyn = nscol->p_varattnosyn;
750  }
751  else
752  {
753  /* System column, so use predetermined type data */
754  const FormData_pg_attribute *sysatt;
755 
757  var = makeVar(nsitem->p_rtindex,
758  attnum,
759  sysatt->atttypid,
760  sysatt->atttypmod,
761  sysatt->attcollation,
762  sublevels_up);
763  }
764  var->location = location;
765 
766  /* Mark Var if it's nulled by any outer joins */
767  markNullableIfNeeded(pstate, var);
768 
769  /* Require read access to the column */
770  markVarForSelectPriv(pstate, var);
771 
772  return (Node *) var;
773 }
@ EXPR_KIND_MERGE_WHEN
Definition: parse_node.h:58
@ EXPR_KIND_GENERATED_COLUMN
Definition: parse_node.h:83
@ EXPR_KIND_CHECK_CONSTRAINT
Definition: parse_node.h:68
static int scanRTEForColumn(ParseState *pstate, RangeTblEntry *rte, Alias *eref, const char *colname, int location, int fuzzy_rte_penalty, FuzzyAttrMatchState *fuzzystate)
ParseExprKind p_expr_kind
Definition: parse_node.h:230
#define TableOidAttributeNumber
Definition: sysattr.h:26

References Alias::aliasname, attnum, ereport, errcode(), errmsg(), ERROR, EXPR_KIND_CHECK_CONSTRAINT, EXPR_KIND_GENERATED_COLUMN, EXPR_KIND_MERGE_WHEN, FormData_pg_attribute, InvalidAttrNumber, Var::location, makeVar(), markNullableIfNeeded(), markVarForSelectPriv(), ParseState::p_expr_kind, ParseNamespaceItem::p_names, ParseNamespaceItem::p_nscolumns, ParseNamespaceItem::p_rte, ParseNamespaceItem::p_rtindex, ParseNamespaceColumn::p_varattno, ParseNamespaceColumn::p_varattnosyn, ParseNamespaceColumn::p_varcollid, ParseNamespaceColumn::p_varno, ParseNamespaceColumn::p_varnosyn, ParseNamespaceColumn::p_vartype, ParseNamespaceColumn::p_vartypmod, parser_errposition(), scanRTEForColumn(), SystemAttributeDefinition(), and TableOidAttributeNumber.

Referenced by colNameToVar(), ParseComplexProjection(), and transformColumnRef().