Age Owner Branch data TLA Line data Source code
1 : : /*-------------------------------------------------------------------------
2 : : *
3 : : * plancat.c
4 : : * routines for accessing the system catalogs
5 : : *
6 : : *
7 : : * Portions Copyright (c) 1996-2026, PostgreSQL Global Development Group
8 : : * Portions Copyright (c) 1994, Regents of the University of California
9 : : *
10 : : *
11 : : * IDENTIFICATION
12 : : * src/backend/optimizer/util/plancat.c
13 : : *
14 : : *-------------------------------------------------------------------------
15 : : */
16 : : #include "postgres.h"
17 : :
18 : : #include <math.h>
19 : :
20 : : #include "access/genam.h"
21 : : #include "access/htup_details.h"
22 : : #include "access/nbtree.h"
23 : : #include "access/sysattr.h"
24 : : #include "access/table.h"
25 : : #include "access/tableam.h"
26 : : #include "access/transam.h"
27 : : #include "access/xlog.h"
28 : : #include "catalog/catalog.h"
29 : : #include "catalog/heap.h"
30 : : #include "catalog/pg_am.h"
31 : : #include "catalog/pg_proc.h"
32 : : #include "catalog/pg_statistic_ext.h"
33 : : #include "catalog/pg_statistic_ext_data.h"
34 : : #include "foreign/fdwapi.h"
35 : : #include "miscadmin.h"
36 : : #include "nodes/makefuncs.h"
37 : : #include "nodes/nodeFuncs.h"
38 : : #include "nodes/supportnodes.h"
39 : : #include "optimizer/cost.h"
40 : : #include "optimizer/optimizer.h"
41 : : #include "optimizer/plancat.h"
42 : : #include "parser/parse_relation.h"
43 : : #include "parser/parsetree.h"
44 : : #include "partitioning/partdesc.h"
45 : : #include "rewrite/rewriteHandler.h"
46 : : #include "rewrite/rewriteManip.h"
47 : : #include "statistics/statistics.h"
48 : : #include "storage/bufmgr.h"
49 : : #include "tcop/tcopprot.h"
50 : : #include "utils/builtins.h"
51 : : #include "utils/lsyscache.h"
52 : : #include "utils/partcache.h"
53 : : #include "utils/rel.h"
54 : : #include "utils/snapmgr.h"
55 : : #include "utils/syscache.h"
56 : :
57 : : /* GUC parameter */
58 : : int constraint_exclusion = CONSTRAINT_EXCLUSION_PARTITION;
59 : :
60 : : typedef struct NotnullHashEntry
61 : : {
62 : : Oid relid; /* OID of the relation */
63 : : Bitmapset *notnullattnums; /* attnums of NOT NULL columns */
64 : : } NotnullHashEntry;
65 : :
66 : :
67 : : static void get_relation_foreign_keys(PlannerInfo *root, RelOptInfo *rel,
68 : : Relation relation, bool inhparent);
69 : : static bool infer_collation_opclass_match(InferenceElem *elem, Relation idxRel,
70 : : List *idxExprs);
71 : : static List *get_relation_constraints(PlannerInfo *root,
72 : : Oid relationObjectId, RelOptInfo *rel,
73 : : bool include_noinherit,
74 : : bool include_notnull,
75 : : bool include_partition);
76 : : static List *build_index_tlist(PlannerInfo *root, IndexOptInfo *index,
77 : : Relation heapRelation);
78 : : static List *get_relation_statistics(PlannerInfo *root, RelOptInfo *rel,
79 : : Relation relation);
80 : : static void set_relation_partition_info(PlannerInfo *root, RelOptInfo *rel,
81 : : Relation relation);
82 : : static PartitionScheme find_partition_scheme(PlannerInfo *root,
83 : : Relation relation);
84 : : static void set_baserel_partition_key_exprs(Relation relation,
85 : : RelOptInfo *rel);
86 : : static void set_baserel_partition_constraint(Relation relation,
87 : : RelOptInfo *rel);
88 : :
89 : :
90 : : /*
91 : : * get_relation_info -
92 : : * Retrieves catalog information for a given relation.
93 : : *
94 : : * Given the Oid of the relation, return the following info into fields
95 : : * of the RelOptInfo struct:
96 : : *
97 : : * min_attr lowest valid AttrNumber
98 : : * max_attr highest valid AttrNumber
99 : : * indexlist list of IndexOptInfos for relation's indexes
100 : : * statlist list of StatisticExtInfo for relation's statistic objects
101 : : * serverid if it's a foreign table, the server OID
102 : : * fdwroutine if it's a foreign table, the FDW function pointers
103 : : * pages number of pages
104 : : * tuples number of tuples
105 : : * rel_parallel_workers user-defined number of parallel workers
106 : : *
107 : : * Also, add information about the relation's foreign keys to root->fkey_list.
108 : : *
109 : : * Also, initialize the attr_needed[] and attr_widths[] arrays. In most
110 : : * cases these are left as zeroes, but sometimes we need to compute attr
111 : : * widths here, and we may as well cache the results for costsize.c.
112 : : *
113 : : * If inhparent is true, all we need to do is set up the attr arrays:
114 : : * the RelOptInfo actually represents the appendrel formed by an inheritance
115 : : * tree, and so the parent rel's physical size and index information isn't
116 : : * important for it, however, for partitioned tables, we do populate the
117 : : * indexlist as the planner uses unique indexes as unique proofs for certain
118 : : * optimizations.
119 : : */
120 : : void
7168 tgl@sss.pgh.pa.us 121 :CBC 374141 : get_relation_info(PlannerInfo *root, Oid relationObjectId, bool inhparent,
122 : : RelOptInfo *rel)
123 : : {
8487 124 : 374141 : Index varno = rel->relid;
125 : : Relation relation;
126 : : bool hasindex;
8492 127 : 374141 : List *indexinfos = NIL;
128 : :
129 : : /*
130 : : * We need not lock the relation since it was already locked, either by
131 : : * the rewriter or when expand_inherited_rtentry() added it to the query's
132 : : * rangetable.
133 : : */
2661 andres@anarazel.de 134 : 374141 : relation = table_open(relationObjectId, NoLock);
135 : :
136 : : /*
137 : : * Relations without a table AM can be used in a query only if they are of
138 : : * special-cased relkinds. This check prevents us from crashing later if,
139 : : * for example, a view's ON SELECT rule has gone missing. Note that
140 : : * table_open() already rejected indexes and composite types; spell the
141 : : * error the same way it does.
142 : : */
1296 tgl@sss.pgh.pa.us 143 [ + + ]: 374141 : if (!relation->rd_tableam)
144 : : {
145 [ + + ]: 15462 : if (!(relation->rd_rel->relkind == RELKIND_FOREIGN_TABLE ||
146 [ - + ]: 14174 : relation->rd_rel->relkind == RELKIND_PARTITIONED_TABLE))
1296 tgl@sss.pgh.pa.us 147 [ # # ]:UBC 0 : ereport(ERROR,
148 : : (errcode(ERRCODE_WRONG_OBJECT_TYPE),
149 : : errmsg("cannot open relation \"%s\"",
150 : : RelationGetRelationName(relation)),
151 : : errdetail_relkind_not_supported(relation->rd_rel->relkind)));
152 : : }
153 : :
154 : : /* Temporary and unlogged relations are inaccessible during recovery. */
1870 bruce@momjian.us 155 [ + + - + ]:CBC 374141 : if (!RelationIsPermanent(relation) && RecoveryInProgress())
5446 rhaas@postgresql.org 156 [ # # ]:UBC 0 : ereport(ERROR,
157 : : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
158 : : errmsg("cannot access temporary or unlogged relations during recovery")));
159 : :
8346 tgl@sss.pgh.pa.us 160 :CBC 374141 : rel->min_attr = FirstLowInvalidHeapAttributeNumber + 1;
161 : 374141 : rel->max_attr = RelationGetNumberOfAttributes(relation);
5964 rhaas@postgresql.org 162 : 374141 : rel->reltablespace = RelationGetForm(relation)->reltablespace;
163 : :
7825 tgl@sss.pgh.pa.us 164 [ - + ]: 374141 : Assert(rel->max_attr >= rel->min_attr);
165 : 374141 : rel->attr_needed = (Relids *)
166 : 374141 : palloc0((rel->max_attr - rel->min_attr + 1) * sizeof(Relids));
167 : 374141 : rel->attr_widths = (int32 *)
168 : 374141 : palloc0((rel->max_attr - rel->min_attr + 1) * sizeof(int32));
169 : :
170 : : /*
171 : : * Record which columns are defined as NOT NULL. We leave this
172 : : * unpopulated for non-partitioned inheritance parent relations as it's
173 : : * ambiguous as to what it means. Some child tables may have a NOT NULL
174 : : * constraint for a column while others may not. We could work harder and
175 : : * build a unioned set of all child relations notnullattnums, but there's
176 : : * currently no need. The RelOptInfo corresponding to the !inh
177 : : * RangeTblEntry does get populated.
178 : : */
753 drowley@postgresql.o 179 [ + + + + ]: 374141 : if (!inhparent || relation->rd_rel->relkind == RELKIND_PARTITIONED_TABLE)
287 rguo@postgresql.org 180 :GNC 349170 : rel->notnullattnums = find_relation_notnullatts(root, relationObjectId);
181 : :
182 : : /*
183 : : * Estimate relation size --- unless it's an inheritance parent, in which
184 : : * case the size we want is not the rel's own size but the size of its
185 : : * inheritance tree. That will be computed in set_append_rel_size().
186 : : */
7168 tgl@sss.pgh.pa.us 187 [ + + ]:CBC 374141 : if (!inhparent)
188 : 335022 : estimate_rel_size(relation, rel->attr_widths - rel->min_attr,
5317 189 : 335022 : &rel->pages, &rel->tuples, &rel->allvisfrac);
190 : :
191 : : /* Retrieve the parallel_workers reloption, or -1 if not set. */
3617 192 [ + + ]: 374141 : rel->rel_parallel_workers = RelationGetParallelWorkers(relation, -1);
193 : :
194 : : /*
195 : : * Make list of indexes. Ignore indexes on system catalogs if told to.
196 : : * Don't bother with indexes from traditional inheritance parents. For
197 : : * partitioned tables, we need a list of at least unique indexes as these
198 : : * serve as unique proofs for certain planner optimizations. However,
199 : : * let's not discriminate here and just record all partitioned indexes
200 : : * whether they're unique indexes or not.
201 : : */
1212 drowley@postgresql.o 202 [ + + + + ]: 374141 : if ((inhparent && relation->rd_rel->relkind != RELKIND_PARTITIONED_TABLE)
203 [ - + - - ]: 349170 : || (IgnoreSystemIndexes && IsSystemRelation(relation)))
8492 tgl@sss.pgh.pa.us 204 : 24971 : hasindex = false;
205 : : else
206 : 349170 : hasindex = relation->rd_rel->relhasindex;
207 : :
208 [ + + ]: 374141 : if (hasindex)
209 : : {
210 : : List *indexoidlist;
211 : : LOCKMODE lmode;
212 : : ListCell *l;
213 : :
214 : 276766 : indexoidlist = RelationGetIndexList(relation);
215 : :
216 : : /*
217 : : * For each index, we get the same type of lock that the executor will
218 : : * need, and do not release it. This saves a couple of trips to the
219 : : * shared lock manager while not creating any real loss of
220 : : * concurrency, because no schema changes could be happening on the
221 : : * index while we hold lock on the parent rel, and no lock type used
222 : : * for queries blocks any other kind of index operation.
223 : : */
2588 224 : 276766 : lmode = root->simple_rte_array[varno]->rellockmode;
225 : :
8014 neilc@samurai.com 226 [ + + + + : 863970 : foreach(l, indexoidlist)
+ + ]
227 : : {
8010 228 : 587204 : Oid indexoid = lfirst_oid(l);
229 : : Relation indexRelation;
230 : : Form_pg_index index;
126 tgl@sss.pgh.pa.us 231 :GNC 587204 : const IndexAmRoutine *amroutine = NULL;
232 : : IndexOptInfo *info;
233 : : int ncolumns,
234 : : nkeycolumns;
235 : : int i;
236 : :
237 : : /*
238 : : * Extract info from the relation descriptor for the index.
239 : : */
7218 tgl@sss.pgh.pa.us 240 :CBC 587204 : indexRelation = index_open(indexoid, lmode);
8378 241 : 587204 : index = indexRelation->rd_index;
242 : :
243 : : /*
244 : : * Ignore invalid indexes, since they can't safely be used for
245 : : * queries. Note that this is OK because the data structure we
246 : : * are constructing is only used by the planner --- the executor
247 : : * still needs to insert into "invalid" indexes, if they're marked
248 : : * indisready.
249 : : */
2686 peter_e@gmx.net 250 [ + + ]: 587204 : if (!index->indisvalid)
251 : : {
7193 tgl@sss.pgh.pa.us 252 : 25 : index_close(indexRelation, NoLock);
253 : 25 : continue;
254 : : }
255 : :
256 : : /*
257 : : * If the index is valid, but cannot yet be used, ignore it; but
258 : : * mark the plan we are generating as transient. See
259 : : * src/backend/access/heap/README.HOT for discussion.
260 : : */
6802 261 [ + + ]: 587179 : if (index->indcheckxmin &&
262 [ + + ]: 237 : !TransactionIdPrecedes(HeapTupleHeaderGetXmin(indexRelation->rd_indextuple->t_data),
263 : : TransactionXmin))
264 : : {
265 : 162 : root->glob->transientPlan = true;
266 : 162 : index_close(indexRelation, NoLock);
267 : 162 : continue;
268 : : }
269 : :
8492 270 : 587017 : info = makeNode(IndexOptInfo);
271 : :
272 : 587017 : info->indexoid = index->indexrelid;
5964 rhaas@postgresql.org 273 : 587017 : info->reltablespace =
274 : 587017 : RelationGetForm(indexRelation)->reltablespace;
7709 tgl@sss.pgh.pa.us 275 : 587017 : info->rel = rel;
8378 276 : 587017 : info->ncolumns = ncolumns = index->indnatts;
2950 teodor@sigaev.ru 277 : 587017 : info->nkeycolumns = nkeycolumns = index->indnkeyatts;
278 : :
146 michael@paquier.xyz 279 :GNC 587017 : info->indexkeys = palloc_array(int, ncolumns);
280 : 587017 : info->indexcollations = palloc_array(Oid, nkeycolumns);
281 : 587017 : info->opfamily = palloc_array(Oid, nkeycolumns);
282 : 587017 : info->opcintype = palloc_array(Oid, nkeycolumns);
283 : 587017 : info->canreturn = palloc_array(bool, ncolumns);
284 : :
8378 tgl@sss.pgh.pa.us 285 [ + + ]:CBC 1690218 : for (i = 0; i < ncolumns; i++)
286 : : {
7707 287 : 1103201 : info->indexkeys[i] = index->indkey.values[i];
2950 teodor@sigaev.ru 288 : 1103201 : info->canreturn[i] = index_can_return(indexRelation, i + 1);
289 : : }
290 : :
291 [ + + ]: 1689923 : for (i = 0; i < nkeycolumns; i++)
292 : : {
6914 tgl@sss.pgh.pa.us 293 : 1102906 : info->opfamily[i] = indexRelation->rd_opfamily[i];
294 : 1102906 : info->opcintype[i] = indexRelation->rd_opcintype[i];
2945 teodor@sigaev.ru 295 : 1102906 : info->indexcollations[i] = indexRelation->rd_indcollation[i];
296 : : }
297 : :
8492 tgl@sss.pgh.pa.us 298 : 587017 : info->relam = indexRelation->rd_rel->relam;
299 : :
300 : : /*
301 : : * We don't have an AM for partitioned indexes, so we'll just
302 : : * NULLify the AM related fields for those.
303 : : */
1212 drowley@postgresql.o 304 [ + + ]: 587017 : if (indexRelation->rd_rel->relkind != RELKIND_PARTITIONED_INDEX)
305 : : {
306 : : /* We copy just the fields we need, not all of rd_indam */
307 : 582081 : amroutine = indexRelation->rd_indam;
308 : 582081 : info->amcanorderbyop = amroutine->amcanorderbyop;
309 : 582081 : info->amoptionalkey = amroutine->amoptionalkey;
310 : 582081 : info->amsearcharray = amroutine->amsearcharray;
311 : 582081 : info->amsearchnulls = amroutine->amsearchnulls;
312 : 582081 : info->amcanparallel = amroutine->amcanparallel;
313 : 582081 : info->amhasgettuple = (amroutine->amgettuple != NULL);
314 [ + - ]: 1164162 : info->amhasgetbitmap = amroutine->amgetbitmap != NULL &&
416 melanieplageman@gmai 315 [ + - ]: 582081 : relation->rd_tableam->scan_bitmap_next_tuple != NULL;
1212 drowley@postgresql.o 316 [ + + ]: 1145385 : info->amcanmarkpos = (amroutine->ammarkpos != NULL &&
317 [ + - ]: 563304 : amroutine->amrestrpos != NULL);
318 : 582081 : info->amcostestimate = amroutine->amcostestimate;
319 [ - + ]: 582081 : Assert(info->amcostestimate != NULL);
320 : :
321 : : /* Fetch index opclass options */
322 : 582081 : info->opclassoptions = RelationGetIndexAttOptions(indexRelation, true);
323 : :
324 : : /*
325 : : * Fetch the ordering information for the index, if any.
326 : : */
327 [ + + ]: 582081 : if (info->relam == BTREE_AM_OID)
328 : : {
329 : : /*
330 : : * If it's a btree index, we can use its opfamily OIDs
331 : : * directly as the sort ordering opfamily OIDs.
332 : : */
333 [ - + ]: 563304 : Assert(amroutine->amcanorder);
334 : :
335 : 563304 : info->sortopfamily = info->opfamily;
146 michael@paquier.xyz 336 :GNC 563304 : info->reverse_sort = palloc_array(bool, nkeycolumns);
337 : 563304 : info->nulls_first = palloc_array(bool, nkeycolumns);
338 : :
1212 drowley@postgresql.o 339 [ + + ]:CBC 1424057 : for (i = 0; i < nkeycolumns; i++)
340 : : {
341 : 860753 : int16 opt = indexRelation->rd_indoption[i];
342 : :
343 : 860753 : info->reverse_sort[i] = (opt & INDOPTION_DESC) != 0;
344 : 860753 : info->nulls_first[i] = (opt & INDOPTION_NULLS_FIRST) != 0;
345 : : }
346 : : }
347 [ - + ]: 18777 : else if (amroutine->amcanorder)
348 : : {
349 : : /*
350 : : * Otherwise, identify the corresponding btree opfamilies
351 : : * by trying to map this index's "<" operators into btree.
352 : : * Since "<" uniquely defines the behavior of a sort
353 : : * order, this is a sufficient test.
354 : : *
355 : : * XXX This method is rather slow and complicated. It'd
356 : : * be better to have a way to explicitly declare the
357 : : * corresponding btree opfamily for each opfamily of the
358 : : * other index type.
359 : : */
146 michael@paquier.xyz 360 :UNC 0 : info->sortopfamily = palloc_array(Oid, nkeycolumns);
361 : 0 : info->reverse_sort = palloc_array(bool, nkeycolumns);
362 : 0 : info->nulls_first = palloc_array(bool, nkeycolumns);
363 : :
1212 drowley@postgresql.o 364 [ # # ]:UBC 0 : for (i = 0; i < nkeycolumns; i++)
365 : : {
366 : 0 : int16 opt = indexRelation->rd_indoption[i];
367 : : Oid ltopr;
368 : : Oid opfamily;
369 : : Oid opcintype;
370 : : CompareType cmptype;
371 : :
372 : 0 : info->reverse_sort[i] = (opt & INDOPTION_DESC) != 0;
373 : 0 : info->nulls_first[i] = (opt & INDOPTION_NULLS_FIRST) != 0;
374 : :
394 peter@eisentraut.org 375 : 0 : ltopr = get_opfamily_member_for_cmptype(info->opfamily[i],
376 : 0 : info->opcintype[i],
377 : 0 : info->opcintype[i],
378 : : COMPARE_LT);
1212 drowley@postgresql.o 379 [ # # # # ]: 0 : if (OidIsValid(ltopr) &&
380 : 0 : get_ordering_op_properties(ltopr,
381 : : &opfamily,
382 : : &opcintype,
394 peter@eisentraut.org 383 : 0 : &cmptype) &&
384 [ # # ]: 0 : opcintype == info->opcintype[i] &&
385 [ # # ]: 0 : cmptype == COMPARE_LT)
386 : : {
387 : : /* Successful mapping */
388 : 0 : info->sortopfamily[i] = opfamily;
389 : : }
390 : : else
391 : : {
392 : : /* Fail ... quietly treat index as unordered */
1212 drowley@postgresql.o 393 : 0 : info->sortopfamily = NULL;
394 : 0 : info->reverse_sort = NULL;
395 : 0 : info->nulls_first = NULL;
396 : 0 : break;
397 : : }
398 : : }
399 : : }
400 : : else
401 : : {
1212 drowley@postgresql.o 402 :CBC 18777 : info->sortopfamily = NULL;
403 : 18777 : info->reverse_sort = NULL;
404 : 18777 : info->nulls_first = NULL;
405 : : }
406 : : }
407 : : else
408 : : {
409 : 4936 : info->amcanorderbyop = false;
410 : 4936 : info->amoptionalkey = false;
411 : 4936 : info->amsearcharray = false;
412 : 4936 : info->amsearchnulls = false;
413 : 4936 : info->amcanparallel = false;
414 : 4936 : info->amhasgettuple = false;
415 : 4936 : info->amhasgetbitmap = false;
416 : 4936 : info->amcanmarkpos = false;
417 : 4936 : info->amcostestimate = NULL;
418 : :
5636 tgl@sss.pgh.pa.us 419 : 4936 : info->sortopfamily = NULL;
420 : 4936 : info->reverse_sort = NULL;
421 : 4936 : info->nulls_first = NULL;
422 : : }
423 : :
424 : : /*
425 : : * Fetch the index expressions and predicate, if any. We must
426 : : * modify the copies we obtain from the relcache to have the
427 : : * correct varno for the parent relation, so that they match up
428 : : * correctly against qual clauses.
429 : : *
430 : : * After fixing the varnos, we need to run the index expressions
431 : : * and predicate through const-simplification again, using a valid
432 : : * "root". This ensures that NullTest quals for Vars can be
433 : : * properly reduced.
434 : : */
8378 435 : 587017 : info->indexprs = RelationGetIndexExpressions(indexRelation);
436 : 587017 : info->indpred = RelationGetIndexPredicate(indexRelation);
147 rguo@postgresql.org 437 [ + + ]:GNC 587017 : if (info->indexprs)
438 : : {
439 [ + + ]: 2490 : if (varno != 1)
440 : 1615 : ChangeVarNodes((Node *) info->indexprs, 1, varno, 0);
441 : :
442 : 2490 : info->indexprs = (List *)
443 : 2490 : eval_const_expressions(root, (Node *) info->indexprs);
444 : : }
445 [ + + ]: 587017 : if (info->indpred)
446 : : {
447 [ + + ]: 847 : if (varno != 1)
448 : 105 : ChangeVarNodes((Node *) info->indpred, 1, varno, 0);
449 : :
450 : 847 : info->indpred = (List *)
451 : 847 : eval_const_expressions(root,
452 : 847 : (Node *) make_ands_explicit(info->indpred));
453 : 847 : info->indpred = make_ands_implicit((Expr *) info->indpred);
454 : : }
455 : :
456 : : /* Build targetlist using the completed indexprs data */
5320 tgl@sss.pgh.pa.us 457 :CBC 587017 : info->indextlist = build_index_tlist(root, info, relation);
458 : :
3240 459 : 587017 : info->indrestrictinfo = NIL; /* set later, in indxpath.c */
460 : 587017 : info->predOK = false; /* set later, in indxpath.c */
8378 461 : 587017 : info->unique = index->indisunique;
509 drowley@postgresql.o 462 : 587017 : info->nullsnotdistinct = index->indnullsnotdistinct;
5308 tgl@sss.pgh.pa.us 463 : 587017 : info->immediate = index->indimmediate;
5557 464 : 587017 : info->hypothetical = false;
465 : :
466 : : /*
467 : : * Estimate the index size. If it's not a partial index, we lock
468 : : * the number-of-tuples estimate to equal the parent table; if it
469 : : * is partial then we have to use the same methods as we would for
470 : : * a table, except we can be sure that the index is not larger
471 : : * than the table. We must ignore partitioned indexes here as
472 : : * there are not physical indexes.
473 : : */
1212 drowley@postgresql.o 474 [ + + ]: 587017 : if (indexRelation->rd_rel->relkind != RELKIND_PARTITIONED_INDEX)
475 : : {
476 [ + + ]: 582081 : if (info->indpred == NIL)
477 : : {
478 : 581254 : info->pages = RelationGetNumberOfBlocks(indexRelation);
7825 tgl@sss.pgh.pa.us 479 : 581254 : info->tuples = rel->tuples;
480 : : }
481 : : else
482 : : {
483 : : double allvisfrac; /* dummy */
484 : :
1212 drowley@postgresql.o 485 : 827 : estimate_rel_size(indexRelation, NULL,
486 : 827 : &info->pages, &info->tuples, &allvisfrac);
487 [ + + ]: 827 : if (info->tuples > rel->tuples)
488 : 15 : info->tuples = rel->tuples;
489 : : }
490 : :
491 : : /*
492 : : * Get tree height while we have the index open
493 : : */
602 peter@eisentraut.org 494 [ + + ]: 582081 : if (amroutine->amgettreeheight)
495 : : {
496 : 563304 : info->tree_height = amroutine->amgettreeheight(indexRelation);
497 : : }
498 : : else
499 : : {
500 : : /* For other index types, just set it to "unknown" for now */
1212 drowley@postgresql.o 501 : 18777 : info->tree_height = -1;
502 : : }
503 : : }
504 : : else
505 : : {
506 : : /* Zero these out for partitioned indexes */
507 : 4936 : info->pages = 0;
508 : 4936 : info->tuples = 0.0;
4862 tgl@sss.pgh.pa.us 509 : 4936 : info->tree_height = -1;
510 : : }
511 : :
7218 512 : 587017 : index_close(indexRelation, NoLock);
513 : :
514 : : /*
515 : : * We've historically used lcons() here. It'd make more sense to
516 : : * use lappend(), but that causes the planner to change behavior
517 : : * in cases where two indexes seem equally attractive. For now,
518 : : * stick with lcons() --- few tables should have so many indexes
519 : : * that the O(N^2) behavior of lcons() is really a problem.
520 : : */
8492 521 : 587017 : indexinfos = lcons(info, indexinfos);
522 : : }
523 : :
8010 neilc@samurai.com 524 : 276766 : list_free(indexoidlist);
525 : : }
526 : :
8492 tgl@sss.pgh.pa.us 527 : 374141 : rel->indexlist = indexinfos;
528 : :
247 rguo@postgresql.org 529 :GNC 374141 : rel->statlist = get_relation_statistics(root, rel, relation);
530 : :
531 : : /* Grab foreign-table info using the relcache, while we have it */
4808 tgl@sss.pgh.pa.us 532 [ + + ]:CBC 374141 : if (relation->rd_rel->relkind == RELKIND_FOREIGN_TABLE)
533 : : {
534 : : /* Check if the access to foreign tables is restricted */
638 msawada@postgresql.o 535 [ + + ]: 1288 : if (unlikely((restrict_nonsystem_relation_kind & RESTRICT_RELKIND_FOREIGN_TABLE) != 0))
536 : : {
537 : : /* there must not be built-in foreign tables */
538 [ - + ]: 2 : Assert(RelationGetRelid(relation) >= FirstNormalObjectId);
539 : :
540 [ + - ]: 2 : ereport(ERROR,
541 : : (errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
542 : : errmsg("access to non-system foreign table is restricted")));
543 : : }
544 : :
4013 tgl@sss.pgh.pa.us 545 : 1286 : rel->serverid = GetForeignServerIdByRelId(RelationGetRelid(relation));
4808 546 : 1286 : rel->fdwroutine = GetFdwRoutineForRelation(relation, true);
547 : : }
548 : : else
549 : : {
4013 550 : 372853 : rel->serverid = InvalidOid;
4808 551 : 372853 : rel->fdwroutine = NULL;
552 : : }
553 : :
554 : : /* Collect info about relation's foreign keys, if relevant */
3471 555 : 374130 : get_relation_foreign_keys(root, rel, relation, inhparent);
556 : :
557 : : /* Collect info about functions implemented by the rel's table AM. */
1893 drowley@postgresql.o 558 [ + + ]: 374130 : if (relation->rd_tableam &&
559 [ + - ]: 358679 : relation->rd_tableam->scan_set_tidrange != NULL &&
560 [ + - ]: 358679 : relation->rd_tableam->scan_getnextslot_tidrange != NULL)
561 : 358679 : rel->amflags |= AMFLAG_HAS_TID_RANGE;
562 : :
563 : : /*
564 : : * Collect info about relation's partitioning scheme, if any. Only
565 : : * inheritance parents may be partitioned.
566 : : */
3149 rhaas@postgresql.org 567 [ + + + + ]: 374130 : if (inhparent && relation->rd_rel->relkind == RELKIND_PARTITIONED_TABLE)
568 : 14148 : set_relation_partition_info(root, rel, relation);
569 : :
2661 andres@anarazel.de 570 : 374130 : table_close(relation, NoLock);
10892 scrappy@hub.org 571 : 374130 : }
572 : :
573 : : /*
574 : : * get_relation_foreign_keys -
575 : : * Retrieves foreign key information for a given relation.
576 : : *
577 : : * ForeignKeyOptInfos for relevant foreign keys are created and added to
578 : : * root->fkey_list. We do this now while we have the relcache entry open.
579 : : * We could sometimes avoid making useless ForeignKeyOptInfos if we waited
580 : : * until all RelOptInfos have been built, but the cost of re-opening the
581 : : * relcache entries would probably exceed any savings.
582 : : */
583 : : static void
3608 tgl@sss.pgh.pa.us 584 : 374130 : get_relation_foreign_keys(PlannerInfo *root, RelOptInfo *rel,
585 : : Relation relation, bool inhparent)
586 : : {
587 : 374130 : List *rtable = root->parse->rtable;
588 : : List *cachedfkeys;
589 : : ListCell *lc;
590 : :
591 : : /*
592 : : * If it's not a baserel, we don't care about its FKs. Also, if the query
593 : : * references only a single relation, we can skip the lookup since no FKs
594 : : * could satisfy the requirements below.
595 : : */
596 [ + + + + ]: 711329 : if (rel->reloptkind != RELOPT_BASEREL ||
597 : 337199 : list_length(rtable) < 2)
598 : 184359 : return;
599 : :
600 : : /*
601 : : * If it's the parent of an inheritance tree, ignore its FKs. We could
602 : : * make useful FK-based deductions if we found that all members of the
603 : : * inheritance tree have equivalent FK constraints, but detecting that
604 : : * would require code that hasn't been written.
605 : : */
3471 606 [ + + ]: 189771 : if (inhparent)
607 : 5169 : return;
608 : :
609 : : /*
610 : : * Extract data about relation's FKs from the relcache. Note that this
611 : : * list belongs to the relcache and might disappear in a cache flush, so
612 : : * we must not do any further catalog access within this function.
613 : : */
3608 614 : 184602 : cachedfkeys = RelationGetFKeyList(relation);
615 : :
616 : : /*
617 : : * Figure out which FKs are of interest for this query, and create
618 : : * ForeignKeyOptInfos for them. We want only FKs that reference some
619 : : * other RTE of the current query. In queries containing self-joins,
620 : : * there might be more than one other RTE for a referenced table, and we
621 : : * should make a ForeignKeyOptInfo for each occurrence.
622 : : *
623 : : * Ideally, we would ignore RTEs that correspond to non-baserels, but it's
624 : : * too hard to identify those here, so we might end up making some useless
625 : : * ForeignKeyOptInfos. If so, match_foreign_keys_to_quals() will remove
626 : : * them again.
627 : : */
628 [ + + + + : 187088 : foreach(lc, cachedfkeys)
+ + ]
629 : : {
630 : 2486 : ForeignKeyCacheInfo *cachedfk = (ForeignKeyCacheInfo *) lfirst(lc);
631 : : Index rti;
632 : : ListCell *lc2;
633 : :
634 : : /* conrelid should always be that of the table we're considering */
635 [ - + ]: 2486 : Assert(cachedfk->conrelid == RelationGetRelid(relation));
636 : :
637 : : /* skip constraints currently not enforced */
398 peter@eisentraut.org 638 [ + + ]: 2486 : if (!cachedfk->conenforced)
639 : 27 : continue;
640 : :
641 : : /* Scan to find other RTEs matching confrelid */
3608 tgl@sss.pgh.pa.us 642 : 2459 : rti = 0;
643 [ + - + + : 11190 : foreach(lc2, rtable)
+ + ]
644 : : {
645 : 8731 : RangeTblEntry *rte = (RangeTblEntry *) lfirst(lc2);
646 : : ForeignKeyOptInfo *info;
647 : :
648 : 8731 : rti++;
649 : : /* Ignore if not the correct table */
650 [ + + ]: 8731 : if (rte->rtekind != RTE_RELATION ||
651 [ + + ]: 5639 : rte->relid != cachedfk->confrelid)
652 : 6650 : continue;
653 : : /* Ignore if it's an inheritance parent; doesn't really match */
3471 654 [ + + ]: 2081 : if (rte->inh)
655 : 253 : continue;
656 : : /* Ignore self-referential FKs; we only care about joins */
3608 657 [ + + ]: 1828 : if (rti == rel->relid)
658 : 110 : continue;
659 : :
660 : : /* OK, let's make an entry */
661 : 1718 : info = makeNode(ForeignKeyOptInfo);
662 : 1718 : info->con_relid = rel->relid;
663 : 1718 : info->ref_relid = rti;
664 : 1718 : info->nkeys = cachedfk->nkeys;
665 : 1718 : memcpy(info->conkey, cachedfk->conkey, sizeof(info->conkey));
666 : 1718 : memcpy(info->confkey, cachedfk->confkey, sizeof(info->confkey));
667 : 1718 : memcpy(info->conpfeqop, cachedfk->conpfeqop, sizeof(info->conpfeqop));
668 : : /* zero out fields to be filled by match_foreign_keys_to_quals */
669 : 1718 : info->nmatched_ec = 0;
2015 670 : 1718 : info->nconst_ec = 0;
3608 671 : 1718 : info->nmatched_rcols = 0;
672 : 1718 : info->nmatched_ri = 0;
673 : 1718 : memset(info->eclass, 0, sizeof(info->eclass));
2015 674 : 1718 : memset(info->fk_eclass_member, 0, sizeof(info->fk_eclass_member));
3608 675 : 1718 : memset(info->rinfos, 0, sizeof(info->rinfos));
676 : :
677 : 1718 : root->fkey_list = lappend(root->fkey_list, info);
678 : : }
679 : : }
680 : : }
681 : :
682 : : /*
683 : : * get_relation_notnullatts -
684 : : * Retrieves column not-null constraint information for a given relation.
685 : : *
686 : : * We do this while we have the relcache entry open, and store the column
687 : : * not-null constraint information in a hash table based on the relation OID.
688 : : */
689 : : void
287 rguo@postgresql.org 690 :GNC 401472 : get_relation_notnullatts(PlannerInfo *root, Relation relation)
691 : : {
692 : 401472 : Oid relid = RelationGetRelid(relation);
693 : : NotnullHashEntry *hentry;
694 : : bool found;
235 695 : 401472 : Bitmapset *notnullattnums = NULL;
696 : :
697 : : /* bail out if the relation has no not-null constraints */
287 698 [ + + ]: 401472 : if (relation->rd_att->constr == NULL ||
699 [ + + ]: 266438 : !relation->rd_att->constr->has_not_null)
700 : 175020 : return;
701 : :
702 : : /* create the hash table if it hasn't been created yet */
703 [ + + ]: 261414 : if (root->glob->rel_notnullatts_hash == NULL)
704 : : {
705 : : HTAB *hashtab;
706 : : HASHCTL hash_ctl;
707 : :
708 : 127135 : hash_ctl.keysize = sizeof(Oid);
709 : 127135 : hash_ctl.entrysize = sizeof(NotnullHashEntry);
710 : 127135 : hash_ctl.hcxt = CurrentMemoryContext;
711 : :
712 : 127135 : hashtab = hash_create("Relation NOT NULL attnums",
713 : : 64L, /* arbitrary initial size */
714 : : &hash_ctl,
715 : : HASH_ELEM | HASH_BLOBS | HASH_CONTEXT);
716 : :
717 : 127135 : root->glob->rel_notnullatts_hash = hashtab;
718 : : }
719 : :
720 : : /*
721 : : * Create a hash entry for this relation OID, if we don't have one
722 : : * already.
723 : : */
724 : 261414 : hentry = (NotnullHashEntry *) hash_search(root->glob->rel_notnullatts_hash,
725 : : &relid,
726 : : HASH_ENTER,
727 : : &found);
728 : :
729 : : /* bail out if a hash entry already exists for this relation OID */
730 [ + + ]: 261414 : if (found)
731 : 34962 : return;
732 : :
733 : : /* collect the column not-null constraint information for this relation */
734 [ + + ]: 3311026 : for (int i = 0; i < relation->rd_att->natts; i++)
735 : : {
736 : 3084574 : CompactAttribute *attr = TupleDescCompactAttr(relation->rd_att, i);
737 : :
738 [ - + ]: 3084574 : Assert(attr->attnullability != ATTNULLABLE_UNKNOWN);
739 : :
740 [ + + ]: 3084574 : if (attr->attnullability == ATTNULLABLE_VALID)
741 : : {
742 : 2592649 : notnullattnums = bms_add_member(notnullattnums, i + 1);
743 : :
744 : : /*
745 : : * Per RemoveAttributeById(), dropped columns will have their
746 : : * attnotnull unset, so we needn't check for dropped columns in
747 : : * the above condition.
748 : : */
749 [ - + ]: 2592649 : Assert(!attr->attisdropped);
750 : : }
751 : : }
752 : :
753 : : /* ... and initialize the new hash entry */
754 : 226452 : hentry->notnullattnums = notnullattnums;
755 : : }
756 : :
757 : : /*
758 : : * find_relation_notnullatts -
759 : : * Searches the hash table and returns the column not-null constraint
760 : : * information for a given relation.
761 : : */
762 : : Bitmapset *
763 : 363139 : find_relation_notnullatts(PlannerInfo *root, Oid relid)
764 : : {
765 : : NotnullHashEntry *hentry;
766 : : bool found;
767 : :
768 [ + + ]: 363139 : if (root->glob->rel_notnullatts_hash == NULL)
769 : 100724 : return NULL;
770 : :
771 : 262415 : hentry = (NotnullHashEntry *) hash_search(root->glob->rel_notnullatts_hash,
772 : : &relid,
773 : : HASH_FIND,
774 : : &found);
775 [ + + ]: 262415 : if (!found)
776 : 5432 : return NULL;
777 : :
778 : 256983 : return hentry->notnullattnums;
779 : : }
780 : :
781 : : /*
782 : : * infer_arbiter_indexes -
783 : : * Determine the unique indexes used to arbitrate speculative insertion.
784 : : *
785 : : * Uses user-supplied inference clause expressions and predicate to match a
786 : : * unique index from those defined and ready on the heap relation (target).
787 : : * An exact match is required on columns/expressions (although they can appear
788 : : * in any order). However, the predicate given by the user need only restrict
789 : : * insertion to a subset of some part of the table covered by some particular
790 : : * unique index (in particular, a partial unique index) in order to be
791 : : * inferred.
792 : : *
793 : : * The implementation does not consider which B-Tree operator class any
794 : : * particular available unique index attribute uses, unless one was specified
795 : : * in the inference specification. The same is true of collations. In
796 : : * particular, there is no system dependency on the default operator class for
797 : : * the purposes of inference. If no opclass (or collation) is specified, then
798 : : * all matching indexes (that may or may not match the default in terms of
799 : : * each attribute opclass/collation) are used for inference.
800 : : */
801 : : List *
4015 andres@anarazel.de 802 :CBC 1788 : infer_arbiter_indexes(PlannerInfo *root)
803 : : {
804 : 1788 : OnConflictExpr *onconflict = root->parse->onConflict;
805 : :
806 : : /* Iteration state */
807 : : Index varno;
808 : : RangeTblEntry *rte;
809 : : Relation relation;
810 : 1788 : Oid indexOidFromConstraint = InvalidOid;
811 : : List *indexList;
155 alvherre@kurilemu.de 812 :GNC 1788 : List *indexRelList = NIL;
813 : :
814 : : /*
815 : : * Required attributes and expressions used to match indexes to the clause
816 : : * given by the user. In the ON CONFLICT ON CONSTRAINT case, we compute
817 : : * these from that constraint's index to match all other indexes, to
818 : : * account for the case where that index is being concurrently reindexed.
819 : : */
820 : 1788 : List *inferIndexExprs = (List *) onconflict->arbiterWhere;
4015 andres@anarazel.de 821 :CBC 1788 : Bitmapset *inferAttrs = NULL;
822 : 1788 : List *inferElems = NIL;
823 : :
824 : : /* Results */
4004 825 : 1788 : List *results = NIL;
162 alvherre@kurilemu.de 826 :GNC 1788 : bool foundValid = false;
827 : :
828 : : /*
829 : : * Quickly return NIL for ON CONFLICT DO NOTHING without an inference
830 : : * specification or named constraint. ON CONFLICT DO SELECT/UPDATE
831 : : * statements must always provide one or the other (but parser ought to
832 : : * have caught that already).
833 : : */
4015 andres@anarazel.de 834 [ + + ]:CBC 1788 : if (onconflict->arbiterElems == NIL &&
835 [ + + ]: 320 : onconflict->constraint == InvalidOid)
836 : 163 : return NIL;
837 : :
838 : : /*
839 : : * We need not lock the relation since it was already locked, either by
840 : : * the rewriter or when expand_inherited_rtentry() added it to the query's
841 : : * rangetable.
842 : : */
693 tgl@sss.pgh.pa.us 843 : 1625 : varno = root->parse->resultRelation;
844 : 1625 : rte = rt_fetch(varno, root->parse->rtable);
845 : :
2588 846 : 1625 : relation = table_open(rte->relid, NoLock);
847 : :
848 : : /*
849 : : * Build normalized/BMS representation of plain indexed attributes, as
850 : : * well as a separate list of expression items. This simplifies matching
851 : : * the cataloged definition of indexes.
852 : : */
155 alvherre@kurilemu.de 853 [ + + + + :GNC 5056 : foreach_ptr(InferenceElem, elem, onconflict->arbiterElems)
+ + ]
854 : : {
855 : : Var *var;
856 : : int attno;
857 : :
858 : : /* we cannot also have a constraint name, per grammar */
859 [ - + ]: 1806 : Assert(!OidIsValid(onconflict->constraint));
860 : :
4015 andres@anarazel.de 861 [ + + ]:CBC 1806 : if (!IsA(elem->expr, Var))
862 : : {
863 : : /* If not a plain Var, just shove it in inferElems for now */
864 : 130 : inferElems = lappend(inferElems, elem->expr);
865 : 130 : continue;
866 : : }
867 : :
868 : 1676 : var = (Var *) elem->expr;
869 : 1676 : attno = var->varattno;
870 : :
3646 tgl@sss.pgh.pa.us 871 [ - + ]: 1676 : if (attno == 0)
4015 andres@anarazel.de 872 [ # # ]:UBC 0 : ereport(ERROR,
873 : : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
874 : : errmsg("whole row unique index inference specifications are not supported")));
875 : :
3646 tgl@sss.pgh.pa.us 876 :CBC 1676 : inferAttrs = bms_add_member(inferAttrs,
877 : : attno - FirstLowInvalidHeapAttributeNumber);
878 : : }
879 : :
880 : : /*
881 : : * Next, open all the indexes. We need this list for two things: first,
882 : : * if an ON CONSTRAINT clause was given, and that constraint's index is
883 : : * undergoing REINDEX CONCURRENTLY, then we need to consider all matches
884 : : * for that index. Second, if an attribute list was specified in the ON
885 : : * CONFLICT clause, we use the list to find the indexes whose attributes
886 : : * match that list.
887 : : */
155 alvherre@kurilemu.de 888 :GNC 1625 : indexList = RelationGetIndexList(relation);
889 [ + + + + : 5269 : foreach_oid(indexoid, indexList)
+ + ]
890 : : {
891 : : Relation idxRel;
892 : :
893 : : /* obtain the same lock type that the executor will ultimately use */
894 : 2019 : idxRel = index_open(indexoid, rte->rellockmode);
895 : 2019 : indexRelList = lappend(indexRelList, idxRel);
896 : : }
897 : :
898 : : /*
899 : : * If a constraint was named in the command, look up its index. We don't
900 : : * return it immediately because we need some additional sanity checks,
901 : : * and also because we need to include other indexes as arbiters to
902 : : * account for REINDEX CONCURRENTLY processing it.
903 : : */
4015 andres@anarazel.de 904 [ + + ]:CBC 1625 : if (onconflict->constraint != InvalidOid)
905 : : {
906 : : /* we cannot also have an explicit list of elements, per grammar */
155 alvherre@kurilemu.de 907 [ - + ]:GNC 157 : Assert(onconflict->arbiterElems == NIL);
908 : :
909 : 157 : indexOidFromConstraint = get_constraint_index(onconflict->constraint);
4015 andres@anarazel.de 910 [ - + ]:CBC 157 : if (indexOidFromConstraint == InvalidOid)
4015 andres@anarazel.de 911 [ # # ]:UBC 0 : ereport(ERROR,
912 : : (errcode(ERRCODE_WRONG_OBJECT_TYPE),
913 : : errmsg("constraint in ON CONFLICT clause has no associated index")));
914 : :
915 : : /*
916 : : * Find the named constraint index to extract its attributes and
917 : : * predicates.
918 : : */
155 alvherre@kurilemu.de 919 [ + - + - :GNC 334 : foreach_ptr(RelationData, idxRel, indexRelList)
+ + ]
920 : : {
921 : 177 : Form_pg_index idxForm = idxRel->rd_index;
922 : :
923 [ + + ]: 177 : if (indexOidFromConstraint == idxForm->indexrelid)
924 : : {
925 : : /* Found it. */
926 [ - + ]: 157 : Assert(idxForm->indisready);
927 : :
928 : : /*
929 : : * Set up inferElems and inferIndexExprs to match the
930 : : * constraint index, so that we can match them in the loop
931 : : * below.
932 : : */
933 [ + + ]: 435 : for (int natt = 0; natt < idxForm->indnkeyatts; natt++)
934 : : {
935 : : int attno;
936 : :
937 : 278 : attno = idxRel->rd_index->indkey.values[natt];
938 [ + + ]: 278 : if (attno != InvalidAttrNumber)
939 : : inferAttrs =
940 : 265 : bms_add_member(inferAttrs,
941 : : attno - FirstLowInvalidHeapAttributeNumber);
942 : : }
943 : :
944 : 157 : inferElems = RelationGetIndexExpressions(idxRel);
945 : 157 : inferIndexExprs = RelationGetIndexPredicate(idxRel);
946 : 157 : break;
947 : : }
948 : : }
949 : : }
950 : :
951 : : /*
952 : : * Using that representation, iterate through the list of indexes on the
953 : : * target relation to find matches.
954 : : */
955 [ + + + + : 5157 : foreach_ptr(RelationData, idxRel, indexRelList)
+ + ]
956 : : {
957 : : Form_pg_index idxForm;
958 : : Bitmapset *indexedAttrs;
959 : : List *idxExprs;
960 : : List *predExprs;
961 : : AttrNumber natt;
962 : : bool match;
963 : :
964 : : /*
965 : : * Extract info from the relation descriptor for the index.
966 : : *
967 : : * Let executor complain about !indimmediate case directly, because
968 : : * enforcement needs to occur there anyway when an inference clause is
969 : : * omitted.
970 : : */
4015 andres@anarazel.de 971 :CBC 2019 : idxForm = idxRel->rd_index;
972 : :
973 : : /*
974 : : * Ignore indexes that aren't indisready, because we cannot trust
975 : : * their catalog structure yet. However, if any indexes are marked
976 : : * indisready but not yet indisvalid, we still consider them, because
977 : : * they might turn valid while we're running. Doing it this way
978 : : * allows a concurrent transaction with a slightly later catalog
979 : : * snapshot infer the same set of indexes, which is critical to
980 : : * prevent spurious 'duplicate key' errors.
981 : : *
982 : : * However, another critical aspect is that a unique index that isn't
983 : : * yet marked indisvalid=true might not be complete yet, meaning it
984 : : * wouldn't detect possible duplicate rows. In order to prevent false
985 : : * negatives, we require that we include in the set of inferred
986 : : * indexes at least one index that is marked valid.
987 : : */
162 alvherre@kurilemu.de 988 [ - + ]:GNC 2019 : if (!idxForm->indisready)
155 alvherre@kurilemu.de 989 :UNC 0 : continue;
990 : :
991 : : /*
992 : : * Ignore invalid indexes for partitioned tables. It's possible that
993 : : * some partitions don't have the index (yet), and then we would not
994 : : * find a match during ExecInitPartitionInfo.
995 : : */
145 alvherre@kurilemu.de 996 [ + + ]:GNC 2019 : if (relation->rd_rel->relkind == RELKIND_PARTITIONED_TABLE &&
997 [ + + ]: 209 : !idxForm->indisvalid)
998 : 9 : continue;
999 : :
1000 : : /*
1001 : : * Note that we do not perform a check against indcheckxmin (like e.g.
1002 : : * get_relation_info()) here to eliminate candidates, because
1003 : : * uniqueness checking only cares about the most recently committed
1004 : : * tuple versions.
1005 : : */
1006 : :
1007 : : /*
1008 : : * Look for match for "ON constraint_name" variant, which may not be a
1009 : : * unique constraint. This can only be a constraint name.
1010 : : */
4015 andres@anarazel.de 1011 [ + + ]:CBC 2010 : if (indexOidFromConstraint == idxForm->indexrelid)
1012 : : {
1013 : : /*
1014 : : * ON CONFLICT DO UPDATE and ON CONFLICT DO SELECT are not
1015 : : * supported with exclusion constraints.
1016 : : */
82 dean.a.rasheed@gmail 1017 [ + + ]:GNC 157 : if (idxForm->indisexclusion &&
1018 [ + + ]: 131 : (onconflict->action == ONCONFLICT_UPDATE ||
1019 [ + + ]: 79 : onconflict->action == ONCONFLICT_SELECT))
4015 andres@anarazel.de 1020 [ + - + + ]:CBC 56 : ereport(ERROR,
1021 : : errcode(ERRCODE_WRONG_OBJECT_TYPE),
1022 : : errmsg("ON CONFLICT DO %s not supported with exclusion constraints",
1023 : : onconflict->action == ONCONFLICT_UPDATE ? "UPDATE" : "SELECT"));
1024 : :
1025 : : /* Consider this one a match already */
4004 1026 : 101 : results = lappend_oid(results, idxForm->indexrelid);
162 alvherre@kurilemu.de 1027 :GNC 101 : foundValid |= idxForm->indisvalid;
155 1028 : 101 : continue;
1029 : : }
4015 andres@anarazel.de 1030 [ + + ]:CBC 1853 : else if (indexOidFromConstraint != InvalidOid)
1031 : : {
1032 : : /*
1033 : : * In the case of "ON constraint_name DO SELECT/UPDATE" we need to
1034 : : * skip non-unique candidates.
1035 : : */
82 dean.a.rasheed@gmail 1036 [ + + ]:GNC 26 : if (!idxForm->indisunique &&
1037 [ + - ]: 5 : (onconflict->action == ONCONFLICT_UPDATE ||
1038 [ - + ]: 5 : onconflict->action == ONCONFLICT_SELECT))
155 alvherre@kurilemu.de 1039 :UNC 0 : continue;
1040 : : }
1041 : : else
1042 : : {
1043 : : /*
1044 : : * Only considering conventional inference at this point (not
1045 : : * named constraints), so index under consideration can be
1046 : : * immediately skipped if it's not unique.
1047 : : */
155 alvherre@kurilemu.de 1048 [ + + ]:GNC 1827 : if (!idxForm->indisunique)
1049 : 2 : continue;
1050 : : }
1051 : :
1052 : : /*
1053 : : * So-called unique constraints with WITHOUT OVERLAPS are really
1054 : : * exclusion constraints, so skip those too.
1055 : : */
595 peter@eisentraut.org 1056 [ + + ]:CBC 1851 : if (idxForm->indisexclusion)
155 alvherre@kurilemu.de 1057 :GNC 101 : continue;
1058 : :
1059 : : /* Build BMS representation of plain (non expression) index attrs */
3646 tgl@sss.pgh.pa.us 1060 :CBC 1750 : indexedAttrs = NULL;
2950 teodor@sigaev.ru 1061 [ + + ]: 3936 : for (natt = 0; natt < idxForm->indnkeyatts; natt++)
1062 : : {
4015 andres@anarazel.de 1063 : 2186 : int attno = idxRel->rd_index->indkey.values[natt];
1064 : :
1065 [ + + ]: 2186 : if (attno != 0)
3646 tgl@sss.pgh.pa.us 1066 : 1951 : indexedAttrs = bms_add_member(indexedAttrs,
1067 : : attno - FirstLowInvalidHeapAttributeNumber);
1068 : : }
1069 : :
1070 : : /* Non-expression attributes (if any) must match */
4015 andres@anarazel.de 1071 [ + + ]: 1750 : if (!bms_equal(indexedAttrs, inferAttrs))
155 alvherre@kurilemu.de 1072 :GNC 333 : continue;
1073 : :
1074 : : /* Expression attributes (if any) must match */
4015 andres@anarazel.de 1075 :CBC 1417 : idxExprs = RelationGetIndexExpressions(idxRel);
147 rguo@postgresql.org 1076 [ + + ]:GNC 1417 : if (idxExprs)
1077 : : {
1078 [ + + ]: 130 : if (varno != 1)
1079 : 5 : ChangeVarNodes((Node *) idxExprs, 1, varno, 0);
1080 : :
1081 : 130 : idxExprs = (List *) eval_const_expressions(root, (Node *) idxExprs);
1082 : : }
1083 : :
1084 : : /*
1085 : : * If arbiterElems are present, check them. (Note that if a
1086 : : * constraint name was given in the command line, this list is NIL.)
1087 : : */
155 alvherre@kurilemu.de 1088 : 1417 : match = true;
1089 [ + + + + : 4540 : foreach_ptr(InferenceElem, elem, onconflict->arbiterElems)
+ + ]
1090 : : {
1091 : : /*
1092 : : * Ensure that collation/opclass aspects of inference expression
1093 : : * element match. Even though this loop is primarily concerned
1094 : : * with matching expressions, it is a convenient point to check
1095 : : * this for both expressions and ordinary (non-expression)
1096 : : * attributes appearing as inference elements.
1097 : : */
3936 andres@anarazel.de 1098 [ + + ]:CBC 1743 : if (!infer_collation_opclass_match(elem, idxRel, idxExprs))
1099 : : {
155 alvherre@kurilemu.de 1100 :GNC 29 : match = false;
1101 : 29 : break;
1102 : : }
1103 : :
1104 : : /*
1105 : : * Plain Vars don't factor into count of expression elements, and
1106 : : * the question of whether or not they satisfy the index
1107 : : * definition has already been considered (they must).
1108 : : */
4015 andres@anarazel.de 1109 [ + + ]:CBC 1714 : if (IsA(elem->expr, Var))
1110 : 1578 : continue;
1111 : :
1112 : : /*
1113 : : * Might as well avoid redundant check in the rare cases where
1114 : : * infer_collation_opclass_match() is required to do real work.
1115 : : * Otherwise, check that element expression appears in cataloged
1116 : : * index definition.
1117 : : */
1118 [ + + ]: 136 : if (elem->infercollid != InvalidOid ||
4004 1119 [ + + + + ]: 237 : elem->inferopclass != InvalidOid ||
4015 1120 : 116 : list_member(idxExprs, elem->expr))
1121 : 128 : continue;
1122 : :
155 alvherre@kurilemu.de 1123 :GNC 8 : match = false;
1124 : 8 : break;
1125 : : }
1126 [ + + ]: 1417 : if (!match)
1127 : 37 : continue;
1128 : :
1129 : : /*
1130 : : * In case of inference from an attribute list, ensure that the
1131 : : * expression elements from inference clause are not missing any
1132 : : * cataloged expressions. This does the right thing when unique
1133 : : * indexes redundantly repeat the same attribute, or if attributes
1134 : : * redundantly appear multiple times within an inference clause.
1135 : : *
1136 : : * In case a constraint was named, ensure the candidate has an equal
1137 : : * set of expressions as the named constraint's index.
1138 : : */
4015 andres@anarazel.de 1139 [ + + ]:CBC 1380 : if (list_difference(idxExprs, inferElems) != NIL)
155 alvherre@kurilemu.de 1140 :GNC 39 : continue;
1141 : :
4015 andres@anarazel.de 1142 :CBC 1341 : predExprs = RelationGetIndexPredicate(idxRel);
147 rguo@postgresql.org 1143 [ + + ]:GNC 1341 : if (predExprs)
1144 : : {
1145 [ + + ]: 53 : if (varno != 1)
1146 : 5 : ChangeVarNodes((Node *) predExprs, 1, varno, 0);
1147 : :
1148 : : predExprs = (List *)
1149 : 53 : eval_const_expressions(root,
1150 : 53 : (Node *) make_ands_explicit(predExprs));
1151 : 53 : predExprs = make_ands_implicit((Expr *) predExprs);
1152 : : }
1153 : :
1154 : : /*
1155 : : * Partial indexes affect each form of ON CONFLICT differently: if a
1156 : : * constraint was named, then the predicates must be identical. In
1157 : : * conventional inference, the index's predicate must be implied by
1158 : : * the WHERE clause.
1159 : : */
155 alvherre@kurilemu.de 1160 [ + + ]: 1341 : if (OidIsValid(indexOidFromConstraint))
1161 : : {
1162 [ - + ]: 6 : if (list_difference(predExprs, inferIndexExprs) != NIL)
155 alvherre@kurilemu.de 1163 :UNC 0 : continue;
1164 : : }
1165 : : else
1166 : : {
155 alvherre@kurilemu.de 1167 [ + + ]:GNC 1335 : if (!predicate_implied_by(predExprs, inferIndexExprs, false))
1168 : 24 : continue;
1169 : : }
1170 : :
1171 : : /* All good -- consider this index a match */
4004 andres@anarazel.de 1172 :CBC 1317 : results = lappend_oid(results, idxForm->indexrelid);
162 alvherre@kurilemu.de 1173 :GNC 1317 : foundValid |= idxForm->indisvalid;
1174 : : }
1175 : :
1176 : : /* Close all indexes */
155 1177 [ + + + + : 5101 : foreach_ptr(RelationData, idxRel, indexRelList)
+ + ]
1178 : : {
4015 andres@anarazel.de 1179 :CBC 1963 : index_close(idxRel, NoLock);
1180 : : }
1181 : :
1182 : 1569 : list_free(indexList);
155 alvherre@kurilemu.de 1183 :GNC 1569 : list_free(indexRelList);
2661 andres@anarazel.de 1184 :CBC 1569 : table_close(relation, NoLock);
1185 : :
1186 : : /* We require at least one indisvalid index */
162 alvherre@kurilemu.de 1187 [ + + - + ]:GNC 1569 : if (results == NIL || !foundValid)
4015 andres@anarazel.de 1188 [ + - ]:CBC 212 : ereport(ERROR,
1189 : : (errcode(ERRCODE_INVALID_COLUMN_REFERENCE),
1190 : : errmsg("there is no unique or exclusion constraint matching the ON CONFLICT specification")));
1191 : :
4004 1192 : 1357 : return results;
1193 : : }
1194 : :
1195 : : /*
1196 : : * infer_collation_opclass_match - ensure infer element opclass/collation match
1197 : : *
1198 : : * Given unique index inference element from inference specification, if
1199 : : * collation was specified, or if opclass was specified, verify that there is
1200 : : * at least one matching indexed attribute (occasionally, there may be more).
1201 : : * Skip this in the common case where inference specification does not include
1202 : : * collation or opclass (instead matching everything, regardless of cataloged
1203 : : * collation/opclass of indexed attribute).
1204 : : *
1205 : : * At least historically, Postgres has not offered collations or opclasses
1206 : : * with alternative-to-default notions of equality, so these additional
1207 : : * criteria should only be required infrequently.
1208 : : *
1209 : : * Don't give up immediately when an inference element matches some attribute
1210 : : * cataloged as indexed but not matching additional opclass/collation
1211 : : * criteria. This is done so that the implementation is as forgiving as
1212 : : * possible of redundancy within cataloged index attributes (or, less
1213 : : * usefully, within inference specification elements). If collations actually
1214 : : * differ between apparently redundantly indexed attributes (redundant within
1215 : : * or across indexes), then there really is no redundancy as such.
1216 : : *
1217 : : * Note that if an inference element specifies an opclass and a collation at
1218 : : * once, both must match in at least one particular attribute within index
1219 : : * catalog definition in order for that inference element to be considered
1220 : : * inferred/satisfied.
1221 : : */
1222 : : static bool
4015 1223 : 1743 : infer_collation_opclass_match(InferenceElem *elem, Relation idxRel,
1224 : : List *idxExprs)
1225 : : {
1226 : : AttrNumber natt;
3240 tgl@sss.pgh.pa.us 1227 : 1743 : Oid inferopfamily = InvalidOid; /* OID of opclass opfamily */
3936 andres@anarazel.de 1228 : 1743 : Oid inferopcinputtype = InvalidOid; /* OID of opclass input type */
3617 rhaas@postgresql.org 1229 : 1743 : int nplain = 0; /* # plain attrs observed */
1230 : :
1231 : : /*
1232 : : * If inference specification element lacks collation/opclass, then no
1233 : : * need to check for exact match.
1234 : : */
4004 andres@anarazel.de 1235 [ + + + + ]: 1743 : if (elem->infercollid == InvalidOid && elem->inferopclass == InvalidOid)
4015 1236 : 1649 : return true;
1237 : :
1238 : : /*
1239 : : * Lookup opfamily and input type, for matching indexes
1240 : : */
4004 1241 [ + + ]: 94 : if (elem->inferopclass)
1242 : : {
1243 : 69 : inferopfamily = get_opclass_family(elem->inferopclass);
1244 : 69 : inferopcinputtype = get_opclass_input_type(elem->inferopclass);
1245 : : }
1246 : :
4015 1247 [ + + ]: 202 : for (natt = 1; natt <= idxRel->rd_att->natts; natt++)
1248 : : {
4000 bruce@momjian.us 1249 : 173 : Oid opfamily = idxRel->rd_opfamily[natt - 1];
1250 : 173 : Oid opcinputtype = idxRel->rd_opcintype[natt - 1];
1251 : 173 : Oid collation = idxRel->rd_indcollation[natt - 1];
3936 andres@anarazel.de 1252 : 173 : int attno = idxRel->rd_index->indkey.values[natt - 1];
1253 : :
1254 [ + + ]: 173 : if (attno != 0)
1255 : 140 : nplain++;
1256 : :
4004 1257 [ + + + + ]: 173 : if (elem->inferopclass != InvalidOid &&
1258 [ - + ]: 54 : (inferopfamily != opfamily || inferopcinputtype != opcinputtype))
1259 : : {
1260 : : /* Attribute needed to match opclass, but didn't */
4015 1261 : 74 : continue;
1262 : : }
1263 : :
1264 [ + + ]: 99 : if (elem->infercollid != InvalidOid &&
1265 [ + + ]: 70 : elem->infercollid != collation)
1266 : : {
1267 : : /* Attribute needed to match collation, but didn't */
1268 : 30 : continue;
1269 : : }
1270 : :
1271 : : /* If one matching index att found, good enough -- return true */
3936 1272 [ + + ]: 69 : if (IsA(elem->expr, Var))
1273 : : {
1274 [ + - ]: 45 : if (((Var *) elem->expr)->varattno == attno)
1275 : 45 : return true;
1276 : : }
1277 [ + - ]: 24 : else if (attno == 0)
1278 : : {
1279 : 24 : Node *nattExpr = list_nth(idxExprs, (natt - 1) - nplain);
1280 : :
1281 : : /*
1282 : : * Note that unlike routines like match_index_to_operand() we
1283 : : * don't need to care about RelabelType. Neither the index
1284 : : * definition nor the inference clause should contain them.
1285 : : */
1286 [ + + ]: 24 : if (equal(elem->expr, nattExpr))
1287 : 20 : return true;
1288 : : }
1289 : : }
1290 : :
4015 1291 : 29 : return false;
1292 : : }
1293 : :
1294 : : /*
1295 : : * estimate_rel_size - estimate # pages and # tuples in a table or index
1296 : : *
1297 : : * We also estimate the fraction of the pages that are marked all-visible in
1298 : : * the visibility map, for use in estimation of index-only scans.
1299 : : *
1300 : : * If attr_widths isn't NULL, it points to the zero-index entry of the
1301 : : * relation's attr_widths[] cache; we fill this in if we have need to compute
1302 : : * the attribute widths for estimation purposes.
1303 : : */
1304 : : void
7825 tgl@sss.pgh.pa.us 1305 : 357153 : estimate_rel_size(Relation rel, int32 *attr_widths,
1306 : : BlockNumber *pages, double *tuples, double *allvisfrac)
1307 : : {
1308 : : BlockNumber curpages;
1309 : : BlockNumber relpages;
1310 : : double reltuples;
1311 : : BlockNumber relallvisible;
1312 : : double density;
1313 : :
1614 peter@eisentraut.org 1314 [ + + + + : 357153 : if (RELKIND_HAS_TABLE_AM(rel->rd_rel->relkind))
+ + ]
1315 : : {
1454 tgl@sss.pgh.pa.us 1316 : 354999 : table_relation_estimate_size(rel, attr_widths, pages, tuples,
1317 : : allvisfrac);
1318 : : }
1614 peter@eisentraut.org 1319 [ + + ]: 2154 : else if (rel->rd_rel->relkind == RELKIND_INDEX)
1320 : : {
1321 : : /*
1322 : : * XXX: It'd probably be good to move this into a callback, individual
1323 : : * index types e.g. know if they have a metapage.
1324 : : */
1325 : :
1326 : : /* it has storage, ok to call the smgr */
1454 tgl@sss.pgh.pa.us 1327 : 827 : curpages = RelationGetNumberOfBlocks(rel);
1328 : :
1329 : : /* report estimated # pages */
1330 : 827 : *pages = curpages;
1331 : : /* quick exit if rel is clearly empty */
1332 [ - + ]: 827 : if (curpages == 0)
1333 : : {
1454 tgl@sss.pgh.pa.us 1334 :UBC 0 : *tuples = 0;
1335 : 0 : *allvisfrac = 0;
1336 : 0 : return;
1337 : : }
1338 : :
1339 : : /* coerce values in pg_class to more desirable types */
1454 tgl@sss.pgh.pa.us 1340 :CBC 827 : relpages = (BlockNumber) rel->rd_rel->relpages;
1341 : 827 : reltuples = (double) rel->rd_rel->reltuples;
1342 : 827 : relallvisible = (BlockNumber) rel->rd_rel->relallvisible;
1343 : :
1344 : : /*
1345 : : * Discount the metapage while estimating the number of tuples. This
1346 : : * is a kluge because it assumes more than it ought to about index
1347 : : * structure. Currently it's OK for btree, hash, and GIN indexes but
1348 : : * suspect for GiST indexes.
1349 : : */
1350 [ + + ]: 827 : if (relpages > 0)
1351 : : {
1352 : 812 : curpages--;
1353 : 812 : relpages--;
1354 : : }
1355 : :
1356 : : /* estimate number of tuples from previous tuple density */
1357 [ + + + + ]: 827 : if (reltuples >= 0 && relpages > 0)
1358 : 610 : density = reltuples / (double) relpages;
1359 : : else
1360 : : {
1361 : : /*
1362 : : * If we have no data because the relation was never vacuumed,
1363 : : * estimate tuple width from attribute datatypes. We assume here
1364 : : * that the pages are completely full, which is OK for tables
1365 : : * (since they've presumably not been VACUUMed yet) but is
1366 : : * probably an overestimate for indexes. Fortunately
1367 : : * get_relation_info() can clamp the overestimate to the parent
1368 : : * table's size.
1369 : : *
1370 : : * Note: this code intentionally disregards alignment
1371 : : * considerations, because (a) that would be gilding the lily
1372 : : * considering how crude the estimate is, and (b) it creates
1373 : : * platform dependencies in the default plans which are kind of a
1374 : : * headache for regression testing.
1375 : : *
1376 : : * XXX: Should this logic be more index specific?
1377 : : */
1378 : : int32 tuple_width;
1379 : :
1380 : 217 : tuple_width = get_rel_data_width(rel, attr_widths);
1381 : 217 : tuple_width += MAXALIGN(SizeofHeapTupleHeader);
1382 : 217 : tuple_width += sizeof(ItemIdData);
1383 : : /* note: integer division is intentional here */
1384 : 217 : density = (BLCKSZ - SizeOfPageHeaderData) / tuple_width;
1385 : : }
1386 : 827 : *tuples = rint(density * (double) curpages);
1387 : :
1388 : : /*
1389 : : * We use relallvisible as-is, rather than scaling it up like we do
1390 : : * for the pages and tuples counts, on the theory that any pages added
1391 : : * since the last VACUUM are most likely not marked all-visible. But
1392 : : * costsize.c wants it converted to a fraction.
1393 : : */
1394 [ - + - - ]: 827 : if (relallvisible == 0 || curpages <= 0)
1395 : 827 : *allvisfrac = 0;
1454 tgl@sss.pgh.pa.us 1396 [ # # ]:UBC 0 : else if ((double) relallvisible >= curpages)
1397 : 0 : *allvisfrac = 1;
1398 : : else
1399 : 0 : *allvisfrac = (double) relallvisible / curpages;
1400 : : }
1401 : : else
1402 : : {
1403 : : /*
1404 : : * Just use whatever's in pg_class. This covers foreign tables,
1405 : : * sequences, and also relkinds without storage (shouldn't get here?);
1406 : : * see initializations in AddNewRelationTuple(). Note that FDW must
1407 : : * cope if reltuples is -1!
1408 : : */
1454 tgl@sss.pgh.pa.us 1409 :CBC 1327 : *pages = rel->rd_rel->relpages;
1410 : 1327 : *tuples = rel->rd_rel->reltuples;
1411 : 1327 : *allvisfrac = 0;
1412 : : }
1413 : : }
1414 : :
1415 : :
1416 : : /*
1417 : : * get_rel_data_width
1418 : : *
1419 : : * Estimate the average width of (the data part of) the relation's tuples.
1420 : : *
1421 : : * If attr_widths isn't NULL, it points to the zero-index entry of the
1422 : : * relation's attr_widths[] cache; use and update that cache as appropriate.
1423 : : *
1424 : : * Currently we ignore dropped columns. Ideally those should be included
1425 : : * in the result, but we haven't got any way to get info about them; and
1426 : : * since they might be mostly NULLs, treating them as zero-width is not
1427 : : * necessarily the wrong thing anyway.
1428 : : */
1429 : : int32
5689 1430 : 123600 : get_rel_data_width(Relation rel, int32 *attr_widths)
1431 : : {
868 1432 : 123600 : int64 tuple_width = 0;
1433 : : int i;
1434 : :
5689 1435 [ + + ]: 687149 : for (i = 1; i <= RelationGetNumberOfAttributes(rel); i++)
1436 : : {
3180 andres@anarazel.de 1437 : 563549 : Form_pg_attribute att = TupleDescAttr(rel->rd_att, i - 1);
1438 : : int32 item_width;
1439 : :
5689 tgl@sss.pgh.pa.us 1440 [ + + ]: 563549 : if (att->attisdropped)
1441 : 2173 : continue;
1442 : :
1443 : : /* use previously cached data, if any */
5646 1444 [ + + + + ]: 561376 : if (attr_widths != NULL && attr_widths[i] > 0)
1445 : : {
1446 : 3457 : tuple_width += attr_widths[i];
1447 : 3457 : continue;
1448 : : }
1449 : :
1450 : : /* This should match set_rel_width() in costsize.c */
5689 1451 : 557919 : item_width = get_attavgwidth(RelationGetRelid(rel), i);
1452 [ + + ]: 557919 : if (item_width <= 0)
1453 : : {
1454 : 556798 : item_width = get_typavgwidth(att->atttypid, att->atttypmod);
1455 [ - + ]: 556798 : Assert(item_width > 0);
1456 : : }
1457 [ + + ]: 557919 : if (attr_widths != NULL)
1458 : 508575 : attr_widths[i] = item_width;
1459 : 557919 : tuple_width += item_width;
1460 : : }
1461 : :
868 1462 : 123600 : return clamp_width_est(tuple_width);
1463 : : }
1464 : :
1465 : : /*
1466 : : * get_relation_data_width
1467 : : *
1468 : : * External API for get_rel_data_width: same behavior except we have to
1469 : : * open the relcache entry.
1470 : : */
1471 : : int32
5646 1472 : 1737 : get_relation_data_width(Oid relid, int32 *attr_widths)
1473 : : {
1474 : : int32 result;
1475 : : Relation relation;
1476 : :
1477 : : /* As above, assume relation is already locked */
2661 andres@anarazel.de 1478 : 1737 : relation = table_open(relid, NoLock);
1479 : :
5646 tgl@sss.pgh.pa.us 1480 : 1737 : result = get_rel_data_width(relation, attr_widths);
1481 : :
2661 andres@anarazel.de 1482 : 1737 : table_close(relation, NoLock);
1483 : :
5689 tgl@sss.pgh.pa.us 1484 : 1737 : return result;
1485 : : }
1486 : :
1487 : :
1488 : : /*
1489 : : * get_relation_constraints
1490 : : *
1491 : : * Retrieve the applicable constraint expressions of the given relation.
1492 : : * Only constraints that have been validated are considered.
1493 : : *
1494 : : * Returns a List (possibly empty) of constraint expressions. Each one
1495 : : * has been canonicalized, and its Vars are changed to have the varno
1496 : : * indicated by rel->relid. This allows the expressions to be easily
1497 : : * compared to expressions taken from WHERE.
1498 : : *
1499 : : * If include_noinherit is true, it's okay to include constraints that
1500 : : * are marked NO INHERIT.
1501 : : *
1502 : : * If include_notnull is true, "col IS NOT NULL" expressions are generated
1503 : : * and added to the result for each column that's marked attnotnull.
1504 : : *
1505 : : * If include_partition is true, and the relation is a partition,
1506 : : * also include the partitioning constraints.
1507 : : *
1508 : : * Note: at present this is invoked at most once per relation per planner
1509 : : * run, and in many cases it won't be invoked at all, so there seems no
1510 : : * point in caching the data in RelOptInfo.
1511 : : */
1512 : : static List *
6608 1513 : 17341 : get_relation_constraints(PlannerInfo *root,
1514 : : Oid relationObjectId, RelOptInfo *rel,
1515 : : bool include_noinherit,
1516 : : bool include_notnull,
1517 : : bool include_partition)
1518 : : {
7591 1519 : 17341 : List *result = NIL;
1520 : 17341 : Index varno = rel->relid;
1521 : : Relation relation;
1522 : : TupleConstr *constr;
1523 : :
1524 : : /*
1525 : : * We assume the relation has already been safely locked.
1526 : : */
2661 andres@anarazel.de 1527 : 17341 : relation = table_open(relationObjectId, NoLock);
1528 : :
7591 tgl@sss.pgh.pa.us 1529 : 17341 : constr = relation->rd_att->constr;
1530 [ + + ]: 17341 : if (constr != NULL)
1531 : : {
7507 bruce@momjian.us 1532 : 6358 : int num_check = constr->num_check;
1533 : : int i;
1534 : :
7591 tgl@sss.pgh.pa.us 1535 [ + + ]: 6987 : for (i = 0; i < num_check; i++)
1536 : : {
1537 : : Node *cexpr;
1538 : :
1539 : : /*
1540 : : * If this constraint hasn't been fully validated yet, we must
1541 : : * ignore it here.
1542 : : */
5452 alvherre@alvh.no-ip. 1543 [ + + ]: 629 : if (!constr->check[i].ccvalid)
1544 : 110 : continue;
1545 : :
1546 : : /*
1547 : : * NOT ENFORCED constraints are always marked as invalid, which
1548 : : * should have been ignored.
1549 : : */
479 peter@eisentraut.org 1550 [ - + ]: 519 : Assert(constr->check[i].ccenforced);
1551 : :
1552 : : /*
1553 : : * Also ignore if NO INHERIT and we weren't told that that's safe.
1554 : : */
2562 tgl@sss.pgh.pa.us 1555 [ + + - + ]: 519 : if (constr->check[i].ccnoinherit && !include_noinherit)
2562 tgl@sss.pgh.pa.us 1556 :UBC 0 : continue;
1557 : :
7591 tgl@sss.pgh.pa.us 1558 :CBC 519 : cexpr = stringToNode(constr->check[i].ccbin);
1559 : :
1560 : : /*
1561 : : * Fix Vars to have the desired varno. This must be done before
1562 : : * const-simplification because eval_const_expressions reduces
1563 : : * NullTest for Vars based on varno.
1564 : : */
247 rguo@postgresql.org 1565 [ + + ]:GNC 519 : if (varno != 1)
1566 : 503 : ChangeVarNodes(cexpr, 1, varno, 0);
1567 : :
1568 : : /*
1569 : : * Run each expression through const-simplification and
1570 : : * canonicalization. This is not just an optimization, but is
1571 : : * necessary, because we will be comparing it to
1572 : : * similarly-processed qual clauses, and may fail to detect valid
1573 : : * matches without this. This must match the processing done to
1574 : : * qual clauses in preprocess_expression()! (We can skip the
1575 : : * stuff involving subqueries, however, since we don't allow any
1576 : : * in check constraints.)
1577 : : */
6608 tgl@sss.pgh.pa.us 1578 :CBC 519 : cexpr = eval_const_expressions(root, cexpr);
1579 : :
2977 1580 : 519 : cexpr = (Node *) canonicalize_qual((Expr *) cexpr, true);
1581 : :
1582 : : /*
1583 : : * Finally, convert to implicit-AND format (that is, a List) and
1584 : : * append the resulting item(s) to our output list.
1585 : : */
7591 1586 : 519 : result = list_concat(result,
1587 : 519 : make_ands_implicit((Expr *) cexpr));
1588 : : }
1589 : :
1590 : : /* Add NOT NULL constraints in expression form, if requested */
6688 1591 [ + + + + ]: 6358 : if (include_notnull && constr->has_not_null)
1592 : : {
6172 bruce@momjian.us 1593 : 5739 : int natts = relation->rd_att->natts;
1594 : :
6688 tgl@sss.pgh.pa.us 1595 [ + + ]: 22674 : for (i = 1; i <= natts; i++)
1596 : : {
393 alvherre@alvh.no-ip. 1597 : 16935 : CompactAttribute *att = TupleDescCompactAttr(relation->rd_att, i - 1);
1598 : :
1599 [ + + + - ]: 16935 : if (att->attnullability == ATTNULLABLE_VALID && !att->attisdropped)
1600 : : {
1601 : 7369 : Form_pg_attribute wholeatt = TupleDescAttr(relation->rd_att, i - 1);
6172 bruce@momjian.us 1602 : 7369 : NullTest *ntest = makeNode(NullTest);
1603 : :
6688 tgl@sss.pgh.pa.us 1604 : 7369 : ntest->arg = (Expr *) makeVar(varno,
1605 : : i,
1606 : : wholeatt->atttypid,
1607 : : wholeatt->atttypmod,
1608 : : wholeatt->attcollation,
1609 : : 0);
1610 : 7369 : ntest->nulltesttype = IS_NOT_NULL;
1611 : :
1612 : : /*
1613 : : * argisrow=false is correct even for a composite column,
1614 : : * because attnotnull does not represent a SQL-spec IS NOT
1615 : : * NULL test in such a case, just IS DISTINCT FROM NULL.
1616 : : */
3568 1617 : 7369 : ntest->argisrow = false;
4090 1618 : 7369 : ntest->location = -1;
6688 1619 : 7369 : result = lappend(result, ntest);
1620 : : }
1621 : : }
1622 : : }
1623 : : }
1624 : :
1625 : : /*
1626 : : * Add partitioning constraints, if requested.
1627 : : */
2562 1628 [ + + + + ]: 17341 : if (include_partition && relation->rd_rel->relispartition)
1629 : : {
1630 : : /* make sure rel->partition_qual is set */
2457 alvherre@alvh.no-ip. 1631 : 10 : set_baserel_partition_constraint(relation, rel);
1632 : 10 : result = list_concat(result, rel->partition_qual);
1633 : : }
1634 : :
1635 : : /*
1636 : : * Expand virtual generated columns in the constraint expressions.
1637 : : */
232 peter@eisentraut.org 1638 [ + + ]: 17341 : if (result)
1639 : 5959 : result = (List *) expand_generated_columns_in_expr((Node *) result,
1640 : : relation,
1641 : : varno);
1642 : :
2661 andres@anarazel.de 1643 : 17341 : table_close(relation, NoLock);
1644 : :
7591 tgl@sss.pgh.pa.us 1645 : 17341 : return result;
1646 : : }
1647 : :
1648 : : /*
1649 : : * Try loading data for the statistics object.
1650 : : *
1651 : : * We don't know if the data (specified by statOid and inh value) exist.
1652 : : * The result is stored in stainfos list.
1653 : : */
1654 : : static void
1570 tomas.vondra@postgre 1655 : 3438 : get_relation_statistics_worker(List **stainfos, RelOptInfo *rel,
1656 : : Oid statOid, bool inh,
1657 : : Bitmapset *keys, List *exprs)
1658 : : {
1659 : : Form_pg_statistic_ext_data dataForm;
1660 : : HeapTuple dtup;
1661 : :
1662 : 3438 : dtup = SearchSysCache2(STATEXTDATASTXOID,
1663 : : ObjectIdGetDatum(statOid), BoolGetDatum(inh));
1664 [ + + ]: 3438 : if (!HeapTupleIsValid(dtup))
1665 : 1729 : return;
1666 : :
1667 : 1709 : dataForm = (Form_pg_statistic_ext_data) GETSTRUCT(dtup);
1668 : :
1669 : : /* add one StatisticExtInfo for each kind built */
1670 [ + + ]: 1709 : if (statext_is_kind_built(dtup, STATS_EXT_NDISTINCT))
1671 : : {
1672 : 608 : StatisticExtInfo *info = makeNode(StatisticExtInfo);
1673 : :
1674 : 608 : info->statOid = statOid;
1675 : 608 : info->inherit = dataForm->stxdinherit;
1676 : 608 : info->rel = rel;
1677 : 608 : info->kind = STATS_EXT_NDISTINCT;
1678 : 608 : info->keys = bms_copy(keys);
1679 : 608 : info->exprs = exprs;
1680 : :
1681 : 608 : *stainfos = lappend(*stainfos, info);
1682 : : }
1683 : :
1684 [ + + ]: 1709 : if (statext_is_kind_built(dtup, STATS_EXT_DEPENDENCIES))
1685 : : {
1686 : 453 : StatisticExtInfo *info = makeNode(StatisticExtInfo);
1687 : :
1688 : 453 : info->statOid = statOid;
1689 : 453 : info->inherit = dataForm->stxdinherit;
1690 : 453 : info->rel = rel;
1691 : 453 : info->kind = STATS_EXT_DEPENDENCIES;
1692 : 453 : info->keys = bms_copy(keys);
1693 : 453 : info->exprs = exprs;
1694 : :
1695 : 453 : *stainfos = lappend(*stainfos, info);
1696 : : }
1697 : :
1698 [ + + ]: 1709 : if (statext_is_kind_built(dtup, STATS_EXT_MCV))
1699 : : {
1700 : 758 : StatisticExtInfo *info = makeNode(StatisticExtInfo);
1701 : :
1702 : 758 : info->statOid = statOid;
1703 : 758 : info->inherit = dataForm->stxdinherit;
1704 : 758 : info->rel = rel;
1705 : 758 : info->kind = STATS_EXT_MCV;
1706 : 758 : info->keys = bms_copy(keys);
1707 : 758 : info->exprs = exprs;
1708 : :
1709 : 758 : *stainfos = lappend(*stainfos, info);
1710 : : }
1711 : :
1712 [ + + ]: 1709 : if (statext_is_kind_built(dtup, STATS_EXT_EXPRESSIONS))
1713 : : {
1714 : 716 : StatisticExtInfo *info = makeNode(StatisticExtInfo);
1715 : :
1716 : 716 : info->statOid = statOid;
1717 : 716 : info->inherit = dataForm->stxdinherit;
1718 : 716 : info->rel = rel;
1719 : 716 : info->kind = STATS_EXT_EXPRESSIONS;
1720 : 716 : info->keys = bms_copy(keys);
1721 : 716 : info->exprs = exprs;
1722 : :
1723 : 716 : *stainfos = lappend(*stainfos, info);
1724 : : }
1725 : :
1726 : 1709 : ReleaseSysCache(dtup);
1727 : : }
1728 : :
1729 : : /*
1730 : : * get_relation_statistics
1731 : : * Retrieve extended statistics defined on the table.
1732 : : *
1733 : : * Returns a List (possibly empty) of StatisticExtInfo objects describing
1734 : : * the statistics. Note that this doesn't load the actual statistics data,
1735 : : * just the identifying metadata. Only stats actually built are considered.
1736 : : */
1737 : : static List *
247 rguo@postgresql.org 1738 :GNC 374141 : get_relation_statistics(PlannerInfo *root, RelOptInfo *rel,
1739 : : Relation relation)
1740 : : {
1866 tomas.vondra@postgre 1741 :CBC 374141 : Index varno = rel->relid;
1742 : : List *statoidlist;
3329 alvherre@alvh.no-ip. 1743 : 374141 : List *stainfos = NIL;
1744 : : ListCell *l;
1745 : :
1746 : 374141 : statoidlist = RelationGetStatExtList(relation);
1747 : :
1748 [ + + + + : 375860 : foreach(l, statoidlist)
+ + ]
1749 : : {
1750 : 1719 : Oid statOid = lfirst_oid(l);
1751 : : Form_pg_statistic_ext staForm;
1752 : : HeapTuple htup;
1753 : 1719 : Bitmapset *keys = NULL;
1866 tomas.vondra@postgre 1754 : 1719 : List *exprs = NIL;
1755 : : int i;
1756 : :
3329 alvherre@alvh.no-ip. 1757 : 1719 : htup = SearchSysCache1(STATEXTOID, ObjectIdGetDatum(statOid));
2557 tgl@sss.pgh.pa.us 1758 [ - + ]: 1719 : if (!HeapTupleIsValid(htup))
3278 tgl@sss.pgh.pa.us 1759 [ # # ]:UBC 0 : elog(ERROR, "cache lookup failed for statistics object %u", statOid);
3329 alvherre@alvh.no-ip. 1760 :CBC 1719 : staForm = (Form_pg_statistic_ext) GETSTRUCT(htup);
1761 : :
1762 : : /*
1763 : : * First, build the array of columns covered. This is ultimately
1764 : : * wasted if no stats within the object have actually been built, but
1765 : : * it doesn't seem worth troubling over that case.
1766 : : */
3305 1767 [ + + ]: 4815 : for (i = 0; i < staForm->stxkeys.dim1; i++)
1768 : 3096 : keys = bms_add_member(keys, staForm->stxkeys.values[i]);
1769 : :
1770 : : /*
1771 : : * Preprocess expressions (if any). We read the expressions, fix the
1772 : : * varnos, and run them through eval_const_expressions.
1773 : : *
1774 : : * XXX We don't know yet if there are any data for this stats object,
1775 : : * with either stxdinherit value. But it's reasonable to assume there
1776 : : * is at least one of those, possibly both. So it's better to process
1777 : : * keys and expressions here.
1778 : : */
1779 : : {
1780 : : bool isnull;
1781 : : Datum datum;
1782 : :
1783 : : /* decode expression (if any) */
1866 tomas.vondra@postgre 1784 : 1719 : datum = SysCacheGetAttr(STATEXTOID, htup,
1785 : : Anum_pg_statistic_ext_stxexprs, &isnull);
1786 : :
1787 [ + + ]: 1719 : if (!isnull)
1788 : : {
1789 : : char *exprsString;
1790 : :
1791 : 723 : exprsString = TextDatumGetCString(datum);
1792 : 723 : exprs = (List *) stringToNode(exprsString);
1793 : 723 : pfree(exprsString);
1794 : :
1795 : : /* Expand virtual generated columns in the expressions */
34 dean.a.rasheed@gmail 1796 :GNC 723 : exprs = (List *) expand_generated_columns_in_expr((Node *) exprs, relation, 1);
1797 : :
1798 : : /*
1799 : : * Modify the copies we obtain from the relcache to have the
1800 : : * correct varno for the parent relation, so that they match
1801 : : * up correctly against qual clauses.
1802 : : *
1803 : : * This must be done before const-simplification because
1804 : : * eval_const_expressions reduces NullTest for Vars based on
1805 : : * varno.
1806 : : */
247 rguo@postgresql.org 1807 [ - + ]: 723 : if (varno != 1)
247 rguo@postgresql.org 1808 :UNC 0 : ChangeVarNodes((Node *) exprs, 1, varno, 0);
1809 : :
1810 : : /*
1811 : : * Run the expressions through eval_const_expressions. This is
1812 : : * not just an optimization, but is necessary, because the
1813 : : * planner will be comparing them to similarly-processed qual
1814 : : * clauses, and may fail to detect valid matches without this.
1815 : : * We must not use canonicalize_qual, however, since these
1816 : : * aren't qual expressions.
1817 : : */
247 rguo@postgresql.org 1818 :GNC 723 : exprs = (List *) eval_const_expressions(root, (Node *) exprs);
1819 : :
1820 : : /* May as well fix opfuncids too */
1866 tomas.vondra@postgre 1821 :CBC 723 : fix_opfuncids((Node *) exprs);
1822 : : }
1823 : : }
1824 : :
1825 : : /* extract statistics for possible values of stxdinherit flag */
1826 : :
1570 1827 : 1719 : get_relation_statistics_worker(&stainfos, rel, statOid, true, keys, exprs);
1828 : :
1829 : 1719 : get_relation_statistics_worker(&stainfos, rel, statOid, false, keys, exprs);
1830 : :
3329 alvherre@alvh.no-ip. 1831 : 1719 : ReleaseSysCache(htup);
1832 : 1719 : bms_free(keys);
1833 : : }
1834 : :
1835 : 374141 : list_free(statoidlist);
1836 : :
1837 : 374141 : return stainfos;
1838 : : }
1839 : :
1840 : : /*
1841 : : * relation_excluded_by_constraints
1842 : : *
1843 : : * Detect whether the relation need not be scanned because it has either
1844 : : * self-inconsistent restrictions, or restrictions inconsistent with the
1845 : : * relation's applicable constraints.
1846 : : *
1847 : : * Note: this examines only rel->relid, rel->reloptkind, and
1848 : : * rel->baserestrictinfo; therefore it can be called before filling in
1849 : : * other fields of the RelOptInfo.
1850 : : */
1851 : : bool
6608 tgl@sss.pgh.pa.us 1852 : 415243 : relation_excluded_by_constraints(PlannerInfo *root,
1853 : : RelOptInfo *rel, RangeTblEntry *rte)
1854 : : {
1855 : : bool include_noinherit;
1856 : : bool include_notnull;
2562 1857 : 415243 : bool include_partition = false;
1858 : : List *safe_restrictions;
1859 : : List *constraint_pred;
1860 : : List *safe_constraints;
1861 : : ListCell *lc;
1862 : :
1863 : : /* As of now, constraint exclusion works only with simple relations. */
3319 rhaas@postgresql.org 1864 [ + + - + ]: 415243 : Assert(IS_SIMPLE_REL(rel));
1865 : :
1866 : : /*
1867 : : * If there are no base restriction clauses, we have no hope of proving
1868 : : * anything below, so fall out quickly.
1869 : : */
2562 tgl@sss.pgh.pa.us 1870 [ + + ]: 415243 : if (rel->baserestrictinfo == NIL)
1871 : 194092 : return false;
1872 : :
1873 : : /*
1874 : : * Regardless of the setting of constraint_exclusion, detect
1875 : : * constant-FALSE-or-NULL restriction clauses. Although const-folding
1876 : : * will reduce "anything AND FALSE" to just "FALSE", the baserestrictinfo
1877 : : * list can still have other members besides the FALSE constant, due to
1878 : : * qual pushdown and other mechanisms; so check them all. This doesn't
1879 : : * fire very often, but it seems cheap enough to be worth doing anyway.
1880 : : * (Without this, we'd miss some optimizations that 9.5 and earlier found
1881 : : * via much more roundabout methods.)
1882 : : */
937 1883 [ + - + + : 549156 : foreach(lc, rel->baserestrictinfo)
+ + ]
1884 : : {
1885 : 328590 : RestrictInfo *rinfo = (RestrictInfo *) lfirst(lc);
3711 1886 : 328590 : Expr *clause = rinfo->clause;
1887 : :
1888 [ + - + + ]: 328590 : if (clause && IsA(clause, Const) &&
1889 [ + + ]: 585 : (((Const *) clause)->constisnull ||
1890 [ + - ]: 580 : !DatumGetBool(((Const *) clause)->constvalue)))
1891 : 585 : return true;
1892 : : }
1893 : :
1894 : : /*
1895 : : * Skip further tests, depending on constraint_exclusion.
1896 : : */
2934 alvherre@alvh.no-ip. 1897 [ + + + - ]: 220566 : switch (constraint_exclusion)
1898 : : {
1899 : 45 : case CONSTRAINT_EXCLUSION_OFF:
1900 : : /* In 'off' mode, never make any further tests */
1901 : 45 : return false;
1902 : :
1903 : 220405 : case CONSTRAINT_EXCLUSION_PARTITION:
1904 : :
1905 : : /*
1906 : : * When constraint_exclusion is set to 'partition' we only handle
1907 : : * appendrel members. Partition pruning has already been applied,
1908 : : * so there is no need to consider the rel's partition constraints
1909 : : * here.
1910 : : */
1861 tgl@sss.pgh.pa.us 1911 [ + + ]: 220405 : if (rel->reloptkind == RELOPT_OTHER_MEMBER_REL)
2562 1912 : 17532 : break; /* appendrel member, so process it */
1913 : 202873 : return false;
1914 : :
2934 alvherre@alvh.no-ip. 1915 : 116 : case CONSTRAINT_EXCLUSION_ON:
1916 : :
1917 : : /*
1918 : : * In 'on' mode, always apply constraint exclusion. If we are
1919 : : * considering a baserel that is a partition (i.e., it was
1920 : : * directly named rather than expanded from a parent table), then
1921 : : * its partition constraints haven't been considered yet, so
1922 : : * include them in the processing here.
1923 : : */
1861 tgl@sss.pgh.pa.us 1924 [ + + ]: 116 : if (rel->reloptkind == RELOPT_BASEREL)
2562 1925 : 91 : include_partition = true;
2931 1926 : 116 : break; /* always try to exclude */
1927 : : }
1928 : :
1929 : : /*
1930 : : * Check for self-contradictory restriction clauses. We dare not make
1931 : : * deductions with non-immutable functions, but any immutable clauses that
1932 : : * are self-contradictory allow us to conclude the scan is unnecessary.
1933 : : *
1934 : : * Note: strip off RestrictInfo because predicate_refuted_by() isn't
1935 : : * expecting to see any in its predicate argument.
1936 : : */
7213 1937 : 17648 : safe_restrictions = NIL;
1938 [ + - + + : 42069 : foreach(lc, rel->baserestrictinfo)
+ + ]
1939 : : {
1940 : 24421 : RestrictInfo *rinfo = (RestrictInfo *) lfirst(lc);
1941 : :
1942 [ + + ]: 24421 : if (!contain_mutable_functions((Node *) rinfo->clause))
1943 : 22926 : safe_restrictions = lappend(safe_restrictions, rinfo->clause);
1944 : : }
1945 : :
1946 : : /*
1947 : : * We can use weak refutation here, since we're comparing restriction
1948 : : * clauses with restriction clauses.
1949 : : */
2979 1950 [ + + ]: 17648 : if (predicate_refuted_by(safe_restrictions, safe_restrictions, true))
7213 1951 : 60 : return true;
1952 : :
1953 : : /*
1954 : : * Only plain relations have constraints, so stop here for other rtekinds.
1955 : : */
2562 1956 [ + + ]: 17588 : if (rte->rtekind != RTE_RELATION)
7395 1957 : 247 : return false;
1958 : :
1959 : : /*
1960 : : * If we are scanning just this table, we can use NO INHERIT constraints,
1961 : : * but not if we're scanning its children too. (Note that partitioned
1962 : : * tables should never have NO INHERIT constraints; but it's not necessary
1963 : : * for us to assume that here.)
1964 : : */
2562 1965 : 17341 : include_noinherit = !rte->inh;
1966 : :
1967 : : /*
1968 : : * Currently, attnotnull constraints must be treated as NO INHERIT unless
1969 : : * this is a partitioned table. In future we might track their
1970 : : * inheritance status more accurately, allowing this to be refined.
1971 : : *
1972 : : * XXX do we need/want to change this?
1973 : : */
1974 [ + + + + ]: 17341 : include_notnull = (!rte->inh || rte->relkind == RELKIND_PARTITIONED_TABLE);
1975 : :
1976 : : /*
1977 : : * Fetch the appropriate set of constraint expressions.
1978 : : */
1979 : 17341 : constraint_pred = get_relation_constraints(root, rte->relid, rel,
1980 : : include_noinherit,
1981 : : include_notnull,
1982 : : include_partition);
1983 : :
1984 : : /*
1985 : : * We do not currently enforce that CHECK constraints contain only
1986 : : * immutable functions, so it's necessary to check here. We daren't draw
1987 : : * conclusions from plan-time evaluation of non-immutable functions. Since
1988 : : * they're ANDed, we can just ignore any mutable constraints in the list,
1989 : : * and reason about the rest.
1990 : : */
7213 1991 : 17341 : safe_constraints = NIL;
1992 [ + + + + : 25379 : foreach(lc, constraint_pred)
+ + ]
1993 : : {
7153 bruce@momjian.us 1994 : 8038 : Node *pred = (Node *) lfirst(lc);
1995 : :
7213 tgl@sss.pgh.pa.us 1996 [ + - ]: 8038 : if (!contain_mutable_functions(pred))
1997 : 8038 : safe_constraints = lappend(safe_constraints, pred);
1998 : : }
1999 : :
2000 : : /*
2001 : : * The constraints are effectively ANDed together, so we can just try to
2002 : : * refute the entire collection at once. This may allow us to make proofs
2003 : : * that would fail if we took them individually.
2004 : : *
2005 : : * Note: we use rel->baserestrictinfo, not safe_restrictions as might seem
2006 : : * an obvious optimization. Some of the clauses might be OR clauses that
2007 : : * have volatile and nonvolatile subclauses, and it's OK to make
2008 : : * deductions with the nonvolatile parts.
2009 : : *
2010 : : * We need strong refutation because we have to prove that the constraints
2011 : : * would yield false, not just NULL.
2012 : : */
3247 rhaas@postgresql.org 2013 [ + + ]: 17341 : if (predicate_refuted_by(safe_constraints, rel->baserestrictinfo, false))
7395 tgl@sss.pgh.pa.us 2014 : 161 : return true;
2015 : :
2016 : 17180 : return false;
2017 : : }
2018 : :
2019 : :
2020 : : /*
2021 : : * build_physical_tlist
2022 : : *
2023 : : * Build a targetlist consisting of exactly the relation's user attributes,
2024 : : * in order. The executor can special-case such tlists to avoid a projection
2025 : : * step at runtime, so we use such tlists preferentially for scan nodes.
2026 : : *
2027 : : * Exception: if there are any dropped or missing columns, we punt and return
2028 : : * NIL. Ideally we would like to handle these cases too. However this
2029 : : * creates problems for ExecTypeFromTL, which may be asked to build a tupdesc
2030 : : * for a tlist that includes vars of no-longer-existent types. In theory we
2031 : : * could dig out the required info from the pg_attribute entries of the
2032 : : * relation, but that data is not readily available to ExecTypeFromTL.
2033 : : * For now, we don't apply the physical-tlist optimization when there are
2034 : : * dropped cols.
2035 : : *
2036 : : * We also support building a "physical" tlist for subqueries, functions,
2037 : : * values lists, table expressions, and CTEs, since the same optimization can
2038 : : * occur in SubqueryScan, FunctionScan, ValuesScan, CteScan, TableFunc,
2039 : : * NamedTuplestoreScan, and WorkTableScan nodes.
2040 : : */
2041 : : List *
7639 2042 : 149379 : build_physical_tlist(PlannerInfo *root, RelOptInfo *rel)
2043 : : {
7653 2044 : 149379 : List *tlist = NIL;
8346 2045 : 149379 : Index varno = rel->relid;
6954 2046 [ + - ]: 149379 : RangeTblEntry *rte = planner_rt_fetch(varno, root);
2047 : : Relation relation;
2048 : : Query *subquery;
2049 : : Var *var;
2050 : : ListCell *l;
2051 : : int attrno,
2052 : : numattrs;
2053 : : List *colvars;
2054 : :
7653 2055 [ + + + - ]: 149379 : switch (rte->rtekind)
2056 : : {
2057 : 128631 : case RTE_RELATION:
2058 : : /* Assume we already have adequate lock */
2661 andres@anarazel.de 2059 : 128631 : relation = table_open(rte->relid, NoLock);
2060 : :
7653 tgl@sss.pgh.pa.us 2061 : 128631 : numattrs = RelationGetNumberOfAttributes(relation);
2062 [ + + ]: 2193386 : for (attrno = 1; attrno <= numattrs; attrno++)
2063 : : {
3180 andres@anarazel.de 2064 : 2064838 : Form_pg_attribute att_tup = TupleDescAttr(relation->rd_att,
2065 : : attrno - 1);
2066 : :
2960 andrew@dunslane.net 2067 [ + + + + ]: 2064838 : if (att_tup->attisdropped || att_tup->atthasmissing)
2068 : : {
2069 : : /* found a dropped or missing col, so punt */
7653 tgl@sss.pgh.pa.us 2070 : 83 : tlist = NIL;
2071 : 83 : break;
2072 : : }
2073 : :
2074 : 2064755 : var = makeVar(varno,
2075 : : attrno,
2076 : : att_tup->atttypid,
2077 : : att_tup->atttypmod,
2078 : : att_tup->attcollation,
2079 : : 0);
2080 : :
2081 : 2064755 : tlist = lappend(tlist,
2082 : 2064755 : makeTargetEntry((Expr *) var,
2083 : : attrno,
2084 : : NULL,
2085 : : false));
2086 : : }
2087 : :
2661 andres@anarazel.de 2088 : 128631 : table_close(relation, NoLock);
8346 tgl@sss.pgh.pa.us 2089 : 128631 : break;
2090 : :
7653 2091 : 5225 : case RTE_SUBQUERY:
2092 : 5225 : subquery = rte->subquery;
2093 [ + - + + : 21022 : foreach(l, subquery->targetList)
+ + ]
2094 : : {
2095 : 15797 : TargetEntry *tle = (TargetEntry *) lfirst(l);
2096 : :
2097 : : /*
2098 : : * A resjunk column of the subquery can be reflected as
2099 : : * resjunk in the physical tlist; we need not punt.
2100 : : */
5730 peter_e@gmx.net 2101 : 15797 : var = makeVarFromTargetEntry(varno, tle);
2102 : :
7653 tgl@sss.pgh.pa.us 2103 : 15797 : tlist = lappend(tlist,
2104 : 15797 : makeTargetEntry((Expr *) var,
2105 : 15797 : tle->resno,
2106 : : NULL,
2107 : 15797 : tle->resjunk));
2108 : : }
2109 : 5225 : break;
2110 : :
7645 2111 : 15523 : case RTE_FUNCTION:
2112 : : case RTE_TABLEFUNC:
2113 : : case RTE_VALUES:
2114 : : case RTE_CTE:
2115 : : case RTE_NAMEDTUPLESTORE:
2116 : : case RTE_RESULT:
2117 : : /* Not all of these can have dropped cols, but share code anyway */
474 dean.a.rasheed@gmail 2118 : 15523 : expandRTE(rte, varno, 0, VAR_RETURNING_DEFAULT, -1,
2119 : : true /* include dropped */ , NULL, &colvars);
7645 tgl@sss.pgh.pa.us 2120 [ + - + + : 70892 : foreach(l, colvars)
+ + ]
2121 : : {
2122 : 55369 : var = (Var *) lfirst(l);
2123 : :
2124 : : /*
2125 : : * A non-Var in expandRTE's output means a dropped column;
2126 : : * must punt.
2127 : : */
2128 [ - + ]: 55369 : if (!IsA(var, Var))
2129 : : {
7645 tgl@sss.pgh.pa.us 2130 :UBC 0 : tlist = NIL;
2131 : 0 : break;
2132 : : }
2133 : :
7645 tgl@sss.pgh.pa.us 2134 :CBC 55369 : tlist = lappend(tlist,
2135 : 55369 : makeTargetEntry((Expr *) var,
2136 : 55369 : var->varattno,
2137 : : NULL,
2138 : : false));
2139 : : }
2140 : 15523 : break;
2141 : :
7653 tgl@sss.pgh.pa.us 2142 :UBC 0 : default:
2143 : : /* caller error */
2144 [ # # ]: 0 : elog(ERROR, "unsupported RTE kind %d in build_physical_tlist",
2145 : : (int) rte->rtekind);
2146 : : break;
2147 : : }
2148 : :
8008 tgl@sss.pgh.pa.us 2149 :CBC 149379 : return tlist;
2150 : : }
2151 : :
2152 : : /*
2153 : : * build_index_tlist
2154 : : *
2155 : : * Build a targetlist representing the columns of the specified index.
2156 : : * Each column is represented by a Var for the corresponding base-relation
2157 : : * column, or an expression in base-relation Vars, as appropriate.
2158 : : *
2159 : : * There are never any dropped columns in indexes, so unlike
2160 : : * build_physical_tlist, we need no failure case.
2161 : : */
2162 : : static List *
5320 2163 : 587017 : build_index_tlist(PlannerInfo *root, IndexOptInfo *index,
2164 : : Relation heapRelation)
2165 : : {
2166 : 587017 : List *tlist = NIL;
2167 : 587017 : Index varno = index->rel->relid;
2168 : : ListCell *indexpr_item;
2169 : : int i;
2170 : :
2171 : 587017 : indexpr_item = list_head(index->indexprs);
2172 [ + + ]: 1690218 : for (i = 0; i < index->ncolumns; i++)
2173 : : {
2174 : 1103201 : int indexkey = index->indexkeys[i];
2175 : : Expr *indexvar;
2176 : :
2177 [ + + ]: 1103201 : if (indexkey != 0)
2178 : : {
2179 : : /* simple column */
2180 : : const FormData_pg_attribute *att_tup;
2181 : :
2182 [ - + ]: 1100707 : if (indexkey < 0)
2723 andres@anarazel.de 2183 :UBC 0 : att_tup = SystemAttributeDefinition(indexkey);
2184 : : else
3180 andres@anarazel.de 2185 :CBC 1100707 : att_tup = TupleDescAttr(heapRelation->rd_att, indexkey - 1);
2186 : :
5320 tgl@sss.pgh.pa.us 2187 : 1100707 : indexvar = (Expr *) makeVar(varno,
2188 : : indexkey,
2189 : 1100707 : att_tup->atttypid,
2190 : 1100707 : att_tup->atttypmod,
2191 : 1100707 : att_tup->attcollation,
2192 : : 0);
2193 : : }
2194 : : else
2195 : : {
2196 : : /* expression column */
2197 [ - + ]: 2494 : if (indexpr_item == NULL)
5320 tgl@sss.pgh.pa.us 2198 [ # # ]:UBC 0 : elog(ERROR, "wrong number of index expressions");
5320 tgl@sss.pgh.pa.us 2199 :CBC 2494 : indexvar = (Expr *) lfirst(indexpr_item);
2486 2200 : 2494 : indexpr_item = lnext(index->indexprs, indexpr_item);
2201 : : }
2202 : :
5320 2203 : 1103201 : tlist = lappend(tlist,
2204 : 1103201 : makeTargetEntry(indexvar,
2205 : 1103201 : i + 1,
2206 : : NULL,
2207 : : false));
2208 : : }
2209 [ - + ]: 587017 : if (indexpr_item != NULL)
5320 tgl@sss.pgh.pa.us 2210 [ # # ]:UBC 0 : elog(ERROR, "wrong number of index expressions");
2211 : :
5320 tgl@sss.pgh.pa.us 2212 :CBC 587017 : return tlist;
2213 : : }
2214 : :
2215 : : /*
2216 : : * restriction_selectivity
2217 : : *
2218 : : * Returns the selectivity of a specified restriction operator clause.
2219 : : * This code executes registered procedures stored in the
2220 : : * operator relation, by calling the function manager.
2221 : : *
2222 : : * See clause_selectivity() for the meaning of the additional parameters.
2223 : : */
2224 : : Selectivity
7639 2225 : 604519 : restriction_selectivity(PlannerInfo *root,
2226 : : Oid operatorid,
2227 : : List *args,
2228 : : Oid inputcollid,
2229 : : int varRelid)
2230 : : {
6137 peter_e@gmx.net 2231 : 604519 : RegProcedure oprrest = get_oprrest(operatorid);
2232 : : float8 result;
2233 : :
2234 : : /*
2235 : : * if the oprrest procedure is missing for whatever reason, use a
2236 : : * selectivity of 0.5
2237 : : */
9116 tgl@sss.pgh.pa.us 2238 [ + + ]: 604519 : if (!oprrest)
2239 : 96 : return (Selectivity) 0.5;
2240 : :
5049 2241 : 604423 : result = DatumGetFloat8(OidFunctionCall4Coll(oprrest,
2242 : : inputcollid,
2243 : : PointerGetDatum(root),
2244 : : ObjectIdGetDatum(operatorid),
2245 : : PointerGetDatum(args),
2246 : : Int32GetDatum(varRelid)));
2247 : :
9471 2248 [ + - - + ]: 604403 : if (result < 0.0 || result > 1.0)
8320 tgl@sss.pgh.pa.us 2249 [ # # ]:UBC 0 : elog(ERROR, "invalid restriction selectivity: %f", result);
2250 : :
9471 tgl@sss.pgh.pa.us 2251 :CBC 604403 : return (Selectivity) result;
2252 : : }
2253 : :
2254 : : /*
2255 : : * join_selectivity
2256 : : *
2257 : : * Returns the selectivity of a specified join operator clause.
2258 : : * This code executes registered procedures stored in the
2259 : : * operator relation, by calling the function manager.
2260 : : *
2261 : : * See clause_selectivity() for the meaning of the additional parameters.
2262 : : */
2263 : : Selectivity
7639 2264 : 221057 : join_selectivity(PlannerInfo *root,
2265 : : Oid operatorid,
2266 : : List *args,
2267 : : Oid inputcollid,
2268 : : JoinType jointype,
2269 : : SpecialJoinInfo *sjinfo)
2270 : : {
6137 peter_e@gmx.net 2271 : 221057 : RegProcedure oprjoin = get_oprjoin(operatorid);
2272 : : float8 result;
2273 : :
2274 : : /*
2275 : : * if the oprjoin procedure is missing for whatever reason, use a
2276 : : * selectivity of 0.5
2277 : : */
9116 tgl@sss.pgh.pa.us 2278 [ + + ]: 221057 : if (!oprjoin)
2279 : 119 : return (Selectivity) 0.5;
2280 : :
5049 2281 : 220938 : result = DatumGetFloat8(OidFunctionCall5Coll(oprjoin,
2282 : : inputcollid,
2283 : : PointerGetDatum(root),
2284 : : ObjectIdGetDatum(operatorid),
2285 : : PointerGetDatum(args),
2286 : : Int16GetDatum(jointype),
2287 : : PointerGetDatum(sjinfo)));
2288 : :
9471 2289 [ + - - + ]: 220938 : if (result < 0.0 || result > 1.0)
8320 tgl@sss.pgh.pa.us 2290 [ # # ]:UBC 0 : elog(ERROR, "invalid join selectivity: %f", result);
2291 : :
9471 tgl@sss.pgh.pa.us 2292 :CBC 220938 : return (Selectivity) result;
2293 : : }
2294 : :
2295 : : /*
2296 : : * function_selectivity
2297 : : *
2298 : : * Attempt to estimate the selectivity of a specified boolean function clause
2299 : : * by asking its support function. If the function lacks support, return -1.
2300 : : *
2301 : : * See clause_selectivity() for the meaning of the additional parameters.
2302 : : */
2303 : : Selectivity
2642 2304 : 11409 : function_selectivity(PlannerInfo *root,
2305 : : Oid funcid,
2306 : : List *args,
2307 : : Oid inputcollid,
2308 : : bool is_join,
2309 : : int varRelid,
2310 : : JoinType jointype,
2311 : : SpecialJoinInfo *sjinfo)
2312 : : {
2313 : 11409 : RegProcedure prosupport = get_func_support(funcid);
2314 : : SupportRequestSelectivity req;
2315 : : SupportRequestSelectivity *sresult;
2316 : :
2317 [ + + ]: 11409 : if (!prosupport)
227 tgl@sss.pgh.pa.us 2318 :GNC 11384 : return (Selectivity) -1; /* no support function */
2319 : :
2642 tgl@sss.pgh.pa.us 2320 :CBC 25 : req.type = T_SupportRequestSelectivity;
2321 : 25 : req.root = root;
2322 : 25 : req.funcid = funcid;
2323 : 25 : req.args = args;
2324 : 25 : req.inputcollid = inputcollid;
2325 : 25 : req.is_join = is_join;
2326 : 25 : req.varRelid = varRelid;
2327 : 25 : req.jointype = jointype;
2328 : 25 : req.sjinfo = sjinfo;
2329 : 25 : req.selectivity = -1; /* to catch failure to set the value */
2330 : :
2331 : : sresult = (SupportRequestSelectivity *)
2332 : 25 : DatumGetPointer(OidFunctionCall1(prosupport,
2333 : : PointerGetDatum(&req)));
2334 : :
2335 [ - + ]: 25 : if (sresult != &req)
227 tgl@sss.pgh.pa.us 2336 :UNC 0 : return (Selectivity) -1; /* function did not honor request */
2337 : :
2642 tgl@sss.pgh.pa.us 2338 [ + - - + ]:CBC 25 : if (req.selectivity < 0.0 || req.selectivity > 1.0)
2642 tgl@sss.pgh.pa.us 2339 [ # # ]:UBC 0 : elog(ERROR, "invalid function selectivity: %f", req.selectivity);
2340 : :
2642 tgl@sss.pgh.pa.us 2341 :CBC 25 : return (Selectivity) req.selectivity;
2342 : : }
2343 : :
2344 : : /*
2345 : : * add_function_cost
2346 : : *
2347 : : * Get an estimate of the execution cost of a function, and *add* it to
2348 : : * the contents of *cost. The estimate may include both one-time and
2349 : : * per-tuple components, since QualCost does.
2350 : : *
2351 : : * The funcid must always be supplied. If it is being called as the
2352 : : * implementation of a specific parsetree node (FuncExpr, OpExpr,
2353 : : * WindowFunc, etc), pass that as "node", else pass NULL.
2354 : : *
2355 : : * In some usages root might be NULL, too.
2356 : : */
2357 : : void
2358 : 929269 : add_function_cost(PlannerInfo *root, Oid funcid, Node *node,
2359 : : QualCost *cost)
2360 : : {
2361 : : HeapTuple proctup;
2362 : : Form_pg_proc procform;
2363 : :
2364 : 929269 : proctup = SearchSysCache1(PROCOID, ObjectIdGetDatum(funcid));
2365 [ - + ]: 929269 : if (!HeapTupleIsValid(proctup))
2642 tgl@sss.pgh.pa.us 2366 [ # # ]:UBC 0 : elog(ERROR, "cache lookup failed for function %u", funcid);
2642 tgl@sss.pgh.pa.us 2367 :CBC 929269 : procform = (Form_pg_proc) GETSTRUCT(proctup);
2368 : :
2369 [ + + ]: 929269 : if (OidIsValid(procform->prosupport))
2370 : : {
2371 : : SupportRequestCost req;
2372 : : SupportRequestCost *sresult;
2373 : :
2374 : 28144 : req.type = T_SupportRequestCost;
2375 : 28144 : req.root = root;
2376 : 28144 : req.funcid = funcid;
2377 : 28144 : req.node = node;
2378 : :
2379 : : /* Initialize cost fields so that support function doesn't have to */
2380 : 28144 : req.startup = 0;
2381 : 28144 : req.per_tuple = 0;
2382 : :
2383 : : sresult = (SupportRequestCost *)
2384 : 28144 : DatumGetPointer(OidFunctionCall1(procform->prosupport,
2385 : : PointerGetDatum(&req)));
2386 : :
2387 [ + + ]: 28144 : if (sresult == &req)
2388 : : {
2389 : : /* Success, so accumulate support function's estimate into *cost */
2390 : 15 : cost->startup += req.startup;
2391 : 15 : cost->per_tuple += req.per_tuple;
2392 : 15 : ReleaseSysCache(proctup);
2393 : 15 : return;
2394 : : }
2395 : : }
2396 : :
2397 : : /* No support function, or it failed, so rely on procost */
2398 : 929254 : cost->per_tuple += procform->procost * cpu_operator_cost;
2399 : :
2400 : 929254 : ReleaseSysCache(proctup);
2401 : : }
2402 : :
2403 : : /*
2404 : : * get_function_rows
2405 : : *
2406 : : * Get an estimate of the number of rows returned by a set-returning function.
2407 : : *
2408 : : * The funcid must always be supplied. In current usage, the calling node
2409 : : * will always be supplied, and will be either a FuncExpr or OpExpr.
2410 : : * But it's a good idea to not fail if it's NULL.
2411 : : *
2412 : : * In some usages root might be NULL, too.
2413 : : *
2414 : : * Note: this returns the unfiltered result of the support function, if any.
2415 : : * It's usually a good idea to apply clamp_row_est() to the result, but we
2416 : : * leave it to the caller to do so.
2417 : : */
2418 : : double
2419 : 41109 : get_function_rows(PlannerInfo *root, Oid funcid, Node *node)
2420 : : {
2421 : : HeapTuple proctup;
2422 : : Form_pg_proc procform;
2423 : : double result;
2424 : :
2425 : 41109 : proctup = SearchSysCache1(PROCOID, ObjectIdGetDatum(funcid));
2426 [ - + ]: 41109 : if (!HeapTupleIsValid(proctup))
2642 tgl@sss.pgh.pa.us 2427 [ # # ]:UBC 0 : elog(ERROR, "cache lookup failed for function %u", funcid);
2642 tgl@sss.pgh.pa.us 2428 :CBC 41109 : procform = (Form_pg_proc) GETSTRUCT(proctup);
2429 : :
2430 [ - + ]: 41109 : Assert(procform->proretset); /* else caller error */
2431 : :
2432 [ + + ]: 41109 : if (OidIsValid(procform->prosupport))
2433 : : {
2434 : : SupportRequestRows req;
2435 : : SupportRequestRows *sresult;
2436 : :
2437 : 16282 : req.type = T_SupportRequestRows;
2438 : 16282 : req.root = root;
2439 : 16282 : req.funcid = funcid;
2440 : 16282 : req.node = node;
2441 : :
2442 : 16282 : req.rows = 0; /* just for sanity */
2443 : :
2444 : : sresult = (SupportRequestRows *)
2445 : 16282 : DatumGetPointer(OidFunctionCall1(procform->prosupport,
2446 : : PointerGetDatum(&req)));
2447 : :
2448 [ + + ]: 16282 : if (sresult == &req)
2449 : : {
2450 : : /* Success */
2451 : 12831 : ReleaseSysCache(proctup);
2452 : 12831 : return req.rows;
2453 : : }
2454 : : }
2455 : :
2456 : : /* No support function, or it failed, so rely on prorows */
2457 : 28278 : result = procform->prorows;
2458 : :
2459 : 28278 : ReleaseSysCache(proctup);
2460 : :
2461 : 28278 : return result;
2462 : : }
2463 : :
2464 : : /*
2465 : : * has_unique_index
2466 : : *
2467 : : * Detect whether there is a unique index on the specified attribute
2468 : : * of the specified relation, thus allowing us to conclude that all
2469 : : * the (non-null) values of the attribute are distinct.
2470 : : *
2471 : : * This function does not check the index's indimmediate property, which
2472 : : * means that uniqueness may transiently fail to hold intra-transaction.
2473 : : * That's appropriate when we are making statistical estimates, but beware
2474 : : * of using this for any correctness proofs.
2475 : : */
2476 : : bool
9116 2477 : 1827910 : has_unique_index(RelOptInfo *rel, AttrNumber attno)
2478 : : {
2479 : : ListCell *ilist;
2480 : :
2481 [ + + + + : 4532037 : foreach(ilist, rel->indexlist)
+ + ]
2482 : : {
2483 : 3249707 : IndexOptInfo *index = (IndexOptInfo *) lfirst(ilist);
2484 : :
2485 : : /*
2486 : : * Note: ignore partial indexes, since they don't allow us to conclude
2487 : : * that all attr values are distinct, *unless* they are marked predOK
2488 : : * which means we know the index's predicate is satisfied by the
2489 : : * query. We don't take any interest in expressional indexes either.
2490 : : * Also, a multicolumn unique index doesn't allow us to conclude that
2491 : : * just the specified attr is unique.
2492 : : */
2493 [ + + ]: 3249707 : if (index->unique &&
2950 teodor@sigaev.ru 2494 [ + + ]: 2270188 : index->nkeycolumns == 1 &&
9116 tgl@sss.pgh.pa.us 2495 [ + + ]: 1234322 : index->indexkeys[0] == attno &&
6288 2496 [ + + + + ]: 545641 : (index->indpred == NIL || index->predOK))
9116 2497 : 545580 : return true;
2498 : : }
2499 : 1282330 : return false;
2500 : : }
2501 : :
2502 : :
2503 : : /*
2504 : : * has_row_triggers
2505 : : *
2506 : : * Detect whether the specified relation has any row-level triggers for event.
2507 : : */
2508 : : bool
3700 rhaas@postgresql.org 2509 : 258 : has_row_triggers(PlannerInfo *root, Index rti, CmdType event)
2510 : : {
2511 [ + - ]: 258 : RangeTblEntry *rte = planner_rt_fetch(rti, root);
2512 : : Relation relation;
2513 : : TriggerDesc *trigDesc;
2514 : 258 : bool result = false;
2515 : :
2516 : : /* Assume we already have adequate lock */
2661 andres@anarazel.de 2517 : 258 : relation = table_open(rte->relid, NoLock);
2518 : :
3700 rhaas@postgresql.org 2519 : 258 : trigDesc = relation->trigdesc;
2520 [ + + + - : 258 : switch (event)
- ]
2521 : : {
2522 : 82 : case CMD_INSERT:
2523 [ + + ]: 82 : if (trigDesc &&
2524 [ + + ]: 13 : (trigDesc->trig_insert_after_row ||
2525 [ + - ]: 7 : trigDesc->trig_insert_before_row))
2526 : 13 : result = true;
2527 : 82 : break;
2528 : 95 : case CMD_UPDATE:
2529 [ + + ]: 95 : if (trigDesc &&
2530 [ + + ]: 24 : (trigDesc->trig_update_after_row ||
2531 [ + + ]: 14 : trigDesc->trig_update_before_row))
2532 : 18 : result = true;
2533 : 95 : break;
2534 : 81 : case CMD_DELETE:
2535 [ + + ]: 81 : if (trigDesc &&
2536 [ + + ]: 15 : (trigDesc->trig_delete_after_row ||
2537 [ + + ]: 9 : trigDesc->trig_delete_before_row))
2538 : 8 : result = true;
2539 : 81 : break;
2540 : : /* There is no separate event for MERGE, only INSERT/UPDATE/DELETE */
1499 alvherre@alvh.no-ip. 2541 :UBC 0 : case CMD_MERGE:
2542 : 0 : result = false;
270 efujita@postgresql.o 2543 : 0 : break;
2544 : 0 : default:
2545 [ # # ]: 0 : elog(ERROR, "unrecognized CmdType: %d", (int) event);
2546 : : break;
2547 : : }
2548 : :
270 efujita@postgresql.o 2549 :CBC 258 : table_close(relation, NoLock);
2550 : 258 : return result;
2551 : : }
2552 : :
2553 : : /*
2554 : : * has_transition_tables
2555 : : *
2556 : : * Detect whether the specified relation has any transition tables for event.
2557 : : */
2558 : : bool
2559 : 195 : has_transition_tables(PlannerInfo *root, Index rti, CmdType event)
2560 : : {
2561 [ + - ]: 195 : RangeTblEntry *rte = planner_rt_fetch(rti, root);
2562 : : Relation relation;
2563 : : TriggerDesc *trigDesc;
2564 : 195 : bool result = false;
2565 : :
2566 [ - + ]: 195 : Assert(rte->rtekind == RTE_RELATION);
2567 : :
2568 : : /* Currently foreign tables cannot have transition tables */
2569 [ + + ]: 195 : if (rte->relkind == RELKIND_FOREIGN_TABLE)
2570 : 145 : return result;
2571 : :
2572 : : /* Assume we already have adequate lock */
2573 : 50 : relation = table_open(rte->relid, NoLock);
2574 : :
2575 : 50 : trigDesc = relation->trigdesc;
2576 [ - + + - : 50 : switch (event)
- ]
2577 : : {
270 efujita@postgresql.o 2578 :UBC 0 : case CMD_INSERT:
2579 [ # # ]: 0 : if (trigDesc &&
2580 [ # # ]: 0 : trigDesc->trig_insert_new_table)
2581 : 0 : result = true;
2582 : 0 : break;
270 efujita@postgresql.o 2583 :CBC 30 : case CMD_UPDATE:
2584 [ + + ]: 30 : if (trigDesc &&
2585 [ - + ]: 4 : (trigDesc->trig_update_old_table ||
270 efujita@postgresql.o 2586 [ # # ]:UBC 0 : trigDesc->trig_update_new_table))
270 efujita@postgresql.o 2587 :CBC 4 : result = true;
2588 : 30 : break;
2589 : 20 : case CMD_DELETE:
2590 [ + + ]: 20 : if (trigDesc &&
2591 [ + - ]: 4 : trigDesc->trig_delete_old_table)
2592 : 4 : result = true;
2593 : 20 : break;
2594 : : /* There is no separate event for MERGE, only INSERT/UPDATE/DELETE */
270 efujita@postgresql.o 2595 :UBC 0 : case CMD_MERGE:
2596 : 0 : result = false;
1499 alvherre@alvh.no-ip. 2597 : 0 : break;
3700 rhaas@postgresql.org 2598 : 0 : default:
2599 [ # # ]: 0 : elog(ERROR, "unrecognized CmdType: %d", (int) event);
2600 : : break;
2601 : : }
2602 : :
2661 andres@anarazel.de 2603 :CBC 50 : table_close(relation, NoLock);
3700 rhaas@postgresql.org 2604 : 50 : return result;
2605 : : }
2606 : :
2607 : : /*
2608 : : * has_stored_generated_columns
2609 : : *
2610 : : * Does table identified by RTI have any STORED GENERATED columns?
2611 : : */
2612 : : bool
2593 peter@eisentraut.org 2613 : 219 : has_stored_generated_columns(PlannerInfo *root, Index rti)
2614 : : {
2615 [ + - ]: 219 : RangeTblEntry *rte = planner_rt_fetch(rti, root);
2616 : : Relation relation;
2617 : : TupleDesc tupdesc;
andres@anarazel.de 2618 : 219 : bool result = false;
2619 : :
2620 : : /* Assume we already have adequate lock */
2390 michael@paquier.xyz 2621 : 219 : relation = table_open(rte->relid, NoLock);
2622 : :
2593 peter@eisentraut.org 2623 : 219 : tupdesc = RelationGetDescr(relation);
2624 [ + + + + ]: 219 : result = tupdesc->constr && tupdesc->constr->has_generated_stored;
2625 : :
2390 michael@paquier.xyz 2626 : 219 : table_close(relation, NoLock);
2627 : :
2593 peter@eisentraut.org 2628 : 219 : return result;
2629 : : }
2630 : :
2631 : : /*
2632 : : * get_dependent_generated_columns
2633 : : *
2634 : : * Get the column numbers of any STORED GENERATED columns of the relation
2635 : : * that depend on any column listed in target_cols. Both the input and
2636 : : * result bitmapsets contain column numbers offset by
2637 : : * FirstLowInvalidHeapAttributeNumber.
2638 : : */
2639 : : Bitmapset *
1216 tgl@sss.pgh.pa.us 2640 : 45 : get_dependent_generated_columns(PlannerInfo *root, Index rti,
2641 : : Bitmapset *target_cols)
2642 : : {
2643 : 45 : Bitmapset *dependentCols = NULL;
2644 [ + - ]: 45 : RangeTblEntry *rte = planner_rt_fetch(rti, root);
2645 : : Relation relation;
2646 : : TupleDesc tupdesc;
2647 : : TupleConstr *constr;
2648 : :
2649 : : /* Assume we already have adequate lock */
2650 : 45 : relation = table_open(rte->relid, NoLock);
2651 : :
2652 : 45 : tupdesc = RelationGetDescr(relation);
2653 : 45 : constr = tupdesc->constr;
2654 : :
2655 [ + + + + ]: 45 : if (constr && constr->has_generated_stored)
2656 : : {
2657 [ + + ]: 6 : for (int i = 0; i < constr->num_defval; i++)
2658 : : {
2659 : 4 : AttrDefault *defval = &constr->defval[i];
2660 : : Node *expr;
2661 : 4 : Bitmapset *attrs_used = NULL;
2662 : :
2663 : : /* skip if not generated column */
195 drowley@postgresql.o 2664 [ - + ]:GNC 4 : if (!TupleDescCompactAttr(tupdesc, defval->adnum - 1)->attgenerated)
1216 tgl@sss.pgh.pa.us 2665 :UBC 0 : continue;
2666 : :
2667 : : /* identify columns this generated column depends on */
1216 tgl@sss.pgh.pa.us 2668 :CBC 4 : expr = stringToNode(defval->adbin);
2669 : 4 : pull_varattnos(expr, 1, &attrs_used);
2670 : :
2671 [ + - ]: 4 : if (bms_overlap(target_cols, attrs_used))
2672 : 4 : dependentCols = bms_add_member(dependentCols,
2673 : 4 : defval->adnum - FirstLowInvalidHeapAttributeNumber);
2674 : : }
2675 : : }
2676 : :
2677 : 45 : table_close(relation, NoLock);
2678 : :
2679 : 45 : return dependentCols;
2680 : : }
2681 : :
2682 : : /*
2683 : : * set_relation_partition_info
2684 : : *
2685 : : * Set partitioning scheme and related information for a partitioned table.
2686 : : */
2687 : : static void
3149 rhaas@postgresql.org 2688 : 14148 : set_relation_partition_info(PlannerInfo *root, RelOptInfo *rel,
2689 : : Relation relation)
2690 : : {
2691 : : PartitionDesc partdesc;
2692 : :
2693 : : /*
2694 : : * Create the PartitionDirectory infrastructure if we didn't already.
2695 : : */
2593 tgl@sss.pgh.pa.us 2696 [ + + ]: 14148 : if (root->glob->partition_directory == NULL)
2697 : : {
2698 : 9172 : root->glob->partition_directory =
1839 alvherre@alvh.no-ip. 2699 : 9172 : CreatePartitionDirectory(CurrentMemoryContext, true);
2700 : : }
2701 : :
2616 rhaas@postgresql.org 2702 : 14148 : partdesc = PartitionDirectoryLookup(root->glob->partition_directory,
2703 : : relation);
3149 2704 : 14148 : rel->part_scheme = find_partition_scheme(root, relation);
2705 [ + - - + ]: 14148 : Assert(partdesc != NULL && rel->part_scheme != NULL);
2601 tgl@sss.pgh.pa.us 2706 : 14148 : rel->boundinfo = partdesc->boundinfo;
3149 rhaas@postgresql.org 2707 : 14148 : rel->nparts = partdesc->nparts;
3133 2708 : 14148 : set_baserel_partition_key_exprs(relation, rel);
2457 alvherre@alvh.no-ip. 2709 : 14148 : set_baserel_partition_constraint(relation, rel);
3149 rhaas@postgresql.org 2710 : 14148 : }
2711 : :
2712 : : /*
2713 : : * find_partition_scheme
2714 : : *
2715 : : * Find or create a PartitionScheme for this Relation.
2716 : : */
2717 : : static PartitionScheme
2718 : 14148 : find_partition_scheme(PlannerInfo *root, Relation relation)
2719 : : {
2720 : 14148 : PartitionKey partkey = RelationGetPartitionKey(relation);
2721 : : ListCell *lc;
2722 : : int partnatts,
2723 : : i;
2724 : : PartitionScheme part_scheme;
2725 : :
2726 : : /* A partitioned table should have a partition key. */
2727 [ - + ]: 14148 : Assert(partkey != NULL);
2728 : :
2729 : 14148 : partnatts = partkey->partnatts;
2730 : :
2731 : : /* Search for a matching partition scheme and return if found one. */
2732 [ + + + + : 15736 : foreach(lc, root->part_schemes)
+ + ]
2733 : : {
2734 : 5472 : part_scheme = lfirst(lc);
2735 : :
2736 : : /* Match partitioning strategy and number of keys. */
2737 [ + + ]: 5472 : if (partkey->strategy != part_scheme->strategy ||
2738 [ + + ]: 4634 : partnatts != part_scheme->partnatts)
2739 : 1213 : continue;
2740 : :
2741 : : /* Match partition key type properties. */
2742 [ + + ]: 4259 : if (memcmp(partkey->partopfamily, part_scheme->partopfamily,
2743 : 3884 : sizeof(Oid) * partnatts) != 0 ||
2744 [ + - ]: 3884 : memcmp(partkey->partopcintype, part_scheme->partopcintype,
2745 : 3884 : sizeof(Oid) * partnatts) != 0 ||
2988 2746 [ - + ]: 3884 : memcmp(partkey->partcollation, part_scheme->partcollation,
2747 : : sizeof(Oid) * partnatts) != 0)
3149 2748 : 375 : continue;
2749 : :
2750 : : /*
2751 : : * Length and byval information should match when partopcintype
2752 : : * matches.
2753 : : */
2754 [ - + ]: 3884 : Assert(memcmp(partkey->parttyplen, part_scheme->parttyplen,
2755 : : sizeof(int16) * partnatts) == 0);
2756 [ - + ]: 3884 : Assert(memcmp(partkey->parttypbyval, part_scheme->parttypbyval,
2757 : : sizeof(bool) * partnatts) == 0);
2758 : :
2759 : : /*
2760 : : * If partopfamily and partopcintype matched, must have the same
2761 : : * partition comparison functions. Note that we cannot reliably
2762 : : * Assert the equality of function structs themselves for they might
2763 : : * be different across PartitionKey's, so just Assert for the function
2764 : : * OIDs.
2765 : : */
2766 : : #ifdef USE_ASSERT_CHECKING
2951 alvherre@alvh.no-ip. 2767 [ + + ]: 7793 : for (i = 0; i < partkey->partnatts; i++)
2768 [ - + ]: 3909 : Assert(partkey->partsupfunc[i].fn_oid ==
2769 : : part_scheme->partsupfunc[i].fn_oid);
2770 : : #endif
2771 : :
2772 : : /* Found matching partition scheme. */
3149 rhaas@postgresql.org 2773 : 3884 : return part_scheme;
2774 : : }
2775 : :
2776 : : /*
2777 : : * Did not find matching partition scheme. Create one copying relevant
2778 : : * information from the relcache. We need to copy the contents of the
2779 : : * array since the relcache entry may not survive after we have closed the
2780 : : * relation.
2781 : : */
146 michael@paquier.xyz 2782 :GNC 10264 : part_scheme = palloc0_object(PartitionSchemeData);
3149 rhaas@postgresql.org 2783 :CBC 10264 : part_scheme->strategy = partkey->strategy;
2784 : 10264 : part_scheme->partnatts = partkey->partnatts;
2785 : :
146 michael@paquier.xyz 2786 :GNC 10264 : part_scheme->partopfamily = palloc_array(Oid, partnatts);
3133 rhaas@postgresql.org 2787 :CBC 10264 : memcpy(part_scheme->partopfamily, partkey->partopfamily,
2788 : : sizeof(Oid) * partnatts);
2789 : :
146 michael@paquier.xyz 2790 :GNC 10264 : part_scheme->partopcintype = palloc_array(Oid, partnatts);
3133 rhaas@postgresql.org 2791 :CBC 10264 : memcpy(part_scheme->partopcintype, partkey->partopcintype,
2792 : : sizeof(Oid) * partnatts);
2793 : :
146 michael@paquier.xyz 2794 :GNC 10264 : part_scheme->partcollation = palloc_array(Oid, partnatts);
2988 rhaas@postgresql.org 2795 :CBC 10264 : memcpy(part_scheme->partcollation, partkey->partcollation,
2796 : : sizeof(Oid) * partnatts);
2797 : :
146 michael@paquier.xyz 2798 :GNC 10264 : part_scheme->parttyplen = palloc_array(int16, partnatts);
3133 rhaas@postgresql.org 2799 :CBC 10264 : memcpy(part_scheme->parttyplen, partkey->parttyplen,
2800 : : sizeof(int16) * partnatts);
2801 : :
146 michael@paquier.xyz 2802 :GNC 10264 : part_scheme->parttypbyval = palloc_array(bool, partnatts);
3133 rhaas@postgresql.org 2803 :CBC 10264 : memcpy(part_scheme->parttypbyval, partkey->parttypbyval,
2804 : : sizeof(bool) * partnatts);
2805 : :
146 michael@paquier.xyz 2806 :GNC 10264 : part_scheme->partsupfunc = palloc_array(FmgrInfo, partnatts);
2951 alvherre@alvh.no-ip. 2807 [ + + ]:CBC 22108 : for (i = 0; i < partnatts; i++)
2808 : 11844 : fmgr_info_copy(&part_scheme->partsupfunc[i], &partkey->partsupfunc[i],
2809 : : CurrentMemoryContext);
2810 : :
2811 : : /* Add the partitioning scheme to PlannerInfo. */
3149 rhaas@postgresql.org 2812 : 10264 : root->part_schemes = lappend(root->part_schemes, part_scheme);
2813 : :
2814 : 10264 : return part_scheme;
2815 : : }
2816 : :
2817 : : /*
2818 : : * set_baserel_partition_key_exprs
2819 : : *
2820 : : * Builds partition key expressions for the given base relation and fills
2821 : : * rel->partexprs.
2822 : : */
2823 : : static void
3133 2824 : 14148 : set_baserel_partition_key_exprs(Relation relation,
2825 : : RelOptInfo *rel)
2826 : : {
3149 2827 : 14148 : PartitionKey partkey = RelationGetPartitionKey(relation);
2828 : : int partnatts;
2829 : : int cnt;
2830 : : List **partexprs;
2831 : : ListCell *lc;
3133 2832 : 14148 : Index varno = rel->relid;
2833 : :
2834 [ + + + - : 14148 : Assert(IS_SIMPLE_REL(rel) && rel->relid > 0);
- + ]
2835 : :
2836 : : /* A partitioned table should have a partition key. */
3149 2837 [ - + ]: 14148 : Assert(partkey != NULL);
2838 : :
2839 : 14148 : partnatts = partkey->partnatts;
146 michael@paquier.xyz 2840 :GNC 14148 : partexprs = palloc_array(List *, partnatts);
3149 rhaas@postgresql.org 2841 :CBC 14148 : lc = list_head(partkey->partexprs);
2842 : :
2843 [ + + ]: 29901 : for (cnt = 0; cnt < partnatts; cnt++)
2844 : : {
2845 : : Expr *partexpr;
2846 : 15753 : AttrNumber attno = partkey->partattrs[cnt];
2847 : :
2848 [ + + ]: 15753 : if (attno != InvalidAttrNumber)
2849 : : {
2850 : : /* Single column partition key is stored as a Var node. */
2851 [ - + ]: 14968 : Assert(attno > 0);
2852 : :
2853 : 14968 : partexpr = (Expr *) makeVar(varno, attno,
2854 : 14968 : partkey->parttypid[cnt],
2855 : 14968 : partkey->parttypmod[cnt],
2856 : 14968 : partkey->parttypcoll[cnt], 0);
2857 : : }
2858 : : else
2859 : : {
2860 [ - + ]: 785 : if (lc == NULL)
3149 rhaas@postgresql.org 2861 [ # # ]:UBC 0 : elog(ERROR, "wrong number of partition key expressions");
2862 : :
2863 : : /* Re-stamp the expression with given varno. */
3149 rhaas@postgresql.org 2864 :CBC 785 : partexpr = (Expr *) copyObject(lfirst(lc));
2865 : 785 : ChangeVarNodes((Node *) partexpr, 1, varno, 0);
2486 tgl@sss.pgh.pa.us 2866 : 785 : lc = lnext(partkey->partexprs, lc);
2867 : : }
2868 : :
2869 : : /* Base relations have a single expression per key. */
3149 rhaas@postgresql.org 2870 : 15753 : partexprs[cnt] = list_make1(partexpr);
2871 : : }
2872 : :
3133 2873 : 14148 : rel->partexprs = partexprs;
2874 : :
2875 : : /*
2876 : : * A base relation does not have nullable partition key expressions, since
2877 : : * no outer join is involved. We still allocate an array of empty
2878 : : * expression lists to keep partition key expression handling code simple.
2879 : : * See build_joinrel_partition_info() and match_expr_to_partition_keys().
2880 : : */
146 michael@paquier.xyz 2881 :GNC 14148 : rel->nullable_partexprs = palloc0_array(List *, partnatts);
3149 rhaas@postgresql.org 2882 :CBC 14148 : }
2883 : :
2884 : : /*
2885 : : * set_baserel_partition_constraint
2886 : : *
2887 : : * Builds the partition constraint for the given base relation and sets it
2888 : : * in the given RelOptInfo. All Var nodes are restamped with the relid of the
2889 : : * given relation.
2890 : : */
2891 : : static void
2457 alvherre@alvh.no-ip. 2892 : 14158 : set_baserel_partition_constraint(Relation relation, RelOptInfo *rel)
2893 : : {
2894 : : List *partconstr;
2895 : :
2896 [ - + ]: 14158 : if (rel->partition_qual) /* already done */
2457 alvherre@alvh.no-ip. 2897 :UBC 0 : return;
2898 : :
2899 : : /*
2900 : : * Run the partition quals through const-simplification similar to check
2901 : : * constraints. We skip canonicalize_qual, though, because partition
2902 : : * quals should be in canonical form already; also, since the qual is in
2903 : : * implicit-AND format, we'd have to explicitly convert it to explicit-AND
2904 : : * format and back again.
2905 : : */
2457 alvherre@alvh.no-ip. 2906 :CBC 14158 : partconstr = RelationGetPartitionQual(relation);
2907 [ + + ]: 14158 : if (partconstr)
2908 : : {
2909 : 3150 : partconstr = (List *) expression_planner((Expr *) partconstr);
2910 [ + + ]: 3150 : if (rel->relid != 1)
2911 : 3075 : ChangeVarNodes((Node *) partconstr, 1, rel->relid, 0);
2912 : 3150 : rel->partition_qual = partconstr;
2913 : : }
2914 : : }
|
