PostgreSQL Source Code git master
Loading...
Searching...
No Matches
analyzejoins.c File Reference
Include dependency graph for analyzejoins.c:

Go to the source code of this file.

Data Structures

struct  SelfJoinCandidate
 

Functions

static bool join_is_removable (PlannerInfo *root, SpecialJoinInfo *sjinfo)
 
static void remove_leftjoinrel_from_query (PlannerInfo *root, int relid, SpecialJoinInfo *sjinfo)
 
static void remove_rel_from_query (PlannerInfo *root, int relid, int subst, SpecialJoinInfo *sjinfo, Relids joinrelids)
 
static void remove_rel_from_restrictinfo (RestrictInfo *rinfo, int relid, int ojrelid)
 
static void remove_rel_from_eclass (EquivalenceClass *ec, int relid, int ojrelid)
 
static Listremove_rel_from_joinlist (List *joinlist, int relid, int *nremoved)
 
static bool rel_supports_distinctness (PlannerInfo *root, RelOptInfo *rel)
 
static bool rel_is_distinct_for (PlannerInfo *root, RelOptInfo *rel, List *clause_list, List **extra_clauses)
 
static DistinctColInfodistinct_col_search (int colno, List *distinct_cols)
 
static bool is_innerrel_unique_for (PlannerInfo *root, Relids joinrelids, Relids outerrelids, RelOptInfo *innerrel, JoinType jointype, List *restrictlist, List **extra_clauses)
 
static int self_join_candidates_cmp (const void *a, const void *b)
 
static bool replace_relid_callback (Node *node, ChangeVarNodes_context *context)
 
Listremove_useless_joins (PlannerInfo *root, List *joinlist)
 
void reduce_unique_semijoins (PlannerInfo *root)
 
bool query_supports_distinctness (Query *query)
 
bool query_is_distinct_for (Query *query, List *distinct_cols)
 
bool innerrel_is_unique (PlannerInfo *root, Relids joinrelids, Relids outerrelids, RelOptInfo *innerrel, JoinType jointype, List *restrictlist, bool force_cache)
 
bool innerrel_is_unique_ext (PlannerInfo *root, Relids joinrelids, Relids outerrelids, RelOptInfo *innerrel, JoinType jointype, List *restrictlist, bool force_cache, List **extra_clauses)
 
static void update_eclasses (EquivalenceClass *ec, int from, int to)
 
static bool restrict_infos_logically_equal (RestrictInfo *a, RestrictInfo *b)
 
static void add_non_redundant_clauses (PlannerInfo *root, List *rinfo_candidates, List **keep_rinfo_list, Index removed_relid)
 
static void remove_self_join_rel (PlannerInfo *root, PlanRowMark *kmark, PlanRowMark *rmark, RelOptInfo *toKeep, RelOptInfo *toRemove, List *restrictlist)
 
static void split_selfjoin_quals (PlannerInfo *root, List *joinquals, List **selfjoinquals, List **otherjoinquals, int from, int to)
 
static bool match_unique_clauses (PlannerInfo *root, RelOptInfo *outer, List *uclauses, Index relid)
 
static Relids remove_self_joins_one_group (PlannerInfo *root, Relids relids)
 
static Relids remove_self_joins_recurse (PlannerInfo *root, List *joinlist, Relids toRemove)
 
Listremove_useless_self_joins (PlannerInfo *root, List *joinlist)
 

Variables

bool enable_self_join_elimination
 

Function Documentation

◆ add_non_redundant_clauses()

static void add_non_redundant_clauses ( PlannerInfo root,
List rinfo_candidates,
List **  keep_rinfo_list,
Index  removed_relid 
)
static

Definition at line 1706 of file analyzejoins.c.

