PostgreSQL Source Code  git master
plancat.c File Reference
#include "postgres.h"
#include <math.h>
#include "access/genam.h"
#include "access/htup_details.h"
#include "access/nbtree.h"
#include "access/sysattr.h"
#include "access/table.h"
#include "access/tableam.h"
#include "access/transam.h"
#include "access/xlog.h"
#include "catalog/catalog.h"
#include "catalog/dependency.h"
#include "catalog/heap.h"
#include "catalog/pg_am.h"
#include "catalog/pg_proc.h"
#include "catalog/pg_statistic_ext.h"
#include "foreign/fdwapi.h"
#include "miscadmin.h"
#include "nodes/makefuncs.h"
#include "nodes/supportnodes.h"
#include "optimizer/clauses.h"
#include "optimizer/cost.h"
#include "optimizer/optimizer.h"
#include "optimizer/plancat.h"
#include "optimizer/prep.h"
#include "parser/parse_relation.h"
#include "parser/parsetree.h"
#include "partitioning/partdesc.h"
#include "rewrite/rewriteManip.h"
#include "statistics/statistics.h"
#include "storage/bufmgr.h"
#include "utils/builtins.h"
#include "utils/lsyscache.h"
#include "utils/partcache.h"
#include "utils/rel.h"
#include "utils/snapmgr.h"
#include "utils/syscache.h"
Include dependency graph for plancat.c:

Go to the source code of this file.

Functions

static void get_relation_foreign_keys (PlannerInfo *root, RelOptInfo *rel, Relation relation, bool inhparent)
 
static bool infer_collation_opclass_match (InferenceElem *elem, Relation idxRel, List *idxExprs)
 
static Listget_relation_constraints (PlannerInfo *root, Oid relationObjectId, RelOptInfo *rel, bool include_noinherit, bool include_notnull, bool include_partition)
 
static Listbuild_index_tlist (PlannerInfo *root, IndexOptInfo *index, Relation heapRelation)
 
static Listget_relation_statistics (RelOptInfo *rel, Relation relation)
 
static void set_relation_partition_info (PlannerInfo *root, RelOptInfo *rel, Relation relation)
 
static PartitionScheme find_partition_scheme (PlannerInfo *root, Relation rel)
 
static void set_baserel_partition_key_exprs (Relation relation, RelOptInfo *rel)
 
static void set_baserel_partition_constraint (Relation relation, RelOptInfo *rel)
 
void get_relation_info (PlannerInfo *root, Oid relationObjectId, bool inhparent, RelOptInfo *rel)
 
Listinfer_arbiter_indexes (PlannerInfo *root)
 
void estimate_rel_size (Relation rel, int32 *attr_widths, BlockNumber *pages, double *tuples, double *allvisfrac)
 
int32 get_rel_data_width (Relation rel, int32 *attr_widths)
 
int32 get_relation_data_width (Oid relid, int32 *attr_widths)
 
bool relation_excluded_by_constraints (PlannerInfo *root, RelOptInfo *rel, RangeTblEntry *rte)
 
Listbuild_physical_tlist (PlannerInfo *root, RelOptInfo *rel)
 
Selectivity restriction_selectivity (PlannerInfo *root, Oid operatorid, List *args, Oid inputcollid, int varRelid)
 
Selectivity join_selectivity (PlannerInfo *root, Oid operatorid, List *args, Oid inputcollid, JoinType jointype, SpecialJoinInfo *sjinfo)
 
Selectivity function_selectivity (PlannerInfo *root, Oid funcid, List *args, Oid inputcollid, bool is_join, int varRelid, JoinType jointype, SpecialJoinInfo *sjinfo)
 
void add_function_cost (PlannerInfo *root, Oid funcid, Node *node, QualCost *cost)
 
double get_function_rows (PlannerInfo *root, Oid funcid, Node *node)
 
bool has_unique_index (RelOptInfo *rel, AttrNumber attno)
 
bool has_row_triggers (PlannerInfo *root, Index rti, CmdType event)
 
bool has_stored_generated_columns (PlannerInfo *root, Index rti)
 

Variables

int constraint_exclusion = CONSTRAINT_EXCLUSION_PARTITION
 
get_relation_info_hook_type get_relation_info_hook = NULL
 

Function Documentation

◆ add_function_cost()

void add_function_cost ( PlannerInfo root,
Oid  funcid,
Node node,
QualCost cost 
)

Definition at line 1905 of file plancat.c.

References cpu_operator_cost, DatumGetPointer, elog, ERROR, SupportRequestCost::funcid, GETSTRUCT, HeapTupleIsValid, SupportRequestCost::node, ObjectIdGetDatum, OidFunctionCall1, OidIsValid, QualCost::per_tuple, SupportRequestCost::per_tuple, PointerGetDatum, PROCOID, ReleaseSysCache(), SupportRequestCost::root, SearchSysCache1(), QualCost::startup, SupportRequestCost::startup, T_SupportRequestCost, and SupportRequestCost::type.

Referenced by cost_qual_eval_walker(), cost_windowagg(), and get_agg_clause_costs_walker().

1907 {
1908  HeapTuple proctup;
1909  Form_pg_proc procform;
1910 
1911  proctup = SearchSysCache1(PROCOID, ObjectIdGetDatum(funcid));
1912  if (!HeapTupleIsValid(proctup))
1913  elog(ERROR, "cache lookup failed for function %u", funcid);
1914  procform = (Form_pg_proc) GETSTRUCT(proctup);
1915 
1916  if (OidIsValid(procform->prosupport))
1917  {
1918  SupportRequestCost req;
1919  SupportRequestCost *sresult;
1920 
1921  req.type = T_SupportRequestCost;
1922  req.root = root;
1923  req.funcid = funcid;
1924  req.node = node;
1925 
1926  /* Initialize cost fields so that support function doesn't have to */
1927  req.startup = 0;
1928  req.per_tuple = 0;
1929 
1930  sresult = (SupportRequestCost *)
1931  DatumGetPointer(OidFunctionCall1(procform->prosupport,
1932  PointerGetDatum(&req)));
1933 
1934  if (sresult == &req)
1935  {
1936  /* Success, so accumulate support function's estimate into *cost */
1937  cost->startup += req.startup;
1938  cost->per_tuple += req.per_tuple;
1939  ReleaseSysCache(proctup);
1940  return;
1941  }
1942  }
1943 
1944  /* No support function, or it failed, so rely on procost */
1945  cost->per_tuple += procform->procost * cpu_operator_cost;
1946 
1947  ReleaseSysCache(proctup);
1948 }
#define GETSTRUCT(TUP)
Definition: htup_details.h:655
#define PointerGetDatum(X)
Definition: postgres.h:556
#define OidIsValid(objectId)
Definition: c.h:652
Cost startup
Definition: pathnodes.h:45
Cost per_tuple
Definition: pathnodes.h:46
#define ObjectIdGetDatum(X)
Definition: postgres.h:507
#define ERROR
Definition: elog.h:43
#define OidFunctionCall1(functionId, arg1)
Definition: fmgr.h:662
double cpu_operator_cost
Definition: costsize.c:122
HeapTuple SearchSysCache1(int cacheId, Datum key1)
Definition: syscache.c:1116
void ReleaseSysCache(HeapTuple tuple)
Definition: syscache.c:1164
FormData_pg_proc * Form_pg_proc
Definition: pg_proc.h:133
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
struct PlannerInfo * root
Definition: supportnodes.h:136
#define DatumGetPointer(X)
Definition: postgres.h:549
#define elog(elevel,...)
Definition: elog.h:214

◆ build_index_tlist()

static List * build_index_tlist ( PlannerInfo root,
IndexOptInfo index,
Relation  heapRelation 
)
static

Definition at line 1701 of file plancat.c.

References elog, ERROR, FormData_pg_attribute, i, IndexOptInfo::indexkeys, IndexOptInfo::indexprs, lappend(), lfirst, list_head(), lnext(), makeTargetEntry(), makeVar(), IndexOptInfo::ncolumns, NIL, RelationData::rd_att, IndexOptInfo::rel, RelOptInfo::relid, SystemAttributeDefinition(), and TupleDescAttr.

Referenced by get_relation_info().

1703 {
1704  List *tlist = NIL;
1705  Index varno = index->rel->relid;
1706  ListCell *indexpr_item;
1707  int i;
1708 
1709  indexpr_item = list_head(index->indexprs);
1710  for (i = 0; i < index->ncolumns; i++)
1711  {
1712  int indexkey = index->indexkeys[i];
1713  Expr *indexvar;
1714 
1715  if (indexkey != 0)
1716  {
1717  /* simple column */
1718  const FormData_pg_attribute *att_tup;
1719 
1720  if (indexkey < 0)
1721  att_tup = SystemAttributeDefinition(indexkey);
1722  else
1723  att_tup = TupleDescAttr(heapRelation->rd_att, indexkey - 1);
1724 
1725  indexvar = (Expr *) makeVar(varno,
1726  indexkey,
1727  att_tup->atttypid,
1728  att_tup->atttypmod,
1729  att_tup->attcollation,
1730  0);
1731  }
1732  else
1733  {
1734  /* expression column */
1735  if (indexpr_item == NULL)
1736  elog(ERROR, "wrong number of index expressions");
1737  indexvar = (Expr *) lfirst(indexpr_item);
1738  indexpr_item = lnext(index->indexprs, indexpr_item);
1739  }
1740 
1741  tlist = lappend(tlist,
1742  makeTargetEntry(indexvar,
1743  i + 1,
1744  NULL,
1745  false));
1746  }
1747  if (indexpr_item != NULL)
1748  elog(ERROR, "wrong number of index expressions");
1749 
1750  return tlist;
1751 }
#define NIL
Definition: pg_list.h:65
static ListCell * lnext(const List *l, const ListCell *c)
Definition: pg_list.h:310
#define TupleDescAttr(tupdesc, i)
Definition: tupdesc.h:92
const FormData_pg_attribute * SystemAttributeDefinition(AttrNumber attno)
Definition: heap.c:249
RelOptInfo * rel
Definition: pathnodes.h:819
#define ERROR
Definition: elog.h:43
static ListCell * list_head(const List *l)
Definition: pg_list.h:125
TargetEntry * makeTargetEntry(Expr *expr, AttrNumber resno, char *resname, bool resjunk)
Definition: makefuncs.c:238
Var * makeVar(Index varno, AttrNumber varattno, Oid vartype, int32 vartypmod, Oid varcollid, Index varlevelsup)
Definition: makefuncs.c:66
Index relid
Definition: pathnodes.h:692
List * lappend(List *list, void *datum)
Definition: list.c:321
unsigned int Index
Definition: c.h:483
TupleDesc rd_att
Definition: rel.h:110
FormData_pg_attribute
Definition: pg_attribute.h:177
#define lfirst(lc)
Definition: pg_list.h:169
#define elog(elevel,...)
Definition: elog.h:214
int i
int * indexkeys
Definition: pathnodes.h:829
Definition: pg_list.h:50
List * indexprs
Definition: pathnodes.h:842

◆ build_physical_tlist()

List* build_physical_tlist ( PlannerInfo root,
RelOptInfo rel 
)

Definition at line 1580 of file plancat.c.

References elog, ERROR, expandRTE(), IsA, lappend(), lfirst, makeTargetEntry(), makeVar(), makeVarFromTargetEntry(), NIL, NoLock, planner_rt_fetch, RelationData::rd_att, RelationGetNumberOfAttributes, RelOptInfo::relid, RangeTblEntry::relid, TargetEntry::resjunk, TargetEntry::resno, RTE_CTE, RTE_FUNCTION, RTE_NAMEDTUPLESTORE, RTE_RELATION, RTE_RESULT, RTE_SUBQUERY, RTE_TABLEFUNC, RTE_VALUES, RangeTblEntry::rtekind, RangeTblEntry::subquery, table_close(), table_open(), Query::targetList, and TupleDescAttr.

Referenced by create_scan_plan().

1581 {
1582  List *tlist = NIL;
1583  Index varno = rel->relid;
1584  RangeTblEntry *rte = planner_rt_fetch(varno, root);
1585  Relation relation;
1586  Query *subquery;
1587  Var *var;
1588  ListCell *l;
1589  int attrno,
1590  numattrs;
1591  List *colvars;
1592 
1593  switch (rte->rtekind)
1594  {
1595  case RTE_RELATION:
1596  /* Assume we already have adequate lock */
1597  relation = table_open(rte->relid, NoLock);
1598 
1599  numattrs = RelationGetNumberOfAttributes(relation);
1600  for (attrno = 1; attrno <= numattrs; attrno++)
1601  {
1602  Form_pg_attribute att_tup = TupleDescAttr(relation->rd_att,
1603  attrno - 1);
1604 
1605  if (att_tup->attisdropped || att_tup->atthasmissing)
1606  {
1607  /* found a dropped or missing col, so punt */
1608  tlist = NIL;
1609  break;
1610  }
1611 
1612  var = makeVar(varno,
1613  attrno,
1614  att_tup->atttypid,
1615  att_tup->atttypmod,
1616  att_tup->attcollation,
1617  0);
1618 
1619  tlist = lappend(tlist,
1620  makeTargetEntry((Expr *) var,
1621  attrno,
1622  NULL,
1623  false));
1624  }
1625 
1626  table_close(relation, NoLock);
1627  break;
1628 
1629  case RTE_SUBQUERY:
1630  subquery = rte->subquery;
1631  foreach(l, subquery->targetList)
1632  {
1633  TargetEntry *tle = (TargetEntry *) lfirst(l);
1634 
1635  /*
1636  * A resjunk column of the subquery can be reflected as
1637  * resjunk in the physical tlist; we need not punt.
1638  */
1639  var = makeVarFromTargetEntry(varno, tle);
1640 
1641  tlist = lappend(tlist,
1642  makeTargetEntry((Expr *) var,
1643  tle->resno,
1644  NULL,
1645  tle->resjunk));
1646  }
1647  break;
1648 
1649  case RTE_FUNCTION:
1650  case RTE_TABLEFUNC:
1651  case RTE_VALUES:
1652  case RTE_CTE:
1653  case RTE_NAMEDTUPLESTORE:
1654  case RTE_RESULT:
1655  /* Not all of these can have dropped cols, but share code anyway */
1656  expandRTE(rte, varno, 0, -1, true /* include dropped */ ,
1657  NULL, &colvars);
1658  foreach(l, colvars)
1659  {
1660  var = (Var *) lfirst(l);
1661 
1662  /*
1663  * A non-Var in expandRTE's output means a dropped column;
1664  * must punt.
1665  */
1666  if (!IsA(var, Var))
1667  {
1668  tlist = NIL;
1669  break;
1670  }
1671 
1672  tlist = lappend(tlist,
1673  makeTargetEntry((Expr *) var,
1674  var->varattno,
1675  NULL,
1676  false));
1677  }
1678  break;
1679 
1680  default:
1681  /* caller error */
1682  elog(ERROR, "unsupported RTE kind %d in build_physical_tlist",
1683  (int) rte->rtekind);
1684  break;
1685  }
1686 
1687  return tlist;
1688 }
#define NIL
Definition: pg_list.h:65
#define IsA(nodeptr, _type_)
Definition: nodes.h:579
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:167
#define RelationGetNumberOfAttributes(relation)
Definition: rel.h:462
#define TupleDescAttr(tupdesc, i)
Definition: tupdesc.h:92
Var * makeVarFromTargetEntry(Index varno, TargetEntry *tle)
Definition: makefuncs.c:103
Definition: primnodes.h:181
List * targetList
Definition: parsenodes.h:140
bool resjunk
Definition: primnodes.h:1417
#define ERROR
Definition: elog.h:43
#define planner_rt_fetch(rti, root)
Definition: pathnodes.h:372
#define NoLock
Definition: lockdefs.h:34
AttrNumber resno
Definition: primnodes.h:1411
FormData_pg_attribute * Form_pg_attribute
Definition: pg_attribute.h:193
TargetEntry * makeTargetEntry(Expr *expr, AttrNumber resno, char *resname, bool resjunk)
Definition: makefuncs.c:238
Var * makeVar(Index varno, AttrNumber varattno, Oid vartype, int32 vartypmod, Oid varcollid, Index varlevelsup)
Definition: makefuncs.c:66
Index relid
Definition: pathnodes.h:692
List * lappend(List *list, void *datum)
Definition: list.c:321
void expandRTE(RangeTblEntry *rte, int rtindex, int sublevels_up, int location, bool include_dropped, List **colnames, List **colvars)
unsigned int Index
Definition: c.h:483
TupleDesc rd_att
Definition: rel.h:110
#define lfirst(lc)
Definition: pg_list.h:169
RTEKind rtekind
Definition: parsenodes.h:977
Query * subquery
Definition: parsenodes.h:1012
#define elog(elevel,...)
Definition: elog.h:214
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
Definition: pg_list.h:50

