华为云用户手册

tcp_user_timeout 参数说明：在支持TCP_USER_TIMEOUT套接字选项的操作系统上，设置 GaussDB 在发送数据时，指定传输的数据在TCP连接被强制关闭之前可以保持未确认状态的最大时长。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 如果操作系统不支持TCP_USER_TIMEOUT选项，这个参数的值将不生效，默认为0。 在通过UNIX域套接字进行连接的操作系统上，这个参数将被忽略。 取值范围：0-3600000，单位为ms。其中0表示跟随操作系统设置。 默认值：0 注意，不同操作系统内核下，这个参数生效结果将不同： aarch64 EulerOS（Linux内核版本：4.19），超时时间即为该参数设置值。 x86 Euler2.5（Linux内核版本：3.10），超时时间不是该参数设置值，而是不同区间的最大值，即超时时间取值为：tcp_user_timeout设置值所处“Linux TCP重传总耗时”区间的上限最大值。例如：tcp_user_timeout=40000时，重传总耗时为51秒。 表1 x86 Euler2.5（Linux内核版本：3.10）tcp_user_timeout参数取值示意 Linux TCP重传次数 Linux TCP重传总耗时区间（秒） tcp_user_timeout设置举例（毫秒） 实际Linux TCP重传总耗时（秒） 1 (0.2,0.6] 400 0.6 2 (0.6,1.4] 1000 1.4 3 (1.4,3] 2000 3 4 (3,6.2] 4000 6.2 5 (6.2,12.6] 10000 12.6 6 (12.6,25.4] 20000 25.4 7 (25.4,51] 40000 51 8 (51,102.2] 80000 102.2 9 (102.2,204.6] 150000 204.6 10 (204.6,324.6] 260000 324.6 11 (324.6,444.6] 400000 444.6 注：TCP每次重传耗时随重传次数指数增加，当TCP一次重传到达120秒后，后续每次重传都将耗时120秒不再变化。

tcp_keepalives_count 参数说明：在支持TCP_KEEPCNT套接字选项的操作系统上，设置GaussDB服务端在断开与客户端连接之前可以等待的保持活跃信号个数。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 如果操作系统不支持TCP_KEEPCNT选项，这个参数的值必须为0。 在通过UNIX域套接字进行连接的操作系统上，这个参数将被忽略。 将该值设置为0时，将使用系统的值。 该参数在不同的会话之间不共享，也就是说不同的会话连接可能有不同的值。 查看该参数时查出来的是当前会话连接内的参数值，而不是GUC副本的值。 取值范围：0-100，其中0表示GaussDB未收到客户端反馈的保持活跃信号则立即断开连接。 默认值：20

comm_proxy_attr 参数说明：通信代理库相关参数配置。 该参数仅支持欧拉2.9系统下的集中式ARM单机。 本功能在线程池开启状态下生效，即enable_thread_pool为on。 配置该参数时需同步配置GUC参数local_bind_address为libos_kni的网卡IP。 参数模板：comm_proxy_attr = '{enable_libnet:true, enable_dfx:false, numa_num:4, numa_bind:[[30,31],[62,63],[94,95],[126,127]]}' 可配置参数说明。 enable_libnet：是否开启用户态协议，取值范围：true、false。 enable_dfx：是否开启通信代理库视图，取值范围：true、false。 numa_num：机器环境中numa的数量，支持2P、4P服务器，取值范围：4、8。 numa_bind：代理线程绑核参数，每个numa两个CPU绑核，共numa_num组，取值范围：[0，cpu数-1]。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串，长度大于0。 默认值：'none'

tcp_keepalives_idle 参数说明：在支持TCP_KEEPIDLE套接字选项的系统上，设置发送活跃信号的间隔秒数。不设置发送保持活跃信号，连接就会处于闲置状态。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 如果操作系统不支持TCP_KEEPIDLE选项 ，这个参数的值必须为0。 在通过UNIX域套接字进行的连接的操作系统上，这个参数将被忽略。 将该值设置为0时，将使用系统的值。 该参数在不同的会话之间不共享，也就是说不同的会话连接可能有不同的值。 查看该参数时查出来的是当前会话连接内的参数值，而不是GUC副本的值。 取值范围：0-3600，单位为s。 默认值：60