1710{
1712 {
1713 bool is_redundant = false;
1714
1715 Assert(!bms_is_member(removed_relid, rinfo->required_relids));
1716
1718 {
1719 if (!bms_equal(src->clause_relids, rinfo->clause_relids))
1720 /* Can't compare trivially different clauses */
1721 continue;
1722
1723 if (src == rinfo ||
1724 (rinfo->parent_ec != NULL &&
1725 src->parent_ec == rinfo->parent_ec) ||
1727 {
1728 is_redundant = true;
1729 break;
1730 }
1731 }
1732 if (!is_redundant)
1734 }
1735}
static bool restrict_infos_logically_equal(RestrictInfo *a, RestrictInfo *b)
bool bms_equal(const Bitmapset *a, const Bitmapset *b)
Definition bitmapset.c:142
bool bms_is_member(int x, const Bitmapset *a)
Definition bitmapset.c:510
#define Assert(condition)
Definition c.h:943
void distribute_restrictinfo_to_rels(PlannerInfo *root, RestrictInfo *restrictinfo)
Definition initsplan.c:3578
#define foreach_node(type, var, lst)
Definition pg_list.h:528
static int fb(int x)
tree ctl root
Definition radixtree.h:1857

References Assert, bms_equal(), bms_is_member(), distribute_restrictinfo_to_rels(), fb(), foreach_node, restrict_infos_logically_equal(), and root.

Referenced by remove_self_join_rel().

◆ distinct_col_search()

static DistinctColInfo * distinct_col_search ( int  colno,
List distinct_cols 
)
static

Definition at line 1319 of file analyzejoins.c.

1320{
1322 {
1323 if (dcinfo->colno == colno)
1324 return dcinfo;
1325 }
1326
1327 return NULL;
1328}
#define foreach_ptr(type, var, lst)
Definition pg_list.h:501

References fb(), and foreach_ptr.

Referenced by query_is_distinct_for().

◆ innerrel_is_unique()

bool innerrel_is_unique ( PlannerInfo root,
Relids  joinrelids,
Relids  outerrelids,
RelOptInfo innerrel,
JoinType  jointype,
List restrictlist,
bool  force_cache 
)

Definition at line 1357 of file analyzejoins.c.

1364{
1365 return innerrel_is_unique_ext(root, joinrelids, outerrelids, innerrel,
1366 jointype, restrictlist, force_cache, NULL);
1367}
bool innerrel_is_unique_ext(PlannerInfo *root, Relids joinrelids, Relids outerrelids, RelOptInfo *innerrel, JoinType jointype, List *restrictlist, bool force_cache, List **extra_clauses)

References fb(), innerrel_is_unique_ext(), and root.

Referenced by add_paths_to_joinrel(), and reduce_unique_semijoins().

◆ innerrel_is_unique_ext()

bool innerrel_is_unique_ext ( PlannerInfo root,
Relids  joinrelids,
Relids  outerrelids,
RelOptInfo innerrel,
JoinType  jointype,
List restrictlist,
bool  force_cache,
List **  extra_clauses 
)

Definition at line 1379 of file analyzejoins.c.

1387{
1389 ListCell *lc;
1391 List *outer_exprs = NIL;
1392 bool self_join = (extra_clauses != NULL);
1393
1394 /* Certainly can't prove uniqueness when there are no joinclauses */
1395 if (restrictlist == NIL)
1396 return false;
1397
1398 /*
1399 * Make a quick check to eliminate cases in which we will surely be unable
1400 * to prove uniqueness of the innerrel.
1401 */
1402 if (!rel_supports_distinctness(root, innerrel))
1403 return false;
1404
1405 /*
1406 * Query the cache to see if we've managed to prove that innerrel is
1407 * unique for any subset of this outerrel. For non-self-join search, we
1408 * don't need an exact match, as extra outerrels can't make the innerrel
1409 * any less unique (or more formally, the restrictlist for a join to a
1410 * superset outerrel must be a superset of the conditions we successfully
1411 * used before). For self-join search, we require an exact match of
1412 * outerrels because we need extra clauses to be valid for our case. Also,
1413 * for self-join checking we've filtered the clauses list. Thus, we can
1414 * match only the result cached for a self-join search for another
1415 * self-join check.
1416 */
1417 foreach(lc, innerrel->unique_for_rels)
1418 {
1420
1421 if ((!self_join && bms_is_subset(uniqueRelInfo->outerrelids, outerrelids)) ||
1422 (self_join && bms_equal(uniqueRelInfo->outerrelids, outerrelids) &&
1423 uniqueRelInfo->self_join))
1424 {
1425 if (extra_clauses)
1426 *extra_clauses = uniqueRelInfo->extra_clauses;
1427 return true; /* Success! */
1428 }
1429 }
1430
1431 /*
1432 * Conversely, we may have already determined that this outerrel, or some
1433 * superset thereof, cannot prove this innerrel to be unique.
1434 */
1435 foreach(lc, innerrel->non_unique_for_rels)
1436 {
1437 Relids unique_for_rels = (Relids) lfirst(lc);
1438
1439 if (bms_is_subset(outerrelids, unique_for_rels))
1440 return false;
1441 }
1442
1443 /* No cached information, so try to make the proof. */
1444 if (is_innerrel_unique_for(root, joinrelids, outerrelids, innerrel,
1445 jointype, restrictlist,
1446 self_join ? &outer_exprs : NULL))
1447 {
1448 /*
1449 * Cache the positive result for future probes, being sure to keep it
1450 * in the planner_cxt even if we are working in GEQO.
1451 *
1452 * Note: one might consider trying to isolate the minimal subset of
1453 * the outerrels that proved the innerrel unique. But it's not worth
1454 * the trouble, because the planner builds up joinrels incrementally
1455 * and so we'll see the minimally sufficient outerrels before any
1456 * supersets of them anyway.
1457 */
1458 old_context = MemoryContextSwitchTo(root->planner_cxt);
1460 uniqueRelInfo->outerrelids = bms_copy(outerrelids);
1461 uniqueRelInfo->self_join = self_join;
1462 uniqueRelInfo->extra_clauses = outer_exprs;
1463 innerrel->unique_for_rels = lappend(innerrel->unique_for_rels,
1466
1467 if (extra_clauses)
1468 *extra_clauses = outer_exprs;
1469 return true; /* Success! */
1470 }
1471 else
1472 {
1473 /*
1474 * None of the join conditions for outerrel proved innerrel unique, so
1475 * we can safely reject this outerrel or any subset of it in future
1476 * checks.
1477 *
1478 * However, in normal planning mode, caching this knowledge is totally
1479 * pointless; it won't be queried again, because we build up joinrels
1480 * from smaller to larger. It's only useful when using GEQO or
1481 * another planner extension that attempts planning multiple times.
1482 *
1483 * Also, allow callers to override that heuristic and force caching;
1484 * that's useful for reduce_unique_semijoins, which calls here before
1485 * the normal join search starts.
1486 */
1487 if (force_cache || root->assumeReplanning)
1488 {
1489 old_context = MemoryContextSwitchTo(root->planner_cxt);
1490 innerrel->non_unique_for_rels =
1491 lappend(innerrel->non_unique_for_rels,
1492 bms_copy(outerrelids));
1494 }
1495
1496 return false;
1497 }
1498}
static bool is_innerrel_unique_for(PlannerInfo *root, Relids joinrelids, Relids outerrelids, RelOptInfo *innerrel, JoinType jointype, List *restrictlist, List **extra_clauses)
static bool rel_supports_distinctness(PlannerInfo *root, RelOptInfo *rel)
bool bms_is_subset(const Bitmapset *a, const Bitmapset *b)
Definition bitmapset.c:412
Bitmapset * bms_copy(const Bitmapset *a)
Definition bitmapset.c:122
List * lappend(List *list, void *datum)
Definition list.c:339
#define makeNode(_type_)
Definition nodes.h:161
static MemoryContext MemoryContextSwitchTo(MemoryContext context)
Definition palloc.h:124
Bitmapset * Relids
Definition pathnodes.h:103
#define lfirst(lc)
Definition pg_list.h:172
#define NIL
Definition pg_list.h:68
Definition pg_list.h:54
List * unique_for_rels
Definition pathnodes.h:1124
List * non_unique_for_rels
Definition pathnodes.h:1126

References bms_copy(), bms_equal(), bms_is_subset(), fb(), is_innerrel_unique_for(), lappend(), lfirst, makeNode, MemoryContextSwitchTo(), NIL, RelOptInfo::non_unique_for_rels, rel_supports_distinctness(), root, and RelOptInfo::unique_for_rels.

Referenced by innerrel_is_unique(), and remove_self_joins_one_group().

◆ is_innerrel_unique_for()

static bool is_innerrel_unique_for ( PlannerInfo root,
Relids  joinrelids,
Relids  outerrelids,
RelOptInfo innerrel,
JoinType  jointype,
List restrictlist,
List **  extra_clauses 
)
static

Definition at line 1506 of file analyzejoins.c.

1513{
1514 List *clause_list = NIL;
1515 ListCell *lc;
1516
1517 /*
1518 * Search for mergejoinable clauses that constrain the inner rel against
1519 * the outer rel. If an operator is mergejoinable then it behaves like
1520 * equality for some btree opclass, so it's what we want. The
1521 * mergejoinability test also eliminates clauses containing volatile
1522 * functions, which we couldn't depend on.
1523 */
1524 foreach(lc, restrictlist)
1525 {
1527
1528 /*
1529 * As noted above, if it's a pushed-down clause and we're at an outer
1530 * join, we can't use it.
1531 */
1532 if (IS_OUTER_JOIN(jointype) &&
1534 continue;
1535
1536 /* Ignore if it's not a mergejoinable clause */
1537 if (!restrictinfo->can_join ||
1538 restrictinfo->mergeopfamilies == NIL)
1539 continue; /* not mergejoinable */
1540
1541 /*
1542 * Check if the clause has the form "outer op inner" or "inner op
1543 * outer", and if so mark which side is inner.
1544 */
1545 if (!clause_sides_match_join(restrictinfo, outerrelids,
1546 innerrel->relids))
1547 continue; /* no good for these input relations */
1548
1549 /* OK, add to the list */
1551 }
1552
1553 /* Let rel_is_distinct_for() do the hard work */
1554 return rel_is_distinct_for(root, innerrel, clause_list, extra_clauses);
1555}
static bool rel_is_distinct_for(PlannerInfo *root, RelOptInfo *rel, List *clause_list, List **extra_clauses)
#define IS_OUTER_JOIN(jointype)
Definition nodes.h:348
#define RINFO_IS_PUSHED_DOWN(rinfo, joinrelids)
Definition pathnodes.h:3058
static bool clause_sides_match_join(RestrictInfo *rinfo, Relids outerrelids, Relids innerrelids)
Relids relids
Definition pathnodes.h:1021

References clause_sides_match_join(), fb(), IS_OUTER_JOIN, lappend(), lfirst, NIL, rel_is_distinct_for(), RelOptInfo::relids, RINFO_IS_PUSHED_DOWN, and root.

Referenced by innerrel_is_unique_ext().

◆ join_is_removable()

static bool join_is_removable ( PlannerInfo root,
SpecialJoinInfo sjinfo 
)
static

Definition at line 158 of file analyzejoins.c.

159{
160 int innerrelid;
161 RelOptInfo *innerrel;
165 ListCell *l;
166 int attroff;
167
168 /*
169 * Must be a left join to a single baserel, else we aren't going to be
170 * able to do anything with it.
171 */
172 if (sjinfo->jointype != JOIN_LEFT)
173 return false;
174
176 return false;
177
178 /*
179 * Never try to eliminate a left join to the query result rel. Although
180 * the case is syntactically impossible in standard SQL, MERGE will build
181 * a join tree that looks exactly like that.
182 */
183 if (innerrelid == root->parse->resultRelation)
184 return false;
185
186 innerrel = find_base_rel(root, innerrelid);
187
188 /*
189 * Before we go to the effort of checking whether any innerrel variables
190 * are needed above the join, make a quick check to eliminate cases in
191 * which we will surely be unable to prove uniqueness of the innerrel.
192 */
193 if (!rel_supports_distinctness(root, innerrel))
194 return false;
195
196 /* Compute the relid set for the join we are considering */
198 Assert(sjinfo->ojrelid != 0);
201
202 /*
203 * We can't remove the join if any inner-rel attributes are used above the
204 * join. Here, "above" the join includes pushed-down conditions, so we
205 * should reject if attr_needed includes the OJ's own relid; therefore,
206 * compare to inputrelids not joinrelids.
207 *
208 * As a micro-optimization, it seems better to start with max_attr and
209 * count down rather than starting with min_attr and counting up, on the
210 * theory that the system attributes are somewhat less likely to be wanted
211 * and should be tested last.
212 */
213 for (attroff = innerrel->max_attr - innerrel->min_attr;
214 attroff >= 0;
215 attroff--)
216 {
217 if (!bms_is_subset(innerrel->attr_needed[attroff], inputrelids))
218 return false;
219 }
220
221 /*
222 * Similarly check that the inner rel isn't needed by any PlaceHolderVars
223 * that will be used above the join. The PHV case is a little bit more
224 * complicated, because PHVs may have been assigned a ph_eval_at location
225 * that includes the innerrel, yet their contained expression might not
226 * actually reference the innerrel (it could be just a constant, for
227 * instance). If such a PHV is due to be evaluated above the join then it
228 * needn't prevent join removal.
229 */
230 foreach(l, root->placeholder_list)
231 {
233
234 if (bms_overlap(phinfo->ph_lateral, innerrel->relids))
235 return false; /* it references innerrel laterally */
236 if (!bms_overlap(phinfo->ph_eval_at, innerrel->relids))
237 continue; /* it definitely doesn't reference innerrel */
238 if (bms_is_subset(phinfo->ph_needed, inputrelids))
239 continue; /* PHV is not used above the join */
240 if (!bms_is_member(sjinfo->ojrelid, phinfo->ph_eval_at))
241 return false; /* it has to be evaluated below the join */
242
243 /*
244 * We need to be sure there will still be a place to evaluate the PHV
245 * if we remove the join, ie that ph_eval_at wouldn't become empty.
246 */
247 if (!bms_overlap(sjinfo->min_lefthand, phinfo->ph_eval_at))
248 return false; /* there isn't any other place to eval PHV */
249 /* Check contained expression last, since this is a bit expensive */
250 if (bms_overlap(pull_varnos(root, (Node *) phinfo->ph_var->phexpr),
251 innerrel->relids))
252 return false; /* contained expression references innerrel */
253 }
254
255 /*
256 * Search for mergejoinable clauses that constrain the inner rel against
257 * either the outer rel or a pseudoconstant. If an operator is
258 * mergejoinable then it behaves like equality for some btree opclass, so
259 * it's what we want. The mergejoinability test also eliminates clauses
260 * containing volatile functions, which we couldn't depend on.
261 */
262 foreach(l, innerrel->joininfo)
263 {
265
266 /*
267 * If the current join commutes with some other outer join(s) via
268 * outer join identity 3, there will be multiple clones of its join
269 * clauses in the joininfo list. We want to consider only the
270 * has_clone form of such clauses. Processing more than one form
271 * would be wasteful, and also some of the others would confuse the
272 * RINFO_IS_PUSHED_DOWN test below.
273 */
274 if (restrictinfo->is_clone)
275 continue; /* ignore it */
276
277 /*
278 * If it's not a join clause for this outer join, we can't use it.
279 * Note that if the clause is pushed-down, then it is logically from
280 * above the outer join, even if it references no other rels (it might
281 * be from WHERE, for example).
282 */
284 continue; /* ignore; not useful here */
285
286 /* Ignore if it's not a mergejoinable clause */
287 if (!restrictinfo->can_join ||
288 restrictinfo->mergeopfamilies == NIL)
289 continue; /* not mergejoinable */
290
291 /*
292 * Check if the clause has the form "outer op inner" or "inner op
293 * outer", and if so mark which side is inner.
294 */
296 innerrel->relids))
297 continue; /* no good for these input relations */
298
299 /* OK, add to list */
301 }
302
303 /*
304 * Now that we have the relevant equality join clauses, try to prove the
305 * innerrel distinct.
306 */
307 if (rel_is_distinct_for(root, innerrel, clause_list, NULL))
308 return true;
309
310 /*
311 * Some day it would be nice to check for other methods of establishing
312 * distinctness.
313 */
314 return false;
315}
Bitmapset * bms_add_member(Bitmapset *a, int x)
Definition bitmapset.c:799
Bitmapset * bms_union(const Bitmapset *a, const Bitmapset *b)
Definition bitmapset.c:251
bool bms_overlap(const Bitmapset *a, const Bitmapset *b)
Definition bitmapset.c:575
bool bms_get_singleton_member(const Bitmapset *a, int *member)
Definition bitmapset.c:708
@ JOIN_LEFT
Definition nodes.h:304
RelOptInfo * find_base_rel(PlannerInfo *root, int relid)
Definition relnode.c:544
Definition nodes.h:135
List * joininfo
Definition pathnodes.h:1148
AttrNumber max_attr
Definition pathnodes.h:1077
AttrNumber min_attr
Definition pathnodes.h:1075
Relids min_righthand
Definition pathnodes.h:3227
JoinType jointype
Definition pathnodes.h:3230
Relids min_lefthand
Definition pathnodes.h:3226
Relids pull_varnos(PlannerInfo *root, Node *node)
Definition var.c:114

References Assert, bms_add_member(), bms_copy(), bms_get_singleton_member(), bms_is_member(), bms_is_subset(), bms_overlap(), bms_union(), clause_sides_match_join(), fb(), find_base_rel(), JOIN_LEFT, RelOptInfo::joininfo, SpecialJoinInfo::jointype, lappend(), lfirst, RelOptInfo::max_attr, RelOptInfo::min_attr, SpecialJoinInfo::min_lefthand, SpecialJoinInfo::min_righthand, NIL, SpecialJoinInfo::ojrelid, pull_varnos(), rel_is_distinct_for(), rel_supports_distinctness(), RelOptInfo::relids, RINFO_IS_PUSHED_DOWN, and root.

Referenced by remove_useless_joins().

◆ match_unique_clauses()

static bool match_unique_clauses ( PlannerInfo root,
RelOptInfo outer,
List uclauses,
Index  relid 
)
static

Definition at line 2127 of file analyzejoins.c.

2129{
2131 {
2132 Expr *clause;
2133 Node *iclause;
2134 Node *c1;
2135 bool matched = false;
2136
2137 Assert(outer->relid > 0 && relid > 0);
2138
2139 /* Only filters like f(R.x1,...,R.xN) == expr we should consider. */
2140 Assert(bms_is_empty(rinfo->left_relids) ^
2141 bms_is_empty(rinfo->right_relids));
2142
2143 clause = (Expr *) copyObject(rinfo->clause);
2144 ChangeVarNodesExtended((Node *) clause, relid, outer->relid, 0,
2146
2147 iclause = bms_is_empty(rinfo->left_relids) ? get_rightop(clause) :
2148 get_leftop(clause);
2149 c1 = bms_is_empty(rinfo->left_relids) ? get_leftop(clause) :
2150 get_rightop(clause);
2151
2152 /*
2153 * Compare these left and right sides with the corresponding sides of
2154 * the outer's filters. If no one is detected - return immediately.
2155 */
2157 {
2158 Node *oclause;
2159 Node *c2;
2160
2161 if (orinfo->mergeopfamilies == NIL)
2162 /* Don't consider clauses that aren't similar to 'F(X)=G(Y)' */
2163 continue;
2164
2165 Assert(is_opclause(orinfo->clause));
2166
2167 oclause = bms_is_empty(orinfo->left_relids) ?
2168 get_rightop(orinfo->clause) : get_leftop(orinfo->clause);
2169 c2 = (bms_is_empty(orinfo->left_relids) ?
2170 get_leftop(orinfo->clause) : get_rightop(orinfo->clause));
2171
2172 if (equal(iclause, oclause) && equal(c1, c2))
2173 {
2174 matched = true;
2175 break;
2176 }
2177 }
2178
2179 if (!matched)
2180 return false;
2181 }
2182
2183 return true;
2184}
static bool replace_relid_callback(Node *node, ChangeVarNodes_context *context)
#define bms_is_empty(a)
Definition bitmapset.h:118
bool equal(const void *a, const void *b)
Definition equalfuncs.c:223
static Node * get_rightop(const void *clause)
Definition nodeFuncs.h:95
static bool is_opclause(const void *clause)
Definition nodeFuncs.h:76
static Node * get_leftop(const void *clause)
Definition nodeFuncs.h:83
#define copyObject(obj)
Definition nodes.h:232
void ChangeVarNodesExtended(Node *node, int rt_index, int new_index, int sublevels_up, ChangeVarNodes_callback callback)
List * baserestrictinfo
Definition pathnodes.h:1142
Index relid
Definition pathnodes.h:1069

References Assert, RelOptInfo::baserestrictinfo, bms_is_empty, ChangeVarNodesExtended(), copyObject, equal(), fb(), foreach_node, get_leftop(), get_rightop(), is_opclause(), NIL, RelOptInfo::relid, and replace_relid_callback().

Referenced by remove_self_joins_one_group().

◆ query_is_distinct_for()

bool query_is_distinct_for ( Query query,
List distinct_cols 
)

Definition at line 1161 of file analyzejoins.c.

1162{
1163 ListCell *l;
1165
1166 /*
1167 * DISTINCT (including DISTINCT ON) guarantees uniqueness if all the
1168 * columns in the DISTINCT clause appear in colnos and operator semantics
1169 * match. This is true even if there are SRFs in the DISTINCT columns or
1170 * elsewhere in the tlist.
1171 */
1172 if (query->distinctClause)
1173 {
1174 foreach(l, query->distinctClause)
1175 {
1178 query->targetList);
1179
1181 if (dcinfo == NULL ||
1182 !equality_ops_are_compatible(dcinfo->opid, sgc->eqop) ||
1184 exprCollation((Node *) tle->expr)))
1185 break; /* exit early if no match */
1186 }
1187 if (l == NULL) /* had matches for all? */
1188 return true;
1189 }
1190
1191 /*
1192 * Otherwise, a set-returning function in the query's targetlist can
1193 * result in returning duplicate rows, despite any grouping that might
1194 * occur before tlist evaluation. (If all tlist SRFs are within GROUP BY
1195 * columns, it would be safe because they'd be expanded before grouping.
1196 * But it doesn't currently seem worth the effort to check for that.)
1197 */
1198 if (query->hasTargetSRFs)
1199 return false;
1200
1201 /*
1202 * Similarly, GROUP BY without GROUPING SETS guarantees uniqueness if all
1203 * the grouped columns appear in colnos and operator semantics match.
1204 */
1205 if (query->groupClause && !query->groupingSets)
1206 {
1207 foreach(l, query->groupClause)
1208 {
1211 query->targetList);
1212
1214 if (dcinfo == NULL ||
1215 !equality_ops_are_compatible(dcinfo->opid, sgc->eqop) ||
1217 exprCollation((Node *) tle->expr)))
1218 break; /* exit early if no match */
1219 }
1220 if (l == NULL) /* had matches for all? */
1221 return true;
1222 }
1223 else if (query->groupingSets)
1224 {
1225 List *gsets;
1226
1227 /*
1228 * If we have grouping sets with expressions, we probably don't have
1229 * uniqueness and analysis would be hard. Punt.
1230 */
1231 if (query->groupClause)
1232 return false;
1233
1234 /*
1235 * If we have no groupClause (therefore no grouping expressions), we
1236 * might have one or many empty grouping sets. If there's just one,
1237 * or if the DISTINCT clause is used on the GROUP BY, then we're
1238 * returning only one row and are certainly unique. But otherwise, we
1239 * know we're certainly not unique.
1240 */
1241 if (query->groupDistinct)
1242 return true;
1243
1244 gsets = expand_grouping_sets(query->groupingSets, false, -1);
1245
1246 return (list_length(gsets) == 1);
1247 }
1248 else
1249 {
1250 /*
1251 * If we have no GROUP BY, but do have aggregates or HAVING, then the
1252 * result is at most one row so it's surely unique, for any operators.
1253 */
1254 if (query->hasAggs || query->havingQual)
1255 return true;
1256 }
1257
1258 /*
1259 * UNION, INTERSECT, EXCEPT guarantee uniqueness of the whole output row,
1260 * except with ALL.
1261 */
1262 if (query->setOperations)
1263 {
1265
1266 Assert(topop->op != SETOP_NONE);
1267
1268 if (!topop->all)
1269 {
1270 ListCell *lg;
1271
1272 /* We're good if all the nonjunk output columns are in colnos */
1273 lg = list_head(topop->groupClauses);
1274 foreach(l, query->targetList)
1275 {
1278
1279 if (tle->resjunk)
1280 continue; /* ignore resjunk columns */
1281
1282 /* non-resjunk columns should have grouping clauses */
1283 Assert(lg != NULL);
1285 lg = lnext(topop->groupClauses, lg);
1286
1288 if (dcinfo == NULL ||
1289 !equality_ops_are_compatible(dcinfo->opid, sgc->eqop) ||
1291 exprCollation((Node *) tle->expr)))
1292 break; /* exit early if no match */
1293 }
1294 if (l == NULL) /* had matches for all? */
1295 return true;
1296 }
1297 }
1298
1299 /*
1300 * XXX Are there any other cases in which we can easily see the result
1301 * must be distinct?
1302 *
1303 * If you do add more smarts to this function, be sure to update
1304 * query_supports_distinctness() to match.
1305 */
1306
1307 return false;
1308}
static DistinctColInfo * distinct_col_search(int colno, List *distinct_cols)
bool collations_agree_on_equality(Oid coll1, Oid coll2)
Definition lsyscache.c:886
bool equality_ops_are_compatible(Oid opno1, Oid opno2)
Definition lsyscache.c:773
Oid exprCollation(const Node *expr)
Definition nodeFuncs.c:826
#define castNode(_type_, nodeptr)
Definition nodes.h:182
List * expand_grouping_sets(List *groupingSets, bool groupDistinct, int limit)
Definition parse_agg.c:2019
@ SETOP_NONE
static int list_length(const List *l)
Definition pg_list.h:152
static ListCell * list_head(const List *l)
Definition pg_list.h:128
static ListCell * lnext(const List *l, const ListCell *c)
Definition pg_list.h:375
bool groupDistinct
Definition parsenodes.h:220
Node * setOperations
Definition parsenodes.h:239
List * groupClause
Definition parsenodes.h:219
Node * havingQual
Definition parsenodes.h:225
List * targetList
Definition parsenodes.h:201
List * groupingSets
Definition parsenodes.h:223
List * distinctClause
Definition parsenodes.h:229
TargetEntry * get_sortgroupclause_tle(SortGroupClause *sgClause, List *targetList)
Definition tlist.c:376

