华为云用户手册

  • log_min_messages 参数说明:控制写到服务器日志文件中的消息级别,当产生该设置参数级别相等或更高级别的消息时,将这些信息记入日志文件。因此级别越低,服务器运行日志中记录的消息就越多。该参数可在PDB级别设置。 参数类型:枚举类型 参数单位:无 取值范围:消息级别从低到高为debug5、debug4、debug3、debug2(debug)、debug1、info、notice、warning、error、log、fatal、panic。参数的详细信息请参见表1。 debug的消息级别等效于debug2。 对于log_min_messages,log的消息级别高于error,低于fatal。 默认值:warning。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • max_compile_packages 参数说明:设置服务器存储的PACKAGE编译结果的最大数量。 参数类型:整型 参数单位:无 取值范围:0 ~ 2147483647,0表示不开启该功能,不控制PACKAGE编译结果的最大数量。不同规格下该参数取值可以适当调整,可以根据计算公式(max_process_memory * 2%)/ 4.4MB 然后向下取整得到推荐值。 4.4MB是根据实验室模拟统计得到的平均值,实际场景仍需要观察,如果该经验值不符合实际场景,需要重新调整该值以调整存储过程对内存的占用。 默认值: 不同规格默认值:(max_process_memory * 2%)/ 4.4MB 向下取整 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:存储过多的PACKAGE的编译结果可能占用很大内存,将此参数设置为一个合理的值,有助于减少内存占用,提升系统性能。 设置不当的风险与影响:设置太小,会导致全局缓存频繁淘汰,可能会影响性能。
  • max_execute_functions 参数说明:该参数用于定义session内存储过程、函数的执行产物的最大个数。当执行产物个数大于max_execute_functions时,系统将对执行产物进行清理,保留最近调用的max_execute_functions个执行产物。当且仅当enable_global_plsqlcache参数取值为on时,该参数设置有效。 参数类型:整型 参数单位:无 取值范围:1 ~ 2147483647 默认值:1000 设置方式:该参数属于POSTMASTER型参数,请参考表1中对应设置方法进行设置。 设置建议:建议根据系统内存大小设置合理值,内存越大可以设置的取值越大。 设置不当的风险与影响:设置太小,可能会影响性能。
  • enable_global_plsqlcache 参数说明:设置是否对package、存储过程、函数的编译产物进行全局缓存,并对执行产物进行session级缓存,开启该功能可以节省高并发下数据库节点的内存使用。多租数据库特性(enable_mtd)需要关闭该参数。 参数类型:布尔型 参数单位:无 取值范围: on:表示对编译产物进行全局缓存。 off:表示不进行全局缓存。 默认值:on 设置方式:该参数属于POSTMASTER型参数,请参考表1中对应设置方法进行设置。 设置建议:存储过程及包对象较多且并发较高时建议打开,以节省内存。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • STAT_ALL_INDEXES 显示数据库当前节点中的每个索引的访问信息,如表1所示。 表1 STAT_ALL_INDEXES字段 名称 类型 描述 relid oid 这个索引的表的OID。 indexrelid oid 索引的OID。 schemaname name 索引所在的Schema名。 relname name 索引的表名。 indexrelname name 索引名。 idx_scan bigint 该索引上执行的索引扫描次数。 idx_tup_read bigint 该索引上扫描返回的索引项数。 idx_tup_fetch bigint 使用该索引的简单索引扫描在原表中抓取的活跃行数。 last_updated timestamp with time zone 视图中该对象监控数据最后一次更新的时间。 父主题: Object
  • 示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 --查看现有预备语句。 gaussdb=# SELECT name, statement, parameter_types FROM pg_prepared_statements; name | statement | parameter_types ------+-----------+----------------- (0 rows) --创建q1,q2,q3,q4四个预备语句。 gaussdb=# PREPARE q1 AS SELECT 1 AS a; PREPARE gaussdb=# PREPARE q2 AS SELECT 1 AS a; PREPARE gaussdb=# PREPARE q3 AS SELECT 1 AS a; PREPARE gaussdb=# PREPARE q4 AS SELECT 1 AS a; PREPARE --再次查看现有预备语句。 gaussdb=# SELECT name, statement, parameter_types FROM pg_prepared_statements; name | statement | parameter_types ------+------------------------------+----------------- q1 | PREPARE q1 AS SELECT 1 AS a; | {} q4 | PREPARE q4 AS SELECT 1 AS a; | {} q3 | PREPARE q3 AS SELECT 1 AS a; | {} q2 | PREPARE q2 AS SELECT 1 AS a; | {} (4 rows) --删除q4预备语句并查看剩余预备语句。 gaussdb=# DEALLOCATE q4; gaussdb=# SELECT name, statement, parameter_types FROM pg_prepared_statements; name | statement | parameter_types ------+------------------------------+----------------- q1 | PREPARE q1 AS SELECT 1 AS a; | {} q3 | PREPARE q3 AS SELECT 1 AS a; | {} q2 | PREPARE q2 AS SELECT 1 AS a; | {} (3 rows) --删除所有预备语句并查看剩余预备语句。 gaussdb=# DEALLOCATE ALL; DEALLOCATE ALL gaussdb=# SELECT name, statement, parameter_types FROM pg_prepared_statements; name | statement | parameter_types ------+-----------+----------------- (0 rows)
  • SUMMARY_STAT_USER_TABLES 显示数据库各节点所有Schema中用户自定义普通表的状态信息的汇总求和结果(其中timestamp类型字段不进行求和,仅取所有节点该字段的最新值),如表1所示。 表1 SUMMARY_STAT_USER_TABLES 名称 类型 描述 schemaname name 此表所在的Schema名。 relname name 表名。 seq_scan numeric 此表发起的顺序扫描数。 seq_tup_read numeric 顺序扫描抓取的活跃行数。 idx_scan numeric 此表发起的索引扫描数。 idx_tup_fetch numeric 索引扫描抓取的活跃行数。 n_tup_ins numeric 插入行数。 n_tup_upd numeric 更新行数。 n_tup_del numeric 删除行数。 n_tup_hot_upd numeric HOT更新行数(即没有更新索引列的行数)。 n_live_tup numeric 估计活跃行数。 n_dead_tup numeric 估计不活跃行数。在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 numeric 这个表被手动清理的次数(不计算VACUUM FULL)。 autovacuum_count numeric 这个表被autovacuum清理的次数。 analyze_count numeric 这个表被手动分析的次数。 autoanalyze_count numeric 这个表被autovacuum守护线程分析的次数。 父主题: Object
  • sqlapply_logical_decode_options 参数说明:逻辑回放的解码任务启动选项。选项包括:parallel-decode-num,parallel-queue-size,max-txn-in-memory,max-reorderbuffer-in-memory,exclude-users,skip-generated-columns,enable-ddl-decoding,only-local,decode-sequence。 参数类型:字符串 参数单位:无 取值范围: parallel-decode-num 指定并行解码的Decoder线程数量。 取值范围:1~20的整型,默认值为2。 parallel-queue-size 并行逻辑解码线程间进行交互的队列长度。 取值范围:2~1024的整型,且只能为2的幂次方,默认值为128。 max-txn-in-memory 内存管控参数,单位为MB,单个事务占用内存大于该值即进行落盘。 取值范围:0~100的整型,默认值为0,即不开启此种管控。 max-reorderbuffer-in-memory 内存管控参数,单位为GB,拼接-发送线程中正在拼接的事务总内存(包含缓存)大于该值则对当前解码事务进行落盘。 取值范围:0~100的整型,默认值为0,即不开启此种管控。 exclude-users 黑名单用户的名字参数。 取值范围:指定黑名单用户的名字,多个名字通过','分隔。 skip-generated-columns 逻辑解码控制参数,用于跳过存储生成列的输出。对UPDATE和DELETE的旧元组无效,相应元组始终会输出存储生成列。 取值范围:boolean型,默认值为false。 false:设为false时,输出存储生成列的解码结果。 true:值为true时,不输出存储生成列的解码结果。 虚拟生成列不受此参数控制,DML的解码结果始终不会输出虚拟生成列。 enable-ddl-decoding 逻辑解码控制参数,用于控制是否开启DDL语句的逻辑解码。 取值范围:bool型,默认值为true。 false:设为false时,不开启DDL语句的逻辑解码。 true:设为true时,开启DDL语句的逻辑解码。 only-local 是否仅解码本地日志。 取值范围:Boolean,默认值为true。 false:设为false时,解码非本地日志和本地日志。 true:设为true时,仅解码本地日志。 decode-sequence 逻辑解码控制参数,用来指定是否输出sequence值的变更日志的解码结果。 取值范围:boolean型,默认值为true。 false:设为false时,不输出sequence值的变更日志的解码结果。 true:输出sequence值的变更日志的解码结果。 默认值:默认设置enable-ddl-decoding=true和decode-sequence=true。 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。该参数SIGHUP生效并不会影响已经启动的逻辑解码流程。 设置建议:建议根据业务需求进行设置。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • sqlapply_guard_mode 参数说明:逻辑备机的数据保护模式。 参数类型:枚举类型 参数单位:无 取值范围: guard_none:逻辑备不进行额外数据保护。 guard_standby:逻辑备不允许修改主备同步的数据对象。 guard_all:逻辑备只允许逻辑回放修改数据。 默认值:guard_all 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • logical_replica_identity_force 参数说明:控制全局逻辑复制旧元组的记录级别。 参数类型:枚举 参数单位:无 取值范围: 'full'表示所有列都记录为副本标识。 'unique'表示副本标识为主键和唯一键。 'default'表示复制副本标识为默认选择(主键或无)。 'nothing'表示没有记录此关系的副本标识。 ''表示此全局控制参数不生效。 默认值:'' 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 如需将已设置为非默认值的logical_replica_identity_force重新设置成'',须使用将GUC参数恢复成默认值的方法。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • sqlapply_dumptxn_when 参数说明:逻辑回放转储事务的时机。 参数类型:枚举类型 参数单位:无 取值范围: any:逻辑回放总是转储事务的变更到文件。 error:逻辑回放事务执行出错时转储事务的变更到文件。 none:不转储事务的变更到文件。 默认值:error 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • sqlapply_cache_memory_maxsize 参数说明:控制逻辑回放缓存可使用的内存总量。 参数类型:整型 参数单位:kB 取值范围:-1~2147483647‬。-1表示内存使用量不受限制。 默认值:102400 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:在不同CPU和内存下,sqlapply_cache_memory_maxsize的设置值可参考表1。 设置不当的风险与影响:设置过大,会消耗过多的系统资源;设置过小,回放效率会降低。 表1 不同CPU和内存的参数设置参考 编号 CPU个数 内存(GB) sqlapply_apply_worker_count sqlapply_cache_memory_maxsize(kB) 备注 1 4 - 4 102400 - 2 8 - 16 102400 - 3 8 64 64 1024000 - 4 16 128 64 2048000 - 5 32 256 128 4096000 - 6 64 512 192 5120000 - 7 96 768 256 10240000 大于此硬件规格的系统均参考此参数设置值。
  • sql_apply_autorun 参数说明:逻辑备是否自启动逻辑回放。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启。 off:表示关闭。 默认值:off 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:该参数默认为off,在滚动升级期间的备数据库需要设置为on。数据库滚动升级操作时逻辑备机不要关闭此参数。 设置不当的风险与影响:如果在滚动升级期间的备数据库设置为off,逻辑回放会停止,滚动升级会发生异常。
  • logical_switch_time 参数说明:物理容灾数据库转为逻辑复制的转换超时时间。 参数类型:整型 参数单位:分钟 取值范围:0~60。其中0表示不设置超时时间。 默认值:10 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:若容灾备数据库和主数据库RTO或RPO较大(超过10分钟)按照默认时间执行物理转逻辑可能失败,需要修改该参数为当前容灾RTO或RPO值加10分钟或更多。物理转逻辑操作建议在业务低谷期执行。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • max_keep_log_seg 参数说明:流控参数,逻辑复制在DN本地会解析物理日志转换成逻辑日志,当未被解析的物理日志文件数量大于该参数时会触发限流。该参数可在PDB级别设置。 参数类型:整型 参数单位:无 取值范围:0 ~ 2147483647。此参数为0表示关闭限流功能。 默认值:0。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:根据实际业务需求,判断是否需要进行流控。 设置不当的风险与影响:设置过大,流控一直不触发。
  • sqlapply_preserve_commit_order 参数说明:控制逻辑备机,是否按照远端主机事务的提交顺序进行回放提交。 参数类型:布尔型‬ 参数单位:无 取值范围: on:表示按照远端主机事务的提交顺序。 off:表示不按照远端主机事务的提交顺序。 默认值:off 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • logical_sender_timeout 参数说明:设置本端等待逻辑日志接收端接收日志的最大等待时间。 参数类型:整型 参数单位:ms(毫秒) 取值范围:0 ~ 2147483647 默认值:30000(30s) 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • enable_logicalrepl_xlog_prune 参数说明:设置是否开启逻辑复制槽强制失效功能。当GUC参数enable_logicalrepl_xlog_prune=on、max_size_for_xlog_retention为非零值时,如果max_size_for_xlog_retention大于0且当前逻辑复制槽导致保留日志的段数(每段日志大小为16MB)超过max_size_for_xlog_retention,或者max_size_for_xlog_retention小于0且磁盘使用率达到(-max_size_for_xlog_retention)/100,则该逻辑复制槽会强制失效,restart_lsn被置为7FFFFFFF/FFFFFFFF,该复制槽不阻塞xlog日志的回收。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启逻辑复制槽强制失效功能。 off:表示关闭逻辑复制槽强制失效功能。 默认值:off 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:根据实际业务需要确认是否开启。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • disable_logical_cache 参数说明:表示是否缓存解码元信息。 参数类型:布尔型 参数单位:无 取值范围: true:不缓存解码元信息。 false:缓存解码元信息。 默认值:false 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:该参数默认false,如果需要关闭解码元信息缓存设置为true。 设置不当的风险与影响:设置为true,每次解码都需要构建元信息,影响解码性能。建议在构建元信息版本链无报错的情况下,不设置为true。
  • sqlapply_apply_writeset_maxsize 参数说明:在行集冲突检测方法中,控制全局哈希表存放历史修改行标识的数量。 参数类型:整型 参数单位:无 取值范围:-1~2147483647‬ 设置为0,表示关闭行集冲突检测。 设置为-1,则表示数量不受限制。 默认值:10000 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:设置过大,会消耗过多的系统资源。
  • sqlapply_apply_worker_count 参数说明:逻辑回放线程的数量。 参数类型:整型 参数单位:无 取值范围:1~1024 默认值:4 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:在不同CPU和内存下,sqlapply_apply_worker_count的设置值可参考表1。 设置不当的风险与影响:设置过大,会消耗过多的系统资源;设置过小,回放效率会降低。
  • max_cached_tuplebufs 参数说明:逻辑解码时,总元组信息在内存中缓存的数量上限。 参数类型:整型 参数单位:无 取值范围:1~2147483647‬ 默认值:8192 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。建议设置为max_changes_in_memory的两倍以上。 设置不当的风险与影响:设置过大,解码到大事务会占用较多的动态内存;设置过小,解码效率会降低。
  • enable_logical_replication_dictionary 参数说明:表示是否开启创建多版本字典表类型的逻辑复制槽。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启。 off:表示关闭。 默认值:on 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:该参数默认on,如果需要创建online catalog类型的逻辑复制槽时设置为off。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。 当该参数开启时,字典类型的系统表基线化完成后才能创建逻辑复制槽,否则创建失败。
  • enable_logical_replication_ddl 参数说明:设置逻辑解码是否支持DDL,是否反解析,是否生成日志。 参数类型:布尔型 参数单位:无 取值范围: on:逻辑复制可支持DDL,对DDL执行结果进行反解析,并生成DDL的WAL日志。 off:不支持DDL,不反解析也不生成WAL日志。 默认值:on 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • logical_replication_dictionary_retention_time 参数说明:GS_TXN_LSN_TIME以及数据字典相关系统表数据保留时间。 参数类型:整型 参数单位:d(天) 取值范围:[1, 3650] 默认值:365 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:根据实际业务需求进行设置。 设置不当的风险与影响:设置过小,会导致指定位点解码的可选区间过小;设置过大,会影响解码性能。
  • DB_DEPENDENCIES DB_DEPENDENCIES视图显示当前用户可访问的类型、表、视图、存储过程、函数、触发器之间的依赖关系。所有用户都可以访问。该视图同时存在于PG_CATA LOG 和SYS Schema下。 表1 DB_DEPENDENCIES字段 名称 类型 描述 owner name 对象的所有者。 name name 对象的名称。 type character varying(18) 对象的类型。 referenced_owner name 被引用对象的所有者。 referenced_name name 被引用对象的名称。 referenced_type character varying(18) 被引用对象的类型。 referenced_link_name character varying(128) 暂不支持,值为NULL。 dependency_type character varying(4) 暂不支持,值为NULL。 父主题: 其他系统视图
  • password_notify_time 参数说明:该参数决定账户密码到期前提醒的天数。 参数类型:整型 参数单位:天(d) 取值范围:0 ~ 999 0表示不开启提醒功能。 1~999表示账户密码到期前提醒的天数。 默认值:7 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:设置为0时,可能导致账户密码到期没有被提前感知。
  • enable_innertool_cert 参数说明:该参数决定内部工具是否使用证书认证。 参数类型:布尔型 参数单位:无 取值范围: on:表示内部工具使用证书认证。 off:表示内部工具不使用证书认证。 默认值:off 此参数必须与参数ssl同时打开才能生效。 此参数打开后,使用的证书默认配置的是$GAUSSHOME/share/sslcert/gsql目录下的证书,证书的Common Name必须与初始用户相同,否则认证失败。 此参数打开后,初始用户使用证书认证,其他用户则需要使用密码方式认证。 此参数打开后,允许初始用户使用证书认证方式远程连接数据库。 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值,如果用户对安全性要求比较高,建议打开参数,并正确配置相关证书。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • password_effect_time 参数说明:该参数决定账户密码的有效时间。 参数类型:浮点型 参数单位:天(d) 取值范围:0 ~ 999。整数部分表示天数,小数部分可以换算成时、分、秒,如:password_effect_time=0.5,表示0天零12小时。 0表示不开启账户密码有效期限制功能。 1~999表示创建账户所指定的密码有效期,临近或超过有效期时,系统会提示用户修改密码。 默认值:0 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐配置用户密码的有效时间,参数设置越小越安全,但对用户使用带来不便,请依据业务安全诉求进行设置。 设置不当的风险与影响:设置为0时,密码长期不修改会存在安全风险。
  • plat_compat_allow_public_key_retrieval 参数说明:M-Compatibility模式数据库行为配置项。该参数是用来控制内核是否允许客户端请求RSA Public key,默认关闭。 参数类型:布尔型 参数单位:无 取值范围: on:表示内核允许客户端请求RSA Public key,支持口令通过RSA加密传输。 off:表示内核不允许客户端请求RSA Public key。 默认值:off 设置方式:该参数属于POSTMASTER类型参数,请参见表1中对应设置方法进行设置。 设置建议:选择RSA连接时,将该参数设为on,并将ssl设置为off。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
共100000条