tcp_keepalives_interval 参数说明：在支持TCP_KEEPINTVL套接字选项的操作系统上，以秒数声明在重新传输之间等待响应的时间。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：0-180，单位为s。 默认值： 如果操作系统不支持TCP_KEEPINTVL选项，这个参数的值必须为0。 在通过UNIX域套接字进行的连接的操作系统上，这个参数将被忽略。 将该值设置为0时，将使用系统的值。 该参数在不同的会话之间不共享，也就是说不同的会话连接可能有不同的值。 查看该参数时查出来的是当前会话连接内的参数值，而不是GUC副本的值。

enable_default_cfunc_libpath 参数说明：设置GaussDB创建C函数时的so文件是否使用默认路径。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on：代表创建C函数时，so文件必须放在指定的目录（$libdir/proc_srclib）下。 off：代表创建C函数时，so文件可以放在任意可访问的目录下。 默认值：on 参数设置成off时，.so文件可以放在任意可访问的目录下或使用系统自带的.so，存在安全风险，不建议使用。

操作步骤 连接数据库。 查看数据库运行参数当前取值。 方法一：使用SHOW命令。 使用如下命令查看单个参数： 1 gaussdb=# SHOW server_version; server_version显示数据库版本信息的参数。 使用如下命令查看所有参数： 1 gaussdb=# SHOW ALL; 方法二：使用pg_settings视图。 使用如下命令查看单个参数： 1 gaussdb=# SELECT * FROM pg_settings WHERE NAME='server_version'; 使用如下命令查看所有参数： 1 gaussdb=# SELECT * FROM pg_settings;

DBE_SQL_UTIL.create_abort_sql_patch create_abort_sql_patch是用于创建避险SQL PATCH的接口函数，返回执行是否成功。本函数是原函数的重载函数，支持通过parent_unique_sql_id值限制abort patch的生效范围。 限制仅初始用户、sysadmin、opradmin、monadmin用户有权限调用。 表1 DBE_SQL_UTIL.create_abort_sql_patch重载函数入参和返回值列表 参数 类型 描述 patch_name IN name PATCH名称。 unique_sql_id IN bigint 查询全局唯一ID。 parent_unique_sql_id IN bigint 标识外层SQL语句的全局唯一ID，值为0时表示限制存储过程外语句SQL PATCH生效；非0值表示限制特定存储过程生效。 description IN text PATCH的备注，默认值为NULL。 enabled IN bool PATCH是否生效，默认值为true。 result OUT bool 执行是否成功。 父主题： DBE_SQL_UTIL Schema

DBE_SQL_UTIL.create_hint_sql_patch create_hint_sql_patch是用于创建调优SQL PATCH的接口函数，返回执行是否成功。本函数是原函数的重载函数，支持通过parent_unique_sql_id值限制hint patch的生效范围。 限制仅初始用户、sysadmin、opradmin、monadmin用户有权限调用。 表1 DBE_SQL_UTIL.create_hint_sql_patch重载函数入参和返回值列表 参数 类型 描述 patch_name IN name PATCH名称。 unique_sql_id IN bigint 查询全局唯一ID。 parent_unique_sql_id IN bigint 标识外层SQL语句的全局唯一ID，值为0时表示限制存储过程外语句SQL PATCH生效；非0值表示限制特定存储过程生效。 hint_string IN text Hint文本。 description IN text PATCH的备注，默认值为NULL。 enabled IN bool PATCH是否生效，默认值为true。 result OUT bool 执行是否成功。 父主题： DBE_SQL_UTIL Schema

DBE_SQL_UTIL.show_sql_patch show_sql_patch是用于显示给定patch_name对应的SQL PATCH的接口函数，返回运行结果。 限制仅初始用户、sysadmin、opradmin、monadmin用户有权限调用。 表1 DBE_SQL_UTIL.show_sql_patch入参和返回值列表 参数 类型 描述 patch_name IN name PATCH名称。 unique_sql_id OUT bigint 查询全局唯一ID。 enabled OUT bool PATCH是否生效。 abort OUT bool 是否是AbortHint。 hint_str OUT text Hint文本。 父主题： DBE_SQL_UTIL Schema

DBE_SQL_UTIL.disable_sql_patch disable_sql_patch是用于禁用SQL PATCH的接口函数，返回执行是否成功。 限制仅初始用户、sysadmin、opradmin、monadmin用户有权限调用。 表1 DBE_SQL_UTIL.disable_sql_patch入参和返回值列表 参数 类型 描述 patch_name IN name PATCH名称。 result OUT bool 执行是否成功。 父主题： DBE_SQL_UTIL Schema

