1996-08-28 03:59:28 +02:00
|
|
|
/*-------------------------------------------------------------------------
|
|
|
|
*
|
1999-02-14 00:22:53 +01:00
|
|
|
* relation.h
|
1997-09-07 07:04:48 +02:00
|
|
|
* Definitions for internal planner nodes.
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
|
|
|
*
|
|
|
|
* Copyright (c) 1994, Regents of the University of California
|
|
|
|
*
|
1999-07-25 01:21:14 +02:00
|
|
|
* $Id: relation.h,v 1.35 1999/07/24 23:21:04 tgl Exp $
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
|
|
|
*-------------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
#ifndef RELATION_H
|
|
|
|
#define RELATION_H
|
|
|
|
|
1999-07-16 01:04:24 +02:00
|
|
|
#include "nodes/parsenodes.h"
|
1996-08-28 03:59:28 +02:00
|
|
|
|
|
|
|
/*
|
1999-02-18 01:49:48 +01:00
|
|
|
* Relids
|
1997-09-07 07:04:48 +02:00
|
|
|
* List of relation identifiers (indexes into the rangetable).
|
1996-08-28 03:59:28 +02:00
|
|
|
*/
|
|
|
|
|
1999-02-18 01:49:48 +01:00
|
|
|
typedef List *Relids;
|
1996-08-28 03:59:28 +02:00
|
|
|
|
|
|
|
/*
|
1998-07-18 06:22:52 +02:00
|
|
|
* RelOptInfo
|
1997-09-07 07:04:48 +02:00
|
|
|
* Per-base-relation information
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
1997-09-07 07:04:48 +02:00
|
|
|
* Parts of this data structure are specific to various scan and join
|
|
|
|
* mechanisms. It didn't seem worth creating new node types for them.
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
1997-09-07 07:04:48 +02:00
|
|
|
* relids - List of relation indentifiers
|
|
|
|
* indexed - true if the relation has secondary indices
|
|
|
|
* pages - number of pages in the relation
|
|
|
|
* tuples - number of tuples in the relation
|
|
|
|
* size - number of tuples in the relation after restrictions clauses
|
|
|
|
* have been applied
|
|
|
|
* width - number of bytes per tuple in the relation after the
|
|
|
|
* appropriate projections have been done
|
|
|
|
* targetlist - List of TargetList nodes
|
|
|
|
* pathlist - List of Path nodes, one for each possible method of
|
|
|
|
* generating the relation
|
|
|
|
* cheapestpath - least expensive Path (regardless of final order)
|
|
|
|
* pruneable - flag to let the planner know whether it can prune the plan
|
1999-02-04 04:19:11 +01:00
|
|
|
* space of this RelOptInfo or not.
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
1997-09-07 07:04:48 +02:00
|
|
|
* * If the relation is a (secondary) index it will have the following
|
|
|
|
* three fields:
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
1997-09-07 07:04:48 +02:00
|
|
|
* classlist - List of PG_AMOPCLASS OIDs for the index
|
|
|
|
* indexkeys - List of base-relation attribute numbers that are index keys
|
|
|
|
* ordering - List of PG_OPERATOR OIDs which order the indexscan result
|
|
|
|
* relam - the OID of the pg_am of the index
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
1997-09-07 07:04:48 +02:00
|
|
|
* * The presence of the remaining fields depends on the restrictions
|
|
|
|
* and joins which the relation participates in:
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
1999-02-03 21:15:53 +01:00
|
|
|
* restrictinfo - List of RestrictInfo nodes, containing info about each
|
1997-09-07 07:04:48 +02:00
|
|
|
* qualification clause in which this relation participates
|
|
|
|
* joininfo - List of JoinInfo nodes, containing info about each join
|
|
|
|
* clause in which this relation participates
|
|
|
|
* innerjoin - List of Path nodes that represent indices that may be used
|
|
|
|
* as inner paths of nestloop joins
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
|
|
|
* NB. the last element of the arrays classlist, indexkeys and ordering
|
1997-09-07 07:04:48 +02:00
|
|
|
* is always 0. 2/95 - ay
|
1996-08-28 03:59:28 +02:00
|
|
|
*/
|
|
|
|
|
1998-07-18 06:22:52 +02:00
|
|
|
typedef struct RelOptInfo
|
1997-09-07 07:04:48 +02:00
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
NodeTag type;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
/* all relations: */
|
1999-02-18 01:49:48 +01:00
|
|
|
Relids relids; /* integer list of base relids involved */
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
/* catalog statistics information */
|
1997-09-08 04:41:22 +02:00
|
|
|
bool indexed;
|
|
|
|
int pages;
|
|
|
|
int tuples;
|
|
|
|
int size;
|
|
|
|
int width;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
/* materialization information */
|
1997-09-08 04:41:22 +02:00
|
|
|
List *targetlist;
|
1999-02-04 02:47:02 +01:00
|
|
|
List *pathlist; /* Path structures */
|
1999-05-25 18:15:34 +02:00
|
|
|
struct Path *cheapestpath;
|
1997-09-08 04:41:22 +02:00
|
|
|
bool pruneable;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
/* used solely by indices: */
|
1997-09-08 04:41:22 +02:00
|
|
|
Oid *classlist; /* classes of AM operators */
|
|
|
|
int *indexkeys; /* keys over which we're indexing */
|
|
|
|
Oid relam; /* OID of the access method (in pg_am) */
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1997-09-08 04:41:22 +02:00
|
|
|
Oid indproc;
|
|
|
|
List *indpred;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
/* used by various scans and joins: */
|
1997-09-08 04:41:22 +02:00
|
|
|
Oid *ordering; /* OID of operators in sort order */
|
1999-02-04 02:47:02 +01:00
|
|
|
List *restrictinfo; /* RestrictInfo structures */
|
|
|
|
List *joininfo; /* JoinInfo structures */
|
1997-09-08 04:41:22 +02:00
|
|
|
List *innerjoin;
|
1999-05-26 00:43:53 +02:00
|
|
|
} RelOptInfo;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1997-09-08 23:56:23 +02:00
|
|
|
extern Var *get_expr(TargetEntry *foo);
|
1999-05-12 17:02:39 +02:00
|
|
|
extern Var *get_groupclause_expr(GroupClause *groupClause, List *targetList);
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
typedef struct MergeOrder
|
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
NodeTag type;
|
|
|
|
Oid join_operator;
|
|
|
|
Oid left_operator;
|
|
|
|
Oid right_operator;
|
|
|
|
Oid left_type;
|
|
|
|
Oid right_type;
|
1997-09-08 23:56:23 +02:00
|
|
|
} MergeOrder;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
typedef enum OrderType
|
|
|
|
{
|
|
|
|
MERGE_ORDER, SORTOP_ORDER
|
1997-09-08 23:56:23 +02:00
|
|
|
} OrderType;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
typedef struct PathOrder
|
|
|
|
{
|
1999-02-09 04:51:42 +01:00
|
|
|
NodeTag type;
|
|
|
|
|
1997-09-08 04:41:22 +02:00
|
|
|
OrderType ordtype;
|
1997-09-07 07:04:48 +02:00
|
|
|
union
|
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
Oid *sortop;
|
|
|
|
MergeOrder *merge;
|
1999-05-25 18:15:34 +02:00
|
|
|
} ord;
|
1997-09-08 23:56:23 +02:00
|
|
|
} PathOrder;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
typedef struct Path
|
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
NodeTag type;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1998-09-01 06:40:42 +02:00
|
|
|
RelOptInfo *parent;
|
1997-09-08 04:41:22 +02:00
|
|
|
Cost path_cost;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1997-09-08 04:41:22 +02:00
|
|
|
NodeTag pathtype;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1999-05-25 18:15:34 +02:00
|
|
|
PathOrder *pathorder;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1999-05-25 18:15:34 +02:00
|
|
|
List *pathkeys; /* This is a List of List of Var nodes.
|
|
|
|
* See the top of
|
|
|
|
* optimizer/path/pathkeys.c for more
|
|
|
|
* information. */
|
1997-09-08 04:41:22 +02:00
|
|
|
Cost outerjoincost;
|
1999-02-18 01:49:48 +01:00
|
|
|
Relids joinid;
|
1999-02-03 21:15:53 +01:00
|
|
|
List *loc_restrictinfo;
|
1997-09-08 23:56:23 +02:00
|
|
|
} Path;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1999-07-25 01:21:14 +02:00
|
|
|
/*----------
|
|
|
|
* IndexPath represents an index scan. Although an indexscan can only read
|
|
|
|
* a single relation, it can scan it more than once, potentially using a
|
|
|
|
* different index during each scan. The result is the union (OR) of all the
|
|
|
|
* tuples matched during any scan. (The executor is smart enough not to return
|
|
|
|
* the same tuple more than once, even if it is matched in multiple scans.)
|
|
|
|
* 'indexid' is a list of index relation OIDs, one per scan to be performed.
|
|
|
|
* 'indexqual' is a list of index qualifications, also one per scan.
|
|
|
|
* Each entry in 'indexqual' is a sublist of qualification expressions with
|
|
|
|
* implicit AND semantics across the sublist items. Each one of the sublist
|
|
|
|
* items must be an operator expression of the form (var op something) or
|
|
|
|
* (something op var), where the var is a field the associated index keys on
|
|
|
|
* and the op is a member of the operator class of the index.
|
|
|
|
* NOTE that the semantics of the top-level list in 'indexqual' is OR
|
|
|
|
* combination, while the sublists are implicitly AND combinations!
|
|
|
|
*----------
|
|
|
|
*/
|
1997-09-07 07:04:48 +02:00
|
|
|
typedef struct IndexPath
|
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
Path path;
|
|
|
|
List *indexid;
|
|
|
|
List *indexqual;
|
1999-05-25 18:15:34 +02:00
|
|
|
int *indexkeys; /* to transform heap attnos into index
|
|
|
|
* ones */
|
1997-09-08 23:56:23 +02:00
|
|
|
} IndexPath;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1999-02-12 07:43:53 +01:00
|
|
|
typedef struct NestPath
|
1997-09-07 07:04:48 +02:00
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
Path path;
|
1999-02-03 21:15:53 +01:00
|
|
|
List *pathinfo;
|
1997-09-08 04:41:22 +02:00
|
|
|
Path *outerjoinpath;
|
|
|
|
Path *innerjoinpath;
|
1999-05-26 00:43:53 +02:00
|
|
|
} NestPath;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1999-02-12 18:25:05 +01:00
|
|
|
typedef NestPath JoinPath;
|
|
|
|
|
1997-09-07 07:04:48 +02:00
|
|
|
typedef struct MergePath
|
|
|
|
{
|
1999-02-12 18:25:05 +01:00
|
|
|
JoinPath jpath;
|
1997-09-08 04:41:22 +02:00
|
|
|
List *path_mergeclauses;
|
|
|
|
List *outersortkeys;
|
|
|
|
List *innersortkeys;
|
1997-09-08 23:56:23 +02:00
|
|
|
} MergePath;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
typedef struct HashPath
|
|
|
|
{
|
1999-02-12 18:25:05 +01:00
|
|
|
JoinPath jpath;
|
1997-09-08 04:41:22 +02:00
|
|
|
List *path_hashclauses;
|
|
|
|
List *outerhashkeys;
|
|
|
|
List *innerhashkeys;
|
1997-09-08 23:56:23 +02:00
|
|
|
} HashPath;
|
1996-08-28 03:59:28 +02:00
|
|
|
|
1999-02-22 20:55:44 +01:00
|
|
|
/*
|
1996-08-28 03:59:28 +02:00
|
|
|
* Keys
|
1999-02-22 20:55:44 +01:00
|
|
|
*/
|
1996-08-28 03:59:28 +02:00
|
|
|
|
1997-09-07 07:04:48 +02:00
|
|
|
typedef struct OrderKey
|
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
NodeTag type;
|
|
|
|
int attribute_number;
|
|
|
|
Index array_index;
|
1997-09-08 23:56:23 +02:00
|
|
|
} OrderKey;
|
1996-08-28 03:59:28 +02:00
|
|
|
|
1997-09-07 07:04:48 +02:00
|
|
|
typedef struct JoinKey
|
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
NodeTag type;
|
|
|
|
Var *outer;
|
|
|
|
Var *inner;
|
1997-09-08 23:56:23 +02:00
|
|
|
} JoinKey;
|
1996-08-28 03:59:28 +02:00
|
|
|
|
1999-02-22 20:55:44 +01:00
|
|
|
/*
|
1999-07-25 01:21:14 +02:00
|
|
|
* Restriction clause info.
|
|
|
|
* We create one of these for each AND sub-clause of a restriction condition
|
|
|
|
* (WHERE clause). Since the restriction clauses are logically ANDed, we
|
|
|
|
* can use any one of them or any subset of them to filter out tuples,
|
|
|
|
* without having to evaluate the rest. The RestrictInfo node itself stores
|
|
|
|
* data used by the optimizer while choosing the best query plan.
|
1999-02-22 20:55:44 +01:00
|
|
|
*/
|
1996-08-28 03:59:28 +02:00
|
|
|
|
1999-02-03 21:15:53 +01:00
|
|
|
typedef struct RestrictInfo
|
1997-09-07 07:04:48 +02:00
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
NodeTag type;
|
1999-07-25 01:21:14 +02:00
|
|
|
Expr *clause; /* the represented subclause of WHERE cond */
|
|
|
|
Cost selectivity; /* estimated selectivity */
|
|
|
|
List *indexids; /* subclause index IDs if clause is an OR */
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1998-08-04 18:44:31 +02:00
|
|
|
/* mergejoin only */
|
|
|
|
MergeOrder *mergejoinorder;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
/* hashjoin only */
|
1997-09-08 04:41:22 +02:00
|
|
|
Oid hashjoinoperator;
|
1999-02-18 01:49:48 +01:00
|
|
|
Relids restrictinfojoinid;
|
1999-05-26 00:43:53 +02:00
|
|
|
} RestrictInfo;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
typedef struct JoinMethod
|
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
NodeTag type;
|
|
|
|
List *jmkeys;
|
|
|
|
List *clauses;
|
1997-09-08 23:56:23 +02:00
|
|
|
} JoinMethod;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1999-02-04 02:47:02 +01:00
|
|
|
typedef struct HashInfo
|
1997-09-07 07:04:48 +02:00
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
JoinMethod jmethod;
|
|
|
|
Oid hashop;
|
1999-05-26 00:43:53 +02:00
|
|
|
} HashInfo;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1999-02-04 04:19:11 +01:00
|
|
|
typedef struct MergeInfo
|
1997-09-07 07:04:48 +02:00
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
JoinMethod jmethod;
|
|
|
|
MergeOrder *m_ordering;
|
1999-05-26 00:43:53 +02:00
|
|
|
} MergeInfo;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1998-09-01 05:29:17 +02:00
|
|
|
typedef struct JoinInfo
|
1997-09-07 07:04:48 +02:00
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
NodeTag type;
|
1999-02-18 01:49:48 +01:00
|
|
|
Relids unjoined_relids;
|
1999-02-03 21:15:53 +01:00
|
|
|
List *jinfo_restrictinfo;
|
1998-08-04 18:44:31 +02:00
|
|
|
bool mergejoinable;
|
1997-09-08 04:41:22 +02:00
|
|
|
bool hashjoinable;
|
1999-05-26 00:43:53 +02:00
|
|
|
} JoinInfo;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
typedef struct Iter
|
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
NodeTag type;
|
|
|
|
Node *iterexpr;
|
|
|
|
Oid itertype; /* type of the iter expr (use for type
|
1997-09-07 07:04:48 +02:00
|
|
|
* checking) */
|
1997-09-08 23:56:23 +02:00
|
|
|
} Iter;
|
1996-08-28 03:59:28 +02:00
|
|
|
|
|
|
|
/*
|
1999-05-25 18:15:34 +02:00
|
|
|
* Stream:
|
1999-02-22 20:55:44 +01:00
|
|
|
* A stream represents a root-to-leaf path in a plan tree (i.e. a tree of
|
|
|
|
* JoinPaths and Paths). The stream includes pointers to all Path nodes,
|
1999-05-25 18:15:34 +02:00
|
|
|
* as well as to any clauses that reside above Path nodes. This structure
|
1999-02-22 20:55:44 +01:00
|
|
|
* is used to make Path nodes and clauses look similar, so that Predicate
|
|
|
|
* Migration can run.
|
|
|
|
*
|
|
|
|
* pathptr -- pointer to the current path node
|
|
|
|
* cinfo -- if NULL, this stream node referes to the path node.
|
|
|
|
* Otherwise this is a pointer to the current clause.
|
|
|
|
* clausetype -- whether cinfo is in loc_restrictinfo or pathinfo in the
|
|
|
|
* path node
|
|
|
|
* upstream -- linked list pointer upwards
|
|
|
|
* downstream -- ditto, downwards
|
|
|
|
* groupup -- whether or not this node is in a group with the node upstream
|
|
|
|
* groupcost -- total cost of the group that node is in
|
|
|
|
* groupsel -- total selectivity of the group that node is in
|
|
|
|
*/
|
1996-08-28 03:59:28 +02:00
|
|
|
typedef struct Stream *StreamPtr;
|
|
|
|
|
1997-09-07 07:04:48 +02:00
|
|
|
typedef struct Stream
|
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
NodeTag type;
|
|
|
|
Path *pathptr;
|
1999-02-03 21:15:53 +01:00
|
|
|
RestrictInfo *cinfo;
|
1997-09-08 04:41:22 +02:00
|
|
|
int *clausetype;
|
|
|
|
struct Stream *upstream;
|
|
|
|
struct Stream *downstream;
|
|
|
|
bool groupup;
|
|
|
|
Cost groupcost;
|
|
|
|
Cost groupsel;
|
1997-09-08 23:56:23 +02:00
|
|
|
} Stream;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1998-09-01 06:40:42 +02:00
|
|
|
#endif /* RELATION_H */
|