References Assert, castNode, collations_agree_on_equality(), distinct_col_search(), Query::distinctClause, equality_ops_are_compatible(), expand_grouping_sets(), exprCollation(), fb(), get_sortgroupclause_tle(), Query::groupClause, Query::groupDistinct, Query::groupingSets, Query::havingQual, lfirst, list_head(), list_length(), lnext(), SETOP_NONE, Query::setOperations, and Query::targetList.

Referenced by rel_is_distinct_for().

◆ query_supports_distinctness()

bool query_supports_distinctness ( Query query)

Definition at line 1114 of file analyzejoins.c.

1115{
1116 /* SRFs break distinctness except with DISTINCT, see below */
1117 if (query->hasTargetSRFs && query->distinctClause == NIL)
1118 return false;
1119
1120 /* check for features we can prove distinctness with */
1121 if (query->distinctClause != NIL ||
1122 query->groupClause != NIL ||
1123 query->groupingSets != NIL ||
1124 query->hasAggs ||
1125 query->havingQual ||
1126 query->setOperations)
1127 return true;
1128
1129 return false;
1130}

References Query::distinctClause, Query::groupClause, Query::groupingSets, Query::havingQual, NIL, and Query::setOperations.

Referenced by rel_supports_distinctness().

◆ reduce_unique_semijoins()

void reduce_unique_semijoins ( PlannerInfo root)

Definition at line 875 of file analyzejoins.c.

876{
877 ListCell *lc;
878
879 /*
880 * Scan the join_info_list to find semijoins.
881 */
882 foreach(lc, root->join_info_list)
883 {
885 int innerrelid;
886 RelOptInfo *innerrel;
888 List *restrictlist;
889
890 /*
891 * Must be a semijoin to a single baserel, else we aren't going to be
892 * able to do anything with it.
893 */
894 if (sjinfo->jointype != JOIN_SEMI)
895 continue;
896
898 continue;
899
900 innerrel = find_base_rel(root, innerrelid);
901
902 /*
903 * Before we trouble to run generate_join_implied_equalities, make a
904 * quick check to eliminate cases in which we will surely be unable to
905 * prove uniqueness of the innerrel.
906 */
907 if (!rel_supports_distinctness(root, innerrel))
908 continue;
909
910 /* Compute the relid set for the join we are considering */
912 Assert(sjinfo->ojrelid == 0); /* SEMI joins don't have RT indexes */
913
914 /*
915 * Since we're only considering a single-rel RHS, any join clauses it
916 * has must be clauses linking it to the semijoin's min_lefthand. We
917 * can also consider EC-derived join clauses.
918 */
919 restrictlist =
922 sjinfo->min_lefthand,
923 innerrel,
924 NULL),
925 innerrel->joininfo);
926
927 /* Test whether the innerrel is unique for those clauses. */
929 joinrelids, sjinfo->min_lefthand, innerrel,
930 JOIN_SEMI, restrictlist, true))
931 continue;
932
933 /* OK, remove the SpecialJoinInfo from the list. */
934 root->join_info_list = foreach_delete_current(root->join_info_list, lc);
935 }
936}
bool innerrel_is_unique(PlannerInfo *root, Relids joinrelids, Relids outerrelids, RelOptInfo *innerrel, JoinType jointype, List *restrictlist, bool force_cache)
List * generate_join_implied_equalities(PlannerInfo *root, Relids join_relids, Relids outer_relids, RelOptInfo *inner_rel, SpecialJoinInfo *sjinfo)
List * list_concat(List *list1, const List *list2)
Definition list.c:561
@ JOIN_SEMI
Definition nodes.h:317
#define foreach_delete_current(lst, var_or_cell)
Definition pg_list.h:423

References Assert, bms_get_singleton_member(), bms_union(), fb(), find_base_rel(), foreach_delete_current, generate_join_implied_equalities(), innerrel_is_unique(), JOIN_SEMI, RelOptInfo::joininfo, SpecialJoinInfo::jointype, lfirst, list_concat(), SpecialJoinInfo::min_lefthand, SpecialJoinInfo::min_righthand, SpecialJoinInfo::ojrelid, rel_supports_distinctness(), and root.

Referenced by query_planner().

◆ rel_is_distinct_for()

static bool rel_is_distinct_for ( PlannerInfo root,
RelOptInfo rel,
List clause_list,
List **  extra_clauses 
)
static

Definition at line 1011 of file analyzejoins.c.