DBE_SQL_UTIL.enable_sql_patch enable_sql_patch是用于开启SQL PATCH的接口函数，返回执行是否成功。 限制仅初始用户、sysadmin、opradmin、monadmin用户有权限调用。 表1 DBE_SQL_UTIL.enable_sql_patch入参和返回值列表 参数 类型 描述 patch_name IN name PATCH名称。 result OUT bool 执行是否成功。 父主题： DBE_SQL_UTIL Schema

DBE_SQL_UTIL.drop_sql_patch drop_sql_patch是用于删除SQL PATCH的接口函数，返回执行是否成功。 限制仅初始用户、sysadmin、opradmin、monadmin用户有权限调用。 表1 DBE_SQL_UTIL.drop_sql_patch入参和返回值列表 参数 类型 描述 patch_name IN name PATCH名称。 result OUT bool 执行是否成功。 父主题： DBE_SQL_UTIL Schema

DBE_SQL_UTIL.create_abort_sql_patch create_abort_sql_patch是用于创建避险SQL PATCH的接口函数，返回执行是否成功。 限制仅初始用户、sysadmin、opradmin、monadmin用户有权限调用。 表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

DBE_SQL_UTIL.create_hint_sql_patch create_hint_sql_patch是用于创建调优SQL PATCH的接口函数，返回执行是否成功。 限制仅初始用户、sysadmin、opradmin、monadmin用户有权限调用。 表1 DBE_SQL_UTIL.create_hint_sql_patch入参和返回值列表 参数 类型 描述 patch_name IN name PATCH名称。 unique_sql_id IN bigint 查询全局唯一ID。 hint_string IN text Hint文本。 description IN text PATCH的备注，默认值为NULL。 enabled IN bool PATCH是否生效，默认值为true。 result OUT bool 执行是否成功。 父主题： DBE_SQL_UTIL Schema

DBE_SQL_UTIL Schema DBE_SQL_UTIL模式存储了用于管理SQL PATCH的工具，包括创建、删除、开启、禁用SQL PATCH等系统函数。普通用户只有usage权限，没有create、alter、drop、comment等权限。 DBE_SQL_UTIL Schema使用请参考使用SQL PATCH进行调优。 DBE_SQL_UTIL.create_hint_sql_patch DBE_SQL_UTIL.create_abort_sql_patch DBE_SQL_UTIL.drop_sql_patch DBE_SQL_UTIL.enable_sql_patch DBE_SQL_UTIL.disable_sql_patch DBE_SQL_UTIL.show_sql_patch DBE_SQL_UTIL.create_hint_sql_patch DBE_SQL_UTIL.create_abort_sql_patch 父主题： Schema

DBE_PLDEVELOPER.gs_errors 用于记录PL/SQL对象（存储过程、函数、包、包体）编译过程中遇到的报错信息，具体内容见下列字段描述。 打开plsql_show_all_error参数后，如果编译过程中存在报错，则会跳过报错继续编译并把报错信息记录在gs_errors中，如果关闭plsql_show_all_error参数，且behavior_compat_options参数不为skip_insert_gs_source，则会直接将报错信息插入此表中。 该表的owner是创建的用户，修改存储过程或者package的owner不会修改该表信息。 表1 DBE_PLDEVELOPER.gs_errors字段 名称 类型 描述 id oid 对象的ID。 owner bigint 对象创建用户ID。 nspid oid 对象的模式ID。 name name 对象名。 type text 对象类型（procedure/function/package/package body）。 line integer 行号。 src text 报错信息。 创建包头时的开头（as/is之前）和结尾（end之后），如果出现错误，不会记录在gs_errors表格里面，会直接在客户端返回错误的行号和该行具体内容，返回的行号不一定准确。个别is本身和end本身错误场景也不会记录在gs_errors表格里面。 创建包体时的开头（as/is之前）和结尾（end之后），如果出现错误，不会记录在gs_errors表格里面，会直接在客户端返回错误的行号和该行具体内容，返回的行号不一定准确。个别is本身和end本身错误场景也不会记录在gs_errors表格里面。 创建包体时，函数或者存储过程的结尾（end之后），如果出现错误，不会记录在gs_errors表格里面，会直接在客户端返回错误的行号和该行具体内容，行号不一定准确。 创建包体时，函数或者存储过程的开头（as/is 以及 as/is之前）如果出现错误，报错行数不准确。 创建包头时，变量声明少分号，会记录在gs_errors表格里面，记录的报错行号不准确。开启参数不会记录。 包体内存储过程或函数内部，自治事务标识符PRAGMA AUTOMOUS_TRANSACTION声明错误时，不能确保是否能记录在gs_errors表里。 客户端直接报错，但是gs_errors表格未记录的情况，如果客户端报错行号不对，本需求不纠正原本报错的行号。 对于类似 if ....then、for....loop、when .... then 语句中间的错误或EXCEPTION本身错误，报错行号在本行，而不是下一个分号所在行。 包内存储过程或函数内部begin本身错误的场景，报错行数不准。 父主题： DBE_PLDEVELOPER

