华为云用户手册

  • elastic_search_ip_addr 参数说明:Elastic Search系统IP地址,使用https协议格式为:https://ip:port:username;使用http协议格式为:http://ip:port。其中,ip为Elastic Search服务器的IP,port为Elastic Search HTTP通信的侦听端口,范围为9200 - 9299,username为用户在Elastic Search注册账号所使用的用户名,初始用户为elastic使用https协议需要配置相关证书,详见《安全加固指南》中“统一审计“章节。 参数类型:字符串 参数单位:无 取值范围:合法IP字符串或空字符串。 默认值:"" 设置方式:该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值,需要将统一审计日志发送至Elastic Search系统时且use_elastic_search为on时设置。 设置不当的风险与影响:需要保证设置值对应的es服务可正常连通,否则进程启动会失败。
  • enable_mac_check 参数说明:表示基于标签的强制访问控制是否生效。 参数类型:布尔型 参数单位:无 取值范围: on:表示基于标签的强制访问控制生效。 off:表示基于标签的强制访问控制不生效。 默认值:off 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值,可以根据实际业务需要进行调整。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • use_elastic_search 参数说明:统一审计发送日志至Elastic Search系统,enable_security_policy打开且本参数打开后,统一审计日志会通过http(https)传递至Elastic Search系统(默认使用https安全协议)。 参数类型:布尔型 参数单位:无 取值范围: on:开启统一审计日志发送至Elastic Search。 off:关闭统一审计日志发送至Elastic Search。 默认值:off 设置方式:该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值,需要将统一审计日志发送至Elastic Search系统时开启。 设置不当的风险与影响:此参数打开后需要保证elastic_search_ip_addr对应的es服务可正常连通,否则进程启动失败。
  • tde_encrypt_config 参数说明:用于设置透明加密支持xlog和undo-log相关功能的参数。 参数类型:字符串 参数单位:无 取值范围:该参数配置格式为“key=value, key=value, ...”,合法的key和value如下: key取值 value取值 缺省值 功能 log_encrypt on或off on 控制是否对xlog和undo-log加密。 log_algorithm aes_128_ctr或sm4_ctr aes_128_ctr 对xlog和undo-log加密的算法。 table_algorithm aes_128_ctr或sm4_ctr aes_128_ctr 在该种语法中:CREATE .. SET (enable_tde=on, encrypt_algo=aes_128_ctr),如果不主动设置encrypt_algo参数,默认使用table_algorithm中设置的参数。 默认值:"" 设置方式:该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值,可以根据实际业务需要进行调整。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • 语法格式 1 wlmrule("time_limit,max_execute_time,max_iops") 本参数仅在enable_thread_pool=on时对非sysadmin/monitoradmin用户执行的select类型的语句生效。 time_limit:SQL语句被标记为慢SQL的执行时长,取值为0-INT_MAX。 max_execute_time:SQL语句的最大执行时间,执行时间超过该时长后被强制cancel退出,取值为0-INT_MAX。当max_execute_time小于或等于time_limit时,该规则不生效。 max_iops:SQL语句被标记为慢SQL后最大iops上限,仅在use_workload_manager=on时生效。iops限制采用逻辑IO管控,iops定义请参考io_control_unit定义。取值范围为:Low、Medium、High、None、0-INT_MAX。
  • STAT_SYS_TABLES 显示当前节点内pg_catalog、information_schema以及pg_toast模式下所有系统表的状态信息,如表1所示。 表1 STAT_SYS_TABLES字段 名称 类型 描述 relid oid 表的OID。 schemaname name 该表所在的Schema名。 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_updated timestamp with time zone 视图中该对象监控数据最后一次更新的时间。 父主题: Object
  • DB_IND_COLUMNS DB_IND_COLUMNS视图显示当前用户可访问的所有索引的字段信息。该视图同时存在于PG_CATA LOG 和SYS Schema下。 表1 DB_IND_COLUMNS字段 名称 类型 描述 index_owner character varying(64) 索引的所有者。 index_name character varying(64) 索引名。 table_owner character varying(64) 表的所有者。 table_name character varying(64) 表名。 column_name name 列名。 column_position smallint 索引中列的位置。 column_length numeric 列的长度。 char_length numeric 列的长度(字符类型)。 descend character varying(4) 列的排序方式:降序(DESC)、升序(ASC)。 collated_column_id numeric 此列提供语言排序的列的内部序列号。 父主题: 其他系统视图
  • GLOBAL_STAT_USER_TABLES 显示数据库各节点所有Schema中用户自定义普通表的状态信息(不汇总),如表1所示。 表1 GLOBAL_STAT_USER_TABLES字段 名称 类型 描述 node_name name 节点名称。 relid oid 表的OID。 schemaname name 此表所在的Schema名。 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守护线程分析的次数。 父主题: Object
  • pl_get_trace_info 查看trace功能记录信息的接口函数。字段信息详见表1。 表1 pl_get_trace_info 参数 类型 描述 session_id bigint 本条SQL语句所属的会话ID。 level text 本条SQL语句的等级。 database text 本条SQL语句所属数据库名。 func oid 本条SQL语句所属存储过程的OID。 source text 本条SQL语句。 plan text 本条SQL语句的执行计划。 time text 本条SQL语句的执行时间。 threshold float8 本条SQL语句的阈值(单位:毫秒)。 父主题: Trace Function
  • vacuum_defer_cleanup_age 参数说明:通过设置该参数,延迟VACUUM操作清理无效行存表记录的时间,延迟等待的时间是以已经执行的事务数量来量化,通过设置vacuum_defer_cleanup_age的数值来控制延迟事务的数量。即VACUUM和VACUUM FULL操作不会立即清理被删除的元组,而是等到该元组已经被一定数量的事务处理后才执行清理和删除。 参数类型:整型 参数单位:无 取值范围:0 ~ 1000000,值为0表示不延迟。 默认值:0 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:设置过大会导致VACUUM和VACUUM FULL不及时。
  • vacuum_cost_limit 参数说明:设置清理线程休眠的开销限制。当vacuum线程执行的代价达到vacuum_cost_limit时,该线程休眠一次,休眠vacuum_cost_delay时间。该参数可在PDB级别设置。 参数类型:整型 参数单位:无 取值范围:1 ~ 10000 默认值:1000。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。该值越大,Vacuum 的I/O频次限制越小,越不容易进入休眠状态,Vacuum效率越高,对业务I/O的影响就越大。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • vacuum_cost_page_miss 参数说明:设置vacuum清理一个缓冲区中未命中的数据页面的预估代价。该参数可在PDB级别设置。 参数类型:整型 参数单位:无 取值范围:0 ~ 10000 默认值:10。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • vacuum_cost_delay 参数说明:vacuum拉起后台服务线程对于数据表死元组进行整理,它会和业务线程冲突,为了能够控制其对于业务的影响,设置该参数vacuum_cost_delay表示当vacuum执行的开销达到vacuum_cost_limit的值时,vacuum线程就休眠vacuum_cost_delay的时间把资源让给业务线程执行,来确保业务不会被后台vacuum一直阻塞。该参数可在PDB级别设置。 参数类型:整型 参数单位:ms(毫秒) 取值范围:0 ~ 100。0表示关闭基于开销的清理延迟特性,正数值表示打开基于开销的清理延迟特性。在许多系统上,休眠的有效分辨率是10ms,因此把vacuum_cost_delay设置为一个不是10的整数倍数值与设置为下一个10的整数倍数值作用相同。 默认值:0。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:此参数一般设置较小,常见的设置是10ms或20ms。调整此特性资源占用率时,建议调整其他参数,而不是此参数。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • vacuum_cost_page_hit 参数说明:设置vacuum清理一个缓冲区命中的数据页面的预估代价。该参数可在PDB级别设置。 参数类型:整型 参数单位:无 取值范围:0 ~ 10000 默认值:1。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • vacuum_cost_page_dirty 参数说明:vacuum清理页面会产生脏页,当清理的数据页面原先是干净页面时,由于vacuum清理会产生一个需要刷脏到磁盘的额外代价,通过设置该参数,来表示vacuum清理该类数据页面的代价。该参数可在PDB级别设置。 参数类型:整型 参数单位:无 取值范围:0 ~ 10000 默认值:20。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • 数据类型转换 数据库中有些数据类型间允许进行隐式类型转换(例如赋值、函数调用的参数等)、有些数据类型间不允许进行隐式数据类型转换(例如:INT和复合类型),可尝试使用 GaussDB 提供的类型转换函数,例如:CAST进行数据类型强转。 GaussDB数据库 常见的隐式类型转换,请参见表1。 GaussDB支持的DATE的效限范围是:公元前4713年到公元294276年。 表1 隐式类型转换表 原始数据类型 目标数据类型 备注 CHAR VARCHAR2 - CHAR NUMBER 原数据必须由数字组成。 CHAR DATE 原数据不能超出合法日期范围。 CHAR RAW - CHAR CLOB - VARCHAR2 CHAR - VARCHAR2 NUMBER 原数据必须由数字组成。 VARCHAR2 DATE 原数据不能超出合法日期范围。 VARCHAR2 CLOB - NUMBER CHAR - NUMBER VARCHAR2 - DATE CHAR - DATE VARCHAR2 - RAW CHAR - RAW VARCHAR2 - CLOB CHAR - CLOB VARCHAR2 - CLOB NUMBER 原数据必须由数字组成。 INT4 CHAR - INT4 BOOLEAN - BOOLEAN INT4 - 父主题: 存储过程
  • 注意事项 序列的所有者或者被授予了序列ALTER权限的用户或者被授予了ALTER ANY SEQUENCE权限的用户才能执行ALTER SEQUENCE命令,三权分立开关关闭时,系统管理员默认拥有该权限。但要修改序列的所有者,当前用户必须是该序列的所有者或者系统管理员,且该用户是新所有者角色的成员。 当前版本仅支持修改拥有者、归属列、最大值和cache缓存值。若要修改其他参数,可以删除重建,并用Setval函数恢复当前值。 ALTER SEQUENCE MAXVALUE不支持在事务、函数和存储过程中使用。 修改序列的最大值后,会清空该序列在所有会话的cache。 如果Sequence被创建时使用了LARGE标识,则ALTER时也需要使用LARGE标识。 ALTER SEQUENCE会阻塞nextval、setval、currval和lastval的调用。
  • 语法格式 修改序列最大值、归属列和缓存值。 ALTER [ LARGE ] SEQUENCE [ IF EXISTS ] name [MAXVALUE maxvalue | NO MAXVALUE | NOMAXVALUE | CACHE cache] [ OWNED BY { table_name.column_name | NONE } ] ; 修改序列的拥有者。 ALTER [ LARGE ] SEQUENCE [ IF EXISTS ] name OWNER TO new_owner;
  • 参数说明 name 将要修改的序列名称。 IF EXISTS 当序列不存在时使用该选项,不会显示ERROR,而是返回一个NOTICE信息。 MAXVALUE maxvalue | NO MAXVALUE | NOMAXVALUE 执行序列的最大值。新修改的最大值必须大于当前的last_value;如果没有指定,将保持旧的最大值。 取值范围:(last_value, 263-1] ,使用LARGE标识时则为(last_value, 2127-1]。 CACHE 为了快速访问,而在内存中预先存储序列号的个数。如果没有指定,将保持旧的缓冲值。 取值范围:[1, 2^63-1] ,使用LARGE标识时则为:[1, 2127-1]。 OWNED BY 将序列和一个表的指定字段进行关联。这样,在删除该字段或其所在表的时候会自动删除已关联的序列。 如果序列已经和表有关联后,使用这个选项后新的关联关系会覆盖旧的关联。 关联的表和序列的所有者必须是同一个用户,并且在同一个模式中。 使用OWNED BY NONE将删除任何已经存在的关联。 new_owner 序列新所有者的用户名。用户要修改序列的所有者,必须是新角色的直接或者间接成员,并且该角色必须有序列所在模式上的CREATE权限。
  • 示例 --创建一个名为serial的递增序列,从101开始。 gaussdb=# CREATE SEQUENCE serial START 101; --创建一个表,定义默认值。 gaussdb=# CREATE TABLE t1(c1 bigint default nextval('serial')); --将序列serial的归属列变为t1.c1。 gaussdb=# ALTER SEQUENCE serial OWNED BY t1.c1; --删除序列和表。 gaussdb=# DROP SEQUENCE serial CASCADE; gaussdb=# DROP TABLE t1; --创建一个序列seq_test。 gaussdb=# CREATE SEQUENCE seq_test; --查询序列信息。 gaussdb=# \ds List of relations Schema | Name | Type | Owner | Storage --------+----------+----------+-------+--------- public | seq_test | sequence | omm | (1 row) --创建用户u_test并修改序列所有者。 gaussdb=# CREATE USER u_test PASSWORD '********'; gaussdb=# ALTER SEQUENCE seq_test OWNER TO u_test; gaussdb=# \ds List of relations Schema | Name | Type | Owner | Storage --------+----------+----------+--------+--------- public | seq_test | sequence | u_test | (1 row) --删除用户和序列。 gaussdb=# DROP SEQUENCE seq_test; gaussdb=# DROP USER u_test;
  • track_thread_wait_status_interval 参数说明:用来定期收集thread状态信息的时间间隔。该参数可在PDB级别设置。 参数类型:整型 参数单位:分钟(min) 取值范围:0 ~ 1440 默认值:30。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。例如,设置为100,不带单位,表示100min;设置为1d,带单位,表示1d。取值如果要带单位,必须为min、h、d。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • enable_save_datachanged_timestamp 参数说明:确定是否收集insert/update/delete、exchange/truncate/drop partition操作对表数据改动的时间。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示允许收集相关操作对表数据改动的时间。 off:表示禁止收集相关操作对表数据改动的时间。 默认值:on。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • update_process_title 参数说明:控制是否收集每次服务器因接收到一个新的SQL语句而产生的线程名称更新的统计数据。 线程名称可以通过ps命令进行查看。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启收集功能。 off:表示关闭收集功能。 默认值:off 设置方式:该参数属于INTERNAL类型参数,为固定参数,用户无法修改此参数,只能查看。 设置建议:该参数不允许用户进行设置,只能查看。 设置不当的风险与影响:无
  • stats_temp_directory 参数说明:设置存储临时统计数据的目录,仅sysadmin用户可以访问。 将该参数设置为一个基于 RAM 的文件系统目录会减少实际的I/O开销并提升其性能。 参数类型:字符串 参数单位:无 取值范围:合法的目录。 默认值:"pg_stat_tmp" 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • enable_plan_trace 参数说明:控制数据库是否开启plan trace特性,该参数不能使用gs_guc命令进行全局设置,只能在连接的session中使用set命令进行设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启plan trace特性。 off:表示关闭plan trace特性。 默认值:off 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • track_sql_count 参数说明:控制是否对每个会话中当前正在执行的SELECT、INSERT、UPDATE、DELETE、MERGE INTO语句进行计数。该参数可在PDB级别设置。 在x86架构集中式部署下,硬件配置规格为32核CPU/256GB内存,使用Benchmark SQL 5.0工具测试性能,开关此参数性能影响约0.8%。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启计数功能。 off:表示关闭计数功能。 默认值:on。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。 track_sql_count参数受track_activities约束: track_activities开启而track_sql_count关闭时,如果查询了gs_sql_count视图,日志中将会有WARNING提示track_sql_count是关闭的; track_activities和track_sql_count同时关闭时,那么此时日志中将会有两条WARNING,分别提示track_activities是关闭的和track_sql_count是关闭的; track_activities关闭而track_sql_count开启时,此时日志中将仅有WARNING提示track_activities是关闭的。 当参数关闭时,查询视图的结果为0行。
  • track_activity_query_size 参数说明:用于跟踪每一个活动会话中当前正在执行命令的字节数。如果实际命令字节数大于该值,会进行截断。 参数类型:整型 参数单位:字节(byte) 取值范围:100 ~ 102400 默认值:1024 设置方式:该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。 设置建议:根据实际业务场景进行设置。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • track_io_timing 参数说明:控制是否收集数据库I/O调用时序的统计数据。I/O时序统计数据可以在pg_stat_database中查询。开启该参数时,收集器会在当前时间重复查询操作系统的信息,这可能会引起某些平台的重大开销,故默认值设置为off。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启收集功能。 off:表示关闭收集功能。 默认值:off。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • track_functions 参数说明:控制是否收集函数的调用次数和调用耗时的统计数据。该参数可在PDB级别设置。 当SQL语言函数设置为调用查询的“内联”函数时,不管是否开启该参数,这些SQL语言函数都无法被追踪到。 参数类型:枚举类型 参数单位:无 取值范围: pl:表示只追踪过程语言函数。 all:表示追踪SQL语言函数。 none:表示关闭函数追踪功能。 默认值:none。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • track_counts 参数说明:控制是否收集数据库活动的统计数据。该参数可在PDB级别设置。在AutoVacuum自动清理线程中选择清理的数据库时,需要数据库的统计数据,故默认值设置为on。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启收集功能。 off:表示关闭收集功能。 默认值:on。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:该参数设置为off会影响存储引擎空间回收能力,导致空间膨胀。
共100000条