1013{
1014 /*
1015 * We could skip a couple of tests here if we assume all callers checked
1016 * rel_supports_distinctness first, but it doesn't seem worth taking any
1017 * risk for.
1018 */
1019 if (rel->reloptkind != RELOPT_BASEREL)
1020 return false;
1021 if (rel->rtekind == RTE_RELATION)
1022 {
1023 /*
1024 * Examine the indexes to see if we have a matching unique index.
1025 * relation_has_unique_index_for automatically adds any usable
1026 * restriction clauses for the rel, so we needn't do that here.
1027 */
1028 if (relation_has_unique_index_for(root, rel, clause_list, extra_clauses))
1029 return true;
1030 }
1031 else if (rel->rtekind == RTE_SUBQUERY)
1032 {
1033 Index relid = rel->relid;
1034 Query *subquery = root->simple_rte_array[relid]->subquery;
1036 ListCell *l;
1037
1038 /*
1039 * Build the argument list for query_is_distinct_for: a list of
1040 * DistinctColInfo entries, each holding an output column number that
1041 * the query needs to be distinct over, the equality operator that the
1042 * column needs to be distinct according to, and that operator's input
1043 * collation. The collation matters because the subquery's own
1044 * DISTINCT / GROUP BY / set-op proves uniqueness under its own
1045 * collation, which need not agree with the operator's.
1046 *
1047 * (XXX we are not considering restriction clauses attached to the
1048 * subquery; is that worth doing?)
1049 */
1050 foreach(l, clause_list)
1051 {
1053 OpExpr *opexpr;
1054 Var *var;
1056
1057 /*
1058 * The caller's mergejoinability test should have selected only
1059 * OpExprs. The operator might be a cross-type operator and thus
1060 * not exactly the same operator the subquery would consider;
1061 * that's all right since query_is_distinct_for can resolve such
1062 * cases.
1063 */
1064 opexpr = castNode(OpExpr, rinfo->clause);
1065
1066 /* caller identified the inner side for us */
1067 if (rinfo->outer_is_left)
1068 var = (Var *) get_rightop(rinfo->clause);
1069 else
1070 var = (Var *) get_leftop(rinfo->clause);
1071
1072 /*
1073 * We may ignore any RelabelType node above the operand. (There
1074 * won't be more than one, since eval_const_expressions() has been
1075 * applied already.)
1076 */
1077 if (var && IsA(var, RelabelType))
1078 var = (Var *) ((RelabelType *) var)->arg;
1079
1080 /*
1081 * If inner side isn't a Var referencing a subquery output column,
1082 * this clause doesn't help us.
1083 */
1084 if (!var || !IsA(var, Var) ||
1085 var->varno != relid || var->varlevelsup != 0)
1086 continue;
1087
1088 dcinfo = palloc(sizeof(DistinctColInfo));
1089 dcinfo->colno = var->varattno;
1090 dcinfo->opid = opexpr->opno;
1091 dcinfo->collid = opexpr->inputcollid;
1093 }
1094
1095 if (query_is_distinct_for(subquery, distinct_cols))
1096 return true;
1097 }
1098 return false;
1099}
bool query_is_distinct_for(Query *query, List *distinct_cols)
unsigned int Index
Definition c.h:698
bool relation_has_unique_index_for(PlannerInfo *root, RelOptInfo *rel, List *restrictlist, List **extra_clauses)
Definition indxpath.c:4144
void * palloc(Size size)
Definition mcxt.c:1387
#define IsA(nodeptr, _type_)
Definition nodes.h:164
@ RTE_SUBQUERY
@ RTE_RELATION
@ RELOPT_BASEREL
Definition pathnodes.h:977
#define lfirst_node(type, lc)
Definition pg_list.h:176
Oid opno
Definition primnodes.h:851
RelOptKind reloptkind
Definition pathnodes.h:1015
RTEKind rtekind
Definition pathnodes.h:1073
Expr * clause
Definition pathnodes.h:2901
AttrNumber varattno
Definition primnodes.h:275
int varno
Definition primnodes.h:270
Index varlevelsup
Definition primnodes.h:295

References castNode, RestrictInfo::clause, fb(), get_leftop(), get_rightop(), IsA, lappend(), lfirst_node, NIL, OpExpr::opno, palloc(), query_is_distinct_for(), relation_has_unique_index_for(), RelOptInfo::relid, RELOPT_BASEREL, RelOptInfo::reloptkind, root, RTE_RELATION, RTE_SUBQUERY, RelOptInfo::rtekind, Var::varattno, Var::varlevelsup, and Var::varno.

Referenced by is_innerrel_unique_for(), and join_is_removable().

◆ rel_supports_distinctness()

static bool rel_supports_distinctness ( PlannerInfo root,
RelOptInfo rel 
)
static

Definition at line 951 of file analyzejoins.c.

952{
953 /* We only know about baserels ... */
954 if (rel->reloptkind != RELOPT_BASEREL)
955 return false;
956 if (rel->rtekind == RTE_RELATION)
957 {
958 /*
959 * For a plain relation, we only know how to prove uniqueness by
960 * reference to unique indexes. Make sure there's at least one
961 * suitable unique index. It must be immediately enforced, and not a
962 * partial index. (Keep these conditions in sync with
963 * relation_has_unique_index_for!)
964 */
965 ListCell *lc;
966
967 foreach(lc, rel->indexlist)
968 {
970
971 if (ind->unique && ind->immediate && ind->indpred == NIL)
972 return true;
973 }
974 }
975 else if (rel->rtekind == RTE_SUBQUERY)
976 {
977 Query *subquery = root->simple_rte_array[rel->relid]->subquery;
978
979 /* Check if the subquery has any qualities that support distinctness */
980 if (query_supports_distinctness(subquery))
981 return true;
982 }
983 /* We have no proof rules for any other rtekinds. */
984 return false;
985}
bool query_supports_distinctness(Query *query)
List * indexlist
Definition pathnodes.h:1091

References fb(), RelOptInfo::indexlist, lfirst, NIL, query_supports_distinctness(), RelOptInfo::relid, RELOPT_BASEREL, RelOptInfo::reloptkind, root, RTE_RELATION, RTE_SUBQUERY, and RelOptInfo::rtekind.

Referenced by innerrel_is_unique_ext(), join_is_removable(), and reduce_unique_semijoins().

◆ remove_leftjoinrel_from_query()

static void remove_leftjoinrel_from_query ( PlannerInfo root,
int  relid,
SpecialJoinInfo sjinfo 
)
static

Definition at line 326 of file analyzejoins.c.

328{
329 RelOptInfo *rel = find_base_rel(root, relid);
330 int ojrelid = sjinfo->ojrelid;
334 ListCell *l;
335
336 /* Compute the relid set for the join we are considering */
338 Assert(ojrelid != 0);
340
341 remove_rel_from_query(root, relid, -1, sjinfo, joinrelids);
342
343 /*
344 * Remove any joinquals referencing the rel from the joininfo lists.
345 *
346 * In some cases, a joinqual has to be put back after deleting its
347 * reference to the target rel. This can occur for pseudoconstant and
348 * outerjoin-delayed quals, which can get marked as requiring the rel in
349 * order to force them to be evaluated at or above the join. We can't
350 * just discard them, though. Only quals that logically belonged to the
351 * outer join being discarded should be removed from the query.
352 *
353 * We might encounter a qual that is a clone of a deletable qual with some
354 * outer-join relids added (see deconstruct_distribute_oj_quals). To
355 * ensure we get rid of such clones as well, add the relids of all OJs
356 * commutable with this one to the set we test against for
357 * pushed-down-ness.
358 */
360 sjinfo->commute_above_r);
362 sjinfo->commute_below_l);
363
364 /*
365 * We must make a copy of the rel's old joininfo list before starting the
366 * loop, because otherwise remove_join_clause_from_rels would destroy the
367 * list while we're scanning it.
368 */
370 foreach(l, joininfos)
371 {
372 RestrictInfo *rinfo = (RestrictInfo *) lfirst(l);
373
375
377 {
378 /*
379 * There might be references to relid or ojrelid in the
380 * RestrictInfo's relid sets, as a consequence of PHVs having had
381 * ph_eval_at sets that include those. We already checked above
382 * that any such PHV is safe (and updated its ph_eval_at), so we
383 * can just drop those references.
384 */
385 remove_rel_from_restrictinfo(rinfo, relid, ojrelid);
386
387 /*
388 * Cross-check that the clause itself does not reference the
389 * target rel or join.
390 */
391#ifdef USE_ASSERT_CHECKING
392 {
394 (Node *) rinfo->clause);
395
398 }
399#endif
400 /* Now throw it back into the joininfo lists */
402 }
403 }
404
405 /*
406 * There may be references to the rel in root->fkey_list, but if so,
407 * match_foreign_keys_to_quals() will get rid of them.
408 */
409
410 /*
411 * Now remove the rel from the baserel array to prevent it from being
412 * referenced again. (We can't do this earlier because
413 * remove_join_clause_from_rels will touch it.)
414 */
415 root->simple_rel_array[relid] = NULL;
416 root->simple_rte_array[relid] = NULL;
417
418 /* And nuke the RelOptInfo, just in case there's another access path */
419 pfree(rel);
420
421 /*
422 * Now repeat construction of attr_needed bits coming from all other
423 * sources.
424 */
429}
static void remove_rel_from_query(PlannerInfo *root, int relid, int subst, SpecialJoinInfo *sjinfo, Relids joinrelids)
static void remove_rel_from_restrictinfo(RestrictInfo *rinfo, int relid, int ojrelid)
Bitmapset * bms_add_members(Bitmapset *a, const Bitmapset *b)
Definition bitmapset.c:901
void rebuild_eclass_attr_needed(PlannerInfo *root)
void rebuild_lateral_attr_needed(PlannerInfo *root)
Definition initsplan.c:1194
void rebuild_joinclause_attr_needed(PlannerInfo *root)
Definition initsplan.c:3910
void remove_join_clause_from_rels(PlannerInfo *root, RestrictInfo *restrictinfo, Relids join_relids)
Definition joininfo.c:161
List * list_copy(const List *oldlist)
Definition list.c:1573
void pfree(void *pointer)
Definition mcxt.c:1616
void rebuild_placeholder_attr_needed(PlannerInfo *root)
Relids required_relids
Definition pathnodes.h:2932
Relids commute_above_r
Definition pathnodes.h:3233
Relids commute_below_l
Definition pathnodes.h:3234

References Assert, bms_add_member(), bms_add_members(), bms_is_member(), bms_union(), RestrictInfo::clause, SpecialJoinInfo::commute_above_r, SpecialJoinInfo::commute_below_l, distribute_restrictinfo_to_rels(), fb(), find_base_rel(), RelOptInfo::joininfo, lfirst, list_copy(), SpecialJoinInfo::min_lefthand, SpecialJoinInfo::min_righthand, SpecialJoinInfo::ojrelid, pfree(), pull_varnos(), rebuild_eclass_attr_needed(), rebuild_joinclause_attr_needed(), rebuild_lateral_attr_needed(), rebuild_placeholder_attr_needed(), remove_join_clause_from_rels(), remove_rel_from_query(), remove_rel_from_restrictinfo(), RestrictInfo::required_relids, RINFO_IS_PUSHED_DOWN, and root.

Referenced by remove_useless_joins().

◆ remove_rel_from_eclass()

static void remove_rel_from_eclass ( EquivalenceClass ec,
int  relid,
int  ojrelid 
)
static

Definition at line 758 of file analyzejoins.c.

759{
760 ListCell *lc;
761
762 /* Fix up the EC's overall relids */
763 ec->ec_relids = bms_del_member(ec->ec_relids, relid);
764 ec->ec_relids = bms_del_member(ec->ec_relids, ojrelid);
765
766 /*
767 * We don't expect any EC child members to exist at this point. Ensure
768 * that's the case, otherwise, we might be getting asked to do something
769 * this function hasn't been coded for.
770 */
772
773 /*
774 * Fix up the member expressions. Any non-const member that ends with
775 * empty em_relids must be a Var or PHV of the removed relation. We don't
776 * need it anymore, so we can drop it.
777 */
778 foreach(lc, ec->ec_members)
779 {
781
782 if (bms_is_member(relid, cur_em->em_relids) ||
783 bms_is_member(ojrelid, cur_em->em_relids))
784 {
785 Assert(!cur_em->em_is_const);
786 /* em_relids is likely to be shared with some RestrictInfo */
787 cur_em->em_relids = bms_copy(cur_em->em_relids);
788 cur_em->em_relids = bms_del_member(cur_em->em_relids, relid);
789 cur_em->em_relids = bms_del_member(cur_em->em_relids, ojrelid);
790 if (bms_is_empty(cur_em->em_relids))
792 }
793 }
794
795 /* Fix up the source clauses, in case we can re-use them later */
796 foreach(lc, ec->ec_sources)
797 {
798 RestrictInfo *rinfo = (RestrictInfo *) lfirst(lc);
799
800 remove_rel_from_restrictinfo(rinfo, relid, ojrelid);
801 }
802
803 /*
804 * Rather than expend code on fixing up any already-derived clauses, just
805 * drop them. (At this point, any such clauses would be base restriction
806 * clauses, which we'd not need anymore anyway.)
807 */
809}
Bitmapset * bms_del_member(Bitmapset *a, int x)
Definition bitmapset.c:852
void ec_clear_derived_clauses(EquivalenceClass *ec)
List ** ec_childmembers
Definition pathnodes.h:1663

References Assert, bms_copy(), bms_del_member(), bms_is_empty, bms_is_member(), EquivalenceClass::ec_childmembers, ec_clear_derived_clauses(), EquivalenceClass::ec_members, EquivalenceClass::ec_relids, EquivalenceClass::ec_sources, fb(), foreach_delete_current, lfirst, and remove_rel_from_restrictinfo().

Referenced by remove_rel_from_query().

◆ remove_rel_from_joinlist()

static List * remove_rel_from_joinlist ( List joinlist,
int  relid,
int nremoved 
)
static

Definition at line 821 of file analyzejoins.c.

