华为云用户手册

PG_STAT_SYS_TABLES PG_STAT_SYS_TABLES视图显示pg_catalog、information_schema模式的所有命名空间中系统表的统计信息。具体字段信息如表1所示。 表1 PG_STAT_SYS_TABLES字段 名称 类型 描述 relid oid 表的OID。 schemaname name 该表的模式名。 relname name 表名。 seq_scan bigint 该表发起的顺序扫描数。 seq_tup_read bigint 顺序扫描抓取的活跃行数。 idx_scan bigint 该表发起的索引扫描数。 idx_tup_fetch bigint 索引扫描抓取的活跃行数。 n_tup_ins bigint 插入行数。 n_tup_upd bigint 更新行数。 n_tup_del bigint 删除行数。 n_tup_hot_upd bigint HOT更新行数（比如没有更新所需的单独索引）。 n_live_tup bigint 估计活跃行数。 n_dead_tup bigint 估计不活跃行数。在Ustore表中仅代表不活跃行指针数量。 last_vacuum timestamp with time zone 上次手动清理该表的时间（不计算VACUUM FULL）。 last_autovacuum timestamp with time zone 上次被autovacuum守护线程清理的时间。 last_analyze timestamp with time zone 上次手动分析这个表的时间。 last_autoanalyze timestamp with time zone 上次被autovacuum守护线程分析的时间。 vacuum_count bigint 这个表被手动清理的次数（不计算VACUUM FULL）。 autovacuum_count bigint 这个表被autovacuum守护线程清理的次数。 analyze_count bigint 这个表被手动分析的次数。 autoanalyze_count bigint 这个表被autovacuum守护线程分析的次数。 last_data_changed timestamp with time zone 这个表数据最近修改时间。 父主题： 其他系统视图

GLOBAL_STATIO_USER_TABLES GLOBAL_STATIO_USER_TABLES视图显示各节点的命名空间中所有用户关系表的I/O状态信息，如表1所示。 表1 GLOBAL_STATIO_USER_TABLES字段 名称 类型 描述 node_name name 节点名称。 relid oid 表OID。 schemaname name 该表模式名。 relname name 表名。 heap_blks_read bigint 从该表中读取的磁盘块数。 heap_blks_hit bigint 该表缓存命中数。 idx_blks_read bigint 从表中所有索引读取的磁盘块数。 idx_blks_hit bigint 表中所有索引命中缓存数。 toast_blks_read bigint 该表的TOAST表读取的磁盘块数（如果存在）。 toast_blks_hit bigint 该表的TOAST表命中缓冲区数（如果存在）。 tidx_blks_read bigint 该表的TOAST表索引读取的磁盘块数（如果存在）。 tidx_blks_hit bigint 该表的TOAST表索引命中缓冲区数（如果存在）。 父主题： Cache/IO

查看数据 使用系统表pg_tables查询数据库所有表的信息。 1 gaussdb=# SELECT * FROM pg_tables; 使用gsql的\d+命令查询表的属性。 1 gaussdb=# \d+ customer_t1 执行如下命令查询表customer_t1的数据量。 1 gaussdb=# SELECT count(*) FROM customer_t1; 执行如下命令查询表customer_t1的所有数据。 1 gaussdb=# SELECT * FROM customer_t1; 执行如下命令只查询字段c_customer_sk的数据。 1 gaussdb=# SELECT c_customer_sk FROM customer_t1; 执行如下命令过滤字段c_customer_sk的重复数据。 1 gaussdb=# SELECT DISTINCT( c_customer_sk ) FROM customer_t1; 执行如下命令查询字段c_customer_sk为3869的所有数据。 1 gaussdb=# SELECT * FROM customer_t1 WHERE c_customer_sk = 3869; 执行如下命令按照字段c_customer_sk进行排序。 1 gaussdb=# SELECT * FROM customer_t1 ORDER BY c_customer_sk; 父主题： 管理表