DBE_PLDEVELOPER.gs_source 用于记录PL/SQL对象（存储过程、函数、包、包体）编译相关信息，具体内容见下列字段描述。 打开plsql_show_all_error参数后，会把成功或失败的PL/SQL对象编译信息记录在此表中，如果关闭plsql_show_all_error参数则只会将正确的编译相关信息插入此表中。 gs_source表中只记录用户定义的原始对象语句，即使用户使用了ALTER改变了创建的SCHEMA或者名字，gs_source表中的信息也不会发生变化，如果用户更改了对象的SCHEMA或者名字，会导致用户在删除对象后，对象仍存在于gs_source表中。 gs_source表中的owner指创建的用户，不是用户创建存储过程或者package时指定的用户。 数据库默认情况下没有对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 pg_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

DB4AI.PURGE_SNAPSHOT_INTERNAL PURGE_SNAPSHOT_INTERNAL是DB4AI.PURGE_SNAPSHOT函数的内置执行函数。函数存在信息校验，无法直接调用 表1 DB4AI.PURGE_SNAPSHOT_INTERNAL入参和返回值列表 参数 类型 描述 i_schema IN NAME 快照存储的模式名字 i_name IN NAME 快照名称 父主题： DB4AI Schema

DB4AI.PURGE_SNAPSHOT PURGE_SNAPSHOT是DB4AI特性用于删除快照的接口函数。通过语法PURGE SNAPSHOT调用。 表1 DB4AI.PURGE_SNAPSHOT入参和返回值列表 参数 类型 描述 i_schema IN NAME 快照存储的模式名字 i_name IN NAME 快照名称 res OUT db4ai.snapshot_name 结果 父主题： DB4AI Schema

DB4AI.SAMPLE_SNAPSHOT SAMPLE_SNAPSHOT是DB4AI特性用于对基数据进行采样生成快照的接口函数。通过语法SAMPLE SNAPSHOT调用。 表1 DB4AI.SAMPLE_SNAPSHOT入参和返回值列表 参数 类型 描述 i_schema IN NAME 快照存储的模式名字 i_parent IN NAME 父快照名称 i_sample_infixes IN NAME[] 示例快照名称中缀 i_sample_ratios IN NUMBER[] 每个样本的大小，作为父集的比率 i_stratify IN NAME[] 分层策略 i_sample_comments IN TEXT[] 示例快照描述 res OUT db4ai.snapshot_name 结果 父主题： DB4AI Schema

DB4AI.MANAGE_SNAPSHOT_INTERNAL MANAGE_SNAPSHOT_INTERNAL是DB4AI.PUBLISH_SNAPSHOT和DB4AI.ARCHIVE_SNAPSHOT函数的内置执行函数。函数存在信息校验，无法直接调用。 表1 DB4AI.MANAGE_SNAPSHOT_INTERNAL入参和返回值列表 参数 类型 描述 i_schema IN NAME 快照存储的模式名字 i_name IN NAME 快照名称 publish IN BOOLEAN 是否是发布状态 res OUT db4ai.snapshot_name 结果 父主题： DB4AI Schema

DB4AI.PUBLISH_SNAPSHOT PUBLISH_SNAPSHOT是DB4AI特性用于发布快照的接口函数。通过语法PUBLISH SNAPSHOT调用。 表1 DB4AI.PUBLISH_SNAPSHOT入参和返回值列表 参数 类型 描述 i_schema IN NAME 快照存储的模式名字，默认值是当前用户或者PUBLIC i_name IN NAME 快照名称 res OUT db4ai.snapshot_name 结果 父主题： DB4AI Schema

DB4AI.ARCHIVE_SNAPSHOT ARCHIVE_SNAPSHOT是DB4AI特性用于存档快照的接口函数。通过语法ARCHIVE SNAPSHOT调用。生效后的快照无法参与训练等任务。 表1 DB4AI.ARCHIVE_SNAPSHOT入参和返回值列表 参数 类型 描述 i_schema IN NAME 快照存储的模式名字，默认值是当前用户 i_name IN NAME 快照名称 res OUT db4ai.snapshot_name 结果 父主题： DB4AI Schema

