华为云用户手册

  • PGXC_WLM_REBUILD_USER_RESPOOL 该视图用于在所有的节点上重建内存中用户的资源池信息。只在资源池信息缺失或错乱时作为补救措施。查询该视图需要sysadmin权限。 当查询视图无数据显示时,请联系华为工程师提供技术支撑。 表1 PGXC_WLM_REBUILD_USER_RESPOOL字段 名称 类型 描述 gs_wlm_rebuild_user_resource_pool boolean 重建内存中用户资源池信息结果。t为成功,f为失败。 父主题: 负载管理
  • 处理结果集 ODBC处理结果集是从数据库中获取数据并将其提供给应用程序进行处理,作用包括但不限于:检索数据、数据展示、数据处理、数据传输和业务逻辑实现等。 ODBC提供处理结果集的相关API如表1所示。 表1 相关API说明 功能 API 绑定缓冲区到结果集的列中 SQLBindCol 结果集中取行集 SQLFetch 返回结果集中某一列的数据 SQLGetData 获取结果集中列的描述信息 SQLColAttribute 查看最近一次操作错误信息 SQLGetDiagRec 示例如下(完整示例请参考获取和处理数据库中的数据): // 在执行完成SQL语句后,获取结果集某一列的属性。 SQLColAttribute(V_OD_hstmt,1,SQL_DESC_TYPE,typename,100,NULL,NULL); printf("SQLColAtrribute %s\n",typename); // 绑定结果集。 SQLBindCol(V_OD_hstmt,1,SQL_C_SLONG, (SQLPOINTER)&V_OD_buffer,150, (SQLLEN *)&V_OD_err); // 通过SQLFetch取结果集中数据。 V_OD_erg=SQLFetch(V_OD_hstmt); // 通过SQLGetData获取并返回数据。 while(V_OD_erg != SQL_NO_DATA) { SQLGetData(V_OD_hstmt,1,SQL_C_SLONG,(SQLPOINTER)&V_OD_id,0,NULL); printf("SQLGetData ----ID = %d\n",V_OD_id); V_OD_erg=SQLFetch(V_OD_hstmt); }; printf("Done !\n"); 父主题: 开发步骤
  • event_source 参数说明:该参数仅在windows环境下生效。log_destination设置为eventlog时,event_source设置在日志中 GaussDB 日志消息的标识。 参数类型:字符串 参数单位:无 取值范围:字符串 默认值:"PostgreSQL" 设置方式:该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • syslog_facility 参数说明:log_destination设置为syslog时,syslog_facility配置使用syslog记录日志的“设备”。 参数类型:枚举类型 参数单位:无 取值范围:local0、local1、local2、local3、local4、local5、local6、local7。 默认值:local0 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • syslog_ident 参数说明:log_destination设置为syslog时,syslog_ident表示在syslog日志中GaussDB日志消息的标识。 参数类型:字符串 参数单位:无 取值范围:字符串 默认值:"postgres" 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • log_directory 参数说明:logging_collector设置为on时,log_directory决定存放服务器日志文件的目录。它可以是绝对路径,或者是相对路径(相对于数据目录的路径)。log_directory支持动态修改,可以通过gs_guc reload实现,仅sysadmin用户可以访问。 当配置文件中log_directory的值为非法路径时,会导致集群无法重新启动。 通过gs_guc reload动态修改log_directory时,当指定路径为合法路径时,日志输出到新的路径下。当指定路径为非法路径时,日志输出到上一次合法的日志输出路径下而不影响数据库正常运行。此时即使指定的log_directory的值非法,也会写入到配置文件中。 在沙箱环境,路径中不可以包含/var/chroot,例如log的绝对路径是/var/chroot/var/lib/log/Ruby/gs_log/cn_log,则只需要设置为/var/lib/log/Ruby/gs_log/cn_log。 合法路径:用户对此路径有读写权限。 非法路径:用户对此路径无读写权限。 参数类型:字符串 参数单位:无 取值范围:字符串 默认值:安装时指定。 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • log_truncate_on_rotation 参数说明:logging_collector设置为on时,log_truncate_on_rotation设置日志消息的写入方式。 参数类型:布尔型 参数单位:无 取值范围: on:表示GaussDB以覆盖写入的方式写服务器日志消息。 off:表示GaussDB将日志消息附加到同名的现有日志文件上。 默认值:off 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • log_rotation_size 参数说明:logging_collector设置为on时,log_rotation_size决定服务器日志文件的最大容量。当日志消息的总量超过日志文件最大容量时,服务器将生成一个新的日志文件。 参数类型:整型 参数单位:kB 取值范围:0 ~ 2097151。0表示关闭基于容量的新日志文件的创建。 默认值:20480(20MB) 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • log_filename 参数说明:logging_collector设置为on时,log_filename决定服务器运行日志文件的名称。通常日志文件名是按照strftime模式生成,因此可以用系统时间定义日志文件名,用%转义字符实现,仅sysadmin用户可以访问。 建议使用%转义字符定义日志文件名称,否则难以对日志文件进行有效的管理。 当log_destination设为csvlog时,系统会生成附加了时间戳的日志文件名,文件格式为csv格式,例如“server_log.1093827753.csv”。 参数类型:字符串 参数单位:无 取值范围:字符串 默认值:gaussdb-%Y-%m-%d_%H%M%S.log 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • log_file_mode 参数说明:logging_collector设置为on时,log_file_mode设置服务器日志文件的权限。通常log_file_mode的取值是能够被chmod和umask系统调用接受的数字。 使用此选项前请设置log_directory,将日志存储到数据目录之外的地方。 因日志文件可能含有敏感数据,故不能将其设为对外可读。 参数类型:整型 参数单位:无 取值范围:0000~0777 (8进制计数,转化为十进制 0 ~ 511)。 0600表示只允许服务器管理员读写日志文件。 0640表示允许管理员所在用户组成员只能读日志文件。 默认值:0600 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • log_rotation_age 参数说明:logging_collector设置为on时,log_rotation_age表示创建一个新日志文件的时间间隔。当现在的时间减去上次创建服务器日志的时间超过了log_rotation_age时,将生成一个新的日志文件。 假设日志需要保留7天,每天生成一个日志文件,日志文件名设置为server_log.Mon、server_log.Tue等。第二周的周二生成的日志消息会覆盖写入到server_log.Tue。 设置方法:将log_filename设置为server_log.%a ,log_truncate_on_rotation设置为on,log_rotation_age设置为1440。 参数类型:整型 参数单位:min 取值范围:0 ~ 35791394。其中0表示关闭基于时间的新日志文件的创建。 默认值:1440(即1d) 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • log_destination 参数说明:GaussDB支持多种方法记录服务器日志,log_destination的取值为一个逗号分隔开的列表(如log_destination="stderr,csvlog")。 参数类型:字符串 参数单位:无 取值范围:有效值为"stderr"、"csvlog"、"syslog"、"eventlog"。 "stderr",表示日志打印到屏幕。 "csvlog",表示日志的输出格式为“逗号分隔值”即 CS V (Comma Separated Value)格式。使用csvlog记录日志的前提是将logging_collector设置为on,请参见使用CSV格式写日志。 "syslog",表示通过操作系统的syslog记录日志。 GaussDB使用 syslog的LOCAL0 ~ LOCAL7记录日志,请参见syslog_facility。使用syslog记录日志需在操作系统后台服务配置文件中添加代码: 1 local0.* /var/log/gaussdb "eventlog",表示通过事件日志组件记录日志。仅在windows系统下支持。 默认值:"stderr" 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • logging_collector 参数说明:控制开启后端日志收集线程logger进行日志收集。该线程捕获到stderr或csvlog日志消息,将其写入日志文件。 这种记录日志的方法比将日志记录到syslog更加有效,因为某些类型的消息在syslog的输出中无法显示。例如动态链接库加载失败消息和脚本产生的错误消息。 将服务器日志发送到stderr时可以不使用logging_collector参数,此时日志消息会被发送到服务器的stderr指向的空间。这种方法的缺点是日志回滚困难,只适用于较小的日志容量。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启日志收集功能。 off:表示关闭日志收集功能。 默认值:on 设置方式:该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:关闭时无法使用csvlog记录日志。
  • 审视和修改表定义概述 在分布式框架下,数据分布在各个DN上。一个或者几个DN的数据存在一块物理存储设备上,好的表定义至少需要达到以下几个目标: 表数据均匀分布在各个DN上,以防止单个DN对应的存储设备空间不足造成集群有效容量下降。选择合适的分布列,避免数据分布倾斜可以实现该点。 表Scan压力均匀分散在各个DN上,以避免单DN的Scan压力过大,形成Scan的单节点瓶颈。分布列不选择基表上等值filter中的列可以实现该点。 减少扫描数据量。通过分区的剪枝机制可以实现该点。 减少随机I/O。通过聚簇可以实现该点。 避免数据shuffle,减小网络压力。通过选择join-condition或者group by列为分布列可以最大程度实现这点。 从上述描述来看表定义中最重要的一点是分布列的选择。创建表定义一般遵循图1所示流程。表定义在数据库设计阶段创建,在SQL调优过程中进行审视和修改。 图1 表定义流程 父主题: 审视和修改表定义
  • 系统表和系统视图概述 系统表是GaussDB存放结构元数据的地方,它是 GaussDB数据库 系统运行控制信息的来源,是数据库系统的核心组成部分。 系统视图提供了查询系统表和访问数据库内部状态的方法。 系统表和系统视图要么只对管理员可见,要么对所有用户可见。下面的系统表和视图有些标识了需要管理员权限,这些系统表和视图只有管理员可以查询。 用户可以删除后重新创建这些表、增加列、插入和更新数值,但是用户修改系统表会导致系统信息的不一致,从而导致系统控制紊乱。正常情况下不应该由用户手工修改系统表或系统视图,或者手工重命名系统表或系统视图所在的模式,而是由SQL语句关联的系统表操作自动维护系统表信息。 不建议用户修改系统表和系统视图的权限。 用户应该禁止对系统表进行增删改等操作,人为对系统表的修改或破坏可能会导致系统各种异常情况甚至集群不可用。 系统表和系统视图中与外键相关的字段暂不支持。 系统表和系统视图中的字段类型详见数据类型章节介绍。 对于ADM类视图,由于访问到的对象是数据库下所有的该类型的对象,考虑对ADM类视图进行统一权限管理,默认只有系统管理员有权限访问该类型视图,部分ADM类的视图数据来自基表中公开、非敏感的字段;对于DB类视图,查询到的是数据库内当前用户有权限访问的对象,普通用户即可访问该类视图;对于MY类视图,查询到的是当前用户所属的对象,普通用户即可访问该类视图。 父主题: 系统表和系统视图
  • asp_sample_interval 参数说明:每次采样的间隔。 参数类型:整型 参数单位:秒(s) 取值范围:1 ~ 10 默认值:1 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。例如,不带单位取值10,表示asp_sample_interval为10s;带单位取值10s,表示asp_sample_interval为10s。取值如果要带单位,必须为s、min、h、d。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • asp_sample_num 参数说明:LOCAL_ACTIVE_SESSION视图的最大样本个数,仅sysadmin用户可以访问。 参数类型:整型 参数单位:无 取值范围:10000 ~ 100000 默认值:100000 设置方式:该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。若要更改,请在理解参数含义后谨慎操作,避免因误操作产生意料之外的风险。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • wdr_snapshot_full_backup_interval 参数说明:WDR snapshot做全量快照的间隔。该参数控制的不是时间间隔,而是间隔个数。例如,当取值为12时,每一组先生成一个全量快照,再生成11个增量快照;当取值为1时,每个快照都是全量快照。 当且仅当enable_wdr_snapshot参数取值为on时,该参数设置有效。 若在已经生成若干个快照的情况下,更改该参数取值,下一个快照会是全量快照。例如,WDR snapshot当前已经生成了5个增量快照,此时更改参数取值为10,那么下一个快照会为全量快照,然后开启新的周期。 在删除快照的时候,会遵循一组快照一起删除的规则。删除快照的数量受最早的一组快照产生时该参数的取值影响,与该参数的当前取值无关。 参数类型:整型 参数单位:个 取值范围:1 ~ 24 默认值:12 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:根据需求场景进行配置。 设置不当的风险与影响:该参数取值越小,全量快照越多,同样空间占用下能保留的总快照数量越少。
  • asp_flush_rate 参数说明:当内存中样本个数达到asp_sample_num时,会按一定比例把内存中样本刷新到磁盘上,asp_flush_rate为刷新比例。该参数为10时表示按10:1进行刷新。 参数类型:整型 参数单位:无 取值范围:1 ~ 10 默认值:10 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:设置值过小会导致刷盘数据量变大。
  • enable_asp 参数说明:设置是否开启活跃会话信息active session profile。 参数类型:布尔型 参数单位:无 取值范围: on:打开active session profile功能。 off:关闭active session profile功能。 默认值:on 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • asp_flush_mode 参数说明:ASP刷新到磁盘上的方式分为写文件和写系统表,当取值为“file”时,默认写文件,为“table”时写系统表,为“all”时,即写文件也写系统表,仅sysadmin用户可以访问。 参数类型:字符串 参数单位:无 取值范围:当前有效值有“table”、“file”、“all”。 默认值:"table" 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • asp_flush_interval 参数说明:设置ASP定时刷盘的时间间隔。 参数类型:整型 参数单位:秒(s) 取值范围:300 ~ 3600 默认值:300 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。例如,不带单位取值60,表示asp_flush_interval为60s;带单位取值1min,表示asp_flush_interval为1min。取值如果要带单位,必须为s、min、h、d。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • asp_log_filename 参数说明:当ASP写文件时,生成文件名的格式,仅sysadmin用户可以访问。 参数类型:字符串 参数单位:无 取值范围:合法的文件名格式字符串。 默认值:"asp-%Y-%m-%d_%H%M%S.log" 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • enable_asp_standby 参数说明:设置是否开启ASP支持备机功能。开启该功能后,ASP报告进行采样时,会同步获取备机的采集数据。 参数类型:布尔型 参数单位:无 取值范围: on:开启ASP支持备机功能,ASP获取所有备机上的采集数据。 off:关闭ASP支持备机功能。 默认值:on 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • wdr_snapshot_retention_days 参数说明:系统中数据库监控快照数据的保留天数。当数据库运行过程期间所生成的快照数量超过保留天数内允许生成的快照数量的最大值(默认为24*8=192)时,系统将每隔wdr_snapshot_interval时间间隔,清理一次snapshot_id最小的快照数据。 当且仅当enable_wdr_snapshot参数取值为on时,该参数设置有效。 参数类型:整型 参数单位:天(d) 取值范围:1~30 默认值:8 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。取值不能带单位。 设置建议:推荐使用默认值。 设置不当的风险与影响:该参数取值越大,磁盘占用越高。
  • wdr_snapshot_query_timeout 参数说明:系统执行数据库监控快照操作时,设置快照操作相关的sql语句的执行超时时间。如果语句超过设置的时间没有执行完并返回结果,则本次快照操作失败,但会将已经生成的部分快照保留下来。 参数类型:整型 参数单位:秒(s) 取值范围:0 ~ 2147483647 默认值:100 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置,0表示不作超时限制。例如,不带单位取值60,表示wdr_snapshot_query_timeout为60s;带单位取值1min,表示wdr_snapshot_query_timeout为1min。取值如果要带单位,必须为s、min、h、d。 设置建议:根据需求场景进行配置。如果不关心快照中的数据,希望快速生成快照,可以适当地将该参数取值调小;如果需要快照中的数据尽量完备,可以相应地将该参数取值调大。 设置不当的风险与影响:在生成快照超时的前提下,该参数取值越大,超时时间越长,会导致生成快照的时间变长,但快照内的数据更完备。
  • wdr_snapshot_space_threshold 参数说明:快照空间占用维度的控制阈值。当快照占用空间达到该参数取值的50%时,会启用数据库的控制逻辑,使快照占用空间趋于平稳。 当且仅当enable_wdr_snapshot参数取值为on时,该参数设置有效。 若将该参数取值改得比当前快照占用空间要小,并不会使快照占用空间回缩,而是开启控制逻辑,控制快照增长,使快照占用空间趋于平稳。 参数类型:整型 参数单位:kB 取值范围:0 ~ 107374182400 默认值:0,表示不开启按空间阈值控制快照占用空间的功能。 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。例如,不带单位取值1024,表示wdr_snapshot_space_threshold为1024kB;带单位取值1MB,表示wdr_snapshot_space_threshold为1MB。取值如果要带单位,必须为kB、MB、GB。 设置建议:根据需求场景进行配置。 设置不当的风险与影响:设置不当可能导致存量快照数量仅剩最新一组快照。
  • wdr_snapshot_interval 参数说明:后台线程Snapshot自动对数据库监控数据执行各项快照操作的时间间隔。 当且仅当enable_wdr_snapshot参数取值为on时,该参数设置有效。 参数类型:整型 参数单位:分钟(min) 取值范围:10 ~ 60 默认值:60 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。例如,不带单位取值60,表示wdr_snapshot_interval为60min;带单位取值1h,表示wdr_snapshot_interval为1h。取值如果要带单位,必须为min、h、d。 设置建议:推荐使用默认值。 设置不当的风险与影响:在固定保留天数下,该参数取值越小,磁盘占用量越大。
  • enable_wdr_cache 参数说明:该参数的功能为,针对WDR报告后台线程调整GUC参数enable_gsstat_cache状态。当enable_wdr_cache设置为on时,WDR报告后台线程会将enable_gsstat_cache设置为on,否则设置为off。 参数类型:布尔型 参数单位:无 取值范围: on:将enable_gsstat_cache设置为on。 off:将enable_gsstat_cache设置为off。 默认值:on 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:设置为默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • enable_wdr_snapshot 参数说明:设置是否开启数据库监控快照功能。 参数类型:布尔型 参数单位:无 取值范围: on:打开数据库监控快照功能。 off:关闭数据库监控快照功能。 默认值:on 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。 不建议打开的场景: 在多表和多库的场景下,wdr snapshot会在每个库串行记录快照,记录快照时间会很长,不建议打开。 在多表的场景下,由于内部的一些表的性能问题,pg_stat_all_tables在多表的场景下,查询很慢,这时做wdr snapshot就会很慢,所以不建议打开。 如果在大量DDL期间做WDR snapshot会可能造成WDR snapshot失败,不建议打开。
共100000条