GS_RECYCLEBIN gs_recyclebin描述了闪回特性回收站对象的详细信息。 表1 gs_recyclebin字段 名称 类型 描述 oid oid 系统列。 rcybaseid oid 基表对象id，引用gs_recyclebin.oid。 rcydbid oid 当前对象所属数据库OID。 rcyrelid oid 当前对象OID。 rcyname name 回收站对象名称，格式“BIN$unique_id$oid$0”，其中unique_id为最多16字符唯一标识，oid为对象标识符。 rcyoriginname name 原始对象名称。 rcyoperation "char" 操作类型： d表示drop t表示truncate rcytype integer 对象类型： 0表示table。 1表示index。 2表示toast table。 3表示toast index。 4表示sequence，指serial、bigserial、smallserial、largeserial类型自动关联的序列对象。 5表示partition。 6表示global index。 7表示物化视图。 8表示global secondary index。 rcyrecyclecsn bigint 对象drop、truncate时csn。 rcyrecycletime timestamp with time zone 对象drop、truncate时间。 rcycreatecsn bigint 对象创建时csn。 rcychangecsn bigint 对象定义改变的csn。 rcynamespace oid 包含这个关系的名字空间的OID。 rcyowner oid 关系所有者。 rcytablespace oid 这个关系存储所在的表空间。如果为0，则意味着使用该数据库的缺省表空间。如果关系在磁盘上没有文件，则这个字段没有什么意义。 rcyrelfilenode oid 回收站对象在磁盘上的文件名称，如果没有则为0，用于TRUNCATE对象恢复时物理文件还原。 rcycanrestore boolean 是否可以被单独闪回。 rcycanpurge boolean 是否可以被单独purge。 rcyfrozenxid xid32 该表中所有在这个之前的事务id已经被一个固定的（"frozen"）事务id替换。 rcyfrozenxid64 xid 该表中所有在这个之前的事务id已经被一个固定的（"frozen"）事务id替换。 rcybucket oid 12.2.15.42 PG_HASHBUCKET中的桶信息。 父主题： 其他系统表

allocate_mem_cost 参数说明：设置优化器计算Hash Join创建Hash表开辟内存空间所需的开销，供Hash join估算不准时调优使用。 参数类型：浮点型 参数单位：无 取值范围：0 ~ DBL_MAX 默认值：0 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值，仅在Hash Join估算不准确时调整该参数。 设置不当的风险与影响：错误地设置该参数可能导致Hash Join估算不准确，部分场景下影响查询性能。若要更改，请谨慎操作，避免因误操作产生意料之外的风险。

effective_cache_size 参数说明：设置优化器在一次单一的查询中可用的磁盘缓冲区的有效大小。 设置这个参数，要考虑 GaussDB 的共享缓冲区以及内核的磁盘缓冲区，还要考虑预计在不同表之间的并发查询数目，因为它们将共享可用的空间。 这个参数对GaussDB实际运行时分配的共享内存大小没有影响，它只用于计划生成阶段的估算。该数值用磁盘页来计算，通常每个页面是8192字节。 参数类型：整型 参数单位：页面（8kB） 取值范围： 方式一：设置为不带单位的整数，整数范围为1 ~ 2147483647。例如设置为200，表示200个页面，即200*8kB的大小。 方式二：设置为带单位的值，范围为1*8kB ~ 2147483647*8kB。例如设置为200MB，表示200MB的大小。单位仅限于“kB”、“MB”和“GB”。 默认值： 独立部署： CN：2GB（60核CPU/480G内存）；1GB（32核CPU/256G内存，16核CPU/128G内存）；512MB（8核CPU/64G内存）；256MB（4核CPU/32G内存）；128MB（4核CPU/16G内存） DN：70GB（60核CPU/480G内存）；38GB（32核CPU/256G内存）；20GB（16核CPU/128G内存）；8GB（8核CPU/64G内存）；4GB（4核CPU/32G内存）；2GB（4核CPU/16G内存） 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：较大的数值使优化器倾向于选择索引扫描，较小的数值使优化器倾向于选择全表扫描。一般情况下，可以设为shared_buffers大小的1/2，较为激进地，可以设为shared_buffers大小的3/4。内存充足的情况下，该值越大性能越优。 设置不当的风险与影响：错误地设置该参数会影响优化器对生成计划的选择，部分场景下影响查询性能。若要更改，请谨慎操作，避免因误操作产生意料之外的风险。

cpu_index_tuple_cost 参数说明：设置优化器计算在一次索引扫描中处理每条索引的开销。 参数类型：浮点型 参数单位：无 取值范围：0 ~ DBL_MAX 默认值：0.005 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：该参数影响一次查询中对索引扫描的性能开销评估，错误地设置该参数会影响优化器对生成计划的选择，部分场景下影响查询性能。若要更改，请谨慎操作，避免因误操作产生意料之外的风险。

random_page_cost 参数说明：设置优化器计算一次非顺序抓取磁盘页面的开销。 参数类型：浮点型 参数单位：无 取值范围：0 ~ DBL_MAX 默认值：4 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：参见说明部分。 设置不当的风险与影响：该参数影响一次查询中对随机抓取磁盘页面的性能开销评估，错误地设置该参数会影响优化器对生成计划的选择，部分场景下影响查询性能。若要更改，请谨慎操作，避免因误操作产生意料之外的风险。 虽然服务器允许将random_page_cost设置的比seq_page_cost小，但是物理上实际不受影响。如果所有数据库都位于随机访问内存中，两者设置为相等很合理。因为在此种情况下，非顺序抓取页并没有副作用。同样，在缓冲率很高的数据库上，应该相对于CPU参数同时降低这两个值，因为获取内存中的页要比通常情况下开销小很多。 对于指定表空间中的表和索引，可以通过设置同名的表空间参数覆盖库级别的该参数值，即表空间级别该参数的优先级高于库级别该参数的优先级。 相对于seq_page_cost，减少这个值将导致系统更倾向于使用索引扫描，而增加这个值使得索引扫描开销比较高。可以通过同时增加或减少这两个值来调整磁盘I/O相对于CPU的开销。

