华为云用户手册

  • minimum_pool_size 参数说明:Pooler连接自动清理功能使用,表示自动清理后各pooler连接池对应节点的连接数最小剩余量。 参数类型:整型 参数单位:无 取值范围:1 ~ 65535 默认值:50 设置方式:该参数属于USERSET类型参数,请参考表2中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:配置过大,会减少pooler连接池中空闲连接的清理数量,降低回收速率;配置过小,会增大清理数量,导致业务频繁建立连接,对性能有一定损耗。
  • max_pool_size 参数说明:CN的连接池与其它某个CN/DN的最大连接数,当集群规模有变化,如增加节点、减少节点时,可能需要调整该参数。 参数类型:整型 参数单位:无 取值范围:1 ~ 65535 默认值: 独立部署: 32768(60核CPU/480G内存);16384(32核CPU/256G内存);8192(16核CPU/128G内存);4096(8核CPU/64G内存);2048(4核CPU/32G内存);1000(4核CPU/16G内存) 设置方式:该参数属于POSTMASTER类型参数,请参考表2中对应设置方法进行设置。 设置建议:按照不同实例规格下的默认值进行设置,该参数值需要大于max_connections,调整时需预留内部线程所消耗的连接。 设置不当的风险与影响:当业务并发高时,会消耗连接池中CN至其他CN/DN的连接,如果该参数配置过小,连接数达到上限时会产生报错,导致业务失败。由于CN启动时,会根据参数值提前申请内存,所以当该参数值变大,系统会消耗更多内存资源,但总体来说对CN内存影响不大。
  • max_datanodes 参数说明:集群中DN的最大数目,当集群规模有变化,如增加节点、减少节点时,可能需要调整该参数。扩容时,请确保此参数值大于需要扩容到的集群中DN总分片数,否则会导致扩容失败。缩容时,若此参数值偏大,CN启动时会消耗更多的内存资源,但总体来说对CN内存影响不大。 参数类型:整型 参数单位:无 取值范围:2 ~ 65535 默认值:256 设置方式:该参数属于POSTMASTER类型参数,不建议修改此参数,若需修改,请参考表2中对应设置方法进行设置。 设置建议:按照集群的实际规格进行设置。 设置不当的风险与影响:该参数小于集群当前DN个数时,会导致节点创建失败。由于CN启动时,会根据参数值提前申请内存,所以当该参数值变大,系统会消耗更多内存资源,但总体来说对CN内存影响不大。
  • cache_connection 参数说明:是否回收连接池的连接。 参数类型:布尔型 参数单位:无 取值范围: on:表示回收连接池的连接。 off:表示不回收连接池的连接。 默认值:on 设置方式:该参数属于SIGHUP类型参数,请参考表2中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:关闭该参数后,会话执行语句结束后会直接清理掉持有的连接,导致业务频繁建立连接,对性能有一定损耗。开启该参数后,在多库场景下,当内存规格较小并且连接数max_connections配置较大时,可能会导致内存不足,DN无法启动。
  • pooler_port 参数说明:cm_agent、cm_ctl等内部工具运维管理端口,初始化用户或系统管理员通过客户端连接数据库所使用端口。 参数类型:整型 参数单位:无 取值范围:1 ~ 65535。 默认值:不依赖OM组件安装且未指定该GUC参数,默认值是6667。依赖OM组件安装时,若指定port值,该参数值为port+1;若未指定port值,CN实例该参数默认值为8001,DN实例该参数默认值为40001。 设置方式:该参数属于POSTMASTER类型参数,请参考表2中对应设置方法进行设置。 设置建议:一般为集群安装配置设置的值,不建议修改。 设置不当的风险与影响:修改此参数,很可能导致端口号冲突或被拦截,导致数据库通信失败。
  • pooler_maximum_idle_time 参数说明:Pooler连接自动清理功能使用,当连接池中连接空闲时间超过所设置值时,会触发自动清理机制,清理各节点的空闲连接数到minimum_pool_size。 参数类型:整型 参数单位:秒(s) 取值范围:0 ~ 2147483647 默认值:600(即10min) 设置方式:该参数属于USERSET类型参数,请参考表2中对应设置方法进行设置。例如,设置为100,不带单位,表示100s;设置为20min,带单位,表示20min。取值如果要带单位,必须为s、min、h、d。 设置建议:推荐使用默认值。 设置不当的风险与影响:配置过大,会降低pooler连接池中空闲连接的清理频率,降低回收速率;配置过小,会提高清理频率,导致业务频繁建立连接,对性能有一定损耗。
  • persistent_datanode_connections 参数说明:会话是否会释放获得的连接。 参数类型:布尔型 参数单位:无 取值范围: on:表示不会释放获得的连接。 off:表示会释放获得的连接。 默认值:off 设置方式:该参数属于BACKEND类型参数,请参考表2中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:开启该参数后,会存在会话持有连接但并未运行查询的情况,导致其他查询申请不到连接报错。
  • max_coordinators 参数说明:集群中CN的最大数目,当集群规模有变化,如增加节点、减少节点时,可能需要调整该参数。扩容时,请确保此参数值大于需要扩容到的集群中CN的个数,否则会导致扩容失败。缩容时,若此参数值偏大,CN启动时会消耗更多的内存资源,但总体来说对CN内存影响不大。 参数类型:整型 参数单位:无 取值范围:2 ~ 1024 默认值:128 设置方式:该参数属于POSTMASTER类型参数,不建议修改此参数,若需修改,请参考表2中对应设置方法进行设置。 设置建议:按照集群的实际规格进行设置。 设置不当的风险与影响:该参数小于集群当前CN个数时,会导致节点创建失败。由于CN启动时,会根据参数值提前申请内存,所以当该参数值变大,系统会消耗更多内存资源,但总体来说对CN内存影响不大。
  • enable_force_reuse_connections 参数说明:会话是否强制重用新的连接。 参数类型:布尔型 参数单位:无 取值范围: on:表示强制使用新连接。 off:表示使用现有连接。 默认值:off 设置方式:该参数属于BACKEND类型参数,请参考表2中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:开启该参数后,每次执行语句前,会对已持有的连接强制发送reset参数的动作,对性能有一定损耗。
  • pooler_connect_interval_time 参数说明:该参数由pooler建立连接重试功能使用,当参数pooler_connect_max_loops设置大于1时,该参数可以控制不同重试轮数之间执行时间间隔。参数设置方面,建议略大于当前集群主备切换恢复时间。 参数类型:整型 参数单位:秒(s) 取值范围:0 ~ 7200 默认值:15 设置方式:该参数属于USERSET类型参数,请参考表2中对应设置方法进行设置。例如,设置为100,不带单位,表示100s;设置为20min,带单位,表示20min。取值如果要带单位,必须为s、min、h、d。 设置建议:推荐使用默认值。 设置不当的风险与影响:该参数是高可用参数,若设置过长,会导致重试周期拉长,反而降低高可用能力。
  • GLOBAL_IO_WAIT_INFO 显示所有节点I/O管控的实时统计信息,如表1所示。 表1 GLOBAL_IO_WAIT_INFO字段 名称 类型 描述 node_name text 节点名称。 device_name text 节点挂载的数据磁盘名称。 read_per_second double precision 读完成每秒次数。 write_per_second double precision 写完成每秒次数。 write_ratio double precision 写磁盘占总的I/O使用的比例。 io_util double precision 每秒I/O所占CPU总时间的百分比。 total_io_util integer 过去三次I/O所占CPU总时间的等级(取值为0~6)。 tick_count integer 更新磁盘I/O信息的周期,固定为1秒,每次读取数据前都会被清零。 io_wait_list_len integer I/O请求线程等待队列的大小,若为0,则表示当前没有I/O被管控。 父主题: Workload Manager
  • DBE_SQL_UTIL.create_abort_sql_patch create_abort_sql_patch是用于在当前建立连接的CN上创建避险SQL PATCH的接口函数,返回执行是否成功,如表1所示。 限制:仅初始用户、sysadmin、opradmin和monadmin用户有权限调用。 CN之间SQL PATCH不共享,要在各个CN上单独创建。 开启负载均衡场景或者需要指定创建的CN的场景,推荐使用DBE_SQL_UTIL.create_remote_abort_sql_patch接口进行创建。 表1 DBE_SQL_UTIL.create_abort_sql_patch入参和返回值列表 参数 类型 描述 patch_name IN name PATCH名称。 unique_sql_id IN bigint 查询全局唯一id。 description IN text PATCH的备注,默认值为NULL。 enabled IN bool PATCH是否生效,默认值为true。 result OUT bool 执行是否成功。 父主题: DBE_SQL_UTIL Schema
  • global_streaming_hadr_rto_and_rpo_stat global_streaming_hadr_rto_and_rpo_stat视图显示流式容灾的主集群和备集群日志流控信息(只可在主集群的CN使用,DN以及备集群上均不可获取到统计信息),如表1所示。 表1 global_streaming_hadr_rto_and_rpo_stat参数说明 参数 类型 描述 hadr_sender_node_name text 节点的名称,包含主集群和备集群首备。 hadr_receiver_node_name text 备集群首备名称。 current_rto int 流控的信息,当前主备集群的日志rto时间(单位:秒)。-1标识灾备集群多数派异常。 target_rto int 流控的信息,目标主备集群间的rto时间(单位:秒)。 current_rpo int 流控的信息,当前主备集群的日志rpo时间(单位:秒)。-1标识灾备集群多数派异常。 target_rpo int 流控的信息,目标主备集群间的rpo时间(单位:秒)。 rto_sleep_time int RTO流控信息,为了达到目标RTO,预期主机walsender所需要的睡眠时间(单位:微秒)。 rpo_sleep_time int RPO流控信息,为了达到目标RPO,预期主机xlogInsert所需要的睡眠时间(单位:微秒)。 父主题: RTO & RPO
  • DBE_SQL_UTIL.disable_sql_patch disable_sql_patch是用于在当前建立连接的CN上禁用SQL PATCH的接口函数,返回执行是否成功,如表1所示。 限制:仅初始用户、sysadmin、opradmin和monadmin用户有权限调用。 CN之间SQL PATCH不共享,要在各个CN上单独执行。 开启负载均衡场景或者需要指定创建的CN的场景,推荐使用DBE_SQL_UTIL.disable_remote_sql_patch接口进行禁用操作。 表1 DBE_SQL_UTIL.disable_sql_patch入参和返回值列表 参数 类型 描述 patch_name IN name PATCH名称。 result OUT bool 执行是否成功。 父主题: DBE_SQL_UTIL Schema
  • DBE_PLDEBUGGER.info_code debug端调试过程中,调用info_code,查看指定存储过程的源语句和各行对应的行号,行号从函数体开始,函数头部分行号为空,如表1所示。 表1 info_code入参和返回值列表 名称 类型 描述 funcoid IN oid 函数id。 lineno OUT integer 行号。 query OUT text 源语句。 canbreak OUT bool 当前行是否支持断点。 父主题: DBE_PLDEBUGGER Schema
  • DBE_PLDEBUGGER.turn_on 该函数用于标记某一存储过程为可调试,执行turn_on后server端可以执行该存储过程来进行调试,如表1所示。需要用户根据系统表PG_PROC手动获取存储过程oid,传入函数中。turn_on后本session内执行该存储过程会停在第一条sql前等待debug端的调试操作。该设置会在session断连后默认被清理掉。目前不支持对启用自治事务的存储过程/函数进行调试。同时turn_on的存储过程不超过100个。 函数原型为: 12 DBE_PLDEBUGGER.turn_on(Oid)RETURN Record; 表1 turn_on入参和返回值列表 名称 类型 描述 func_oid IN oid 函数oid nodename OUT text 节点名称 port OUT integer 连接端口号 父主题: DBE_PLDEBUGGER Schema
  • DBE_PLDEBUGGER.finish 执行存储过程中当前的SQL直到下一个断点触发或执行到上层栈的下一行,如表1所示。 表1 finish入参和返回值列表 名称 类型 描述 funcoid OUT oid 函数id。 funcname OUT text 函数名。 lineno OUT integer 当前调试运行的下一行行号。 query OUT text 当前调试的下一行函数源码。 父主题: DBE_PLDEBUGGER Schema
  • 如何创建自动递增列? 答: GaussDB数据库 支持创建自动递增列,您可以在创建表时,指定SERIAL数据类型。 示例: gaussdb=# CREATE TABLE table_name(id serial, name varchar(20)); 也可以使用如下方式: --创建序列。gaussdb=# CREATE SEQUENCE tbl_person_id_seq;--创建表tbl_persion,其中id字段依据序列tbl_person_id_seq实现自增。gaussdb=# CREATE TABLE tbl_persion( id int NOT NULL DEFAULT nextval('tbl_person_id_seq'::regclass), name varchar(20)); 父主题: FAQ
  • DBE_PLDEBUGGER.step debug端调试过程中,如果当前执行的是一个存储过程,则进入该存储过程继续调试,返回该存储过程第一行的行号等信息,如果当前执行的不是存储过程,则和next行为一致,执行该sql后返回下一行的行号等信息,如表1所示。 表1 step入参和返回值列表 名称 类型 描述 funcoid OUT oid 函数id。 funcname OUT text 函数名。 lineno OUT integer 当前调试运行的下一行行号。 query OUT text 当前调试的下一行函数源码。 父主题: DBE_PLDEBUGGER Schema
  • GS_ LOG ICAL_INDEX GS_LOGICAL_INDEX系统表存储了索引的部分信息,其他的信息存储在GS_LOGICAL_CLASS系统表中。 表1 GS_LOGICAL_INDEX字段 字段名称 字段类型 说明 indexrelid Oid 索引的OID。 indrelid Oid 它所引用的RELATION OID。 indnatts smallint 索引中的总列数。 indisunique boolean 是否是唯一索引。 indisprimary boolean 这个索引是否为主键。 csnmin bigint 插入元组时的 CS N(提交序列号)。 csnmax bigint 更新或删除元组时的 CSN。 createtime timestamp with time zone 插入元组的时间戳。 originid integer 元组的来源标识符。 dbnode oid 数据库OID。 indimmediate boolean 是否立即执行唯一性约束。 indisvalid boolean 此索引是否可用于查询。 indisready boolean 此索引是否准备好接受插入。 indisusable boolean 此索引是否可用于插入和选择。 indkey int2vector 索引列的列编号。 indcollation oidvector 排序标识符。 indpred pg_node_tree 如果是部分索引,则为谓词的表达式树;否则为 NULL。 indisreplident boolean 索引是否被标识为复制标识索引。 父主题: 逻辑解码
  • 向量化引擎支持的数据类型 向量化引擎支持的数据类型如表1所示。 表1 向量化引擎支持的数据类型 类别 数据类型 长度 是否支持 Numeric Types tinyint [unsigned] 1 支持 smallint [unsigned] 2 支持 mediumint [unsigned] 3 支持 integer [unsigned] 4 支持 bigint [unsigned] 8 支持 decimal -1 支持 numeric -1 支持 real 4 支持 double precision 8 支持 smallserial 2 支持 serial 4 支持 bigserial 8 支持 largeserial -1 支持 Monetary Types money 8 支持 Boolean Types boolean 1 支持 Character Types character varying(n), varchar(n) -1 支持 character(n), char(n),nchar(n) n 支持 character、char 1 支持 text -1 支持 varchar2(n) -1 支持 nvarchar2(n) -1 支持 clob -1 支持 Binary Types blob -1 不支持 raw -1 支持 bytea -1 支持 Bit String Types bit(n) n 支持 bit varying(n) -1 支持 Date/Time Types timestamp with time zone 8 支持 timestamp without time zone 8 支持 date 4 支持 time without time zone 8 支持 time with time zone 12 支持 interval 16 支持 Network Address Types cidr 7 or 19 支持 inet 7 or 19 支持 macaddr 6 不支持 XML Types xml -1 支持 Other Types enum enum 类型由若干个标签构成的列表,每一个标签值都是一个非空字符串,且字符串长度必须不超过63个字节。 支持 ... ... 不支持 enum类型当前仅支持如下方式创建,详情请参见CREATE TYPE。 CREATE TYPE name AS ENUM (['label' [, ...]]); 父主题: 数据类型
  • GS_LOGICAL_NAMESPACE GS_LOGICAL_NAMESPACE系统表存储名称空间相关的信息。 表1 GS_LOGICAL_NAMESPACE字段 字段名称 字段类型 说明 nspid oid 命名空间的OID。 nspname name 命名空间名称。 nspowner oid 命名空间所有者的OID。 nsptimeline bigint 命名空间的时间线标识符。 csnmin bigint 插入元组时的 CSN(提交序列号)。 csnmax bigint 更新或删除元组时的 CSN。 createtime timestamp with time zone 插入元组的时间戳。 originid integer 元组的来源标识符。 dbnode oid 数据库OID。 父主题: 逻辑解码
  • GLOBAL_SESSION_SQL_MEMORY GLOBAL_SESSION_SQL_MEMORY视图显示当前用户在各个节点上正在执行的语句的内存使用量,如表1所示。 表1 GLOBAL_SESSION_SQL_MEMORY字段 名称 类型 描述 node_name text 当前集群下的节点名称。 pid bigint 线程ID。 sessionid bigint 会话ID。 unique_sql_id bigint 语句的unique sql id。 query_id bigint 语句的debug query id。 query text 该会话当前运行语句。 peak_used_memory integer 该语句内存使用峰值(单位:MB)。 current_used_memory integer 该语句当前内存使用值(单位:MB)。 父主题: Query
  • DBE_PLDEVELOPER.gs_source 用于记录PL/SQL对象(存储过程、函数、包、包体)相关信息,如表1所示。 gs_source表中只记录用户定义的原始对象语句,即使用户使用了ALTER改变了创建的SCHEMA或者名字,gs_source表中的信息也不会发生变化,如果用户更改了对象的SCHEMA或者名字,用户在删除对象后,对象会从gs_source表中被删除。 gs_source表中的owner表示创建的用户,不是用户创建存储过程或package时指定的用户。 设置GUC参数behavior_compat_options="skip_insert_gs_source"后,PL/SQL对象(存储过程、函数、包、包体)相关信息将不在gs_source中记录。 gs_source权限与pg_catalog下的系统表保持一致(系统管理员与普通用户不允许DROP、ALTER、DELETE、UPDATE、INSERT,允许SELECT),利用GUC参数allow_system_table_mods控制操作gs_source的权限,此GUC参数默认为off,修改此GUC参数生效需要重启数据库。 数据库默认情况下没有对gs_source表中设置行级访问控制,如果用户需要使用数据库隔离性特性,请使用如下语句进行添加行级访问控制: ALTER TABLE dbe_pldeveloper.gs_source ENABLE ROW LEVEL SECURITY;CREATE ROW LEVEL SECURITY POLICY all_data_rls ON dbe_pldeveloper.gs_source USING(owner = (SELECT oid FROM gs_roles WHERE rolname=current_user)); 表1 DBE_PLDEVELOPER.gs_source字段 名称 类型 描述 id oid 对象id。 owner bigint 对象创建用户id。 nspid oid 对象的模式id。 name name 对象名。 type text 对象类型(procedure/function/package/package body)。 status boolean 是否创建成功。 src text 对象创建的原始语句。 父主题: DBE_PLDEVELOPER
  • SUMMARY_STATIO_ALL_SEQUEN CES SUMMARY_STATIO_ALL_SEQUENCES视图包含集群内汇聚的数据库中每个序列的每一行,显示特定序列关于I/O的统计,如表1所示。 表1 SUMMARY_STATIO_ALL_SEQUENCES字段 名称 类型 描述 schemaname name 序列中模式名。 relname name 序列名。 blks_read numeric 从序列中读取的磁盘块数。 blks_hit numeric 序列中缓存命中数。 父主题: Cache/IO
  • GLOBAL_COMM_DELAY GLOBAL_COMM_DELAY视图展示所有DN的TCP代理通信库时延状态,如表1所示。 表1 GLOBAL_COMM_DELAY字段 名称 类型 描述 node_name text 节点名称。 remote_name text 连接对端节点名称。 remote_host text 连接对端IP地址。 stream_num integer 当前物理连接使用的stream逻辑连接数量。 min_delay integer 当前物理连接一分钟内探测到的最小时延(单位:微秒)。 说明: 负数结果无效,请重新等待时延状态更新后再执行。 average integer 当前物理连接一分钟内探测时延的平均值(单位:微秒)。 max_delay integer 当前物理连接一分钟内探测到的最大时延(单位:微秒)。 父主题: Comm
  • GLOBAL_RECORD_RESET_TIME GLOBAL_RECORD_RESET_TIME用于获取集群中各节点的“重置(重启,主备倒换,数据库删除)时间”的统计信息,如表1所示。 表1 GLOBAL_RECORD_RESET_TIME字段 名称 类型 描述 node_name text 节点名称。 reset_time timestamp with time zone 重置时间点。 父主题: Utility
  • POOLER_STATUS POOLER_STATUS视图用于查询本地CN 的pooler中的缓存连接状态,如表1所示。 表1 POOLER_STATUS字段 名称 类型 描述 database text 数据库名称。 user_name text 用户名。 tid bigint 非线程池逻辑下为连接CN的线程id,线程池逻辑下为连接CN的sessionid。 node_oid bigint 连接的实例节点OID。 node_name name 连接的实例节点名称。 in_use boolean 连接是否正被使用: t(true):表示连接正在使用。 f(false):表示连接没有使用。 local_host text 本端IP。 local_port bigint 本端端口号。 remote_host text 连接的节点IP。 node_port bigint 连接的节点端口。 fdsock bigint 端口文件描述符。 remote_pid bigint 对端处于非线程池逻辑下为对端的线程id,对端处于线程池逻辑下为对端的sessionid。 session_params text 会话参数。 used_count bigint 该连接的复用次数。 idx bigint 连接的实例节点逻辑连接id。 streamid bigint 每个逻辑连接对应的流标识id。 父主题: Utility
  • GLOBAL_RECOVERY_STATUS GLOBAL_RECOVERY_STATUS视图显示关于主机和备机的日志流控信息,如表1所示。 表1 GLOBAL_RECOVERY_STATUS字段 名称 类型 描述 node_name text 节点的名称,包含主机和备机。 standby_node_name text 备机节点的名称。 source_ip text 主机的IP地址。 source_port integer 主机的端口号。 dest_ip text 备机的IP地址。 dest_port integer 备机的端口号。 current_rto bigint 备机当前的日志流控时间,单位秒。 target_rto bigint 备机通过GUC参数设置的预期流控时间,单位秒。 current_sleep_time bigint 为了达到此RTO预期,主机所需要执行的睡眠时间,单位微秒。 父主题: Utility
  • USER_LOGIN USER_LOGIN用来记录用户登录和退出次数的相关信息,如表1所示。 表1 USER_LOGIN字段 名称 类型 描述 node_name text 节点名称。 user_name text 用户名称。 user_id integer 用户oid(同pg_authid中的oid字段)。 login_counter bigint 登录次数。 logout_counter bigint 退出次数。 dbid oid 用户登录的数据库id。 父主题: Utility
共99354条