granicus.if.org Git - postgresql/blob - src/include/executor/execdesc.h

   1 /*-------------------------------------------------------------------------
   2  *
   3  * execdesc.h
   4  *        plan and query descriptor accessor macros used by the executor
   5  *        and related modules.
   6  *
   7  *
   8  * Portions Copyright (c) 1996-2009, PostgreSQL Global Development Group
   9  * Portions Copyright (c) 1994, Regents of the University of California
  10  *
  11  * $PostgreSQL: pgsql/src/include/executor/execdesc.h,v 1.39 2009/01/01 17:23:59 momjian Exp $
  12  *
  13  *-------------------------------------------------------------------------
  14  */
  15 #ifndef EXECDESC_H
  16 #define EXECDESC_H
  17
  18 #include "nodes/execnodes.h"
  19 #include "nodes/plannodes.h"
  20 #include "tcop/dest.h"
  21
  22
  23 /* ----------------
  24  *              query descriptor:
  25  *
  26  *      a QueryDesc encapsulates everything that the executor
  27  *      needs to execute the query.
  28  *
  29  *      For the convenience of SQL-language functions, we also support QueryDescs
  30  *      containing utility statements; these must not be passed to the executor
  31  *      however.
  32  * ---------------------
  33  */
  34 typedef struct QueryDesc
  35 {
  36         /* These fields are provided by CreateQueryDesc */
  37         CmdType         operation;              /* CMD_SELECT, CMD_UPDATE, etc. */
  38         PlannedStmt *plannedstmt;       /* planner's output, or null if utility */
  39         Node       *utilitystmt;        /* utility statement, or null */
  40         Snapshot        snapshot;               /* snapshot to use for query */
  41         Snapshot        crosscheck_snapshot;    /* crosscheck for RI update/delete */
  42         DestReceiver *dest;                     /* the destination for tuple output */
  43         ParamListInfo params;           /* param values being passed in */
  44         bool            doInstrument;   /* TRUE requests runtime instrumentation */
  45
  46         /* These fields are set by ExecutorStart */
  47         TupleDesc       tupDesc;                /* descriptor for result tuples */
  48         EState     *estate;                     /* executor's query-wide state */
  49         PlanState  *planstate;          /* tree of per-plan-node state */
  50
  51         /* This is always set NULL by the core system, but plugins can change it */
  52         struct Instrumentation *totaltime;      /* total time spent in ExecutorRun */
  53 } QueryDesc;
  54
  55 /* in pquery.c */
  56 extern QueryDesc *CreateQueryDesc(PlannedStmt *plannedstmt,
  57                                 Snapshot snapshot,
  58                                 Snapshot crosscheck_snapshot,
  59                                 DestReceiver *dest,
  60                                 ParamListInfo params,
  61                                 bool doInstrument);
  62
  63 extern QueryDesc *CreateUtilityQueryDesc(Node *utilitystmt,
  64                                            Snapshot snapshot,
  65                                            DestReceiver *dest,
  66                                            ParamListInfo params);
  67
  68 extern void FreeQueryDesc(QueryDesc *qdesc);
  69
  70 #endif   /* EXECDESC_H  */