cpu_tuple_cost 参数说明：设置优化器计算在一次查询中处理每一行数据的开销。 参数类型：浮点型 参数单位：无 取值范围：0 ~ DBL_MAX 默认值：0.01 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：该参数影响一次查询中对处理一行数据的性能开销评估，错误地设置该参数会影响优化器对生成计划的选择，部分场景下影响查询性能。若要更改，请谨慎操作，避免因误操作产生意料之外的风险。

cpu_operator_cost 参数说明：设置优化器计算一次查询中执行一个操作符或函数的开销。 参数类型：浮点型 参数单位：无 取值范围：0 ~ DBL_MAX 默认值：0.0025 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：该参数影响一次查询中对操作符或函数的性能开销评估，错误地设置该参数会影响优化器对生成计划的选择，部分场景下影响查询性能。若要更改，请谨慎操作，避免因误操作产生意料之外的风险。

seq_page_cost 参数说明：设置优化器计算一次顺序磁盘页面抓取的开销。 参数类型：浮点型 参数单位：无 取值范围：0 ~ DBL_MAX 默认值：1 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：该参数影响一次查询中对顺序抓取磁盘页面的性能开销评估，错误地设置该参数会影响优化器对生成计划的选择，部分场景下影响查询性能。若要更改，请谨慎操作，避免因误操作产生意料之外的风险。

check_gtm_primary_time 参数说明：该参数设置GTM检测其主节点与ETCD主节点一致性的时间间隔。 参数类型：整型 参数单位：s（秒） 取值范围：0 ~ 2147483647‬。0表示检测功能关闭，不进行检测。 默认值：2 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据业务需要进行设置。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_authentication_type 参数说明：GTM模块端口认证方式。 参数类型：枚举类型 参数单位：无 取值范围： trust：表示未配置端口认证。 gss：表示采用kerberos端口认证。 只有当kerberos服务端和客户端成功安装后才能修改为gss，否则GTM模块无法正常通信，将影响集群状态。 默认值：trust 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_enable_threadpool 参数说明：用来指定GTM是否开启GTM线程池功能，设置后需要重启才能生效。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启GTM线程池功能。 off：表示不开启GTM线程池功能。 默认值：on 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

enable_connect_control 参数说明：设置gtm开启连接控制，检测连接IP是否来自集群内部。 参数类型：布尔型 参数单位：无 取值范围： on：检测连接IP是否来自集群内部，非集群内部的IP连接则拒绝访问。 off：不会检测连接IP是否来自集群内部。 默认值：on 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_max_trans 参数说明：设置gtm最大可接收连接数，不建议用户修改该参数。 参数类型：整型 参数单位：无 取值范围：256 ~ 200000 默认值：8192 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。如果需要改动，此参数不能小于（最大连接数+100）。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_option 参数说明：GTM模式选项，用来指定选用的GTM模式，需要在GTM/CN/DN所有实例上配置，配置的值要一致，共三种模式：GTM模式，GTM-Lite模式，GTM-Free模式。其中GTM模式和GTM-Lite模式要在enable_gtm_free参数设置为off的情况下生效，当前版本暂不支持安装好的集群进行不同GTM模式之间的切换。 参数类型：整型 参数单位：无 取值范围：0 ~ 2 0：表示GTM模式； 1：表示GTM-Lite模式； 2：表示GTM-Free模式。 默认值：1 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_num_threads 参数说明：当gtm_enable_threadpool线程池功能开启时，用来控制线程池工作线程的数量。 参数类型：整型 参数单位：无 取值范围：0 ~ 16384之间。该数值与gtm_max_trans大小相关，不应该超过（gtm_max_trans - 1 - 辅助线程数），其中辅助线程数当前版本为2。 默认值：1024 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_krb_server_keyfile 参数说明：kerberos服务端key文件所在位置，需要配置为绝对路径。该文件通常为${GAUSSHOME}/kerberos路径下，以keytab格式结尾，文件名与集群运行所在用户名相同。与上述gtm_authentication_type参数是配对的，当gtm_authentication_type参数修改为gss时，该参数也必须配置为正确路径，否则将影响集群状态。 参数类型：字符串 参数单位：无 取值范围：合法的文件路径。 默认值："" 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