◆ estimate_rel_size()

void estimate_rel_size ( Relation  rel,
int32 attr_widths,
BlockNumber pages,
double *  tuples,
double *  allvisfrac 
)

Definition at line 949 of file plancat.c.

References get_rel_data_width(), MAXALIGN, RelationData::rd_rel, RelationGetNumberOfBlocks, SizeofHeapTupleHeader, SizeOfPageHeaderData, and table_relation_estimate_size().

Referenced by get_relation_info(), hashbuild(), and plan_create_index_workers().

951 {
952  BlockNumber curpages;
953  BlockNumber relpages;
954  double reltuples;
955  BlockNumber relallvisible;
956  double density;
957 
958  switch (rel->rd_rel->relkind)
959  {
960  case RELKIND_RELATION:
961  case RELKIND_MATVIEW:
962  case RELKIND_TOASTVALUE:
963  table_relation_estimate_size(rel, attr_widths, pages, tuples,
964  allvisfrac);
965  break;
966 
967  case RELKIND_INDEX:
968 
969  /*
970  * XXX: It'd probably be good to move this into a callback,
971  * individual index types e.g. know if they have a metapage.
972  */
973 
974  /* it has storage, ok to call the smgr */
975  curpages = RelationGetNumberOfBlocks(rel);
976 
977  /* report estimated # pages */
978  *pages = curpages;
979  /* quick exit if rel is clearly empty */
980  if (curpages == 0)
981  {
982  *tuples = 0;
983  *allvisfrac = 0;
984  break;
985  }
986 
987  /* coerce values in pg_class to more desirable types */
988  relpages = (BlockNumber) rel->rd_rel->relpages;
989  reltuples = (double) rel->rd_rel->reltuples;
990  relallvisible = (BlockNumber) rel->rd_rel->relallvisible;
991 
992  /*
993  * Discount the metapage while estimating the number of tuples.
994  * This is a kluge because it assumes more than it ought to about
995  * index structure. Currently it's OK for btree, hash, and GIN
996  * indexes but suspect for GiST indexes.
997  */
998  if (relpages > 0)
999  {
1000  curpages--;
1001  relpages--;
1002  }
1003 
1004  /* estimate number of tuples from previous tuple density */
1005  if (reltuples >= 0 && relpages > 0)
1006  density = reltuples / (double) relpages;
1007  else
1008  {
1009  /*
1010  * If we have no data because the relation was never vacuumed,
1011  * estimate tuple width from attribute datatypes. We assume
1012  * here that the pages are completely full, which is OK for
1013  * tables (since they've presumably not been VACUUMed yet) but
1014  * is probably an overestimate for indexes. Fortunately
1015  * get_relation_info() can clamp the overestimate to the
1016  * parent table's size.
1017  *
1018  * Note: this code intentionally disregards alignment
1019  * considerations, because (a) that would be gilding the lily
1020  * considering how crude the estimate is, and (b) it creates
1021  * platform dependencies in the default plans which are kind
1022  * of a headache for regression testing.
1023  *
1024  * XXX: Should this logic be more index specific?
1025  */
1026  int32 tuple_width;
1027 
1028  tuple_width = get_rel_data_width(rel, attr_widths);
1029  tuple_width += MAXALIGN(SizeofHeapTupleHeader);
1030  tuple_width += sizeof(ItemIdData);
1031  /* note: integer division is intentional here */
1032  density = (BLCKSZ - SizeOfPageHeaderData) / tuple_width;
1033  }
1034  *tuples = rint(density * (double) curpages);
1035 
1036  /*
1037  * We use relallvisible as-is, rather than scaling it up like we
1038  * do for the pages and tuples counts, on the theory that any
1039  * pages added since the last VACUUM are most likely not marked
1040  * all-visible. But costsize.c wants it converted to a fraction.
1041  */
1042  if (relallvisible == 0 || curpages <= 0)
1043  *allvisfrac = 0;
1044  else if ((double) relallvisible >= curpages)
1045  *allvisfrac = 1;
1046  else
1047  *allvisfrac = (double) relallvisible / curpages;
1048  break;
1049 
1050  case RELKIND_SEQUENCE:
1051  /* Sequences always have a known size */
1052  *pages = 1;
1053  *tuples = 1;
1054  *allvisfrac = 0;
1055  break;
1056  case RELKIND_FOREIGN_TABLE:
1057  /* Just use whatever's in pg_class */
1058  /* Note that FDW must cope if reltuples is -1! */
1059  *pages = rel->rd_rel->relpages;
1060  *tuples = rel->rd_rel->reltuples;
1061  *allvisfrac = 0;
1062  break;
1063  default:
1064  /* else it has no disk storage; probably shouldn't get here? */
1065  *pages = 0;
1066  *tuples = 0;
1067  *allvisfrac = 0;
1068  break;
1069  }
1070 }
static void table_relation_estimate_size(Relation rel, int32 *attr_widths, BlockNumber *pages, double *tuples, double *allvisfrac)
Definition: tableam.h:1714
#define SizeofHeapTupleHeader
Definition: htup_details.h:184
uint32 BlockNumber
Definition: block.h:31
#define SizeOfPageHeaderData
Definition: bufpage.h:216
Form_pg_class rd_rel
Definition: rel.h:109
signed int int32
Definition: c.h:363
struct ItemIdData ItemIdData
#define RelationGetNumberOfBlocks(reln)
Definition: bufmgr.h:211
#define MAXALIGN(LEN)
Definition: c.h:699
int32 get_rel_data_width(Relation rel, int32 *attr_widths)
Definition: plancat.c:1087

◆ find_partition_scheme()

static PartitionScheme find_partition_scheme ( PlannerInfo root,
Relation  rel 
)
static

Definition at line 2147 of file plancat.c.

References Assert, CurrentMemoryContext, fmgr_info_copy(), FmgrInfo::fn_oid, i, lappend(), lfirst, palloc(), palloc0(), PlannerInfo::part_schemes, PartitionKeyData::partcollation, PartitionSchemeData::partcollation, PartitionKeyData::partnatts, PartitionSchemeData::partnatts, PartitionKeyData::partopcintype, PartitionSchemeData::partopcintype, PartitionKeyData::partopfamily, PartitionSchemeData::partopfamily, PartitionKeyData::partsupfunc, PartitionSchemeData::partsupfunc, PartitionKeyData::parttypbyval, PartitionSchemeData::parttypbyval, PartitionKeyData::parttyplen, PartitionSchemeData::parttyplen, RelationGetPartitionKey(), PartitionKeyData::strategy, and PartitionSchemeData::strategy.

Referenced by set_relation_partition_info().