822{
823 List *result = NIL;
824 ListCell *jl;
825
826 foreach(jl, joinlist)
827 {
828 Node *jlnode = (Node *) lfirst(jl);
829
830 if (IsA(jlnode, RangeTblRef))
831 {
832 int varno = ((RangeTblRef *) jlnode)->rtindex;
833
834 if (varno == relid)
835 (*nremoved)++;
836 else
838 }
839 else if (IsA(jlnode, List))
840 {
841 /* Recurse to handle subproblem */
842 List *sublist;
843
845 relid, nremoved);
846 /* Avoid including empty sub-lists in the result */
847 if (sublist)
849 }
850 else
851 {
852 elog(ERROR, "unrecognized joinlist node type: %d",
853 (int) nodeTag(jlnode));
854 }
855 }
856
857 return result;
858}
static List * remove_rel_from_joinlist(List *joinlist, int relid, int *nremoved)
uint32 result
#define ERROR
Definition elog.h:40
#define elog(elevel,...)
Definition elog.h:228
#define nodeTag(nodeptr)
Definition nodes.h:139

References elog, ERROR, fb(), IsA, lappend(), lfirst, NIL, nodeTag, remove_rel_from_joinlist(), and result.

Referenced by remove_rel_from_joinlist(), remove_useless_joins(), and remove_useless_self_joins().

◆ remove_rel_from_query()

static void remove_rel_from_query ( PlannerInfo root,
int  relid,
int  subst,
SpecialJoinInfo sjinfo,
Relids  joinrelids 
)
static

Definition at line 449 of file analyzejoins.c.