synchronous_backup 参数说明：指定是否以同步方式备份到GTM备机。 参数类型：枚举类型 参数单位：无 取值范围： on：表示开启同步方式。 off：表示关闭同步方式。 auto：表示自动同步方式。 默认值：auto 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

listen_addresses 参数说明：声明服务器侦听客户端的TCP/IP地址。该地址支持IPv4与IPv6格式。 参数类型：字符串 参数单位：无 取值范围： 主机名或IP地址，多个值之间用英文逗号分隔。支持IPv4与IPv6格式。 星号（*）表示所有IP地址。 置空则服务器不会侦听任何IP地址，这种情况下，只有Unix域套接字可以用于连接数据库。 默认值："*" 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

log_min_messages 参数说明：控制写到服务器日志文件夹下GTM日志文件中的消息级别，当产生该设置参数级别相等或更高级别的消息时，将这些信息记入日志文件。因此级别越低，服务器运行日志中记录的消息就越多。 参数类型：枚举类型 参数单位：无 取值范围：消息级别从低到高为debug5、debug4、debug3、debug2（debug）、debug1、info、notice、warning、error、log、fatal、panic。参数的详细信息请参见表1。 debug的消息级别等效于debug2。 对于log_min_messages，log的消息级别高于error，低于fatal。 默认值：warning 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

log_directory 参数说明：当logging_collector设置为on时，log_directory决定存放服务器日志文件的目录。 它可以是绝对路径，或者是相对路径（相对于数据目录的路径）。 当配置文件中log_directory的值为非法路径（即用户对此路径无读写权限）时，会导致集群无法重新启动。 修改log_directory时，当指定路径为合法路径（即用户对此路径有读写权限）时，日志输出到新的路径下。当指定路径为非法路径时，日志输出到上一次的合法日志输出路径下而不影响数据库正常运行。此时即使指定的log_directory的值非法，也会写入到配置文件中。 参数类型：字符串 参数单位：无 取值范围：合法的目录路径。 默认值：“gtm_log”，表示在数据目录下的“gtm_log/”目录下生成服务器日志。 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

alarm_component 参数说明：在对告警做上报时，会进行告警抑制，即同一个实例的同一个告警项在alarm_report_interval（默认值为10s）内不做重复上报。在这种情况下，该参数设置用于处理告警内容的告警组件的位置。 参数类型：字符串 参数单位：无 取值范围： 若前置脚本gs_preinstall中的--alarm-type参数设置为5，表示未对接第三方组件，告警写入system_alarm日志，此时GUC参数alarm_component的取值为：/opt/huawei/snas/bin/snas_cm_cmd。 若前置脚本gs_preinstall中的--alarm-type参数设置为1，表示对接第三方组件，此时GUC参数alarm_component的值为第三方组件的可执行程序的绝对路径。 默认值："/opt/huawei/snas/bin/snas_cm_cmd" 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

query_memory_limit 参数说明：设置查询可以使用的内存百分比限制。该参数仅适用于默认资源组。对于其它的资源组，没有查询内存限制影响。 参数类型：浮点型 参数单位：无 取值范围：0.0 ~ 1.0 默认值：0.25 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

keepalives_interval 参数说明：在支持TCP_KEEPINTVL套接字选项的操作系统上，此参数控制GTM服务端保持活跃信号发送的时间间隔。 参数类型：整型 参数单位：s（秒） 取值范围：0 ~ 2147483647 默认值：0 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

standby_connection_timeout 参数说明：设置GTM主备之间的超时时间。此参数控制GTM主备机之间的超时设置，增大该参数可以增加GTM主备之间的网络容错能力，但是也会增加故障场景下GTM主备断连的检测时长。 参数类型：整型 参数单位：s（秒） 取值范围：5 ~ 2147483647 默认值：5 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置过大时，可能无法及时检测到断连故障。

keepalives_count 参数说明：在支持TCP_KEEPCNT套接字选项的操作系统上，此参数控制GTM服务端在断开与客户端连接之前，等待未响应的保持活跃信号的最大数量。该参数仅在备GTM上生效。 参数类型：整型 参数单位：无 取值范围：0 ~ 2147483647 默认值：0，表示GTM未收到客户端反馈的保持活跃信号则立即断开连接。 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

active_host 参数说明：目标GTM的地址。即在主GTM上时为备GTM的地址，在备GTM上时为主GTM的地址。该地址支持IPv4与IPv6格式。 参数类型：字符串 参数单位：无 取值范围：字符串，要符合标识符的命名规范。 默认值："" 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

keepalives_idle 参数说明：在支持TCP_KEEPIDLE套接字选项的操作系统上，此参数控制GTM服务端连接上客户端之后，如果没有数据发送，多长时间发送保持活跃信号。 参数类型：整型 参数单位：s（秒） 取值范围：0 ~ 2147483647 默认值：0 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。