PostgreSQL服务过程中的那些事一：启动postgres服务进程一.七：初始化portal管理环境

      话说调用InitPostgres方法给portgres服务进程做相关初始化，这个方法里初始化了relcache和catcache，初始化了执行查询计划的portal的管理器，填充本进程PGPROC结构相关部分成员等，上一节讨论了relcache管理环境的初始化，这一节继续讨论执行sql的portal管理器的初始化。

 

1

先看InitPostgres方法的调用序列梗概图

 

InitPostgres方法的调用序列梗概图

         InitPostgres方法为初始化这个postgres服务进程做了一系列的工作，具体如下：

（1）调用InitProcessPhase2方法，把本进程的PGPROC结构注册到PGPROC数组，就是让共享内存里的PGPROC数组（初始化PGPROC数组的文章见《PostgreSQL启动过程中的那些事七：初始化共享内存和信号十一：shmem中初始化SharedProcArray》）的第一个空元素指向这个PGPROC结构，并注册退出时做内存清理的函数。

（2）调用SharedInvalBackendInit方法，在该后台进程数据的共享失效管理器数组获取一个ProcState结构（相关数据结果见《PostgreSQL启动过程中的那些事七：初始化共享内存和信号十三：shmem中初始化SharedInvalidationState》）给该进程并初始化相关项，并注册退出方法以在退出时标记本进程的项非活跃。

（3）调用ProcSignalInit方法，在ProcSignalSlot结构数组（关于ProcSignalSlot结构数组参见《PostgreSQL启动过程中的那些事七：初始化共享内存和信号十四：shmem中初始化PMSignal》）ProcSignalSlots里给当前进程获取一个元素，元素下标是MyBackendId-1，并注册以在进程退出时释放这个槽。

（4）为访问XLOG，调用RecoveryInProgress方法做共享内存相关初始化。

（5）调用RelationCacheInitlisze方法做管理relcache的环境的初始化。

（6）调用InitCatalogCache方法做管理catcache的环境的初始化。

（7）调用EnablePortalManager方法初始化portal管理器。

（8）调用RelationCacheInitializePhase2方法初始化共享系统表。

（9）调用GetTransactionSnapshot方法获取一个事务快照。这个方法在后面讨论简单查询时再讨论。

（10）调用PerformAuthentication方法根据hba文件设置进行客户端认证。

（11）调用GetDatabaseTuple方法根据数据库名字从pg_database系统表获取要访问的数据库对应的元组。

（12）调用RelationCacheInitializePhase3方法完成relcache初始化。

（13）调用CheckMyDatabase方法检查当前用户的数据库访问权限，从cache里的pg_database取当前数据库的相关属性字段。

（14）调用InitializeClientEncoding方法初始化客户端字符编码。

（15）调用pgstat_bestart方法在PgBackendStatus设置本进程状态。

2

    下面讨论第（7）步，EnablePortalManager方法初始化portal的管理环境。portal表示一个正在运行或可运行query的执行状态的抽象，具体情况到后续《pg服务过程中的那些事二》讨论pg处理简单查询时再具体讨论。EnablePortalManager方法先调用AllocSetContextCreate方法创建内存上下文"PortalMemory"，然后调用hash_create在这个内存上下文里创建哈西表"Portalhash"。“EnablePortalManager调用序列图”见下面，为了图能大一点，PostgresMain以前的调用流程序列就从下面的图中省略了，要回顾可以参考上面的“InitPostgres方法的调用序列梗概图”。

 

 

EnablePortalManager调用序列图

 

Portal是指向PortalData结构的指针类型。相关定义和结构图见下面。

typedefstruct PortalData *Portal;

 

typedefstruct PortalData

{

    /* Bookkeeping data */

    constchar *name;        /* portal's name */

    constchar *prepStmtName;   /* source prepared statement (NULL if none) */

    MemoryContextheap;         /* subsidiary memory for portal */

    ResourceOwnerresowner;     /* resources owned by portal */

    void       (*cleanup) (Portal portal);     /* cleanuphook */

    SubTransactionIdcreateSubid;      /* the ID of the creating subxact */

 

    /*

     * if createSubid isInvalidSubTransactionId, the portal is held over from

     * a previous transaction

     */

 

    /* The query or queries the portal willexecute */

    constchar *sourceText;     /* text of query (as of 8.4, never NULL) */

    constchar *commandTag;     /* command tag for original query */

    List     *stmts;        /* PlannedStmts and/or utility statements */

    CachedPlan *cplan;          /* CachedPlan, if stmts are from one */

 

    ParamListInfoportalParams; /* params to pass to query */

 

    /* Features/options */

    PortalStrategystrategy; /* see above */

    int        cursorOptions;    /* DECLARECURSOR option bits */

 

    /* Status data */

    PortalStatusstatus;     /* see above */

    bool       portalPinned; /* a pinned portal can't be dropped */

 

    /* If not NULL, Executor is active; callExecutorEnd eventually: */

    QueryDesc  *queryDesc;       /* info needed for executor invocation */

 

    /* If portal returns tuples, this is their tupdesc:*/

    TupleDesc  tupDesc;      /* descriptor for result tuples */

    /* and these are the format codes to use forthe columns: */

    int16    *formats;      /* a format code for each column */

 

    /*

     * Where we store tuplesfor a held cursor or a PORTAL_ONE_RETURNING or

     * PORTAL_UTIL_SELECTquery.  (A cursor held past the end ofits

     * transaction no longerhas any active executor state.)

     */

    Tuplestorestate *holdStore; /* store for holdable cursors */

    MemoryContextholdContext;  /* memory containing holdStore */

 

    /*

     * atStart, atEnd andportalPos indicate the current cursor position.

     * portalPos is zero beforethe first row, N after fetching N'th row of

     * query.  After we run off the end, portalPos = # ofrows in query, and

     * atEnd is true.  If portalPos overflows, set posOverflow (thiscauses us

     * to stop relying on itsvalue for navigation).  Note that atStart

     * implies portalPos == 0,but not the reverse (portalPos could have

     * overflowed).

     */

    bool       atStart;

    bool       atEnd;

    bool       posOverflow;

    long       portalPos;

 

    /* Presentation data, primarily used by thepg_cursors system view */

    TimestampTzcreation_time;  /* time at which this portal was defined */

    bool       visible;      /* include this portal in pg_cursors? */

}   PortalData;

 

#define NAMEDATALEN64

 

#define MAX_PORTALNAME_LEN      NAMEDATALEN

 

typedefstruct portalhashent

{

    char       portalname[MAX_PORTALNAME_LEN];

    Portal     portal;

} PortalHashEnt;

 

staticHTAB *PortalHashTable = NULL;

 

管理portal的PostalHashTable

------------
转载请著明出处，来自博客：
blog.csdn.net/beiigang
beigang.iteye.com