452{
453 int ojrelid = sjinfo ? sjinfo->ojrelid : 0;
454 Index rti;
455 ListCell *l;
456 bool is_outer_join = (sjinfo != NULL);
457 bool is_self_join = (!is_outer_join && subst > 0);
458
460 Assert(!is_outer_join || ojrelid > 0);
462
463 /*
464 * Update all_baserels and related relid sets.
465 */
466 root->all_baserels = adjust_relid_set(root->all_baserels, relid, subst);
467 root->all_query_rels = adjust_relid_set(root->all_query_rels, relid, subst);
468
469 if (is_outer_join)
470 {
471 root->outer_join_rels = bms_del_member(root->outer_join_rels, ojrelid);
472 root->all_query_rels = bms_del_member(root->all_query_rels, ojrelid);
473 }
474
475 /*
476 * Likewise remove references from SpecialJoinInfo data structures.
477 *
478 * This is relevant in case the relation we're deleting is part of the
479 * relid sets of special joins: those sets have to be adjusted. If we are
480 * removing an outer join, the RHS of the target outer join will be made
481 * empty here, but that's OK since the caller will delete that
482 * SpecialJoinInfo entirely.
483 */
484 foreach(l, root->join_info_list)
485 {
487
488 /*
489 * initsplan.c is fairly cavalier about allowing SpecialJoinInfos'
490 * lefthand/righthand relid sets to be shared with other data
491 * structures. Ensure that we don't modify the original relid sets.
492 * (The commute_xxx sets are always per-SpecialJoinInfo though.)
493 */
494 sjinf->min_lefthand = bms_copy(sjinf->min_lefthand);
495 sjinf->min_righthand = bms_copy(sjinf->min_righthand);
496 sjinf->syn_lefthand = bms_copy(sjinf->syn_lefthand);
497 sjinf->syn_righthand = bms_copy(sjinf->syn_righthand);
498
499 /* Now adjust relid bit in the sets: */
500 sjinf->min_lefthand = adjust_relid_set(sjinf->min_lefthand, relid, subst);
501 sjinf->min_righthand = adjust_relid_set(sjinf->min_righthand, relid, subst);
502 sjinf->syn_lefthand = adjust_relid_set(sjinf->syn_lefthand, relid, subst);
503 sjinf->syn_righthand = adjust_relid_set(sjinf->syn_righthand, relid, subst);
504
505 if (is_outer_join)
506 {
507 /* Remove ojrelid bit from the sets: */
508 sjinf->min_lefthand = bms_del_member(sjinf->min_lefthand, ojrelid);
509 sjinf->min_righthand = bms_del_member(sjinf->min_righthand, ojrelid);
510 sjinf->syn_lefthand = bms_del_member(sjinf->syn_lefthand, ojrelid);
511 sjinf->syn_righthand = bms_del_member(sjinf->syn_righthand, ojrelid);
512 /* relid cannot appear in these fields, but ojrelid can: */
513 sjinf->commute_above_l = bms_del_member(sjinf->commute_above_l, ojrelid);
514 sjinf->commute_above_r = bms_del_member(sjinf->commute_above_r, ojrelid);
515 sjinf->commute_below_l = bms_del_member(sjinf->commute_below_l, ojrelid);
516 sjinf->commute_below_r = bms_del_member(sjinf->commute_below_r, ojrelid);
517 }
518 else
519 {
520 /*
521 * For self-join removal, replace relid references in
522 * semi_rhs_exprs.
523 */
524 ChangeVarNodesExtended((Node *) sjinf->semi_rhs_exprs, relid, subst,
526 }
527 }
528
529 /*
530 * Likewise remove references from PlaceHolderVar data structures,
531 * removing any no-longer-needed placeholders entirely. We only remove
532 * PHVs for left-join removal. With self-join elimination, PHVs already
533 * get moved to the remaining relation, where they might still be needed.
534 * It might also happen that we skip the removal of some PHVs that could
535 * be removed. However, the overhead of extra PHVs is small compared to
536 * the complexity of analysis needed to remove them.
537 *
538 * Removal is a bit trickier than it might seem: we can remove PHVs that
539 * are used at the target rel and/or in the join qual, but not those that
540 * are used at join partner rels or above the join. It's not that easy to
541 * distinguish PHVs used at partner rels from those used in the join qual,
542 * since they will both have ph_needed sets that are subsets of
543 * joinrelids. However, a PHV used at a partner rel could not have the
544 * target rel in ph_eval_at, so we check that while deciding whether to
545 * remove or just update the PHV. There is no corresponding test in
546 * join_is_removable because it doesn't need to distinguish those cases.
547 */
548 foreach(l, root->placeholder_list)
549 {
551
552 Assert(!is_outer_join || !bms_is_member(relid, phinfo->ph_lateral));
553
554 if (is_outer_join &&
555 bms_is_subset(phinfo->ph_needed, joinrelids) &&
556 bms_is_member(relid, phinfo->ph_eval_at) &&
557 !bms_is_member(ojrelid, phinfo->ph_eval_at))
558 {
559 root->placeholder_list = foreach_delete_current(root->placeholder_list,
560 l);
561 root->placeholder_array[phinfo->phid] = NULL;
562 }
563 else
564 {
565 PlaceHolderVar *phv = phinfo->ph_var;
566
567 phinfo->ph_eval_at = adjust_relid_set(phinfo->ph_eval_at, relid, subst);
568 if (is_outer_join)
569 phinfo->ph_eval_at = bms_del_member(phinfo->ph_eval_at, ojrelid);
570 Assert(!bms_is_empty(phinfo->ph_eval_at)); /* checked previously */
571
572 /* Reduce ph_needed to contain only "relation 0"; see below */
573 if (bms_is_member(0, phinfo->ph_needed))
574 phinfo->ph_needed = bms_make_singleton(0);
575 else
576 phinfo->ph_needed = NULL;
577
578 phv->phrels = adjust_relid_set(phv->phrels, relid, subst);
579 if (is_outer_join)
580 phv->phrels = bms_del_member(phv->phrels, ojrelid);
581 Assert(!bms_is_empty(phv->phrels));
582
583 /*
584 * For self-join removal, update Var nodes within the PHV's
585 * expression to reference the replacement relid, and adjust
586 * ph_lateral for the relid substitution. (For left-join removal,
587 * we're removing rather than replacing, and any surviving PHV
588 * shouldn't reference the removed rel in its expression. Also,
589 * relid can't appear in ph_lateral for outer joins.)
590 */
591 if (is_self_join)
592 {
593 ChangeVarNodesExtended((Node *) phv->phexpr, relid, subst, 0,
595 phinfo->ph_lateral = adjust_relid_set(phinfo->ph_lateral, relid, subst);
596
597 /*
598 * ph_lateral might contain rels mentioned in ph_eval_at after
599 * the replacement, remove them.
600 */
601 phinfo->ph_lateral = bms_difference(phinfo->ph_lateral, phinfo->ph_eval_at);
602 /* ph_lateral might or might not be empty */
603 }
604
605 Assert(phv->phnullingrels == NULL); /* no need to adjust */
606 }
607 }
608
609 /*
610 * Likewise remove references from EquivalenceClasses.
611 *
612 * For self-join removal, the caller has already updated the
613 * EquivalenceClasses, so we can skip this step.
614 */
615 if (is_outer_join)
616 {
617 foreach(l, root->eq_classes)
618 {
620
621 if (bms_is_member(relid, ec->ec_relids) ||
622 bms_is_member(ojrelid, ec->ec_relids))
623 remove_rel_from_eclass(ec, relid, ojrelid);
624 }
625 }
626
627 /*
628 * Finally, we must prepare for the caller to recompute per-Var
629 * attr_needed and per-PlaceHolderVar ph_needed relid sets. These have to
630 * be known accurately, else we may fail to remove other now-removable
631 * joins. Because the caller removes the join clause(s) associated with
632 * the removed join, Vars that were formerly needed may no longer be.
633 *
634 * The actual reconstruction of these relid sets is performed by the
635 * specific caller. Here, we simply clear out the existing attr_needed
636 * sets (we already did this above for ph_needed) to ensure they are
637 * rebuilt from scratch. We can cheat to one small extent: we can avoid
638 * re-examining the targetlist and HAVING qual by preserving "relation 0"
639 * bits from the existing relid sets. This is safe because we'd never
640 * remove such references.
641 *
642 * Additionally, if we are performing self-join elimination, we must
643 * replace references to the removed relid with subst within the
644 * lateral_vars lists.
645 */
646 for (rti = 1; rti < root->simple_rel_array_size; rti++)
647 {
648 RelOptInfo *otherrel = root->simple_rel_array[rti];
649 int attroff;
650
651 /* there may be empty slots corresponding to non-baserel RTEs */
652 if (otherrel == NULL)
653 continue;
654
655 Assert(otherrel->relid == rti); /* sanity check on array */
656
657 for (attroff = otherrel->max_attr - otherrel->min_attr;
658 attroff >= 0;
659 attroff--)
660 {
661 if (bms_is_member(0, otherrel->attr_needed[attroff]))
662 otherrel->attr_needed[attroff] = bms_make_singleton(0);
663 else
664 otherrel->attr_needed[attroff] = NULL;
665 }
666
667 if (is_self_join)
668 ChangeVarNodesExtended((Node *) otherrel->lateral_vars, relid,
669 subst, 0, replace_relid_callback);
670 }
671}
static void remove_rel_from_eclass(EquivalenceClass *ec, int relid, int ojrelid)
Bitmapset * bms_difference(const Bitmapset *a, const Bitmapset *b)
Definition bitmapset.c:346
Bitmapset * bms_make_singleton(int x)
Definition bitmapset.c:216
Relids adjust_relid_set(Relids relids, int oldrelid, int newrelid)

References adjust_relid_set(), Assert, bms_copy(), bms_del_member(), bms_difference(), bms_is_empty, bms_is_member(), bms_is_subset(), bms_make_singleton(), ChangeVarNodesExtended(), EquivalenceClass::ec_relids, fb(), foreach_delete_current, lfirst, SpecialJoinInfo::min_lefthand, SpecialJoinInfo::ojrelid, remove_rel_from_eclass(), replace_relid_callback(), and root.

Referenced by remove_leftjoinrel_from_query(), and remove_self_join_rel().

◆ remove_rel_from_restrictinfo()

static void remove_rel_from_restrictinfo ( RestrictInfo rinfo,
int  relid,
int  ojrelid 
)
static

Definition at line 682 of file analyzejoins.c.

683{
684 /*
685 * initsplan.c is fairly cavalier about allowing RestrictInfos to share
686 * relid sets with other RestrictInfos, and SpecialJoinInfos too. Make
687 * sure this RestrictInfo has its own relid sets before we modify them.
688 * (In present usage, clause_relids is probably not shared, but
689 * required_relids could be; let's not assume anything.)
690 */
691 rinfo->clause_relids = bms_copy(rinfo->clause_relids);
692 rinfo->clause_relids = bms_del_member(rinfo->clause_relids, relid);
693 rinfo->clause_relids = bms_del_member(rinfo->clause_relids, ojrelid);
694 /* Likewise for required_relids */
696 rinfo->required_relids = bms_del_member(rinfo->required_relids, relid);
697 rinfo->required_relids = bms_del_member(rinfo->required_relids, ojrelid);
698 /* Likewise for incompatible_relids */
702 /* Likewise for outer_relids */
703 rinfo->outer_relids = bms_copy(rinfo->outer_relids);
704 rinfo->outer_relids = bms_del_member(rinfo->outer_relids, relid);
705 rinfo->outer_relids = bms_del_member(rinfo->outer_relids, ojrelid);
706 /* Likewise for left_relids */
707 rinfo->left_relids = bms_copy(rinfo->left_relids);
708 rinfo->left_relids = bms_del_member(rinfo->left_relids, relid);
709 rinfo->left_relids = bms_del_member(rinfo->left_relids, ojrelid);
710 /* Likewise for right_relids */
711 rinfo->right_relids = bms_copy(rinfo->right_relids);
712 rinfo->right_relids = bms_del_member(rinfo->right_relids, relid);
713 rinfo->right_relids = bms_del_member(rinfo->right_relids, ojrelid);
714
715 /* If it's an OR, recurse to clean up sub-clauses */
716 if (restriction_is_or_clause(rinfo))
717 {
718 ListCell *lc;
719
720 Assert(is_orclause(rinfo->orclause));
721 foreach(lc, ((BoolExpr *) rinfo->orclause)->args)
722 {
723 Node *orarg = (Node *) lfirst(lc);
724
725 /* OR arguments should be ANDs or sub-RestrictInfos */
726 if (is_andclause(orarg))
727 {
728 List *andargs = ((BoolExpr *) orarg)->args;
729 ListCell *lc2;
730
731 foreach(lc2, andargs)
732 {
734
735 remove_rel_from_restrictinfo(rinfo2, relid, ojrelid);
736 }
737 }
738 else
739 {
741
742 remove_rel_from_restrictinfo(rinfo2, relid, ojrelid);
743 }
744 }
745 }
746}
static bool is_andclause(const void *clause)
Definition nodeFuncs.h:107
static bool is_orclause(const void *clause)
Definition nodeFuncs.h:116
bool restriction_is_or_clause(RestrictInfo *restrictinfo)
Relids outer_relids
Definition pathnodes.h:2938
Relids incompatible_relids
Definition pathnodes.h:2935

References Assert, bms_copy(), bms_del_member(), castNode, fb(), RestrictInfo::incompatible_relids, is_andclause(), is_orclause(), lfirst, lfirst_node, RestrictInfo::outer_relids, remove_rel_from_restrictinfo(), RestrictInfo::required_relids, and restriction_is_or_clause().

Referenced by remove_leftjoinrel_from_query(), remove_rel_from_eclass(), and remove_rel_from_restrictinfo().

◆ remove_self_join_rel()

static void remove_self_join_rel ( PlannerInfo root,
PlanRowMark kmark,
PlanRowMark rmark,
RelOptInfo toKeep,
RelOptInfo toRemove,
List restrictlist 
)
static

Definition at line 1874 of file analyzejoins.c.

1877{
1878 List *joininfos;
1879 ListCell *lc;
1880 int i;
1883
1884 Assert(toKeep->relid > 0);
1885 Assert(toRemove->relid > 0);
1886
1887 /*
1888 * Replace the index of the removing table with the keeping one. The
1889 * technique of removing/distributing restrictinfo is used here to attach
1890 * just appeared (for keeping relation) join clauses and avoid adding
1891 * duplicates of those that already exist in the joininfo list.
1892 */
1893 joininfos = list_copy(toRemove->joininfo);
1895 {
1896 remove_join_clause_from_rels(root, rinfo, rinfo->required_relids);
1897 ChangeVarNodesExtended((Node *) rinfo, toRemove->relid, toKeep->relid,
1899
1900 if (bms_membership(rinfo->required_relids) == BMS_MULTIPLE)
1902 else
1904 }
1905
1906 /*
1907 * Concatenate restrictlist to the list of base restrictions of the
1908 * removing table just to simplify the replacement procedure: all of them
1909 * weren't connected to any keeping relations and need to be added to some
1910 * rels.
1911 */
1912 toRemove->baserestrictinfo = list_concat(toRemove->baserestrictinfo,
1913 restrictlist);
1914 foreach_node(RestrictInfo, rinfo, toRemove->baserestrictinfo)
1915 {
1916 ChangeVarNodesExtended((Node *) rinfo, toRemove->relid, toKeep->relid,
1918
1919 if (bms_membership(rinfo->required_relids) == BMS_MULTIPLE)
1921 else
1923 }
1924
1925 /*
1926 * Now, add all non-redundant clauses to the keeping relation.
1927 */
1929 &toKeep->baserestrictinfo, toRemove->relid);
1931 &toKeep->joininfo, toRemove->relid);
1932
1935
1936 /*
1937 * Arrange equivalence classes, mentioned removing a table, with the
1938 * keeping one: varno of removing table should be replaced in members and
1939 * sources lists. Also, remove duplicated elements if this replacement
1940 * procedure created them.
1941 */
1942 i = -1;
1943 while ((i = bms_next_member(toRemove->eclass_indexes, i)) >= 0)
1944 {
1945 EquivalenceClass *ec = (EquivalenceClass *) list_nth(root->eq_classes, i);
1946
1947 update_eclasses(ec, toRemove->relid, toKeep->relid);
1948 toKeep->eclass_indexes = bms_add_member(toKeep->eclass_indexes, i);
1949 }
1950
1951 /*
1952 * Transfer the targetlist and attr_needed flags.
1953 */
1954
1955 foreach(lc, toRemove->reltarget->exprs)
1956 {
1957 Node *node = lfirst(lc);
1958
1959 ChangeVarNodesExtended(node, toRemove->relid, toKeep->relid, 0,
1961 if (!list_member(toKeep->reltarget->exprs, node))
1962 toKeep->reltarget->exprs = lappend(toKeep->reltarget->exprs, node);
1963 }
1964
1965 for (i = toKeep->min_attr; i <= toKeep->max_attr; i++)
1966 {
1967 int attno = i - toKeep->min_attr;
1968
1969 toRemove->attr_needed[attno] = adjust_relid_set(toRemove->attr_needed[attno],
1970 toRemove->relid, toKeep->relid);
1971 toKeep->attr_needed[attno] = bms_add_members(toKeep->attr_needed[attno],
1972 toRemove->attr_needed[attno]);
1973 }
1974
1975 /*
1976 * If the removed relation has a row mark, transfer it to the remaining
1977 * one.
1978 *
1979 * If both rels have row marks, just keep the one corresponding to the
1980 * remaining relation because we verified earlier that they have the same
1981 * strength.
1982 */
1983 if (rmark)
1984 {
1985 if (kmark)
1986 {
1987 Assert(kmark->markType == rmark->markType);
1988
1989 root->rowMarks = list_delete_ptr(root->rowMarks, rmark);
1990 }
1991 else
1992 {
1993 /* Shouldn't have inheritance children here. */
1994 Assert(rmark->rti == rmark->prti);
1995
1996 rmark->rti = rmark->prti = toKeep->relid;
1997 }
1998 }
1999
2000 /*
2001 * Replace varno in all the query structures, except nodes RangeTblRef
2002 * otherwise later remove_rel_from_joinlist will yield errors.
2003 */
2004 ChangeVarNodesExtended((Node *) root->parse, toRemove->relid, toKeep->relid,
2006
2007 /* Replace links in the planner info */
2009
2010 /* Replace varno in the fully-processed targetlist */
2011 ChangeVarNodesExtended((Node *) root->processed_tlist, toRemove->relid,
2012 toKeep->relid, 0, replace_relid_callback);
2013
2014 /*
2015 * No need to touch all_result_relids or leaf_result_relids: at this point
2016 * those sets contain only parse->resultRelation; inheritance children
2017 * have not been added yet; that happens later in add_other_rels_to_query.
2018 * And remove_self_joins_recurse rejects parse->resultRelation as an SJE
2019 * candidate to preserve the EPQ mechanism. So toRemove->relid cannot be
2020 * a member.
2021 */
2022 Assert(!bms_is_member(toRemove->relid, root->all_result_relids));
2023 Assert(!bms_is_member(toRemove->relid, root->leaf_result_relids));
2024
2025 /*
2026 * There may be references to the rel in root->fkey_list, but if so,
2027 * match_foreign_keys_to_quals() will get rid of them.
2028 */
2029
2030 /*
2031 * Finally, remove the rel from the baserel array to prevent it from being
2032 * referenced again. (We can't do this earlier because
2033 * remove_join_clause_from_rels will touch it.)
2034 */
2035 root->simple_rel_array[toRemove->relid] = NULL;
2036 root->simple_rte_array[toRemove->relid] = NULL;
2037
2038 /* And nuke the RelOptInfo, just in case there's another access path. */
2039 pfree(toRemove);
2040
2041
2042 /*
2043 * Now repeat construction of attr_needed bits coming from all other
2044 * sources.
2045 */
2050}
static void add_non_redundant_clauses(PlannerInfo *root, List *rinfo_candidates, List **keep_rinfo_list, Index removed_relid)
static void update_eclasses(EquivalenceClass *ec, int from, int to)
int bms_next_member(const Bitmapset *a, int prevbit)
Definition bitmapset.c:1290
BMS_Membership bms_membership(const Bitmapset *a)
Definition bitmapset.c:765
@ BMS_MULTIPLE
Definition bitmapset.h:73
int i
Definition isn.c:77
List * list_delete_ptr(List *list, void *datum)
Definition list.c:872
void list_free(List *list)
Definition list.c:1546
bool list_member(const List *list, const void *datum)
Definition list.c:661
static void * list_nth(const List *list, int n)
Definition pg_list.h:331

References add_non_redundant_clauses(), adjust_relid_set(), Assert, bms_add_member(), bms_add_members(), bms_is_member(), bms_membership(), BMS_MULTIPLE, bms_next_member(), ChangeVarNodesExtended(), fb(), foreach_node, i, lappend(), lfirst, list_concat(), list_copy(), list_delete_ptr(), list_free(), list_member(), list_nth(), NIL, pfree(), rebuild_eclass_attr_needed(), rebuild_joinclause_attr_needed(), rebuild_lateral_attr_needed(), rebuild_placeholder_attr_needed(), remove_join_clause_from_rels(), remove_rel_from_query(), replace_relid_callback(), root, and update_eclasses().

Referenced by remove_self_joins_one_group().

◆ remove_self_joins_one_group()

static Relids remove_self_joins_one_group ( PlannerInfo root,
Relids  relids 
)
static

Definition at line 2193 of file analyzejoins.c.

2194{
2195 Relids result = NULL;
2196 int k; /* Index of kept relation */
2197 int r = -1; /* Index of removed relation */
2198
2199 while ((r = bms_next_member(relids, r)) > 0)
2200 {
2201 RelOptInfo *rrel = root->simple_rel_array[r];
2202
2203 k = r;
2204
2205 while ((k = bms_next_member(relids, k)) > 0)
2206 {
2208 RelOptInfo *krel = root->simple_rel_array[k];
2209 List *restrictlist;
2212 ListCell *lc;
2213 bool jinfo_check = true;
2216 List *uclauses = NIL;
2217
2218 /* A sanity check: the relations have the same Oid. */
2219 Assert(root->simple_rte_array[k]->relid ==
2220 root->simple_rte_array[r]->relid);
2221
2222 /*
2223 * It is impossible to eliminate the join of two relations if they
2224 * belong to different rules of order. Otherwise, the planner
2225 * can't find any variants of the correct query plan.
2226 */
2227 foreach(lc, root->join_info_list)
2228 {
2230
2231 if ((bms_is_member(k, info->syn_lefthand) ^
2232 bms_is_member(r, info->syn_lefthand)) ||
2233 (bms_is_member(k, info->syn_righthand) ^
2234 bms_is_member(r, info->syn_righthand)))
2235 {
2236 jinfo_check = false;
2237 break;
2238 }
2239 }
2240 if (!jinfo_check)
2241 continue;
2242
2243 /*
2244 * Check Row Marks equivalence. We can't remove the join if the
2245 * relations have row marks of different strength (e.g., one is
2246 * locked FOR UPDATE, and another just has ROW_MARK_REFERENCE for
2247 * EvalPlanQual rechecking).
2248 */
2249 foreach(lc, root->rowMarks)
2250 {
2252
2253 if (rowMark->rti == r)
2254 {
2255 Assert(rmark == NULL);
2256 rmark = rowMark;
2257 }
2258 else if (rowMark->rti == k)
2259 {
2260 Assert(kmark == NULL);
2261 kmark = rowMark;
2262 }
2263
2264 if (kmark && rmark)
2265 break;
2266 }
2267 if (kmark && rmark && kmark->markType != rmark->markType)
2268 continue;
2269
2270 /*
2271 * We only deal with base rels here, so their relids bitset
2272 * contains only one member -- their relid.
2273 */
2276
2277 /*
2278 * PHVs should not impose any constraints on removing self-joins.
2279 */
2280
2281 /*
2282 * At this stage, joininfo lists of inner and outer can contain
2283 * only clauses required for a superior outer join that can't
2284 * influence this optimization. So, we can avoid to call the
2285 * build_joinrel_restrictlist() routine.
2286 */
2288 rrel->relids,
2289 krel, NULL);
2290 if (restrictlist == NIL)
2291 continue;
2292
2293 /*
2294 * Process restrictlist to separate the self-join quals from the
2295 * other quals. e.g., "x = x" goes to selfjoinquals and "a = b" to
2296 * otherjoinquals.
2297 */
2298 split_selfjoin_quals(root, restrictlist, &selfjoinquals,
2299 &otherjoinquals, rrel->relid, krel->relid);
2300
2301 Assert(list_length(restrictlist) ==
2303
2304 /*
2305 * To enable SJE for the only degenerate case without any self
2306 * join clauses at all, add baserestrictinfo to this list. The
2307 * degenerate case works only if both sides have the same clause.
2308 * So doesn't matter which side to add.
2309 */
2310 selfjoinquals = list_concat(selfjoinquals, krel->baserestrictinfo);
2311
2312 /*
2313 * Determine if the rrel can duplicate outer rows. We must bypass
2314 * the unique rel cache here since we're possibly using a subset
2315 * of join quals. We can use 'force_cache' == true when all join
2316 * quals are self-join quals. Otherwise, we could end up putting
2317 * false negatives in the cache.
2318 */
2322 &uclauses))
2323 continue;
2324
2325 /*
2326 * 'uclauses' is the copy of outer->baserestrictinfo that are
2327 * associated with an index. We proved by matching selfjoinquals
2328 * to a unique index that the outer relation has at most one
2329 * matching row for each inner row. Sometimes that is not enough.
2330 * e.g. "WHERE s1.b = s2.b AND s1.a = 1 AND s2.a = 2" when the
2331 * unique index is (a,b). Having non-empty uclauses, we must
2332 * validate that the inner baserestrictinfo contains the same
2333 * expressions, or we won't match the same row on each side of the
2334 * join.
2335 */
2336 if (!match_unique_clauses(root, rrel, uclauses, krel->relid))
2337 continue;
2338
2339 /*
2340 * Remove rrel RelOptInfo from the planner structures and the
2341 * corresponding row mark.
2342 */
2343 remove_self_join_rel(root, kmark, rmark, krel, rrel, restrictlist);
2344
2346
2347 /* We have removed the outer relation, try the next one. */
2348 break;
2349 }
2350 }
2351
2352 return result;
2353}
static bool match_unique_clauses(PlannerInfo *root, RelOptInfo *outer, List *uclauses, Index relid)
static void split_selfjoin_quals(PlannerInfo *root, List *joinquals, List **selfjoinquals, List **otherjoinquals, int from, int to)
static void remove_self_join_rel(PlannerInfo *root, PlanRowMark *kmark, PlanRowMark *rmark, RelOptInfo *toKeep, RelOptInfo *toRemove, List *restrictlist)
@ JOIN_INNER
Definition nodes.h:303
Relids syn_lefthand
Definition pathnodes.h:3228
Relids syn_righthand
Definition pathnodes.h:3229

References Assert, bms_add_member(), bms_is_member(), bms_next_member(), fb(), generate_join_implied_equalities(), innerrel_is_unique_ext(), JOIN_INNER, lfirst, list_concat(), list_length(), match_unique_clauses(), NIL, remove_self_join_rel(), result, root, split_selfjoin_quals(), SpecialJoinInfo::syn_lefthand, and SpecialJoinInfo::syn_righthand.

Referenced by remove_self_joins_recurse().

◆ remove_self_joins_recurse()

static Relids remove_self_joins_recurse ( PlannerInfo root,
List joinlist,
Relids  toRemove 
)
static

Definition at line 2360 of file analyzejoins.c.

2361{
2362 ListCell *jl;
2363 Relids relids = NULL;
2365 int i;
2366 int j;
2367 int numRels;
2368
2369 /* Collect indexes of base relations of the join tree */
2370 foreach(jl, joinlist)
2371 {
2372 Node *jlnode = (Node *) lfirst(jl);
2373
2374 if (IsA(jlnode, RangeTblRef))
2375 {
2376 int varno = ((RangeTblRef *) jlnode)->rtindex;
2377 RangeTblEntry *rte = root->simple_rte_array[varno];
2378
2379 /*
2380 * We only consider ordinary relations as candidates to be
2381 * removed, and these relations should not have TABLESAMPLE
2382 * clauses specified. Removing a relation with TABLESAMPLE clause
2383 * could potentially change the syntax of the query. Because of
2384 * UPDATE/DELETE EPQ mechanism, currently Query->resultRelation or
2385 * Query->mergeTargetRelation associated rel cannot be eliminated.
2386 */
2387 if (rte->rtekind == RTE_RELATION &&
2388 rte->relkind == RELKIND_RELATION &&
2389 rte->tablesample == NULL &&
2390 varno != root->parse->resultRelation &&
2391 varno != root->parse->mergeTargetRelation)
2392 {
2393 Assert(!bms_is_member(varno, relids));
2394 relids = bms_add_member(relids, varno);
2395 }
2396 }
2397 else if (IsA(jlnode, List))
2398 {
2399 /* Recursively go inside the sub-joinlist */
2401 toRemove);
2402 }
2403 else
2404 elog(ERROR, "unrecognized joinlist node type: %d",
2405 (int) nodeTag(jlnode));
2406 }
2407
2408 numRels = bms_num_members(relids);
2409
2410 /* Need at least two relations for the join */
2411 if (numRels < 2)
2412 return toRemove;
2413
2414 /*
2415 * In order to find relations with the same oid we first build an array of
2416 * candidates and then sort it by oid.
2417 */
2419 i = -1;
2420 j = 0;
2421 while ((i = bms_next_member(relids, i)) >= 0)
2422 {
2423 candidates[j].relid = i;
2424 candidates[j].reloid = root->simple_rte_array[i]->relid;
2425 j++;
2426 }
2427
2430
2431 /*
2432 * Iteratively form a group of relation indexes with the same oid and
2433 * launch the routine that detects self-joins in this group and removes
2434 * excessive range table entries.
2435 *
2436 * At the end of the iteration, exclude the group from the overall relids
2437 * list. So each next iteration of the cycle will involve less and less
2438 * value of relids.
2439 */
2440 i = 0;
2441 for (j = 1; j < numRels + 1; j++)
2442 {
2443 if (j == numRels || candidates[j].reloid != candidates[i].reloid)
2444 {
2445 if (j - i >= 2)
2446 {
2447 /* Create a group of relation indexes with the same oid */
2448 Relids group = NULL;
2450
2451 while (i < j)
2452 {
2453 group = bms_add_member(group, candidates[i].relid);
2454 i++;
2455 }
2456 relids = bms_del_members(relids, group);
2457
2458 /*
2459 * Try to remove self-joins from a group of identical entries.
2460 * Make the next attempt iteratively - if something is deleted
2461 * from a group, changes in clauses and equivalence classes
2462 * can give us a chance to find more candidates.
2463 */
2464 do
2465 {
2466 Assert(!bms_overlap(group, toRemove));
2469 group = bms_del_members(group, removed);
2470 } while (!bms_is_empty(removed) &&
2471 bms_membership(group) == BMS_MULTIPLE);
2473 bms_free(group);
2474 }
2475 else
2476 {
2477 /* Single relation, just remove it from the set */
2478 relids = bms_del_member(relids, candidates[i].relid);
2479 i = j;
2480 }
2481 }
2482 }
2483
2484 Assert(bms_is_empty(relids));
2485
2486 return toRemove;
2487}
static int self_join_candidates_cmp(const void *a, const void *b)
static Relids remove_self_joins_one_group(PlannerInfo *root, Relids relids)
static Relids remove_self_joins_recurse(PlannerInfo *root, List *joinlist, Relids toRemove)
Bitmapset * bms_del_members(Bitmapset *a, const Bitmapset *b)
Definition bitmapset.c:1145
void bms_free(Bitmapset *a)
Definition bitmapset.c:239
int bms_num_members(const Bitmapset *a)
Definition bitmapset.c:744
#define palloc_array(type, count)
Definition fe_memutils.h:76
int j
Definition isn.c:78
#define qsort(a, b, c, d)
Definition port.h:495

References Assert, bms_add_member(), bms_add_members(), bms_del_member(), bms_del_members(), bms_free(), bms_is_empty, bms_is_member(), bms_membership(), BMS_MULTIPLE, bms_next_member(), bms_num_members(), bms_overlap(), elog, ERROR, fb(), i, IsA, j, lfirst, nodeTag, palloc_array, qsort, remove_self_joins_one_group(), remove_self_joins_recurse(), root, RTE_RELATION, and self_join_candidates_cmp().

Referenced by remove_self_joins_recurse(), and remove_useless_self_joins().

◆ remove_useless_joins()

List * remove_useless_joins ( PlannerInfo root,
List joinlist 
)

Definition at line 93 of file analyzejoins.c.

94{
95 ListCell *lc;
96
97 /*
98 * We are only interested in relations that are left-joined to, so we can
99 * scan the join_info_list to find them easily.
100 */
101restart:
102 foreach(lc, root->join_info_list)
103 {
105 int innerrelid;
106 int nremoved;
107
108 /* Skip if not removable */
109 if (!join_is_removable(root, sjinfo))
110 continue;
111
112 /*
113 * Currently, join_is_removable can only succeed when the sjinfo's
114 * righthand is a single baserel. Remove that rel from the query and
115 * joinlist.
116 */
118
120
121 /* We verify that exactly one reference gets removed from joinlist */
122 nremoved = 0;
124 if (nremoved != 1)
125 elog(ERROR, "failed to find relation %d in joinlist", innerrelid);
126
127 /*
128 * We can delete this SpecialJoinInfo from the list too, since it's no
129 * longer of interest. (Since we'll restart the foreach loop
130 * immediately, we don't bother with foreach_delete_current.)
131 */
132 root->join_info_list = list_delete_cell(root->join_info_list, lc);
133
134 /*
135 * Restart the scan. This is necessary to ensure we find all
136 * removable joins independently of ordering of the join_info_list
137 * (note that removal of attr_needed bits may make a join appear
138 * removable that did not before).
139 */
140 goto restart;
141 }
142
143 return joinlist;
144}
static void remove_leftjoinrel_from_query(PlannerInfo *root, int relid, SpecialJoinInfo *sjinfo)
static bool join_is_removable(PlannerInfo *root, SpecialJoinInfo *sjinfo)
int bms_singleton_member(const Bitmapset *a)
Definition bitmapset.c:665
List * list_delete_cell(List *list, ListCell *cell)
Definition list.c:841

References bms_singleton_member(), elog, ERROR, fb(), join_is_removable(), lfirst, list_delete_cell(), SpecialJoinInfo::min_righthand, remove_leftjoinrel_from_query(), remove_rel_from_joinlist(), and root.

Referenced by query_planner().

◆ remove_useless_self_joins()

List * remove_useless_self_joins ( PlannerInfo root,
List joinlist 
)

Definition at line 2540 of file analyzejoins.c.

2541{
2543 int relid = -1;
2544
2547 return joinlist;
2548
2549 /*
2550 * Merge pairs of relations participated in self-join. Remove unnecessary
2551 * range table entries.
2552 */
2554
2555 if (unlikely(toRemove != NULL))
2556 {
2557 /* At the end, remove orphaned relation links */
2558 while ((relid = bms_next_member(toRemove, relid)) >= 0)
2559 {
2560 int nremoved = 0;
2561
2563 if (nremoved != 1)
2564 elog(ERROR, "failed to find relation %d in joinlist", relid);
2565 }
2566 }
2567
2568 return joinlist;
2569}
bool enable_self_join_elimination
#define unlikely(x)
Definition c.h:438
#define linitial(l)
Definition pg_list.h:178

References bms_next_member(), elog, enable_self_join_elimination, ERROR, fb(), IsA, linitial, list_length(), NIL, remove_rel_from_joinlist(), remove_self_joins_recurse(), root, and unlikely.

Referenced by query_planner().

◆ replace_relid_callback()

static bool replace_relid_callback ( Node node,
ChangeVarNodes_context context 
)
static

Definition at line 1750 of file analyzejoins.c.

1751{
1752 if (IsA(node, RangeTblRef))
1753 {
1754 return true;
1755 }
1756 else if (IsA(node, RestrictInfo))
1757 {
1758 RestrictInfo *rinfo = (RestrictInfo *) node;
1759 int relid = -1;
1760 bool is_req_equal =
1761 (rinfo->required_relids == rinfo->clause_relids);
1763 (bms_membership(rinfo->clause_relids) == BMS_MULTIPLE);
1764
1765 /*
1766 * Recurse down into clauses if the target relation is present in
1767 * clause_relids or required_relids. We must check required_relids
1768 * because the relation not present in clause_relids might still be
1769 * present somewhere in orclause.
1770 */
1771 if (bms_is_member(context->rt_index, rinfo->clause_relids) ||
1772 bms_is_member(context->rt_index, rinfo->required_relids))
1773 {
1775
1776 ChangeVarNodesWalkExpression((Node *) rinfo->clause, context);
1777 ChangeVarNodesWalkExpression((Node *) rinfo->orclause, context);
1778
1779 new_clause_relids = adjust_relid_set(rinfo->clause_relids,
1780 context->rt_index,
1781 context->new_index);
1782
1783 /*
1784 * Incrementally adjust num_base_rels based on the change of
1785 * clause_relids, which could contain both base relids and
1786 * outer-join relids. This operation is legal until we remove
1787 * only baserels.
1788 */
1789 rinfo->num_base_rels -= bms_num_members(rinfo->clause_relids) -
1791
1792 rinfo->clause_relids = new_clause_relids;
1793 rinfo->left_relids =
1794 adjust_relid_set(rinfo->left_relids, context->rt_index, context->new_index);
1795 rinfo->right_relids =
1796 adjust_relid_set(rinfo->right_relids, context->rt_index, context->new_index);
1797 }
1798
1799 if (is_req_equal)
1800 rinfo->required_relids = rinfo->clause_relids;
1801 else
1802 rinfo->required_relids =
1803 adjust_relid_set(rinfo->required_relids, context->rt_index, context->new_index);
1804
1805 rinfo->outer_relids =
1806 adjust_relid_set(rinfo->outer_relids, context->rt_index, context->new_index);
1807 rinfo->incompatible_relids =
1808 adjust_relid_set(rinfo->incompatible_relids, context->rt_index, context->new_index);
1809
1810 if (rinfo->mergeopfamilies &&
1811 bms_get_singleton_member(rinfo->clause_relids, &relid) &&
1813 relid == context->new_index && IsA(rinfo->clause, OpExpr))
1814 {
1815 Expr *leftOp;
1816 Expr *rightOp;
1817
1818 leftOp = (Expr *) get_leftop(rinfo->clause);
1819 rightOp = (Expr *) get_rightop(rinfo->clause);
1820
1821 /*
1822 * For self-join elimination, changing varnos could transform
1823 * "t1.a = t2.a" into "t1.a = t1.a". That is always true as long
1824 * as "t1.a" is not null. We use equal() to check for such a
1825 * case, and then we replace the qual with a check for not null
1826 * (NullTest).
1827 */
1828 if (leftOp != NULL && equal(leftOp, rightOp))
1829 {
1831
1832 ntest->arg = leftOp;
1833 ntest->nulltesttype = IS_NOT_NULL;
1834 ntest->argisrow = false;
1835 ntest->location = -1;
1836 rinfo->clause = (Expr *) ntest;
1837 rinfo->mergeopfamilies = NIL;
1838 rinfo->left_em = NULL;
1839 rinfo->right_em = NULL;
1840 }
1841 Assert(rinfo->orclause == NULL);
1842 }
1843 return true;
1844 }
1845
1846 return false;
1847}
@ IS_NOT_NULL
Definition primnodes.h:1992
bool ChangeVarNodesWalkExpression(Node *node, ChangeVarNodes_context *context)

References adjust_relid_set(), Assert, bms_get_singleton_member(), bms_is_member(), bms_membership(), BMS_MULTIPLE, bms_num_members(), ChangeVarNodesWalkExpression(), RestrictInfo::clause, equal(), fb(), get_leftop(), get_rightop(), RestrictInfo::incompatible_relids, IS_NOT_NULL, IsA, makeNode, ChangeVarNodes_context::new_index, NIL, RestrictInfo::outer_relids, RestrictInfo::required_relids, and ChangeVarNodes_context::rt_index.

Referenced by match_unique_clauses(), remove_rel_from_query(), remove_self_join_rel(), split_selfjoin_quals(), and update_eclasses().

◆ restrict_infos_logically_equal()

static bool restrict_infos_logically_equal ( RestrictInfo a,
RestrictInfo b 
)
static

Definition at line 1680 of file analyzejoins.c.

1681{
1682 int saved_rinfo_serial = a->rinfo_serial;
1683 bool result;
1684
1685 a->rinfo_serial = b->rinfo_serial;
1686 result = equal(a, b);
1687 a->rinfo_serial = saved_rinfo_serial;
1688
1689 return result;
1690}
int b
Definition isn.c:74
int a
Definition isn.c:73

References a, b, equal(), fb(), and result.

Referenced by add_non_redundant_clauses().

◆ self_join_candidates_cmp()

static int self_join_candidates_cmp ( const void a,
const void b 
)
static

Definition at line 2493 of file analyzejoins.c.

2494{
2495 const SelfJoinCandidate *ca = (const SelfJoinCandidate *) a;
2496 const SelfJoinCandidate *cb = (const SelfJoinCandidate *) b;
2497
2498 if (ca->reloid != cb->reloid)
2499 return (ca->reloid < cb->reloid ? -1 : 1);
2500 else
2501 return 0;
2502}

References a, b, fb(), and SelfJoinCandidate::reloid.

Referenced by remove_self_joins_recurse().

◆ split_selfjoin_quals()

static void split_selfjoin_quals ( PlannerInfo root,
List joinquals,
List **  selfjoinquals,
List **  otherjoinquals,
int  from,
int  to 
)
static

Definition at line 2062 of file analyzejoins.c.

2064{
2065 List *sjoinquals = NIL;
2066 List *ojoinquals = NIL;
2067
2069 {
2070 OpExpr *expr;
2071 Node *leftexpr;
2072 Node *rightexpr;
2073
2074 /* In general, clause looks like F(arg1) = G(arg2) */
2075 if (!rinfo->mergeopfamilies ||
2076 bms_num_members(rinfo->clause_relids) != 2 ||
2077 bms_membership(rinfo->left_relids) != BMS_SINGLETON ||
2078 bms_membership(rinfo->right_relids) != BMS_SINGLETON)
2079 {
2080 ojoinquals = lappend(ojoinquals, rinfo);
2081 continue;
2082 }
2083
2084 expr = (OpExpr *) rinfo->clause;
2085
2086 if (!IsA(expr, OpExpr) || list_length(expr->args) != 2)
2087 {
2088 ojoinquals = lappend(ojoinquals, rinfo);
2089 continue;
2090 }
2091
2092 leftexpr = get_leftop(rinfo->clause);
2093 rightexpr = copyObject(get_rightop(rinfo->clause));
2094
2096 leftexpr = (Node *) ((RelabelType *) leftexpr)->arg;
2098 rightexpr = (Node *) ((RelabelType *) rightexpr)->arg;
2099
2100 /*
2101 * Quite an expensive operation, narrowing the use case. For example,
2102 * when we have cast of the same var to different (but compatible)
2103 * types.
2104 */
2106 bms_singleton_member(rinfo->right_relids),
2107 bms_singleton_member(rinfo->left_relids), 0,
2109
2110 if (equal(leftexpr, rightexpr))
2111 sjoinquals = lappend(sjoinquals, rinfo);
2112 else
2113 ojoinquals = lappend(ojoinquals, rinfo);
2114 }
2115
2118}
@ BMS_SINGLETON
Definition bitmapset.h:72
Datum arg
Definition elog.c:1323
List * args
Definition primnodes.h:869

References arg, OpExpr::args, bms_membership(), bms_num_members(), BMS_SINGLETON, bms_singleton_member(), ChangeVarNodesExtended(), copyObject, equal(), fb(), foreach_node, get_leftop(), get_rightop(), IsA, lappend(), list_length(), NIL, and replace_relid_callback().

Referenced by remove_self_joins_one_group().

◆ update_eclasses()

static void update_eclasses ( EquivalenceClass ec,
int  from,
int  to 
)
static

Definition at line 1580 of file analyzejoins.c.

1581{
1582 List *new_members = NIL;
1583 List *new_sources = NIL;
1584
1585 /*
1586 * We don't expect any EC child members to exist at this point. Ensure
1587 * that's the case, otherwise, we might be getting asked to do something
1588 * this function hasn't been coded for.
1589 */
1590 Assert(ec->ec_childmembers == NULL);
1591
1593 {
1594 bool is_redundant = false;
1595
1596 if (!bms_is_member(from, em->em_relids))
1597 {
1599 continue;
1600 }
1601
1602 em->em_relids = adjust_relid_set(em->em_relids, from, to);
1603 em->em_jdomain->jd_relids = adjust_relid_set(em->em_jdomain->jd_relids, from, to);
1604
1605 /* We only process inner joins */
1606 ChangeVarNodesExtended((Node *) em->em_expr, from, to, 0,
1608
1610 {
1611 if (!equal(em->em_relids, other->em_relids))
1612 continue;
1613
1614 if (equal(em->em_expr, other->em_expr))
1615 {
1616 is_redundant = true;
1617 break;
1618 }
1619 }
1620
1621 if (!is_redundant)
1623 }
1624
1625 list_free(ec->ec_members);
1626 ec->ec_members = new_members;
1627
1629
1630 /* Update EC source expressions */
1632 {
1633 bool is_redundant = false;
1634
1635 if (!bms_is_member(from, rinfo->required_relids))
1636 {
1638 continue;
1639 }
1640
1641 ChangeVarNodesExtended((Node *) rinfo, from, to, 0,
1643
1644 /*
1645 * After switching the clause to the remaining relation, check it for
1646 * redundancy with existing ones. We don't have to check for
1647 * redundancy with derived clauses, because we've just deleted them.
1648 */
1650 {
1651 if (!equal(rinfo->clause_relids, other->clause_relids))
1652 continue;
1653
1654 if (equal(rinfo->clause, other->clause))
1655 {
1656 is_redundant = true;
1657 break;
1658 }
1659 }
1660
1661 if (!is_redundant)
1663 }
1664
1665 list_free(ec->ec_sources);
1666 ec->ec_sources = new_sources;
1667 ec->ec_relids = adjust_relid_set(ec->ec_relids, from, to);
1668}

References adjust_relid_set(), Assert, bms_is_member(), ChangeVarNodesExtended(), EquivalenceClass::ec_childmembers, ec_clear_derived_clauses(), EquivalenceClass::ec_members, EquivalenceClass::ec_relids, EquivalenceClass::ec_sources, equal(), fb(), foreach_node, lappend(), list_free(), NIL, and replace_relid_callback().

Referenced by remove_self_join_rel().

Variable Documentation

◆ enable_self_join_elimination

bool enable_self_join_elimination

Definition at line 54 of file analyzejoins.c.

Referenced by remove_useless_self_joins().