一、背景

 Postmaster会有各种参数，通过GUC(Grand unified configuration)模块来配置。

二、关键数据结构

1.变量数据类型

boolean、int、real、string、enum。

enum config_type

{

PGC_BOOL,

 PGC_INT,

PGC_REAL,

PGC_STRING,

PGC_ENUM

 };

源码位置：src/include/utils/guc_tables.h

2.GUC参数类型

typedef enum

{ PGC_INTERNAL, //内部进程设置，如版本号（server_version）

PGC_POSTMASTER, //postmaster启动时设置，来源配置文件或命令行参数

PGC_SIGHUP, //通过信号设置

PGC_SU_BACKEND, //postmaster启动时或发送 SIGHUP通知，异步方式。超级用户相关。

PGC_BACKEND, //postmaster启动时或发送 SIGHUP通知，异步方式。

PGC_SUSET, //postmaster启动时设置或超级用户通过SQL设置

PGC_USERSET //可以任意时候设置

}

GucContext;

源码位置：src/include/utils/guc.h

3.参数来源

typedef enum {

 PGC_S_DEFAULT, //缺省配置

 PGC_S_DYNAMIC_DEFAULT, //初始化时动态计算

PGC_S_ENV_VAR, //环境变量

 PGC_S_FILE, // postgresql.conf

PGC_S_ARGV, //命令行参数

PGC_S_GLOBAL, //数据库全局设置

PGC_S_DATABASE, //数据库安装时指定

 PGC_S_USER, //用户指定

PGC_S_DATABASE_USER, //数据库安装时用户指定

PGC_S_CLIENT,//客户端连接请求

PGC_S_OVERRIDE, //特殊情况强制设置为默认值

PGC_S_INTERACTIVE, //错误报告的分割符

PGC_S_TEST, //仅用于测试

PGC_S_SESSION //set命令

} GucSource;

源码位置：src/include/utils/guc.h

4.GUC共性部分

struct config_generic

{ /* constant字段,初始化时候必须设置正确 */

const char *name;//参数名

GucContext context; 参数操作类型源

 enum config_group group; //根据功能对参数分组

 const char *short_desc; //参数简要描述

const char *long_desc; //参数详细描述

int flags; //参数标志

enum config_type vartype; //参数值的数据类型

 int status; //参数状态

GucSource source;//当前参数来源

GucSource reset_source; //参数值为reset_value时的来源

GucContext scontext; //当前参数操作源

GucContext reset_scontext; //重置参数操作源

GucStack *stack; //保存旧值以支持回滚

void *extra; //当前值的 "extra" 指针

char *sourcefile; //配置所在的源文件

 int sourceline; //源文件中的行号

};

5.GUC特性部分

struct config_int

{

struct config_generic gen; //共性通用部分

int *variable;//参数当前被设置的值

 int boot_val; //参数初始值

int min; //参数最小值

int max; //参数最大值

GucIntCheckHook check_hook;

GucIntAssignHook assign_hook; //函数指针，用来设置reset_val

GucShowHook show_hook; //目前没有用到

int reset_val; //重置值

void *reset_extra;

};

三.初始化流程

InitializeGUCOptions函数，代码位置src/backend/utils/misc/guc.c

1.build_guc_varibles()

i)初始化变量数据类型

ii)参数共性数据config_generic **guc_vars

iii)全局config_generic **guc_variables

iv)根据名称排序全局变量

2.初始化GUCOption

 InitializeOneGUCOption(guc_variables[i]);

3.设置"transaction_isolation"."transaction_read_only"为指定缺省值

4.从环境变量中获取信息并设置

  PGPORT、PGDATESTYLE、PGCLIENTENCODING

5.设置stack深度

   max_stack_depth最多2MB

四.命令行参数设置GUC参数

1.getopt和setconfigoption两个函数实现

A:debug_assertions

B:shared_buffers

D:userDoption

d:set_debug_options

E:log_statement

e:datestyle

F:fsync

f:set_plan_disabling_options

h:listen_address

i:listen_address为"*"

k:unix_socket_direct

l:ssl

N:max_connections

n:Reinit=false

O:allow_system_table_mods

o:other其他参数项

P:ignore_system_indexes

p:port

S:work_mem

s:log_statement_stats

T:SendStop=true

t:统计信息设置

W:post_auth_delay

c/-:参数名标识

五.读配置文件

SelectConfigFiles ,代码位置:src/backend?utils/misc/guc.c

1.配置文件的绝对路径(make_absolute_path)

   PGDATA或userDoption -D指定目录

2.设置configfile名称

3.ProcessConfigFile(PGC_POSTMASTER)

i)解析到name_value_pair *item

ii)循环item,设置参数变量

iii)yacc实现解析配置文件,涉及文件:gucfile.l/guc_file.c

4.设置hba_file

5.设置ident_file

六.总结

  GUC参数过程比较简单，但在使用过程中要，注意不同的变量如果有多个源，会根据优先级进行覆盖。