DB4AI.PREPARE_SNAPSHOT_INTERNAL PREPARE_SNAPSHOT_INTERNAL是db4ai.prepare_snapshot函数的内置执行函数。函数存在信息校验，无法直接调用。 表1 DB4AI.PREPARE_SNAPSHOT_INTERNAL入参和返回值列表 参数 类型 描述 s_id IN BIGINT 快照ID p_id IN BIGINT 父快照ID m_id IN BIGINT 矩阵id r_id IN BIGINT 根快照ID i_schema IN NAME 快照模式 i_name IN NAME 快照名称 i_commands IN TEXT[] 定义快照修改的DDL和DML命令 i_comment IN TEXT 快照描述 i_owner IN NAME 快照所有者 i_idx INOUT INT exec_cmds的索引 i_exec_cmds INOUT TEXT[] 用于执行的DDL和DML i_mapping IN NAME[] 将用户列映射到备份列；如果不为NULL，则生成规则 父主题： DB4AI Schema

DB4AI.PREPARE_SNAPSHOT PREPARE_SNAPSHOT是DB4AI特性中数据准备模型训练和解释快照进行协作。快照为所有应用更改的数据和文档提供了完整的序列。通过语法PREPARE SNAPSHOT调用。 表1 DB4AI.PREPARE_SNAPSHOT入参和返回值列表 参数 类型 描述 i_schema IN NAME 快照存储的模式名字，默认值是当前用户或者PUBLIC i_parent IN NAME 父快照名称 i_commands IN TEXT[] 定义快照修改的DDL和DML命令 i_vers IN NAME 版本后缀 i_comment IN TEXT 此数据策展单元的说明 res OUT db4ai.snapshot_name 结果 父主题： DB4AI Schema

DB4AI.CREATE_SNAPSHOT_INTERNAL CREATE_SNAPSHOT_INTERNAL是db4ai.create_snapshot函数的内置执行函数。函数存在信息校验，无法直接调用。 表1 DB4AI.CREATE_SNAPSHOT_INTERNAL入参和返回值列表 参数 类型 描述 s_id IN BIGINT 快照ID i_schema IN NAME 快照存储的名字空间 i_name IN NAME 快照名称 i_commands IN TEXT[] 定义数据获取的SQL命令 i_comment IN TEXT 快照描述 i_owner IN NAME 快照拥有者 父主题： DB4AI Schema

DB4AI.CREATE_SNAPSHOT CREATE_SNAPSHOT是DB4AI特性用于创建快照的接口函数。通过语法CREATE SNAPSHOT调用。 表1 DB4AI.CREATE_SNAPSHOT入参和返回值列表 参数 类型 描述 i_schema IN NAME 快照存储的模式名字，默认值是当前用户或者PUBLIC i_name IN NAME 快照名称 i_commands IN TEXT[] 定义数据获取的SQL命令 i_vers IN NAME 版本后缀 i_comment IN TEXT 快照描述 res OUT db4ai.snapshot_name 结果 父主题： DB4AI Schema

DB4AI Schema DB4AI模式在AI特性中主要是用来存储和管理数据集版本。模式中保存数据表的原始视图快照，以及每一个数据版本的更改记录和版本快照的管理信息。模式面向普通用户，用户可在该模式下查找特性DB4AI.SNAPSHOT创建的快照版本信息。 DB4AI.SNAPSHOT DB4AI.CREATE_SNAPSHOT DB4AI.CREATE_SNAPSHOT_INTERNAL DB4AI.PREPARE_SNAPSHOT DB4AI.PREPARE_SNAPSHOT_INTERNAL DB4AI.ARCHIVE_SNAPSHOT DB4AI.PUBLISH_SNAPSHOT DB4AI.MANAGE_SNAPSHOT_INTERNAL DB4AI.SAMPLE_SNAPSHOT DB4AI.PURGE_SNAPSHOT DB4AI.PURGE_SNAPSHOT_INTERNAL 父主题： Schema

DBE_PLDEBUGGER.set_var 将指定的调试的存储过程中最上层栈上的变量修改为入参的取值。如果存储过程中包含同名的变量，set_var只支持第一个变量值的设置。 表1 set_var入参和返回值列表 名称 类型 描述 var_name IN text 变量名 value IN text 修改值 result OUT boolean 结果，是否成功 父主题： DBE_PLDEBUGGER Schema