2148 {
2149  PartitionKey partkey = RelationGetPartitionKey(relation);
2150  ListCell *lc;
2151  int partnatts,
2152  i;
2153  PartitionScheme part_scheme;
2154 
2155  /* A partitioned table should have a partition key. */
2156  Assert(partkey != NULL);
2157 
2158  partnatts = partkey->partnatts;
2159 
2160  /* Search for a matching partition scheme and return if found one. */
2161  foreach(lc, root->part_schemes)
2162  {
2163  part_scheme = lfirst(lc);
2164 
2165  /* Match partitioning strategy and number of keys. */
2166  if (partkey->strategy != part_scheme->strategy ||
2167  partnatts != part_scheme->partnatts)
2168  continue;
2169 
2170  /* Match partition key type properties. */
2171  if (memcmp(partkey->partopfamily, part_scheme->partopfamily,
2172  sizeof(Oid) * partnatts) != 0 ||
2173  memcmp(partkey->partopcintype, part_scheme->partopcintype,
2174  sizeof(Oid) * partnatts) != 0 ||
2175  memcmp(partkey->partcollation, part_scheme->partcollation,
2176  sizeof(Oid) * partnatts) != 0)
2177  continue;
2178 
2179  /*
2180  * Length and byval information should match when partopcintype
2181  * matches.
2182  */
2183  Assert(memcmp(partkey->parttyplen, part_scheme->parttyplen,
2184  sizeof(int16) * partnatts) == 0);
2185  Assert(memcmp(partkey->parttypbyval, part_scheme->parttypbyval,
2186  sizeof(bool) * partnatts) == 0);
2187 
2188  /*
2189  * If partopfamily and partopcintype matched, must have the same
2190  * partition comparison functions. Note that we cannot reliably
2191  * Assert the equality of function structs themselves for they might
2192  * be different across PartitionKey's, so just Assert for the function
2193  * OIDs.
2194  */
2195 #ifdef USE_ASSERT_CHECKING
2196  for (i = 0; i < partkey->partnatts; i++)
2197  Assert(partkey->partsupfunc[i].fn_oid ==
2198  part_scheme->partsupfunc[i].fn_oid);
2199 #endif
2200 
2201  /* Found matching partition scheme. */
2202  return part_scheme;
2203  }
2204 
2205  /*
2206  * Did not find matching partition scheme. Create one copying relevant
2207  * information from the relcache. We need to copy the contents of the
2208  * array since the relcache entry may not survive after we have closed the
2209  * relation.
2210  */
2211  part_scheme = (PartitionScheme) palloc0(sizeof(PartitionSchemeData));
2212  part_scheme->strategy = partkey->strategy;
2213  part_scheme->partnatts = partkey->partnatts;
2214 
2215  part_scheme->partopfamily = (Oid *) palloc(sizeof(Oid) * partnatts);
2216  memcpy(part_scheme->partopfamily, partkey->partopfamily,
2217  sizeof(Oid) * partnatts);
2218 
2219  part_scheme->partopcintype = (Oid *) palloc(sizeof(Oid) * partnatts);
2220  memcpy(part_scheme->partopcintype, partkey->partopcintype,
2221  sizeof(Oid) * partnatts);
2222 
2223  part_scheme->partcollation = (Oid *) palloc(sizeof(Oid) * partnatts);
2224  memcpy(part_scheme->partcollation, partkey->partcollation,
2225  sizeof(Oid) * partnatts);
2226 
2227  part_scheme->parttyplen = (int16 *) palloc(sizeof(int16) * partnatts);
2228  memcpy(part_scheme->parttyplen, partkey->parttyplen,
2229  sizeof(int16) * partnatts);
2230 
2231  part_scheme->parttypbyval = (bool *) palloc(sizeof(bool) * partnatts);
2232  memcpy(part_scheme->parttypbyval, partkey->parttypbyval,
2233  sizeof(bool) * partnatts);
2234 
2235  part_scheme->partsupfunc = (FmgrInfo *)
2236  palloc(sizeof(FmgrInfo) * partnatts);
2237  for (i = 0; i < partnatts; i++)
2238  fmgr_info_copy(&part_scheme->partsupfunc[i], &partkey->partsupfunc[i],
2240 
2241  /* Add the partitioning scheme to PlannerInfo. */
2242  root->part_schemes = lappend(root->part_schemes, part_scheme);
2243 
2244  return part_scheme;
2245 }
signed short int16
Definition: c.h:362
Definition: fmgr.h:56
Oid * partopfamily
Definition: partcache.h:33
FmgrInfo * partsupfunc
Definition: partcache.h:35
List * part_schemes
Definition: pathnodes.h:303
PartitionKey RelationGetPartitionKey(Relation rel)
Definition: partcache.c:54
unsigned int Oid
Definition: postgres_ext.h:31
void fmgr_info_copy(FmgrInfo *dstinfo, FmgrInfo *srcinfo, MemoryContext destcxt)
Definition: fmgr.c:612
MemoryContext CurrentMemoryContext
Definition: mcxt.c:38
struct PartitionSchemeData * PartitionScheme
Definition: pathnodes.h:406
List * lappend(List *list, void *datum)
Definition: list.c:321
Oid * partcollation
Definition: partcache.h:38
void * palloc0(Size size)
Definition: mcxt.c:981
Oid fn_oid
Definition: fmgr.h:59
bool * parttypbyval
Definition: partcache.h:44
#define Assert(condition)
Definition: c.h:746
#define lfirst(lc)
Definition: pg_list.h:169
int16 * parttyplen
Definition: partcache.h:43
struct FmgrInfo * partsupfunc
Definition: pathnodes.h:403
void * palloc(Size size)
Definition: mcxt.c:950
Oid * partopcintype
Definition: partcache.h:34
int i

◆ function_selectivity()

Selectivity function_selectivity ( PlannerInfo root,
Oid  funcid,
List args,
Oid  inputcollid,
bool  is_join,
int  varRelid,
JoinType  jointype,
SpecialJoinInfo sjinfo 
)

Definition at line 1843 of file plancat.c.

References SupportRequestSelectivity::args, generate_unaccent_rules::args, DatumGetPointer, elog, ERROR, SupportRequestSelectivity::funcid, get_func_support(), SupportRequestSelectivity::inputcollid, SupportRequestSelectivity::is_join, SupportRequestSelectivity::jointype, OidFunctionCall1, PointerGetDatum, SupportRequestSelectivity::root, SupportRequestSelectivity::selectivity, SupportRequestSelectivity::sjinfo, T_SupportRequestSelectivity, SupportRequestSelectivity::type, and SupportRequestSelectivity::varRelid.

Referenced by clause_selectivity().

1851 {
1852  RegProcedure prosupport = get_func_support(funcid);
1854  SupportRequestSelectivity *sresult;
1855 
1856  /*
1857  * If no support function is provided, use our historical default
1858  * estimate, 0.3333333. This seems a pretty unprincipled choice, but
1859  * Postgres has been using that estimate for function calls since 1992.
1860  * The hoariness of this behavior suggests that we should not be in too
1861  * much hurry to use another value.
1862  */
1863  if (!prosupport)
1864  return (Selectivity) 0.3333333;
1865 
1867  req.root = root;
1868  req.funcid = funcid;
1869  req.args = args;
1870  req.inputcollid = inputcollid;
1871  req.is_join = is_join;
1872  req.varRelid = varRelid;
1873  req.jointype = jointype;
1874  req.sjinfo = sjinfo;
1875  req.selectivity = -1; /* to catch failure to set the value */
1876 
1877  sresult = (SupportRequestSelectivity *)
1878  DatumGetPointer(OidFunctionCall1(prosupport,
1879  PointerGetDatum(&req)));
1880 
1881  /* If support function fails, use default */
1882  if (sresult != &req)
1883  return (Selectivity) 0.3333333;
1884 
1885  if (req.selectivity < 0.0 || req.selectivity > 1.0)
1886  elog(ERROR, "invalid function selectivity: %f", req.selectivity);
1887 
1888  return (Selectivity) req.selectivity;
1889 }
#define PointerGetDatum(X)
Definition: postgres.h:556
regproc RegProcedure
Definition: c.h:519
double Selectivity
Definition: nodes.h:661
#define ERROR
Definition: elog.h:43
struct PlannerInfo * root
Definition: supportnodes.h:96
struct SpecialJoinInfo * sjinfo
Definition: supportnodes.h:103
#define OidFunctionCall1(functionId, arg1)
Definition: fmgr.h:662
RegProcedure get_func_support(Oid funcid)
Definition: lsyscache.c:1770
#define DatumGetPointer(X)
Definition: postgres.h:549
#define elog(elevel,...)
Definition: elog.h:214

◆ get_function_rows()

double get_function_rows ( PlannerInfo root,
Oid  funcid,
Node node 
)

Definition at line 1966 of file plancat.c.

References Assert, DatumGetPointer, elog, ERROR, SupportRequestRows::funcid, GETSTRUCT, HeapTupleIsValid, SupportRequestRows::node, ObjectIdGetDatum, OidFunctionCall1, OidIsValid, PointerGetDatum, PROCOID, ReleaseSysCache(), SupportRequestRows::root, SupportRequestRows::rows, SearchSysCache1(), T_SupportRequestRows, and SupportRequestRows::type.

Referenced by expression_returns_set_rows().

1967 {
1968  HeapTuple proctup;
1969  Form_pg_proc procform;
1970  double result;
1971 
1972  proctup = SearchSysCache1(PROCOID, ObjectIdGetDatum(funcid));
1973  if (!HeapTupleIsValid(proctup))
1974  elog(ERROR, "cache lookup failed for function %u", funcid);
1975  procform = (Form_pg_proc) GETSTRUCT(proctup);
1976 
1977  Assert(procform->proretset); /* else caller error */
1978 
1979  if (OidIsValid(procform->prosupport))
1980  {
1981  SupportRequestRows req;
1982  SupportRequestRows *sresult;
1983 
1984  req.type = T_SupportRequestRows;
1985  req.root = root;
1986  req.funcid = funcid;
1987  req.node = node;
1988 
1989  req.rows = 0; /* just for sanity */
1990 
1991  sresult = (SupportRequestRows *)
1992  DatumGetPointer(OidFunctionCall1(procform->prosupport,
1993  PointerGetDatum(&req)));
1994 
1995  if (sresult == &req)
1996  {
1997  /* Success */
1998  ReleaseSysCache(proctup);
1999  return req.rows;
2000  }
2001  }
2002 
2003  /* No support function, or it failed, so rely on prorows */
2004  result = procform->prorows;
2005 
2006  ReleaseSysCache(proctup);
2007 
2008  return result;
2009 }
#define GETSTRUCT(TUP)
Definition: htup_details.h:655
#define PointerGetDatum(X)
Definition: postgres.h:556
#define OidIsValid(objectId)
Definition: c.h:652
struct PlannerInfo * root
Definition: supportnodes.h:163
#define ObjectIdGetDatum(X)
Definition: postgres.h:507
#define ERROR
Definition: elog.h:43
#define OidFunctionCall1(functionId, arg1)
Definition: fmgr.h:662
HeapTuple SearchSysCache1(int cacheId, Datum key1)
Definition: syscache.c:1116
void ReleaseSysCache(HeapTuple tuple)
Definition: syscache.c:1164
FormData_pg_proc * Form_pg_proc
Definition: pg_proc.h:133
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
#define Assert(condition)
Definition: c.h:746
#define DatumGetPointer(X)
Definition: postgres.h:549
#define elog(elevel,...)
Definition: elog.h:214

◆ get_rel_data_width()

int32 get_rel_data_width ( Relation  rel,
int32 attr_widths 
)

Definition at line 1087 of file plancat.c.

References Assert, get_attavgwidth(), get_typavgwidth(), i, RelationData::rd_att, RelationGetNumberOfAttributes, RelationGetRelid, and TupleDescAttr.

Referenced by estimate_rel_size(), get_relation_data_width(), and table_block_relation_estimate_size().

1088 {
1089  int32 tuple_width = 0;
1090  int i;
1091 
1092  for (i = 1; i <= RelationGetNumberOfAttributes(rel); i++)
1093  {
1094  Form_pg_attribute att = TupleDescAttr(rel->rd_att, i - 1);
1095  int32 item_width;
1096 
1097  if (att->attisdropped)
1098  continue;
1099 
1100  /* use previously cached data, if any */
1101  if (attr_widths != NULL && attr_widths[i] > 0)
1102  {
1103  tuple_width += attr_widths[i];
1104  continue;
1105  }
1106 
1107  /* This should match set_rel_width() in costsize.c */
1108  item_width = get_attavgwidth(RelationGetRelid(rel), i);
1109  if (item_width <= 0)
1110  {
1111  item_width = get_typavgwidth(att->atttypid, att->atttypmod);
1112  Assert(item_width > 0);
1113  }
1114  if (attr_widths != NULL)
1115  attr_widths[i] = item_width;
1116  tuple_width += item_width;
1117  }
1118 
1119  return tuple_width;
1120 }
#define RelationGetNumberOfAttributes(relation)
Definition: rel.h:462
#define TupleDescAttr(tupdesc, i)
Definition: tupdesc.h:92
signed int int32
Definition: c.h:363
FormData_pg_attribute * Form_pg_attribute
Definition: pg_attribute.h:193
TupleDesc rd_att
Definition: rel.h:110
int32 get_typavgwidth(Oid typid, int32 typmod)
Definition: lsyscache.c:2466
#define Assert(condition)
Definition: c.h:746
int i
int32 get_attavgwidth(Oid relid, AttrNumber attnum)
Definition: lsyscache.c:2980
#define RelationGetRelid(relation)
Definition: rel.h:456

◆ get_relation_constraints()

static List * get_relation_constraints ( PlannerInfo root,
Oid  relationObjectId,
RelOptInfo rel,
bool  include_noinherit,
bool  include_notnull,
bool  include_partition 
)
static

Definition at line 1169 of file plancat.c.

References NullTest::arg, NullTest::argisrow, canonicalize_qual(), ConstrCheck::ccbin, ConstrCheck::ccnoinherit, ConstrCheck::ccvalid, ChangeVarNodes(), TupleConstr::check, TupleDescData::constr, eval_const_expressions(), TupleConstr::has_not_null, i, IS_NOT_NULL, lappend(), list_concat(), NullTest::location, make_ands_implicit(), makeNode, makeVar(), TupleDescData::natts, NIL, NoLock, NullTest::nulltesttype, TupleConstr::num_check, RelOptInfo::partition_qual, RelationData::rd_att, RelationData::rd_rel, RelOptInfo::relid, set_baserel_partition_constraint(), stringToNode(), table_close(), table_open(), and TupleDescAttr.

Referenced by relation_excluded_by_constraints().

1174 {
1175  List *result = NIL;
1176  Index varno = rel->relid;
1177  Relation relation;
1178  TupleConstr *constr;
1179 
1180  /*
1181  * We assume the relation has already been safely locked.
1182  */
1183  relation = table_open(relationObjectId, NoLock);
1184 
1185  constr = relation->rd_att->constr;
1186  if (constr != NULL)
1187  {
1188  int num_check = constr->num_check;
1189  int i;
1190 
1191  for (i = 0; i < num_check; i++)
1192  {
1193  Node *cexpr;
1194 
1195  /*
1196  * If this constraint hasn't been fully validated yet, we must
1197  * ignore it here. Also ignore if NO INHERIT and we weren't told
1198  * that that's safe.
1199  */
1200  if (!constr->check[i].ccvalid)
1201  continue;
1202  if (constr->check[i].ccnoinherit && !include_noinherit)
1203  continue;
1204 
1205  cexpr = stringToNode(constr->check[i].ccbin);
1206 
1207  /*
1208  * Run each expression through const-simplification and
1209  * canonicalization. This is not just an optimization, but is
1210  * necessary, because we will be comparing it to
1211  * similarly-processed qual clauses, and may fail to detect valid
1212  * matches without this. This must match the processing done to
1213  * qual clauses in preprocess_expression()! (We can skip the
1214  * stuff involving subqueries, however, since we don't allow any
1215  * in check constraints.)
1216  */
1217  cexpr = eval_const_expressions(root, cexpr);
1218 
1219  cexpr = (Node *) canonicalize_qual((Expr *) cexpr, true);
1220 
1221  /* Fix Vars to have the desired varno */
1222  if (varno != 1)
1223  ChangeVarNodes(cexpr, 1, varno, 0);
1224 
1225  /*
1226  * Finally, convert to implicit-AND format (that is, a List) and
1227  * append the resulting item(s) to our output list.
1228  */
1229  result = list_concat(result,
1230  make_ands_implicit((Expr *) cexpr));
1231  }
1232 
1233  /* Add NOT NULL constraints in expression form, if requested */
1234  if (include_notnull && constr->has_not_null)
1235  {
1236  int natts = relation->rd_att->natts;
1237 
1238  for (i = 1; i <= natts; i++)
1239  {
1240  Form_pg_attribute att = TupleDescAttr(relation->rd_att, i - 1);
1241 
1242  if (att->attnotnull && !att->attisdropped)
1243  {
1244  NullTest *ntest = makeNode(NullTest);
1245 
1246  ntest->arg = (Expr *) makeVar(varno,
1247  i,
1248  att->atttypid,
1249  att->atttypmod,
1250  att->attcollation,
1251  0);
1252  ntest->nulltesttype = IS_NOT_NULL;
1253 
1254  /*
1255  * argisrow=false is correct even for a composite column,
1256  * because attnotnull does not represent a SQL-spec IS NOT
1257  * NULL test in such a case, just IS DISTINCT FROM NULL.
1258  */
1259  ntest->argisrow = false;
1260  ntest->location = -1;
1261  result = lappend(result, ntest);
1262  }
1263  }
1264  }
1265  }
1266 
1267  /*
1268  * Add partitioning constraints, if requested.
1269  */
1270  if (include_partition && relation->rd_rel->relispartition)
1271  {
1272  /* make sure rel->partition_qual is set */
1273  set_baserel_partition_constraint(relation, rel);
1274  result = list_concat(result, rel->partition_qual);
1275  }
1276 
1277  table_close(relation, NoLock);
1278 
1279  return result;
1280 }
#define NIL
Definition: pg_list.h:65
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:167
#define TupleDescAttr(tupdesc, i)
Definition: tupdesc.h:92
Definition: nodes.h:528
List * list_concat(List *list1, const List *list2)
Definition: list.c:515
void * stringToNode(const char *str)
Definition: read.c:89
Node * eval_const_expressions(PlannerInfo *root, Node *node)
Definition: clauses.c:2287
Form_pg_class rd_rel
Definition: rel.h:109
Expr * arg
Definition: primnodes.h:1222
#define NoLock
Definition: lockdefs.h:34
TupleConstr * constr
Definition: tupdesc.h:85
Expr * canonicalize_qual(Expr *qual, bool is_check)
Definition: prepqual.c:292
FormData_pg_attribute * Form_pg_attribute
Definition: pg_attribute.h:193
Var * makeVar(Index varno, AttrNumber varattno, Oid vartype, int32 vartypmod, Oid varcollid, Index varlevelsup)
Definition: makefuncs.c:66
Index relid
Definition: pathnodes.h:692
List * lappend(List *list, void *datum)
Definition: list.c:321
List * make_ands_implicit(Expr *clause)
Definition: makefuncs.c:718
unsigned int Index
Definition: c.h:483
TupleDesc rd_att
Definition: rel.h:110
NullTestType nulltesttype
Definition: primnodes.h:1223
uint16 num_check
Definition: tupdesc.h:43
static void set_baserel_partition_constraint(Relation relation, RelOptInfo *rel)
Definition: plancat.c:2322
#define makeNode(_type_)
Definition: nodes.h:576
int location
Definition: primnodes.h:1225
int i
void ChangeVarNodes(Node *node, int rt_index, int new_index, int sublevels_up)
Definition: rewriteManip.c:610
bool argisrow
Definition: primnodes.h:1224
ConstrCheck * check
Definition: tupdesc.h:40
bool ccvalid
Definition: tupdesc.h:32
List * partition_qual
Definition: pathnodes.h:748
bool has_not_null
Definition: tupdesc.h:44
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
Definition: pg_list.h:50
char * ccbin
Definition: tupdesc.h:31
bool ccnoinherit
Definition: tupdesc.h:33

◆ get_relation_data_width()

int32 get_relation_data_width ( Oid  relid,
int32 attr_widths 
)

Definition at line 1129 of file plancat.c.

References get_rel_data_width(), NoLock, table_close(), and table_open().

Referenced by plan_cluster_use_sort(), and set_rel_width().

1130 {
1131  int32 result;
1132  Relation relation;
1133 
1134  /* As above, assume relation is already locked */
1135  relation = table_open(relid, NoLock);
1136 
1137  result = get_rel_data_width(relation, attr_widths);
1138 
1139  table_close(relation, NoLock);
1140 
1141  return result;
1142 }
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:167
signed int int32
Definition: c.h:363
#define NoLock
Definition: lockdefs.h:34
int32 get_rel_data_width(Relation rel, int32 *attr_widths)
Definition: plancat.c:1087
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39

◆ get_relation_foreign_keys()

static void get_relation_foreign_keys ( PlannerInfo root,
RelOptInfo rel,
Relation  relation,
bool  inhparent 
)
static

Definition at line 488 of file plancat.c.

References Assert, ForeignKeyOptInfo::con_relid, ForeignKeyCacheInfo::confkey, ForeignKeyOptInfo::confkey, ForeignKeyCacheInfo::confrelid, ForeignKeyCacheInfo::conkey, ForeignKeyOptInfo::conkey, ForeignKeyCacheInfo::conpfeqop, ForeignKeyOptInfo::conpfeqop, ForeignKeyCacheInfo::conrelid, ForeignKeyOptInfo::eclass, PlannerInfo::fkey_list, RangeTblEntry::inh, lappend(), lfirst, list_length(), makeNode, ForeignKeyCacheInfo::nkeys, ForeignKeyOptInfo::nkeys, ForeignKeyOptInfo::nmatched_ec, ForeignKeyOptInfo::nmatched_rcols, ForeignKeyOptInfo::nmatched_ri, PlannerInfo::parse, ForeignKeyOptInfo::ref_relid, RelationGetFKeyList(), RelationGetRelid, RelOptInfo::relid, RangeTblEntry::relid, RELOPT_BASEREL, RelOptInfo::reloptkind, ForeignKeyOptInfo::rinfos, Query::rtable, RTE_RELATION, and RangeTblEntry::rtekind.

Referenced by get_relation_info().

490 {
491  List *rtable = root->parse->rtable;
492  List *cachedfkeys;
493  ListCell *lc;
494 
495  /*
496  * If it's not a baserel, we don't care about its FKs. Also, if the query
497  * references only a single relation, we can skip the lookup since no FKs
498  * could satisfy the requirements below.
499  */
500  if (rel->reloptkind != RELOPT_BASEREL ||
501  list_length(rtable) < 2)
502  return;
503 
504  /*
505  * If it's the parent of an inheritance tree, ignore its FKs. We could
506  * make useful FK-based deductions if we found that all members of the
507  * inheritance tree have equivalent FK constraints, but detecting that
508  * would require code that hasn't been written.
509  */
510  if (inhparent)
511  return;
512 
513  /*
514  * Extract data about relation's FKs from the relcache. Note that this
515  * list belongs to the relcache and might disappear in a cache flush, so
516  * we must not do any further catalog access within this function.
517  */
518  cachedfkeys = RelationGetFKeyList(relation);
519 
520  /*
521  * Figure out which FKs are of interest for this query, and create
522  * ForeignKeyOptInfos for them. We want only FKs that reference some
523  * other RTE of the current query. In queries containing self-joins,
524  * there might be more than one other RTE for a referenced table, and we
525  * should make a ForeignKeyOptInfo for each occurrence.
526  *
527  * Ideally, we would ignore RTEs that correspond to non-baserels, but it's
528  * too hard to identify those here, so we might end up making some useless
529  * ForeignKeyOptInfos. If so, match_foreign_keys_to_quals() will remove
530  * them again.
531  */
532  foreach(lc, cachedfkeys)
533  {
534  ForeignKeyCacheInfo *cachedfk = (ForeignKeyCacheInfo *) lfirst(lc);
535  Index rti;
536  ListCell *lc2;
537 
538  /* conrelid should always be that of the table we're considering */
539  Assert(cachedfk->conrelid == RelationGetRelid(relation));
540 
541  /* Scan to find other RTEs matching confrelid */
542  rti = 0;
543  foreach(lc2, rtable)
544  {
545  RangeTblEntry *rte = (RangeTblEntry *) lfirst(lc2);
546  ForeignKeyOptInfo *info;
547 
548  rti++;
549  /* Ignore if not the correct table */
550  if (rte->rtekind != RTE_RELATION ||
551  rte->relid != cachedfk->confrelid)
552  continue;
553  /* Ignore if it's an inheritance parent; doesn't really match */
554  if (rte->inh)
555  continue;
556  /* Ignore self-referential FKs; we only care about joins */
557  if (rti == rel->relid)
558  continue;
559 
560  /* OK, let's make an entry */
561  info = makeNode(ForeignKeyOptInfo);
562  info->con_relid = rel->relid;
563  info->ref_relid = rti;
564  info->nkeys = cachedfk->nkeys;
565  memcpy(info->conkey, cachedfk->conkey, sizeof(info->conkey));
566  memcpy(info->confkey, cachedfk->confkey, sizeof(info->confkey));
567  memcpy(info->conpfeqop, cachedfk->conpfeqop, sizeof(info->conpfeqop));
568  /* zero out fields to be filled by match_foreign_keys_to_quals */
569  info->nmatched_ec = 0;
570  info->nmatched_rcols = 0;
571  info->nmatched_ri = 0;
572  memset(info->eclass, 0, sizeof(info->eclass));
573  memset(info->rinfos, 0, sizeof(info->rinfos));
574 
575  root->fkey_list = lappend(root->fkey_list, info);
576  }
577  }
578 }
Query * parse
Definition: pathnodes.h:177
RelOptKind reloptkind
Definition: pathnodes.h:661
AttrNumber conkey[INDEX_MAX_KEYS]
Definition: rel.h:262
List * fkey_list
Definition: pathnodes.h:294
List * rtable
Definition: parsenodes.h:137
Oid conpfeqop[INDEX_MAX_KEYS]
Definition: pathnodes.h:888
Index relid
Definition: pathnodes.h:692
List * lappend(List *list, void *datum)
Definition: list.c:321
struct EquivalenceClass * eclass[INDEX_MAX_KEYS]
Definition: pathnodes.h:895
AttrNumber conkey[INDEX_MAX_KEYS]
Definition: pathnodes.h:886
unsigned int Index
Definition: c.h:483
#define makeNode(_type_)
Definition: nodes.h:576
Oid conpfeqop[INDEX_MAX_KEYS]
Definition: rel.h:264
#define Assert(condition)
Definition: c.h:746
#define lfirst(lc)
Definition: pg_list.h:169
static int list_length(const List *l)
Definition: pg_list.h:149
RTEKind rtekind
Definition: parsenodes.h:977
List * RelationGetFKeyList(Relation relation)
Definition: relcache.c:4405
AttrNumber confkey[INDEX_MAX_KEYS]
Definition: rel.h:263
Definition: pg_list.h:50
AttrNumber confkey[INDEX_MAX_KEYS]
Definition: pathnodes.h:887
#define RelationGetRelid(relation)
Definition: rel.h:456
List * rinfos[INDEX_MAX_KEYS]
Definition: pathnodes.h:897

◆ get_relation_info()

void get_relation_info ( PlannerInfo root,
Oid  relationObjectId,
bool  inhparent,
RelOptInfo rel 
)

Definition at line 113 of file plancat.c.

References _bt_getrootheight(), RelOptInfo::allvisfrac, IndexAmRoutine::amcanorder, IndexAmRoutine::amcanorderbyop, IndexOptInfo::amcanorderbyop, IndexAmRoutine::amcanparallel, IndexOptInfo::amcanparallel, IndexAmRoutine::amcostestimate, IndexOptInfo::amcostestimate, IndexAmRoutine::amgetbitmap, IndexAmRoutine::amgettuple, IndexOptInfo::amhasgetbitmap, IndexOptInfo::amhasgettuple, IndexAmRoutine::amoptionalkey, IndexOptInfo::amoptionalkey, IndexAmRoutine::amsearcharray, IndexOptInfo::amsearcharray, IndexAmRoutine::amsearchnulls, IndexOptInfo::amsearchnulls, Assert, RelOptInfo::attr_needed, RelOptInfo::attr_widths, BTLessStrategyNumber, build_index_tlist(), IndexOptInfo::canreturn, ChangeVarNodes(), ereport, errcode(), errmsg(), ERROR, estimate_rel_size(), RelOptInfo::fdwroutine, FirstLowInvalidHeapAttributeNumber, get_opfamily_member(), get_ordering_op_properties(), get_relation_foreign_keys(), get_relation_info_hook, get_relation_statistics(), GetFdwRoutineForRelation(), GetForeignServerIdByRelId(), PlannerInfo::glob, HeapTupleHeaderGetXmin, IndexOptInfo::hypothetical, i, IgnoreSystemIndexes, IndexOptInfo::immediate, index_can_return(), index_close(), index_open(), IndexOptInfo::indexcollations, IndexOptInfo::indexkeys, RelOptInfo::indexlist, IndexOptInfo::indexoid, IndexOptInfo::indexprs, IndexOptInfo::indextlist, IndexOptInfo::indpred, IndexOptInfo::indrestrictinfo, InvalidOid, IsSystemRelation(), lcons(), lfirst_oid, list_free(), makeNode, RelOptInfo::max_attr, RelOptInfo::min_attr, IndexOptInfo::ncolumns, NIL, IndexOptInfo::nkeycolumns, NoLock, IndexOptInfo::nulls_first, OidIsValid, IndexOptInfo::opcintype, IndexOptInfo::opclassoptions, IndexOptInfo::opfamily, RelOptInfo::pages, IndexOptInfo::pages, palloc(), palloc0(), IndexOptInfo::predOK, RelationData::rd_indam, RelationData::rd_indcollation, RelationData::rd_index, RelationData::rd_indextuple, RelationData::rd_indoption, RelationData::rd_opcintype, RelationData::rd_opfamily, RelationData::rd_rel, RelationData::rd_tableam, RecoveryInProgress(), IndexOptInfo::rel, RelOptInfo::rel_parallel_workers, IndexOptInfo::relam, RelationGetForm, RelationGetIndexAttOptions(), RelationGetIndexExpressions(), RelationGetIndexList(), RelationGetIndexPredicate(), RelationGetNumberOfAttributes, RelationGetNumberOfBlocks, RelationGetParallelWorkers, RelationGetRelid, RelationNeedsWAL, RelOptInfo::relid, RangeTblEntry::rellockmode, RelOptInfo::reltablespace, IndexOptInfo::reltablespace, IndexOptInfo::reverse_sort, TableAmRoutine::scan_bitmap_next_block, RelOptInfo::serverid, set_relation_partition_info(), PlannerInfo::simple_rte_array, IndexOptInfo::sortopfamily, RelOptInfo::statlist, HeapTupleData::t_data, table_close(), table_open(), TransactionIdPrecedes(), TransactionXmin, PlannerGlobal::transientPlan, IndexOptInfo::tree_height, RelOptInfo::tuples, IndexOptInfo::tuples, and IndexOptInfo::unique.

Referenced by build_simple_rel().

115 {
116  Index varno = rel->relid;
117  Relation relation;
118  bool hasindex;
119  List *indexinfos = NIL;
120 
121  /*
122  * We need not lock the relation since it was already locked, either by
123  * the rewriter or when expand_inherited_rtentry() added it to the query's
124  * rangetable.
125  */
126  relation = table_open(relationObjectId, NoLock);
127 
128  /* Temporary and unlogged relations are inaccessible during recovery. */
129  if (!RelationNeedsWAL(relation) && RecoveryInProgress())
130  ereport(ERROR,
131  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
132  errmsg("cannot access temporary or unlogged relations during recovery")));
133 
135  rel->max_attr = RelationGetNumberOfAttributes(relation);
136  rel->reltablespace = RelationGetForm(relation)->reltablespace;
137 
138  Assert(rel->max_attr >= rel->min_attr);
139  rel->attr_needed = (Relids *)
140  palloc0((rel->max_attr - rel->min_attr + 1) * sizeof(Relids));
141  rel->attr_widths = (int32 *)
142  palloc0((rel->max_attr - rel->min_attr + 1) * sizeof(int32));
143 
144  /*
145  * Estimate relation size --- unless it's an inheritance parent, in which
146  * case the size we want is not the rel's own size but the size of its
147  * inheritance tree. That will be computed in set_append_rel_size().
148  */
149  if (!inhparent)
150  estimate_rel_size(relation, rel->attr_widths - rel->min_attr,
151  &rel->pages, &rel->tuples, &rel->allvisfrac);
152 
153  /* Retrieve the parallel_workers reloption, or -1 if not set. */
155 
156  /*
157  * Make list of indexes. Ignore indexes on system catalogs if told to.
158  * Don't bother with indexes for an inheritance parent, either.
159  */
160  if (inhparent ||
161  (IgnoreSystemIndexes && IsSystemRelation(relation)))
162  hasindex = false;
163  else
164  hasindex = relation->rd_rel->relhasindex;
165 
166  if (hasindex)
167  {
168  List *indexoidlist;
169  LOCKMODE lmode;
170  ListCell *l;
171 
172  indexoidlist = RelationGetIndexList(relation);
173 
174  /*
175  * For each index, we get the same type of lock that the executor will
176  * need, and do not release it. This saves a couple of trips to the
177  * shared lock manager while not creating any real loss of
178  * concurrency, because no schema changes could be happening on the
179  * index while we hold lock on the parent rel, and no lock type used
180  * for queries blocks any other kind of index operation.
181  */
182  lmode = root->simple_rte_array[varno]->rellockmode;
183 
184  foreach(l, indexoidlist)
185  {
186  Oid indexoid = lfirst_oid(l);
187  Relation indexRelation;
189  IndexAmRoutine *amroutine;
190  IndexOptInfo *info;
191  int ncolumns,
192  nkeycolumns;
193  int i;
194 
195  /*
196  * Extract info from the relation descriptor for the index.
197  */
198  indexRelation = index_open(indexoid, lmode);
199  index = indexRelation->rd_index;
200 
201  /*
202  * Ignore invalid indexes, since they can't safely be used for
203  * queries. Note that this is OK because the data structure we
204  * are constructing is only used by the planner --- the executor
205  * still needs to insert into "invalid" indexes, if they're marked
206  * indisready.
207  */
208  if (!index->indisvalid)
209  {
210  index_close(indexRelation, NoLock);
211  continue;
212  }
213 
214  /*
215  * Ignore partitioned indexes, since they are not usable for
216  * queries.
217  */
218  if (indexRelation->rd_rel->relkind == RELKIND_PARTITIONED_INDEX)
219  {
220  index_close(indexRelation, NoLock);
221  continue;
222  }
223 
224  /*
225  * If the index is valid, but cannot yet be used, ignore it; but
226  * mark the plan we are generating as transient. See
227  * src/backend/access/heap/README.HOT for discussion.
228  */
229  if (index->indcheckxmin &&
232  {
233  root->glob->transientPlan = true;
234  index_close(indexRelation, NoLock);
235  continue;
236  }
237 
238  info = makeNode(IndexOptInfo);
239 
240  info->indexoid = index->indexrelid;
241  info->reltablespace =
242  RelationGetForm(indexRelation)->reltablespace;
243  info->rel = rel;
244  info->ncolumns = ncolumns = index->indnatts;
245  info->nkeycolumns = nkeycolumns = index->indnkeyatts;
246 
247  info->indexkeys = (int *) palloc(sizeof(int) * ncolumns);
248  info->indexcollations = (Oid *) palloc(sizeof(Oid) * nkeycolumns);
249  info->opfamily = (Oid *) palloc(sizeof(Oid) * nkeycolumns);
250  info->opcintype = (Oid *) palloc(sizeof(Oid) * nkeycolumns);
251  info->canreturn = (bool *) palloc(sizeof(bool) * ncolumns);
252 
253  for (i = 0; i < ncolumns; i++)
254  {
255  info->indexkeys[i] = index->indkey.values[i];
256  info->canreturn[i] = index_can_return(indexRelation, i + 1);
257  }
258 
259  for (i = 0; i < nkeycolumns; i++)
260  {
261  info->opfamily[i] = indexRelation->rd_opfamily[i];
262  info->opcintype[i] = indexRelation->rd_opcintype[i];
263  info->indexcollations[i] = indexRelation->rd_indcollation[i];
264  }
265 
266  info->relam = indexRelation->rd_rel->relam;
267 
268  /* We copy just the fields we need, not all of rd_indam */
269  amroutine = indexRelation->rd_indam;
270  info->amcanorderbyop = amroutine->amcanorderbyop;
271  info->amoptionalkey = amroutine->amoptionalkey;
272  info->amsearcharray = amroutine->amsearcharray;
273  info->amsearchnulls = amroutine->amsearchnulls;
274  info->amcanparallel = amroutine->amcanparallel;
275  info->amhasgettuple = (amroutine->amgettuple != NULL);
276  info->amhasgetbitmap = amroutine->amgetbitmap != NULL &&
277  relation->rd_tableam->scan_bitmap_next_block != NULL;
278  info->amcostestimate = amroutine->amcostestimate;
279  Assert(info->amcostestimate != NULL);
280 
281  /* Fetch index opclass options */
282  info->opclassoptions = RelationGetIndexAttOptions(indexRelation, true);
283 
284  /*
285  * Fetch the ordering information for the index, if any.
286  */
287  if (info->relam == BTREE_AM_OID)
288  {
289  /*
290  * If it's a btree index, we can use its opfamily OIDs
291  * directly as the sort ordering opfamily OIDs.
292  */
293  Assert(amroutine->amcanorder);
294 
295  info->sortopfamily = info->opfamily;
296  info->reverse_sort = (bool *) palloc(sizeof(bool) * nkeycolumns);
297  info->nulls_first = (bool *) palloc(sizeof(bool) * nkeycolumns);
298 
299  for (i = 0; i < nkeycolumns; i++)
300  {
301  int16 opt = indexRelation->rd_indoption[i];
302 
303  info->reverse_sort[i] = (opt & INDOPTION_DESC) != 0;
304  info->nulls_first[i] = (opt & INDOPTION_NULLS_FIRST) != 0;
305  }
306  }
307  else if (amroutine->amcanorder)
308  {
309  /*
310  * Otherwise, identify the corresponding btree opfamilies by
311  * trying to map this index's "<" operators into btree. Since
312  * "<" uniquely defines the behavior of a sort order, this is
313  * a sufficient test.
314  *
315  * XXX This method is rather slow and also requires the
316  * undesirable assumption that the other index AM numbers its
317  * strategies the same as btree. It'd be better to have a way
318  * to explicitly declare the corresponding btree opfamily for
319  * each opfamily of the other index type. But given the lack
320  * of current or foreseeable amcanorder index types, it's not
321  * worth expending more effort on now.
322  */
323  info->sortopfamily = (Oid *) palloc(sizeof(Oid) * nkeycolumns);
324  info->reverse_sort = (bool *) palloc(sizeof(bool) * nkeycolumns);
325  info->nulls_first = (bool *) palloc(sizeof(bool) * nkeycolumns);
326 
327  for (i = 0; i < nkeycolumns; i++)
328  {
329  int16 opt = indexRelation->rd_indoption[i];
330  Oid ltopr;
331  Oid btopfamily;
332  Oid btopcintype;
333  int16 btstrategy;
334 
335  info->reverse_sort[i] = (opt & INDOPTION_DESC) != 0;
336  info->nulls_first[i] = (opt & INDOPTION_NULLS_FIRST) != 0;
337 
338  ltopr = get_opfamily_member(info->opfamily[i],
339  info->opcintype[i],
340  info->opcintype[i],
342  if (OidIsValid(ltopr) &&
344  &btopfamily,
345  &btopcintype,
346  &btstrategy) &&
347  btopcintype == info->opcintype[i] &&
348  btstrategy == BTLessStrategyNumber)
349  {
350  /* Successful mapping */
351  info->sortopfamily[i] = btopfamily;
352  }
353  else
354  {
355  /* Fail ... quietly treat index as unordered */
356  info->sortopfamily = NULL;
357  info->reverse_sort = NULL;
358  info->nulls_first = NULL;
359  break;
360  }
361  }
362  }
363  else
364  {
365  info->sortopfamily = NULL;
366  info->reverse_sort = NULL;
367  info->nulls_first = NULL;
368  }
369 
370  /*
371  * Fetch the index expressions and predicate, if any. We must
372  * modify the copies we obtain from the relcache to have the
373  * correct varno for the parent relation, so that they match up
374  * correctly against qual clauses.
375  */
376  info->indexprs = RelationGetIndexExpressions(indexRelation);
377  info->indpred = RelationGetIndexPredicate(indexRelation);
378  if (info->indexprs && varno != 1)
379  ChangeVarNodes((Node *) info->indexprs, 1, varno, 0);
380  if (info->indpred && varno != 1)
381  ChangeVarNodes((Node *) info->indpred, 1, varno, 0);
382 
383  /* Build targetlist using the completed indexprs data */
384  info->indextlist = build_index_tlist(root, info, relation);
385 
386  info->indrestrictinfo = NIL; /* set later, in indxpath.c */
387  info->predOK = false; /* set later, in indxpath.c */
388  info->unique = index->indisunique;
389  info->immediate = index->indimmediate;
390  info->hypothetical = false;
391 
392  /*
393  * Estimate the index size. If it's not a partial index, we lock
394  * the number-of-tuples estimate to equal the parent table; if it
395  * is partial then we have to use the same methods as we would for
396  * a table, except we can be sure that the index is not larger
397  * than the table.
398  */
399  if (info->indpred == NIL)
400  {
401  info->pages = RelationGetNumberOfBlocks(indexRelation);
402  info->tuples = rel->tuples;
403  }
404  else
405  {
406  double allvisfrac; /* dummy */
407 
408  estimate_rel_size(indexRelation, NULL,
409  &info->pages, &info->tuples, &allvisfrac);
410  if (info->tuples > rel->tuples)
411  info->tuples = rel->tuples;
412  }
413 
414  if (info->relam == BTREE_AM_OID)
415  {
416  /* For btrees, get tree height while we have the index open */
417  info->tree_height = _bt_getrootheight(indexRelation);
418  }
419  else
420  {
421  /* For other index types, just set it to "unknown" for now */
422  info->tree_height = -1;
423  }
424 
425  index_close(indexRelation, NoLock);
426 
427  /*
428  * We've historically used lcons() here. It'd make more sense to
429  * use lappend(), but that causes the planner to change behavior
430  * in cases where two indexes seem equally attractive. For now,
431  * stick with lcons() --- few tables should have so many indexes
432  * that the O(N^2) behavior of lcons() is really a problem.
433  */
434  indexinfos = lcons(info, indexinfos);
435  }
436 
437  list_free(indexoidlist);
438  }
439 
440  rel->indexlist = indexinfos;
441 
442  rel->statlist = get_relation_statistics(rel, relation);
443 
444  /* Grab foreign-table info using the relcache, while we have it */
445  if (relation->rd_rel->relkind == RELKIND_FOREIGN_TABLE)
446  {
448  rel->fdwroutine = GetFdwRoutineForRelation(relation, true);
449  }
450  else
451  {
452  rel->serverid = InvalidOid;
453  rel->fdwroutine = NULL;
454  }
455 
456  /* Collect info about relation's foreign keys, if relevant */
457  get_relation_foreign_keys(root, rel, relation, inhparent);
458 
459  /*
460  * Collect info about relation's partitioning scheme, if any. Only
461  * inheritance parents may be partitioned.
462  */
463  if (inhparent && relation->rd_rel->relkind == RELKIND_PARTITIONED_TABLE)
464  set_relation_partition_info(root, rel, relation);
465 
466  table_close(relation, NoLock);
467 
468  /*
469  * Allow a plugin to editorialize on the info we obtained from the
470  * catalogs. Actions might include altering the assumed relation size,
471  * removing an index, or adding a hypothetical index to the indexlist.
472  */
474  (*get_relation_info_hook) (root, relationObjectId, inhparent, rel);
475 }
signed short int16
Definition: c.h:362
#define NIL
Definition: pg_list.h:65
struct IndexAmRoutine * rd_indam
Definition: rel.h:188
List * statlist
Definition: pathnodes.h:702
int16 * rd_indoption
Definition: rel.h:193
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:167
static List * get_relation_statistics(RelOptInfo *rel, Relation relation)
Definition: plancat.c:1291
Oid * indexcollations
Definition: pathnodes.h:831
Relids * attr_needed
Definition: pathnodes.h:697
bool IsSystemRelation(Relation relation)
Definition: catalog.c:68
amgettuple_function amgettuple
Definition: amapi.h:272
int _bt_getrootheight(Relation rel)
Definition: nbtpage.c:604
int LOCKMODE
Definition: lockdefs.h:26
bool amcanorderbyop
Definition: amapi.h:221
#define RelationGetNumberOfAttributes(relation)
Definition: rel.h:462
List * indextlist
Definition: pathnodes.h:845
#define RelationGetForm(relation)
Definition: rel.h:450
double tuples
Definition: pathnodes.h:704
Oid reltablespace
Definition: pathnodes.h:693
Definition: nodes.h:528
Oid * sortopfamily
Definition: pathnodes.h:834
int errcode(int sqlerrcode)
Definition: elog.c:610
Oid reltablespace
Definition: pathnodes.h:818
bool IgnoreSystemIndexes
Definition: miscinit.c:79
#define FirstLowInvalidHeapAttributeNumber
Definition: sysattr.h:27
bool hypothetical
Definition: pathnodes.h:856
bool immediate
Definition: pathnodes.h:855
double tuples
Definition: pathnodes.h:823
Form_pg_class rd_rel
Definition: rel.h:109
unsigned int Oid
Definition: postgres_ext.h:31
bool RecoveryInProgress(void)
Definition: xlog.c:8076
int tree_height
Definition: pathnodes.h:824
#define OidIsValid(objectId)
Definition: c.h:652
bool amoptionalkey
Definition: amapi.h:229
double allvisfrac
Definition: pathnodes.h:705
signed int int32
Definition: c.h:363
List * RelationGetIndexPredicate(Relation relation)
Definition: relcache.c:4861
struct HeapTupleData * rd_indextuple
Definition: rel.h:176
TransactionId TransactionXmin
Definition: snapmgr.c:112
HeapTupleHeader t_data
Definition: htup.h:68
Definition: type.h:89
BlockNumber pages
Definition: pathnodes.h:822
bool index_can_return(Relation indexRelation, int attno)
Definition: indexam.c:729
Form_pg_index rd_index
Definition: rel.h:174
RelOptInfo * rel
Definition: pathnodes.h:819
bool amoptionalkey
Definition: pathnodes.h:860
amgetbitmap_function amgetbitmap
Definition: amapi.h:273
Oid * rd_indcollation
Definition: rel.h:199
#define ERROR
Definition: elog.h:43
bool(* scan_bitmap_next_block)(TableScanDesc scan, struct TBMIterateResult *tbmres)
Definition: tableam.h:660
amcostestimate_function amcostestimate
Definition: amapi.h:264
#define NoLock
Definition: lockdefs.h:34
bool amcanorderbyop
Definition: pathnodes.h:859
List * RelationGetIndexExpressions(Relation relation)
Definition: relcache.c:4748
PlannerGlobal * glob
Definition: pathnodes.h:179
struct FdwRoutine * fdwroutine
Definition: pathnodes.h:717
Oid get_opfamily_member(Oid opfamily, Oid lefttype, Oid righttype, int16 strategy)
Definition: lsyscache.c:164
static void set_relation_partition_info(PlannerInfo *root, RelOptInfo *rel, Relation relation)
Definition: plancat.c:2121
get_relation_info_hook_type get_relation_info_hook
Definition: plancat.c:60
Oid * rd_opfamily
Definition: rel.h:189
void estimate_rel_size(Relation rel, int32 *attr_widths, BlockNumber *pages, double *tuples, double *allvisfrac)
Definition: plancat.c:949
void(* amcostestimate)()
Definition: pathnodes.h:867
bool amhasgetbitmap
Definition: pathnodes.h:864
bool amcanparallel
Definition: amapi.h:241
bool TransactionIdPrecedes(TransactionId id1, TransactionId id2)
Definition: transam.c:300
Index relid
Definition: pathnodes.h:692
RangeTblEntry ** simple_rte_array
Definition: pathnodes.h:209
Oid serverid
Definition: pathnodes.h:713
FormData_pg_index * Form_pg_index
Definition: pg_index.h:68
bool amsearchnulls
Definition: amapi.h:233
List * indrestrictinfo
Definition: pathnodes.h:847
void * palloc0(Size size)
Definition: mcxt.c:981
int rel_parallel_workers
Definition: pathnodes.h:710
const struct TableAmRoutine * rd_tableam
Definition: rel.h:171
#define RelationGetNumberOfBlocks(reln)
Definition: bufmgr.h:211
unsigned int Index
Definition: c.h:483
List * indexlist
Definition: pathnodes.h:701
bool amsearcharray
Definition: amapi.h:231
bool amhasgettuple
Definition: pathnodes.h:863
#define InvalidOid
Definition: postgres_ext.h:36
#define ereport(elevel,...)
Definition: elog.h:144
List * lcons(void *datum, List *list)
Definition: list.c:453
#define makeNode(_type_)
Definition: nodes.h:576
BlockNumber pages
Definition: pathnodes.h:703
#define Assert(condition)
Definition: c.h:746
static void get_relation_foreign_keys(PlannerInfo *root, RelOptInfo *rel, Relation relation, bool inhparent)
Definition: plancat.c:488
#define HeapTupleHeaderGetXmin(tup)
Definition: htup_details.h:313
Oid GetForeignServerIdByRelId(Oid relid)
Definition: foreign.c:340
bool get_ordering_op_properties(Oid opno, Oid *opfamily, Oid *opcintype, int16 *strategy)
Definition: lsyscache.c:205
bool amsearcharray
Definition: pathnodes.h:861
bool amcanorder
Definition: amapi.h:219
int nkeycolumns
Definition: pathnodes.h:828
#define RelationNeedsWAL(relation)
Definition: rel.h:562
List * RelationGetIndexList(Relation relation)
Definition: relcache.c:4514
Oid * opcintype
Definition: pathnodes.h:833
Bitmapset * Relids
Definition: pathnodes.h:28
void index_close(Relation relation, LOCKMODE lockmode)
Definition: indexam.c:158
Oid * opfamily
Definition: pathnodes.h:832
AttrNumber max_attr
Definition: pathnodes.h:696
void * palloc(Size size)
Definition: mcxt.c:950
int errmsg(const char *fmt,...)
Definition: elog.c:821
FdwRoutine * GetFdwRoutineForRelation(Relation relation, bool makecopy)
Definition: foreign.c:427
void list_free(List *list)
Definition: list.c:1376
int i
void ChangeVarNodes(Node *node, int rt_index, int new_index, int sublevels_up)
Definition: rewriteManip.c:610
#define RelationGetParallelWorkers(relation, defaultpw)
Definition: rel.h:359
static List * build_index_tlist(PlannerInfo *root, IndexOptInfo *index, Relation heapRelation)
Definition: plancat.c:1701
int * indexkeys
Definition: pathnodes.h:829
bool * canreturn
Definition: pathnodes.h:838
bytea ** RelationGetIndexAttOptions(Relation relation, bool copy)
Definition: relcache.c:5436
bool amsearchnulls
Definition: pathnodes.h:862
Oid * rd_opcintype
Definition: rel.h:190
bool * nulls_first
Definition: pathnodes.h:836
bool * reverse_sort
Definition: pathnodes.h:835
bytea ** opclassoptions
Definition: pathnodes.h:837
#define BTLessStrategyNumber
Definition: stratnum.h:29
List * indpred
Definition: pathnodes.h:843
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
int32 * attr_widths
Definition: pathnodes.h:698
Definition: pg_list.h:50
#define RelationGetRelid(relation)
Definition: rel.h:456
Relation index_open(Oid relationId, LOCKMODE lockmode)
Definition: indexam.c:132
bool amcanparallel
Definition: pathnodes.h:865
#define lfirst_oid(lc)
Definition: pg_list.h:171
List * indexprs
Definition: pathnodes.h:842
bool transientPlan
Definition: pathnodes.h:137
AttrNumber min_attr
Definition: pathnodes.h:695

◆ get_relation_statistics()

static List * get_relation_statistics ( RelOptInfo rel,
Relation  relation 
)
static

Definition at line 1291 of file plancat.c.

References bms_add_member(), bms_copy(), bms_free(), elog, ERROR, GETSTRUCT, HeapTupleIsValid, i, StatisticExtInfo::keys, StatisticExtInfo::kind, lappend(), lfirst_oid, list_free(), makeNode, NIL, ObjectIdGetDatum, StatisticExtInfo::rel, RelationGetStatExtList(), ReleaseSysCache(), SearchSysCache1(), statext_is_kind_built(), STATEXTDATASTXOID, STATEXTOID, and StatisticExtInfo::statOid.

Referenced by get_relation_info().

1292 {
1293  List *statoidlist;
1294  List *stainfos = NIL;
1295  ListCell *l;
1296 
1297  statoidlist = RelationGetStatExtList(relation);
1298 
1299  foreach(l, statoidlist)
1300  {
1301  Oid statOid = lfirst_oid(l);
1302  Form_pg_statistic_ext staForm;
1303  HeapTuple htup;
1304  HeapTuple dtup;
1305  Bitmapset *keys = NULL;
1306  int i;
1307 
1308  htup = SearchSysCache1(STATEXTOID, ObjectIdGetDatum(statOid));
1309  if (!HeapTupleIsValid(htup))
1310  elog(ERROR, "cache lookup failed for statistics object %u", statOid);
1311  staForm = (Form_pg_statistic_ext) GETSTRUCT(htup);
1312 
1314  if (!HeapTupleIsValid(dtup))
1315  elog(ERROR, "cache lookup failed for statistics object %u", statOid);
1316 
1317  /*
1318  * First, build the array of columns covered. This is ultimately
1319  * wasted if no stats within the object have actually been built, but
1320  * it doesn't seem worth troubling over that case.
1321  */
1322  for (i = 0; i < staForm->stxkeys.dim1; i++)
1323  keys = bms_add_member(keys, staForm->stxkeys.values[i]);
1324 
1325  /* add one StatisticExtInfo for each kind built */
1326  if (statext_is_kind_built(dtup, STATS_EXT_NDISTINCT))
1327  {
1329 
1330  info->statOid = statOid;
1331  info->rel = rel;
1332  info->kind = STATS_EXT_NDISTINCT;
1333  info->keys = bms_copy(keys);
1334 
1335  stainfos = lappend(stainfos, info);
1336  }
1337 
1338  if (statext_is_kind_built(dtup, STATS_EXT_DEPENDENCIES))
1339  {
1341 
1342  info->statOid = statOid;
1343  info->rel = rel;
1344  info->kind = STATS_EXT_DEPENDENCIES;
1345  info->keys = bms_copy(keys);
1346 
1347  stainfos = lappend(stainfos, info);
1348  }
1349 
1350  if (statext_is_kind_built(dtup, STATS_EXT_MCV))
1351  {
1353 
1354  info->statOid = statOid;
1355  info->rel = rel;
1356  info->kind = STATS_EXT_MCV;
1357  info->keys = bms_copy(keys);
1358 
1359  stainfos = lappend(stainfos, info);
1360  }
1361 
1362  ReleaseSysCache(htup);
1363  ReleaseSysCache(dtup);
1364  bms_free(keys);
1365  }
1366 
1367  list_free(statoidlist);
1368 
1369  return stainfos;
1370 }
#define NIL
Definition: pg_list.h:65
#define GETSTRUCT(TUP)
Definition: htup_details.h:655
Bitmapset * bms_copy(const Bitmapset *a)
Definition: bitmapset.c:74
bool statext_is_kind_built(HeapTuple htup, char type)
unsigned int Oid
Definition: postgres_ext.h:31
#define ObjectIdGetDatum(X)
Definition: postgres.h:507
#define ERROR
Definition: elog.h:43
RelOptInfo * rel
Definition: pathnodes.h:912
List * lappend(List *list, void *datum)
Definition: list.c:321
HeapTuple SearchSysCache1(int cacheId, Datum key1)
Definition: syscache.c:1116
void ReleaseSysCache(HeapTuple tuple)
Definition: syscache.c:1164
void bms_free(Bitmapset *a)
Definition: bitmapset.c:208
#define makeNode(_type_)
Definition: nodes.h:576
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
Bitmapset * bms_add_member(Bitmapset *a, int x)
Definition: bitmapset.c:736
List * RelationGetStatExtList(Relation relation)
Definition: relcache.c:4633
Bitmapset * keys
Definition: pathnodes.h:914
void list_free(List *list)
Definition: list.c:1376
#define elog(elevel,...)
Definition: elog.h:214
int i
Definition: pg_list.h:50
FormData_pg_statistic_ext * Form_pg_statistic_ext
#define lfirst_oid(lc)
Definition: pg_list.h:171

◆ has_row_triggers()

bool has_row_triggers ( PlannerInfo root,
Index  rti,
CmdType  event 
)

Definition at line 2056 of file plancat.c.

References CMD_DELETE, CMD_INSERT, CMD_UPDATE, elog, ERROR, NoLock, planner_rt_fetch, RangeTblEntry::relid, table_close(), table_open(), TriggerDesc::trig_delete_after_row, TriggerDesc::trig_delete_before_row, TriggerDesc::trig_insert_after_row, TriggerDesc::trig_insert_before_row, TriggerDesc::trig_update_after_row, TriggerDesc::trig_update_before_row, and RelationData::trigdesc.

Referenced by make_modifytable().

2057 {
2058  RangeTblEntry *rte = planner_rt_fetch(rti, root);
2059  Relation relation;
2060  TriggerDesc *trigDesc;
2061  bool result = false;
2062 
2063  /* Assume we already have adequate lock */
2064  relation = table_open(rte->relid, NoLock);
2065 
2066  trigDesc = relation->trigdesc;
2067  switch (event)
2068  {
2069  case CMD_INSERT:
2070  if (trigDesc &&
2071  (trigDesc->trig_insert_after_row ||
2072  trigDesc->trig_insert_before_row))
2073  result = true;
2074  break;
2075  case CMD_UPDATE:
2076  if (trigDesc &&
2077  (trigDesc->trig_update_after_row ||
2078  trigDesc->trig_update_before_row))
2079  result = true;
2080  break;
2081  case CMD_DELETE:
2082  if (trigDesc &&
2083  (trigDesc->trig_delete_after_row ||
2084  trigDesc->trig_delete_before_row))
2085  result = true;
2086  break;
2087  default:
2088  elog(ERROR, "unrecognized CmdType: %d", (int) event);
2089  break;
2090  }
2091 
2092  table_close(relation, NoLock);
2093  return result;
2094 }
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:167
#define ERROR
Definition: elog.h:43
#define planner_rt_fetch(rti, root)
Definition: pathnodes.h:372
TriggerDesc * trigdesc
Definition: rel.h:115
bool trig_delete_after_row
Definition: reltrigger.h:67
#define NoLock
Definition: lockdefs.h:34
bool trig_update_before_row
Definition: reltrigger.h:61
bool trig_insert_after_row
Definition: reltrigger.h:57
bool trig_update_after_row
Definition: reltrigger.h:62
bool trig_insert_before_row
Definition: reltrigger.h:56
#define elog(elevel,...)
Definition: elog.h:214
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
bool trig_delete_before_row
Definition: reltrigger.h:66

◆ has_stored_generated_columns()

bool has_stored_generated_columns ( PlannerInfo root,
Index  rti 
)

Definition at line 2097 of file plancat.c.

References TupleDescData::constr, TupleConstr::has_generated_stored, NoLock, planner_rt_fetch, RelationGetDescr, RangeTblEntry::relid, table_close(), and table_open().

Referenced by make_modifytable().

2098 {
2099  RangeTblEntry *rte = planner_rt_fetch(rti, root);
2100  Relation relation;
2101  TupleDesc tupdesc;
2102  bool result = false;
2103 
2104  /* Assume we already have adequate lock */
2105  relation = table_open(rte->relid, NoLock);
2106 
2107  tupdesc = RelationGetDescr(relation);
2108  result = tupdesc->constr && tupdesc->constr->has_generated_stored;
2109 
2110  table_close(relation, NoLock);
2111 
2112  return result;
2113 }
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:167
#define RelationGetDescr(relation)
Definition: rel.h:482
bool has_generated_stored
Definition: tupdesc.h:45
#define planner_rt_fetch(rti, root)
Definition: pathnodes.h:372
#define NoLock
Definition: lockdefs.h:34
TupleConstr * constr
Definition: tupdesc.h:85
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39

◆ has_unique_index()

bool has_unique_index ( RelOptInfo rel,
AttrNumber  attno 
)

Definition at line 2024 of file plancat.c.

References IndexOptInfo::indexkeys, RelOptInfo::indexlist, IndexOptInfo::indpred, lfirst, NIL, IndexOptInfo::nkeycolumns, IndexOptInfo::predOK, and IndexOptInfo::unique.

Referenced by examine_variable().

2025 {
2026  ListCell *ilist;
2027 
2028  foreach(ilist, rel->indexlist)
2029  {
2030  IndexOptInfo *index = (IndexOptInfo *) lfirst(ilist);
2031 
2032  /*
2033  * Note: ignore partial indexes, since they don't allow us to conclude
2034  * that all attr values are distinct, *unless* they are marked predOK
2035  * which means we know the index's predicate is satisfied by the
2036  * query. We don't take any interest in expressional indexes either.
2037  * Also, a multicolumn unique index doesn't allow us to conclude that
2038  * just the specified attr is unique.
2039  */
2040  if (index->unique &&
2041  index->nkeycolumns == 1 &&
2042  index->indexkeys[0] == attno &&
2043  (index->indpred == NIL || index->predOK))
2044  return true;
2045  }
2046  return false;
2047 }
#define NIL
Definition: pg_list.h:65
Definition: type.h:89
List * indexlist
Definition: pathnodes.h:701
#define lfirst(lc)
Definition: pg_list.h:169
int nkeycolumns
Definition: pathnodes.h:828
int * indexkeys
Definition: pathnodes.h:829
List * indpred
Definition: pathnodes.h:843

◆ infer_arbiter_indexes()

List* infer_arbiter_indexes ( PlannerInfo root)

Definition at line 601 of file plancat.c.

References OnConflictExpr::action, OnConflictExpr::arbiterElems, OnConflictExpr::arbiterWhere, bms_add_member(), bms_equal(), OnConflictExpr::constraint, ereport, errcode(), errmsg(), ERROR, InferenceElem::expr, FirstLowInvalidHeapAttributeNumber, get_constraint_index(), index_close(), index_open(), infer_collation_opclass_match(), InferenceElem::infercollid, InferenceElem::inferopclass, InvalidOid, IsA, lappend(), lappend_oid(), lfirst, lfirst_oid, list_difference(), list_free(), list_member(), next, NIL, NoLock, Query::onConflict, ONCONFLICT_UPDATE, PlannerInfo::parse, predicate_implied_by(), RelationData::rd_index, RelationGetIndexExpressions(), RelationGetIndexList(), RelationGetIndexPredicate(), RangeTblEntry::relid, RangeTblEntry::rellockmode, Query::resultRelation, rt_fetch, Query::rtable, table_close(), table_open(), and Var::varattno.

Referenced by make_modifytable().

602 {
603  OnConflictExpr *onconflict = root->parse->onConflict;
604 
605  /* Iteration state */
606  RangeTblEntry *rte;
607  Relation relation;
608  Oid indexOidFromConstraint = InvalidOid;
609  List *indexList;
610  ListCell *l;
611 
612  /* Normalized inference attributes and inference expressions: */
613  Bitmapset *inferAttrs = NULL;
614  List *inferElems = NIL;
615 
616  /* Results */
617  List *results = NIL;
618 
619  /*
620  * Quickly return NIL for ON CONFLICT DO NOTHING without an inference
621  * specification or named constraint. ON CONFLICT DO UPDATE statements
622  * must always provide one or the other (but parser ought to have caught
623  * that already).
624  */
625  if (onconflict->arbiterElems == NIL &&
626  onconflict->constraint == InvalidOid)
627  return NIL;
628 
629  /*
630  * We need not lock the relation since it was already locked, either by
631  * the rewriter or when expand_inherited_rtentry() added it to the query's
632  * rangetable.
633  */
634  rte = rt_fetch(root->parse->resultRelation, root->parse->rtable);
635 
636  relation = table_open(rte->relid, NoLock);
637 
638  /*
639  * Build normalized/BMS representation of plain indexed attributes, as
640  * well as a separate list of expression items. This simplifies matching
641  * the cataloged definition of indexes.
642  */
643  foreach(l, onconflict->arbiterElems)
644  {
645  InferenceElem *elem = (InferenceElem *) lfirst(l);
646  Var *var;
647  int attno;
648 
649  if (!IsA(elem->expr, Var))
650  {
651  /* If not a plain Var, just shove it in inferElems for now */
652  inferElems = lappend(inferElems, elem->expr);
653  continue;
654  }
655 
656  var = (Var *) elem->expr;
657  attno = var->varattno;
658 
659  if (attno == 0)
660  ereport(ERROR,
661  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
662  errmsg("whole row unique index inference specifications are not supported")));
663 
664  inferAttrs = bms_add_member(inferAttrs,
666  }
667 
668  /*
669  * Lookup named constraint's index. This is not immediately returned
670  * because some additional sanity checks are required.
671  */
672  if (onconflict->constraint != InvalidOid)
673  {
674  indexOidFromConstraint = get_constraint_index(onconflict->constraint);
675 
676  if (indexOidFromConstraint == InvalidOid)
677  ereport(ERROR,
678  (errcode(ERRCODE_WRONG_OBJECT_TYPE),
679  errmsg("constraint in ON CONFLICT clause has no associated index")));
680  }
681 
682  /*
683  * Using that representation, iterate through the list of indexes on the
684  * target relation to try and find a match
685  */
686  indexList = RelationGetIndexList(relation);
687 
688  foreach(l, indexList)
689  {
690  Oid indexoid = lfirst_oid(l);
691  Relation idxRel;
692  Form_pg_index idxForm;
693  Bitmapset *indexedAttrs;
694  List *idxExprs;
695  List *predExprs;
696  AttrNumber natt;
697  ListCell *el;
698 
699  /*
700  * Extract info from the relation descriptor for the index. Obtain
701  * the same lock type that the executor will ultimately use.
702  *
703  * Let executor complain about !indimmediate case directly, because
704  * enforcement needs to occur there anyway when an inference clause is
705  * omitted.
706  */
707  idxRel = index_open(indexoid, rte->rellockmode);
708  idxForm = idxRel->rd_index;
709 
710  if (!idxForm->indisvalid)
711  goto next;
712 
713  /*
714  * Note that we do not perform a check against indcheckxmin (like e.g.
715  * get_relation_info()) here to eliminate candidates, because
716  * uniqueness checking only cares about the most recently committed
717  * tuple versions.
718  */
719 
720  /*
721  * Look for match on "ON constraint_name" variant, which may not be
722  * unique constraint. This can only be a constraint name.
723  */
724  if (indexOidFromConstraint == idxForm->indexrelid)
725  {
726  if (!idxForm->indisunique && onconflict->action == ONCONFLICT_UPDATE)
727  ereport(ERROR,
728  (errcode(ERRCODE_WRONG_OBJECT_TYPE),
729  errmsg("ON CONFLICT DO UPDATE not supported with exclusion constraints")));
730 
731  results = lappend_oid(results, idxForm->indexrelid);
732  list_free(indexList);
733  index_close(idxRel, NoLock);
734  table_close(relation, NoLock);
735  return results;
736  }
737  else if (indexOidFromConstraint != InvalidOid)
738  {
739  /* No point in further work for index in named constraint case */
740  goto next;
741  }
742 
743  /*
744  * Only considering conventional inference at this point (not named
745  * constraints), so index under consideration can be immediately
746  * skipped if it's not unique
747  */
748  if (!idxForm->indisunique)
749  goto next;
750 
751  /* Build BMS representation of plain (non expression) index attrs */
752  indexedAttrs = NULL;
753  for (natt = 0; natt < idxForm->indnkeyatts; natt++)
754  {
755  int attno = idxRel->rd_index->indkey.values[natt];
756 
757  if (attno != 0)
758  indexedAttrs = bms_add_member(indexedAttrs,
760  }
761 
762  /* Non-expression attributes (if any) must match */
763  if (!bms_equal(indexedAttrs, inferAttrs))
764  goto next;
765 
766  /* Expression attributes (if any) must match */
767  idxExprs = RelationGetIndexExpressions(idxRel);
768  foreach(el, onconflict->arbiterElems)
769  {
770  InferenceElem *elem = (InferenceElem *) lfirst(el);
771 
772  /*
773  * Ensure that collation/opclass aspects of inference expression
774  * element match. Even though this loop is primarily concerned
775  * with matching expressions, it is a convenient point to check
776  * this for both expressions and ordinary (non-expression)
777  * attributes appearing as inference elements.
778  */
779  if (!infer_collation_opclass_match(elem, idxRel, idxExprs))
780  goto next;
781 
782  /*
783  * Plain Vars don't factor into count of expression elements, and
784  * the question of whether or not they satisfy the index
785  * definition has already been considered (they must).
786  */
787  if (IsA(elem->expr, Var))
788  continue;
789 
790  /*
791  * Might as well avoid redundant check in the rare cases where
792  * infer_collation_opclass_match() is required to do real work.
793  * Otherwise, check that element expression appears in cataloged
794  * index definition.
795  */
796  if (elem->infercollid != InvalidOid ||
797  elem->inferopclass != InvalidOid ||
798  list_member(idxExprs, elem->expr))
799  continue;
800 
801  goto next;
802  }
803 
804  /*
805  * Now that all inference elements were matched, ensure that the
806  * expression elements from inference clause are not missing any
807  * cataloged expressions. This does the right thing when unique
808  * indexes redundantly repeat the same attribute, or if attributes
809  * redundantly appear multiple times within an inference clause.
810  */
811  if (list_difference(idxExprs, inferElems) != NIL)
812  goto next;
813 
814  /*
815  * If it's a partial index, its predicate must be implied by the ON
816  * CONFLICT's WHERE clause.
817  */
818  predExprs = RelationGetIndexPredicate(idxRel);
819 
820  if (!predicate_implied_by(predExprs, (List *) onconflict->arbiterWhere, false))
821  goto next;
822 
823  results = lappend_oid(results, idxForm->indexrelid);
824 next:
825  index_close(idxRel, NoLock);
826  }
827 
828  list_free(indexList);
829  table_close(relation, NoLock);
830 
831  if (results == NIL)
832  ereport(ERROR,
833  (errcode(ERRCODE_INVALID_COLUMN_REFERENCE),
834  errmsg("there is no unique or exclusion constraint matching the ON CONFLICT specification")));
835 
836  return results;
837 }
#define NIL
Definition: pg_list.h:65
#define IsA(nodeptr, _type_)
Definition: nodes.h:579
Query * parse
Definition: pathnodes.h:177
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:167
static int32 next
Definition: blutils.c:219
OnConflictExpr * onConflict
Definition: parsenodes.h:144
int resultRelation
Definition: parsenodes.h:122
static bool infer_collation_opclass_match(InferenceElem *elem, Relation idxRel, List *idxExprs)
Definition: plancat.c:867
int errcode(int sqlerrcode)
Definition: elog.c:610
AttrNumber varattno
Definition: primnodes.h:186
#define FirstLowInvalidHeapAttributeNumber
Definition: sysattr.h:27
unsigned int Oid
Definition: postgres_ext.h:31
Definition: primnodes.h:181
List * lappend_oid(List *list, Oid datum)
Definition: list.c:357
List * RelationGetIndexPredicate(Relation relation)
Definition: relcache.c:4861
List * arbiterElems
Definition: primnodes.h:1532
Form_pg_index rd_index
Definition: rel.h:174
List * rtable
Definition: parsenodes.h:137
#define ERROR
Definition: elog.h:43
bool list_member(const List *list, const void *datum)
Definition: list.c:613
#define NoLock
Definition: lockdefs.h:34
List * RelationGetIndexExpressions(Relation relation)
Definition: relcache.c:4748
#define rt_fetch(rangetable_index, rangetable)
Definition: parsetree.h:31
List * lappend(List *list, void *datum)
Definition: list.c:321
OnConflictAction action
Definition: primnodes.h:1529
FormData_pg_index * Form_pg_index
Definition: pg_index.h:68
#define InvalidOid
Definition: postgres_ext.h:36
#define ereport(elevel,...)
Definition: elog.h:144
#define lfirst(lc)
Definition: pg_list.h:169
List * list_difference(const List *list1, const List *list2)
Definition: list.c:1076
Bitmapset * bms_add_member(Bitmapset *a, int x)
Definition: bitmapset.c:736
List * RelationGetIndexList(Relation relation)
Definition: relcache.c:4514
void index_close(Relation relation, LOCKMODE lockmode)
Definition: indexam.c:158
Node * arbiterWhere
Definition: primnodes.h:1534
int errmsg(const char *fmt,...)
Definition: elog.c:821
void list_free(List *list)
Definition: list.c:1376
Oid get_constraint_index(Oid constraintId)
Definition: pg_depend.c:940
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
bool predicate_implied_by(List *predicate_list, List *clause_list, bool weak)
Definition: predtest.c:151
Definition: pg_list.h:50
int16 AttrNumber
Definition: attnum.h:21
Relation index_open(Oid relationId, LOCKMODE lockmode)
Definition: indexam.c:132
#define lfirst_oid(lc)
Definition: pg_list.h:171
bool bms_equal(const Bitmapset *a, const Bitmapset *b)
Definition: bitmapset.c:94

◆ infer_collation_opclass_match()

static bool infer_collation_opclass_match ( InferenceElem elem,
Relation  idxRel,
List idxExprs 
)
static

Definition at line 867 of file plancat.c.

References equal(), InferenceElem::expr, get_opclass_family(), get_opclass_input_type(), InferenceElem::infercollid, InferenceElem::inferopclass, InvalidOid, IsA, list_nth(), TupleDescData::natts, RelationData::rd_att, RelationData::rd_indcollation, RelationData::rd_index, RelationData::rd_opcintype, and RelationData::rd_opfamily.

Referenced by infer_arbiter_indexes().

869 {
870  AttrNumber natt;
871  Oid inferopfamily = InvalidOid; /* OID of opclass opfamily */
872  Oid inferopcinputtype = InvalidOid; /* OID of opclass input type */
873  int nplain = 0; /* # plain attrs observed */
874 
875  /*
876  * If inference specification element lacks collation/opclass, then no
877  * need to check for exact match.
878  */
879  if (elem->infercollid == InvalidOid && elem->inferopclass == InvalidOid)
880  return true;
881 
882  /*
883  * Lookup opfamily and input type, for matching indexes
884  */
885  if (elem->inferopclass)
886  {
887  inferopfamily = get_opclass_family(elem->inferopclass);
888  inferopcinputtype = get_opclass_input_type(elem->inferopclass);
889  }
890 
891  for (natt = 1; natt <= idxRel->rd_att->natts; natt++)
892  {
893  Oid opfamily = idxRel->rd_opfamily[natt - 1];
894  Oid opcinputtype = idxRel->rd_opcintype[natt - 1];
895  Oid collation = idxRel->rd_indcollation[natt - 1];
896  int attno = idxRel->rd_index->indkey.values[natt - 1];
897 
898  if (attno != 0)
899  nplain++;
900 
901  if (elem->inferopclass != InvalidOid &&
902  (inferopfamily != opfamily || inferopcinputtype != opcinputtype))
903  {
904  /* Attribute needed to match opclass, but didn't */
905  continue;
906  }
907 
908  if (elem->infercollid != InvalidOid &&
909  elem->infercollid != collation)
910  {
911  /* Attribute needed to match collation, but didn't */
912  continue;
913  }
914 
915  /* If one matching index att found, good enough -- return true */
916  if (IsA(elem->expr, Var))
917  {
918  if (((Var *) elem->expr)->varattno == attno)
919  return true;
920  }
921  else if (attno == 0)
922  {
923  Node *nattExpr = list_nth(idxExprs, (natt - 1) - nplain);
924 
925  /*
926  * Note that unlike routines like match_index_to_operand() we
927  * don't need to care about RelabelType. Neither the index
928  * definition nor the inference clause should contain them.
929  */
930  if (equal(elem->expr, nattExpr))
931  return true;
932  }
933  }
934 
935  return false;
936 }
#define IsA(nodeptr, _type_)
Definition: nodes.h:579
bool equal(const void *a, const void *b)
Definition: equalfuncs.c:3032
Definition: nodes.h:528
unsigned int Oid
Definition: postgres_ext.h:31
Definition: primnodes.h:181
Form_pg_index rd_index
Definition: rel.h:174
Oid * rd_indcollation
Definition: rel.h:199
static void * list_nth(const List *list, int n)
Definition: pg_list.h:266
Oid * rd_opfamily
Definition: rel.h:189
TupleDesc rd_att
Definition: rel.h:110
#define InvalidOid
Definition: postgres_ext.h:36
Oid get_opclass_family(Oid opclass)
Definition: lsyscache.c:1129
Oid * rd_opcintype
Definition: rel.h:190
int16 AttrNumber
Definition: attnum.h:21
Oid get_opclass_input_type(Oid opclass)
Definition: lsyscache.c:1151

◆ join_selectivity()

Selectivity join_selectivity ( PlannerInfo root,
Oid  operatorid,
List args,
Oid  inputcollid,
JoinType  jointype,
SpecialJoinInfo sjinfo 
)

Definition at line 1802 of file plancat.c.

References DatumGetFloat8, elog, ERROR, get_oprjoin(), Int16GetDatum, ObjectIdGetDatum, OidFunctionCall5Coll(), and PointerGetDatum.

Referenced by clause_selectivity(), rowcomparesel(), and test_support_func().

1808 {
1809  RegProcedure oprjoin = get_oprjoin(operatorid);
1810  float8 result;
1811 
1812  /*
1813  * if the oprjoin procedure is missing for whatever reason, use a
1814  * selectivity of 0.5
1815  */
1816  if (!oprjoin)
1817  return (Selectivity) 0.5;
1818 
1819  result = DatumGetFloat8(OidFunctionCall5Coll(oprjoin,
1820  inputcollid,
1821  PointerGetDatum(root),
1822  ObjectIdGetDatum(operatorid),
1823  PointerGetDatum(args),
1824  Int16GetDatum(jointype),
1825  PointerGetDatum(sjinfo)));
1826 
1827  if (result < 0.0 || result > 1.0)
1828  elog(ERROR, "invalid join selectivity: %f", result);
1829 
1830  return (Selectivity) result;
1831 }
RegProcedure get_oprjoin(Oid opno)
Definition: lsyscache.c:1493
#define PointerGetDatum(X)
Definition: postgres.h:556
regproc RegProcedure
Definition: c.h:519
#define Int16GetDatum(X)
Definition: postgres.h:451
double Selectivity
Definition: nodes.h:661
#define ObjectIdGetDatum(X)
Definition: postgres.h:507
#define ERROR
Definition: elog.h:43
double float8
Definition: c.h:499
#define DatumGetFloat8(X)
Definition: postgres.h:714
Datum OidFunctionCall5Coll(Oid functionId, Oid collation, Datum arg1, Datum arg2, Datum arg3, Datum arg4, Datum arg5)
Definition: fmgr.c:1456
#define elog(elevel,...)
Definition: elog.h:214

◆ relation_excluded_by_constraints()

bool relation_excluded_by_constraints ( PlannerInfo root,
RelOptInfo rel,
RangeTblEntry rte 
)

Definition at line 1384 of file plancat.c.

References Assert, RelOptInfo::baserestrictinfo, RestrictInfo::clause, constraint_exclusion, CONSTRAINT_EXCLUSION_OFF, CONSTRAINT_EXCLUSION_ON, CONSTRAINT_EXCLUSION_PARTITION, contain_mutable_functions(), DatumGetBool, get_relation_constraints(), RangeTblEntry::inh, INHKIND_NONE, PlannerInfo::inhTargetKind, IS_SIMPLE_REL, IsA, lappend(), lfirst, linitial, list_length(), NIL, PlannerInfo::parse, predicate_refuted_by(), RelOptInfo::relid, RangeTblEntry::relid, RangeTblEntry::relkind, RELOPT_BASEREL, RELOPT_OTHER_MEMBER_REL, RelOptInfo::reloptkind, Query::resultRelation, RTE_RELATION, and RangeTblEntry::rtekind.

Referenced by set_append_rel_size(), and set_rel_size().

1386 {
1387  bool include_noinherit;
1388  bool include_notnull;
1389  bool include_partition = false;
1390  List *safe_restrictions;
1391  List *constraint_pred;
1392  List *safe_constraints;
1393  ListCell *lc;
1394 
1395  /* As of now, constraint exclusion works only with simple relations. */
1396  Assert(IS_SIMPLE_REL(rel));
1397 
1398  /*
1399  * If there are no base restriction clauses, we have no hope of proving
1400  * anything below, so fall out quickly.
1401  */
1402  if (rel->baserestrictinfo == NIL)
1403  return false;
1404 
1405  /*
1406  * Regardless of the setting of constraint_exclusion, detect
1407  * constant-FALSE-or-NULL restriction clauses. Because const-folding will
1408  * reduce "anything AND FALSE" to just "FALSE", any such case should
1409  * result in exactly one baserestrictinfo entry. This doesn't fire very
1410  * often, but it seems cheap enough to be worth doing anyway. (Without
1411  * this, we'd miss some optimizations that 9.5 and earlier found via much
1412  * more roundabout methods.)
1413  */
1414  if (list_length(rel->baserestrictinfo) == 1)
1415  {
1417  Expr *clause = rinfo->clause;
1418 
1419  if (clause && IsA(clause, Const) &&
1420  (((Const *) clause)->constisnull ||
1421  !DatumGetBool(((Const *) clause)->constvalue)))
1422  return true;
1423  }
1424 
1425  /*
1426  * Skip further tests, depending on constraint_exclusion.
1427  */
1428  switch (constraint_exclusion)
1429  {
1431  /* In 'off' mode, never make any further tests */
1432  return false;
1433 
1435 
1436  /*
1437  * When constraint_exclusion is set to 'partition' we only handle
1438  * appendrel members. Normally, they are RELOPT_OTHER_MEMBER_REL
1439  * relations, but we also consider inherited target relations as
1440  * appendrel members for the purposes of constraint exclusion
1441  * (since, indeed, they were appendrel members earlier in
1442  * inheritance_planner).
1443  *
1444  * In both cases, partition pruning was already applied, so there
1445  * is no need to consider the rel's partition constraints here.
1446  */
1447  if (rel->reloptkind == RELOPT_OTHER_MEMBER_REL ||
1448  (rel->relid == root->parse->resultRelation &&
1449  root->inhTargetKind != INHKIND_NONE))
1450  break; /* appendrel member, so process it */
1451  return false;
1452 
1454 
1455  /*
1456  * In 'on' mode, always apply constraint exclusion. If we are
1457  * considering a baserel that is a partition (i.e., it was
1458  * directly named rather than expanded from a parent table), then
1459  * its partition constraints haven't been considered yet, so
1460  * include them in the processing here.
1461  */
1462  if (rel->reloptkind == RELOPT_BASEREL &&
1463  !(rel->relid == root->parse->resultRelation &&
1464  root->inhTargetKind != INHKIND_NONE))
1465  include_partition = true;
1466  break; /* always try to exclude */
1467  }
1468 
1469  /*
1470  * Check for self-contradictory restriction clauses. We dare not make
1471  * deductions with non-immutable functions, but any immutable clauses that
1472  * are self-contradictory allow us to conclude the scan is unnecessary.
1473  *
1474  * Note: strip off RestrictInfo because predicate_refuted_by() isn't
1475  * expecting to see any in its predicate argument.
1476  */
1477  safe_restrictions = NIL;
1478  foreach(lc, rel->baserestrictinfo)
1479  {
1480  RestrictInfo *rinfo = (RestrictInfo *) lfirst(lc);
1481 
1482  if (!contain_mutable_functions((Node *) rinfo->clause))
1483  safe_restrictions = lappend(safe_restrictions, rinfo->clause);
1484  }
1485 
1486  /*
1487  * We can use weak refutation here, since we're comparing restriction
1488  * clauses with restriction clauses.
1489  */
1490  if (predicate_refuted_by(safe_restrictions, safe_restrictions, true))
1491  return true;
1492 
1493  /*
1494  * Only plain relations have constraints, so stop here for other rtekinds.
1495  */
1496  if (rte->rtekind != RTE_RELATION)
1497  return false;
1498 
1499  /*
1500  * If we are scanning just this table, we can use NO INHERIT constraints,
1501  * but not if we're scanning its children too. (Note that partitioned
1502  * tables should never have NO INHERIT constraints; but it's not necessary
1503  * for us to assume that here.)
1504  */
1505  include_noinherit = !rte->inh;
1506 
1507  /*
1508  * Currently, attnotnull constraints must be treated as NO INHERIT unless
1509  * this is a partitioned table. In future we might track their
1510  * inheritance status more accurately, allowing this to be refined.
1511  */
1512  include_notnull = (!rte->inh || rte->relkind == RELKIND_PARTITIONED_TABLE);
1513 
1514  /*
1515  * Fetch the appropriate set of constraint expressions.
1516  */
1517  constraint_pred = get_relation_constraints(root, rte->relid, rel,
1518  include_noinherit,
1519  include_notnull,
1520  include_partition);
1521 
1522  /*
1523  * We do not currently enforce that CHECK constraints contain only
1524  * immutable functions, so it's necessary to check here. We daren't draw
1525  * conclusions from plan-time evaluation of non-immutable functions. Since
1526  * they're ANDed, we can just ignore any mutable constraints in the list,
1527  * and reason about the rest.
1528  */
1529  safe_constraints = NIL;
1530  foreach(lc, constraint_pred)
1531  {
1532  Node *pred = (Node *) lfirst(lc);
1533 
1534  if (!contain_mutable_functions(pred))
1535  safe_constraints = lappend(safe_constraints, pred);
1536  }
1537 
1538  /*
1539  * The constraints are effectively ANDed together, so we can just try to
1540  * refute the entire collection at once. This may allow us to make proofs
1541  * that would fail if we took them individually.
1542  *
1543  * Note: we use rel->baserestrictinfo, not safe_restrictions as might seem
1544  * an obvious optimization. Some of the clauses might be OR clauses that
1545  * have volatile and nonvolatile subclauses, and it's OK to make
1546  * deductions with the nonvolatile parts.
1547  *
1548  * We need strong refutation because we have to prove that the constraints
1549  * would yield false, not just NULL.
1550  */
1551  if (predicate_refuted_by(safe_constraints, rel->baserestrictinfo, false))
1552  return true;
1553 
1554  return false;
1555 }
#define NIL
Definition: pg_list.h:65
#define IsA(nodeptr, _type_)
Definition: nodes.h:579
Query * parse
Definition: pathnodes.h:177
RelOptKind reloptkind
Definition: pathnodes.h:661
List * baserestrictinfo
Definition: pathnodes.h:726
int constraint_exclusion
Definition: plancat.c:57
int resultRelation
Definition: parsenodes.h:122
Definition: nodes.h:528
#define IS_SIMPLE_REL(rel)
Definition: pathnodes.h:637
#define linitial(l)
Definition: pg_list.h:174
bool predicate_refuted_by(List *predicate_list, List *clause_list, bool weak)
Definition: predtest.c:221
#define DatumGetBool(X)
Definition: postgres.h:393
Index relid
Definition: pathnodes.h:692
List * lappend(List *list, void *datum)
Definition: list.c:321
Expr * clause
Definition: pathnodes.h:1984
#define Assert(condition)
Definition: c.h:746
#define lfirst(lc)
Definition: pg_list.h:169
InheritanceKind inhTargetKind
Definition: pathnodes.h:340
static int list_length(const List *l)
Definition: pg_list.h:149
RTEKind rtekind
Definition: parsenodes.h:977
static List * get_relation_constraints(PlannerInfo *root, Oid relationObjectId, RelOptInfo *rel, bool include_noinherit, bool include_notnull, bool include_partition)
Definition: plancat.c:1169
bool contain_mutable_functions(Node *clause)
Definition: clauses.c:645
Definition: pg_list.h:50

◆ restriction_selectivity()

Selectivity restriction_selectivity ( PlannerInfo root,
Oid  operatorid,
List args,
Oid  inputcollid,
int  varRelid 
)

Definition at line 1763 of file plancat.c.

References DatumGetFloat8, elog, ERROR, get_oprrest(), Int32GetDatum, ObjectIdGetDatum, OidFunctionCall4Coll(), and PointerGetDatum.

Referenced by clause_selectivity(), rowcomparesel(), and test_support_func().

1768 {
1769  RegProcedure oprrest = get_oprrest(operatorid);
1770  float8 result;
1771 
1772  /*
1773  * if the oprrest procedure is missing for whatever reason, use a
1774  * selectivity of 0.5
1775  */
1776  if (!oprrest)
1777  return (Selectivity) 0.5;
1778 
1779  result = DatumGetFloat8(OidFunctionCall4Coll(oprrest,
1780  inputcollid,
1781  PointerGetDatum(root),
1782  ObjectIdGetDatum(operatorid),
1783  PointerGetDatum(args),
1784  Int32GetDatum(varRelid)));
1785 
1786  if (result < 0.0 || result > 1.0)
1787  elog(ERROR, "invalid restriction selectivity: %f", result);
1788 
1789  return (Selectivity) result;
1790 }
#define PointerGetDatum(X)
Definition: postgres.h:556
regproc RegProcedure
Definition: c.h:519
double Selectivity
Definition: nodes.h:661
#define ObjectIdGetDatum(X)
Definition: postgres.h:507
#define ERROR
Definition: elog.h:43
double float8
Definition: c.h:499
RegProcedure get_oprrest(Oid opno)
Definition: lsyscache.c:1469
#define DatumGetFloat8(X)
Definition: postgres.h:714
Datum OidFunctionCall4Coll(Oid functionId, Oid collation, Datum arg1, Datum arg2, Datum arg3, Datum arg4)
Definition: fmgr.c:1445
#define Int32GetDatum(X)
Definition: postgres.h:479
#define elog(elevel,...)
Definition: elog.h:214

◆ set_baserel_partition_constraint()

static void set_baserel_partition_constraint ( Relation  relation,
RelOptInfo rel 
)
static

Definition at line 2322 of file plancat.c.

References ChangeVarNodes(), expression_planner(), RelOptInfo::partition_qual, RelationGetPartitionQual(), and RelOptInfo::relid.

Referenced by get_relation_constraints(), and set_relation_partition_info().

2323 {
2324  List *partconstr;
2325 
2326  if (rel->partition_qual) /* already done */
2327  return;
2328 
2329  /*
2330  * Run the partition quals through const-simplification similar to check
2331  * constraints. We skip canonicalize_qual, though, because partition
2332  * quals should be in canonical form already; also, since the qual is in
2333  * implicit-AND format, we'd have to explicitly convert it to explicit-AND
2334  * format and back again.
2335  */
2336  partconstr = RelationGetPartitionQual(relation);
2337  if (partconstr)
2338  {
2339  partconstr = (List *) expression_planner((Expr *) partconstr);
2340  if (rel->relid != 1)
2341  ChangeVarNodes((Node *) partconstr, 1, rel->relid, 0);
2342  rel->partition_qual = partconstr;
2343  }
2344 }
Expr * expression_planner(Expr *expr)
Definition: planner.c:6174
Definition: nodes.h:528
Index relid
Definition: pathnodes.h:692
List * RelationGetPartitionQual(Relation rel)
Definition: partcache.c:276
void ChangeVarNodes(Node *node, int rt_index, int new_index, int sublevels_up)
Definition: rewriteManip.c:610
List * partition_qual
Definition: pathnodes.h:748
Definition: pg_list.h:50

◆ set_baserel_partition_key_exprs()

static void set_baserel_partition_key_exprs ( Relation  relation,
RelOptInfo rel 
)
static

Definition at line 2254 of file plancat.c.

References Assert, ChangeVarNodes(), copyObject, elog, ERROR, InvalidAttrNumber, IS_SIMPLE_REL, lfirst, list_head(), list_make1, lnext(), makeVar(), RelOptInfo::nullable_partexprs, palloc(), palloc0(), PartitionKeyData::partattrs, PartitionKeyData::partexprs, RelOptInfo::partexprs, PartitionKeyData::partnatts, PartitionKeyData::parttypcoll, PartitionKeyData::parttypid, PartitionKeyData::parttypmod, RelationGetPartitionKey(), and RelOptInfo::relid.

Referenced by set_relation_partition_info().

2256 {
2257  PartitionKey partkey = RelationGetPartitionKey(relation);
2258  int partnatts;
2259  int cnt;
2260  List **partexprs;
2261  ListCell *lc;
2262  Index varno = rel->relid;
2263 
2264  Assert(IS_SIMPLE_REL(rel) && rel->relid > 0);
2265 
2266  /* A partitioned table should have a partition key. */
2267  Assert(partkey != NULL);
2268 
2269  partnatts = partkey->partnatts;
2270  partexprs = (List **) palloc(sizeof(List *) * partnatts);
2271  lc = list_head(partkey->partexprs);
2272 
2273  for (cnt = 0; cnt < partnatts; cnt++)
2274  {
2275  Expr *partexpr;
2276  AttrNumber attno = partkey->partattrs[cnt];
2277 
2278  if (attno != InvalidAttrNumber)
2279  {
2280  /* Single column partition key is stored as a Var node. */
2281  Assert(attno > 0);
2282 
2283  partexpr = (Expr *) makeVar(varno, attno,
2284  partkey->parttypid[cnt],
2285  partkey->parttypmod[cnt],
2286  partkey->parttypcoll[cnt], 0);
2287  }
2288  else
2289  {
2290  if (lc == NULL)
2291  elog(ERROR, "wrong number of partition key expressions");
2292 
2293  /* Re-stamp the expression with given varno. */
2294  partexpr = (Expr *) copyObject(lfirst(lc));
2295  ChangeVarNodes((Node *) partexpr, 1, varno, 0);
2296  lc = lnext(partkey->partexprs, lc);
2297  }
2298 
2299  /* Base relations have a single expression per key. */
2300  partexprs[cnt] = list_make1(partexpr);
2301  }
2302 
2303  rel->partexprs = partexprs;
2304 
2305  /*
2306  * A base relation does not have nullable partition key expressions, since
2307  * no outer join is involved. We still allocate an array of empty
2308  * expression lists to keep partition key expression handling code simple.
2309  * See build_joinrel_partition_info() and match_expr_to_partition_keys().
2310  */
2311  rel->nullable_partexprs = (List **) palloc0(sizeof(List *) * partnatts);
2312 }
static ListCell * lnext(const List *l, const ListCell *c)
Definition: pg_list.h:310
Definition: nodes.h:528
List * partexprs
Definition: partcache.h:30
PartitionKey RelationGetPartitionKey(Relation rel)
Definition: partcache.c:54
List ** nullable_partexprs
Definition: pathnodes.h:753
#define IS_SIMPLE_REL(rel)
Definition: pathnodes.h:637
#define list_make1(x1)
Definition: pg_list.h:206
Oid * parttypcoll
Definition: partcache.h:46
List ** partexprs
Definition: pathnodes.h:752
#define ERROR
Definition: elog.h:43
static ListCell * list_head(const List *l)
Definition: pg_list.h:125
Var * makeVar(Index varno, AttrNumber varattno, Oid vartype, int32 vartypmod, Oid varcollid, Index varlevelsup)
Definition: makefuncs.c:66
Index relid
Definition: pathnodes.h:692
void * palloc0(Size size)
Definition: mcxt.c:981
AttrNumber * partattrs
Definition: partcache.h:28
unsigned int Index
Definition: c.h:483
int32 * parttypmod
Definition: partcache.h:42
#define Assert(condition)
Definition: c.h:746
#define lfirst(lc)
Definition: pg_list.h:169
#define InvalidAttrNumber
Definition: attnum.h:23
void * palloc(Size size)
Definition: mcxt.c:950
#define elog(elevel,...)
Definition: elog.h:214
void ChangeVarNodes(Node *node, int rt_index, int new_index, int sublevels_up)
Definition: rewriteManip.c:610
#define copyObject(obj)
Definition: nodes.h:644
Definition: pg_list.h:50
int16 AttrNumber
Definition: attnum.h:21

◆ set_relation_partition_info()

static void set_relation_partition_info ( PlannerInfo root,
RelOptInfo rel,
Relation  relation 
)
static

Definition at line 2121 of file plancat.c.

References Assert, PartitionDescData::boundinfo, RelOptInfo::boundinfo, CreatePartitionDirectory(), CurrentMemoryContext, find_partition_scheme(), PlannerInfo::glob, PartitionDescData::nparts, RelOptInfo::nparts, RelOptInfo::part_scheme, PlannerGlobal::partition_directory, PartitionDirectoryLookup(), set_baserel_partition_constraint(), and set_baserel_partition_key_exprs().

Referenced by get_relation_info().

2123 {
2124  PartitionDesc partdesc;
2125 
2126  /* Create the PartitionDirectory infrastructure if we didn't already */
2127  if (root->glob->partition_directory == NULL)
2128  root->glob->partition_directory =
2130 
2132  relation);
2133  rel->part_scheme = find_partition_scheme(root, relation);
2134  Assert(partdesc != NULL && rel->part_scheme != NULL);
2135  rel->boundinfo = partdesc->boundinfo;
2136  rel->nparts = partdesc->nparts;
2137  set_baserel_partition_key_exprs(relation, rel);
2138  set_baserel_partition_constraint(relation, rel);
2139 }
PartitionDirectory CreatePartitionDirectory(MemoryContext mcxt)
Definition: partdesc.c:284
PartitionBoundInfo boundinfo
Definition: partdesc.h:29
PlannerGlobal * glob
Definition: pathnodes.h:179
int nparts
Definition: pathnodes.h:742
MemoryContext CurrentMemoryContext
Definition: mcxt.c:38
struct PartitionBoundInfoData * boundinfo
Definition: pathnodes.h:745
static void set_baserel_partition_constraint(Relation relation, RelOptInfo *rel)
Definition: plancat.c:2322
static PartitionScheme find_partition_scheme(PlannerInfo *root, Relation rel)
Definition: plancat.c:2147
#define Assert(condition)
Definition: c.h:746
PartitionScheme part_scheme
Definition: pathnodes.h:741
PartitionDesc PartitionDirectoryLookup(PartitionDirectory pdir, Relation rel)
Definition: partdesc.c:316
static void set_baserel_partition_key_exprs(Relation relation, RelOptInfo *rel)
Definition: plancat.c:2254
PartitionDirectory partition_directory
Definition: pathnodes.h:147

Variable Documentation

◆ constraint_exclusion

int constraint_exclusion = CONSTRAINT_EXCLUSION_PARTITION

Definition at line 57 of file plancat.c.

Referenced by relation_excluded_by_constraints().

◆ get_relation_info_hook

get_relation_info_hook_type get_relation_info_hook = NULL

Definition at line 60 of file plancat.c.

Referenced by get_relation_info().