华为云用户手册

使用Schema 在特定Schema下创建对象或者访问特定Schema下的对象，需要使用有Schema修饰的对象名。该名称包含Schema名以及对象名，Schema名和对象名之间用“.”分开。 执行如下命令在myschema下创建mytable表。 1 2 gaussdb=# CREATE TABLE myschema.mytable(id int, name varchar(20)); CREATE TABLE 执行如下命令查询myschema下mytable表的所有数据。 1 2 3 4 gaussdb=# SELECT * FROM myschema.mytable; id | name ----+------ (0 rows)

Schema的搜索路径 通过设置search_path配置参数可以定义数据库查找对象的Schema搜索顺序。搜索路径中的第一个Schema将被设为当前默认Schema。若创建对象时未显式指定所属Schema，系统会自动将其创建至默认Schema中。 执行如下命令查看搜索路径。 1 2 3 4 5 gaussdb=# SHOW search_path; search_path ---------------- "$user",public (1 row) 执行如下命令将搜索路径设置为myschema, public，配置数据库的模式搜索顺序。系统将优先查找myschema，若未找到对应对象则继续搜索public。 1 2 gaussdb=# SET search_path TO myschema, public; SET

Schema的权限控制 默认情况下，用户仅能访问其拥有的Schema内的数据库对象。若要访问其他Schema中的对象，需由目标Schema所有者授予对应USAGE权限。 通过将模式的CREATE权限授予某用户，被授权用户就可以在此模式中创建对象。默认情况下，所有角色都拥有在public模式上的usage权限，但是普通用户没有在public模式上的CREATE权限。普通用户具备连接指定数据库并在其public模式中创建对象的权限时，将产生安全风险。若已授予普通用户public模式的CREATE权限，建议执行以下语句撤销该权限。 撤销PUBLIC在public模式下创建对象的权限，下面语句中第一个“public”指的是模式，第二个“PUBLIC”指系统预定义的所有用户角色。 1 2 gaussdb=# REVOKE CREATE ON SCHEMA public FROM PUBLIC; REVOKE 执行如下命令查看当前Schema。 1 2 3 4 5 gaussdb=# SELECT current_schema(); current_schema ---------------- myschema (1 row) 执行如下命令创建用户jack，并将myschema的usage权限授予用户jack。 1 2 3 4 gaussdb=# CREATE USER jack IDENTIFIED BY '********'; CREATE ROLE gaussdb=# GRANT USAGE ON SCHEMA myschema TO jack; GRANT 将用户jack对于myschema的usage权限收回。 1 2 gaussdb=# REVOKE USAGE ON SCHEMA myschema FROM jack; REVOKE

ADM_TABLESPA CES ADM_TABLESPACES视图显示所有的表空间信息。默认只有系统管理员权限才可以访问，普通用户需要授权才可以访问。该视图同时存在于PG_CATA LOG 和SYS Schema下。A数据库与 GaussDB数据库 逻辑结构特性不一致。 表1 ADM_TABLESPACES字段 名称 类型 描述 tablespace_name character varying(64) 表空间名称。 block_size numeric 暂不支持，值为NULL。 initial_extent numeric 暂不支持，值为NULL。 next_extent numeric 暂不支持，值为NULL。 min_extents numeric 暂不支持，值为NULL。 max_extents numeric 暂不支持，值为NULL。 max_size numeric 暂不支持，值为NULL。 pct_increase numeric 暂不支持，值为NULL。 min_extlen numeric 暂不支持，值为NULL。 contents character varying(9) 暂不支持，值为NULL。 status character varying(9) 暂不支持，值为ONLINE。 logging character varying(9) 暂不支持，值为NULL。 force_logging character varying(3) 暂不支持，值为NULL。 extent_management character varying(10) 暂不支持，值为NULL。 allocation_type character varying(9) 暂不支持，值为NULL。 plugged_in character varying(3) 暂不支持，值为NULL。 segment_space_management character varying(6) 暂不支持，值为NULL。 def_tab_compression character varying(8) 暂不支持，值为NULL。 retention character varying(11) 暂不支持，值为NULL。 bigfile character varying(3) 暂不支持，值为NULL。 predicate_evaluation character varying(7) 暂不支持，值为NULL。 encrypted character varying(3) 暂不支持，值为NULL。 compress_for character varying(30) 暂不支持，值为NULL。 def_inmemory character varying(8) 暂不支持，值为NULL。 def_inmemory_priority character varying(8) 暂不支持，值为NULL。 def_inmemory_distribute character varying(15) 暂不支持，值为NULL。 def_inmemory_compression character varying(17) 暂不支持，值为NULL。 def_inmemory_duplicate character varying(13) 暂不支持，值为NULL。 shared character varying(12) 暂不支持，值为NULL。 def_index_compression character varying(8) 暂不支持，值为NULL。 index_compress_for character varying(13) 暂不支持，值为NULL。 def_cellmemory character varying(14) 暂不支持，值为NULL。 def_inmemory_service character varying(12) 暂不支持，值为NULL。 def_inmemory_service_name character varying(1000) 暂不支持，值为NULL。 lost_write_protect character varying(7) 暂不支持，值为NULL。 chunk_tablespace character varying(1) 暂不支持，值为NULL。 父主题： 其他系统视图

synonym_priv_strict_check 参数说明：控制通过同义词搜索对象时，是否检查同义词关联对象的访问权限。 参数类型：布尔型 参数单位：无 取值范围： on：通过同义词检索对象时，检查是否具有同义词关联对象的访问权限。 off：通过同义词检索对象时，不检查是否具有同义词关联对象的访问权限。 默认值：on。 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：若设置为off，通过同义词访问对象时，不检查对象的访问权限，可能构成越权风险。 直接安装当前版本数据库时，该参数值为on。从之前版本升级到当前版本时，该参数值为off。

enable_cursor_with_hold 参数说明：在A兼容模式下，控制游标是否具有WITH HOLD功能。开启后，游标创建不带HOLD关键字，并且SELECT子句不包含FOR UPDATE/SHARE子句，默认值为WITH HOLD。 参数类型：布尔型 参数单位：无 取值范围： on：游标创建不带HOLD关键字时默认值为WITH HOLD。参数开启后，CURSOR cursor_name FOR query等同于CURSOR cursor_name WITH HOLD FOR query。 off：游标创建不带HOLD关键字时默认值为WITHOUT HOLD。 默认值：off。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。仅支持在session中设置该参数。 设置建议：推荐使用默认值。 设置不当的风险与影响：若设置为on，所有游标不会被释放，在session中会有内存膨胀的风险。

forbid_package_spec_circular_dependency 参数说明：控制PACKAGE包头依赖成环时对象的状态，使用时需要打开enable_force_create_obj参数。 参数类型：布尔型 参数单位：无 取值范围： on：PACKAGE包头依赖成环时对象状态为失效。 off：PACKAGE包头依赖成环时对象状态为有效。 默认值：on。 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：若设置为off，PACKAGE包头依赖成环时对象状态可以变为有效。 直接安装当前版本数据库时，该参数值为on。从之前版本升级到当前版本时，该参数值为off。

modify_function_property 参数说明：在非M兼容模式下，该参数用于控制相关系统函数的属性。在PDB场景内，若未设置该参数，则承接来自全局的设置。 参数类型：字符型 参数单位：无 取值范围：当前只支持表20中的配置项，当设置多个兼容性配置项时，相邻配置项之间用逗号隔开。 默认值：新安装数据库为"3257,5562,4164,4073"；若升级的基础版本不存在该GUC参数，默认为""；若升级的基础版本存在该GUC参数，保留原设置。 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值，不建议客户修改。 设置不当的风险与影响：影响系统函数的属性。 表20 系统函数配置项 系统函数对应的oid 描述 3257 修改函数pg_catalog.current_timestamp(numeric)的易变性，当该配置项存在于GUC参数中时，函数易变性为 'stable'，不存在时为 'immutable'。 4073 修改函数pg_catalog.text_timestamp(text)的易变性，当该配置项存在于GUC参数中时，函数易变性为 'stable'，不存在时为 'immutable'。 4164 修改函数pg_catalog.text_date(text)的易变性，当该配置项存在于GUC参数中时，函数易变性为 'stable'，不存在时为 'immutable'。 5562 修改函数pg_catalog.DBTimezone()的易变性，当该配置项存在于GUC参数中时，函数易变性为 'stable'，不存在时为 'immutable'。

forbid_public_funcname_same_with_sysfunc 参数说明：控制在创建函数及RENAME函数时，是否禁止PUBLIC函数与pg_catalog下的系统函数名称相同。 参数类型：布尔型 参数单位：无 取值范围： on：创建函数及RENAME函数时，禁止PUBLIC函数与pg_catalog下的系统函数名称相同。 off：创建函数及RENAME函数时，允许PUBLIC函数与pg_catalog下的系统函数名称相同。 默认值：on。 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：若设置为off，允许PUBLIC函数与pg_catalog下的系统函数名称相同。 直接安装505.2.0版本数据库时，该参数值为on。从505.2.0之前版本升级到当前版本时，该参数值为off。

enable_case_intervaltonumeric 参数说明：控制CASE语句中是否支持INTERVAL转NUMERIC，该参数仅在A兼容模式下生效。 参数类型：布尔型 参数单位：无 取值范围： on：CASE语句中支持INTERVAL转NUMERIC。 off：CASE语句中不支持INTERVAL转NUMERIC。 默认值：off 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：若设置为on，后续修改为off，可能导致现有CASE语句报错。

format_pg_to_timestamp 参数说明：在PG模式下，控制to_timestamp(string [, fmt])函数的行为。开启后，如果有不支持的格式，自动跳过，当前版本不支持FF，FF7，FF8，FF9，RR，RRRR，SYYYY，x，X等格式；支持早于294277-01-01 00:00:00之前的时间日期和负数年份（转化成公元前）；FF1-FF6会把超出精确度的毫秒四舍五入；当时间日期中相同项冲突时（例如DDD和DD所指的天数不同时）返回一个格式正确的时间不会报错，具体冲突行为如表19所示。多租场景下，该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围： on：实现上述功能。 off：取消实现上述功能。 默认值：on。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：开启会导致 GaussDB 不支持的fmt失效。 表19 to_timestamp fmt冲突 模式 描述 SSSSS与时间冲突 保留时间（分钟，小时）中的值以及SSSSS中的秒数部分的值。 W，J与时间日期冲突 优先级：J，W，mmdd按顺序进行覆盖。 W：未指定时，默认为星期三。 默认行为：W覆盖mmdd。 SSSSS与SS冲突 保留SS，舍弃SSSSS。 DDD与日期冲突 舍弃DDD。

enable_ecpg_cursor_duplicate_operation 参数说明：ECPG控制在A兼容下是否支持重复打开/关闭游标，仅在ECPG连接A兼容数据库时生效。多租场景下，该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围： on：ECPG连接A兼容数据库时，支持重复打开/关闭游标。 off：ECPG连接A兼容数据库时，不支持重复打开/关闭游标。 默认值：on。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：若设置为off，重复打开/关闭游标时会报错。 直接安装本版本数据库时，该参数值为on。从老版本升级到当前版本时，该参数值为off。

gs_format_behavior_compat_options 参数说明：gs_format_behavior_compat_options用于选择GaussDB内部系统函数配置项。多租场景下，该参数可在PDB级别设置。 参数类型：字符串 参数单位：无 取值范围：当前只支持表16中的兼容性配置项，当设置多个兼容性配置项时，相邻配置项之间用逗号隔开。在PDB场景内，若未设置该参数，则承接来自全局的设置。 默认值："karatsuba" 表16 gs_format_behavior兼容性配置项 兼容性配置项 兼容性行为控制 sqrt_karatsuba 设置此参数：表示在调用sqrt平方根函数时使用Karatsuba平方根算法，karatsuba算法性能更高但是在极少数情况下精度可能会和牛顿迭代算法不一致。 不设置此参数：在计算sqrt平方根算法时会使用默认的牛顿迭代算法进行平方根的计算。 allow_textconcat_null 设置此参数：在PG兼容模式下字符串和null值拼接会返回对应的字符串的值。 -- 在PG兼容模式下执行 gaussdb=# set gs_format_behavior_compat_options='allow_textconcat_null'; SET gaussdb=# select 'a' || null || 'b'; ?column? ---------- ab (1 row) 不设置此参数：在PG兼容模式下字符串和null值拼接会返回NULL。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：控制一些兼容性特性是否可用，若要更改，请在理解参数含义后谨慎操作，避免因误操作产生意料之外的风险。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

support_zero_character 参数说明：当数据中包含Unicode编码为\u0000的字符（以下简称0字符）时，数据库是否取消对0字符的校验并且正确处理而不进行截断操作。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启，数据库取消对0字符的校验，能够正确插入和处理0字符，使数据在处理过程中不发生截断。 off：表示关闭，数据库保留对0字符的校验，部分函数在处理0字符时会发生报错或数据截断。 默认值：off 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值，仅在数据中存在0字符且需要对0字符进行正确处理时开启该参数。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。 该参数仅在数据库兼容性为A兼容模式且所有节点都设置为support_zero_character=on时生效。 当support_zero_character=on时，如果数据类型为CHAR(n)、CHARACTER(n)、NCHAR(n)、VARCHAR(n)、CHARACTER VARYING(n)、VARCHAR2(n)、NVARCHAR2(n)、TEXT或CLOB类型，数据库可以正确插入并处理0字符；如果包含0字符的字符串数据可以显式转换为JSON/JSONB、XML、XMLTYPE、数值类型、货币类型、时间类型、几何类型、网络地址类型、位串类型、文本搜索类型、HLL类型、范围类型、对象标识符类型、账本数据库类型、aclitem类型或向量类型时，会在0字符处发生截断；如果字符串类型显式转换为UUID类型时，会在0字符处发生报错。 数据库仅支持以下写入0字符的方式： 通过JDBC连接数据库时，0字符可以通过文本方式写入数据库。 通过dbe_raw.cast_to_varchar2函数直接将0字符编码写入数据库。 通过copy/gs_loader工具将0字符编码写入数据库。 在开启GUC参数时，不同字符集之间进行转换时，0字符会直接返回，不再发生报错。 gsql客户端版本应与数据库版本匹配，在开启GUC参数时，若gsql端接收到的数据中包含0字符，gsql工具会将0字符转换为空格后进行打印输出。若使用旧版本gsql连接数据库，包含0字符的数据仍存在显示被截断的情况。 当开启GUC参数时，0字符在表17所列的函数、高级包函数中的表现为：函数能够正常处理0字符，不会发生在0字符处截断的情况。 部分高级包接口入参为Schema名或object名，理论上不能含有0字符，因此对表18中的函数添加0字符校验，当入参包含0字符时进行报错处理（原表现为0字符后数据被截断）。 当support_zero_character=on时，若处理的数据中不包含0字符，函数性能无明显劣化；若处理的数据中包含0字符，对比相同数量的有效字符时，initcap、upper、lower、nls_upper、nls_lower函数性能劣化程度与数据中0字符个数紧密相关，即0字符个数越多，性能劣化越严重。 当support_zero_character=on时，若逻辑解码工具读取到数据中包含的0字符，则会将0字符转换为空格后进行打印输出（原表现为0字符后数据被截断）。 表17 0字符支持的系统函数和高级包函数列表 序号 函数名/高级包函数名 1 btrim(string text [, characters text]) 2 char_length(string) 或 character_length(string) 3 chr(cvalue int|bigint) 4 chr(integer) 5 coalesce(expr1, expr2, ..., exprn) 6 concat(str1,str2) 7 concat_ws(sep text, str"any" [, str"any" [, ...] ]) 8 convert(string bytea, src_encoding name, dest_encoding name) 9 convert_from(string bytea, src_encoding name) 10 convert_to(string text, dest_encoding name) 11 decode(base_expr, compare1, value1, Compare2,value2, … default) 12 dump(expr[, return_fmt [, start_position [, length ] ] ]) 13 encode(data bytea, format text) 14 format(formatstr text [, str"any" [, ...] ]) 15 greatest(expr1 [, ...]) 16 group_concat([DISTINCT | ALL] expression [,expression ...] [ORDER BY { expression [ [ ASC | DESC | USING operator ] | nlssort_expression_clause ] [ NULLS { FIRST | LAST } ] } [,...]] [SEPARATOR str_val]) 17 initcap(string) 18 instr(string,substring[,position,occurrence]) instr(text,text,int,int) 19 instrb(text,text,int,int) 20 least(expr1 [, ...]) 21 left(str text, n int) 22 length(string) length(string bytea, encoding name ) 23 lengthb(text/bpchar) 24 listagg(expression [, delimiter]) WITHIN GROUP(ORDER BY order-list) 25 lower(string) 26 lpad(string text, length int [, fill text]) 27 ltrim(string [, characters]) 28 nls_lower(string [, nlsparam]) 29 nls_upper(string [, nlsparam]) 30 nullif(expr1, expr2) 31 nvl( expr1 , expr2 ) 32 nvl2( expr1 , expr2，expr3 ) 33 overlay(string placing string FROM int [for int]) 34 position(substring in string) 35 quote_nullable(string text) 36 regexp_count(string text, pattern text [, position int [, flags text]]) 37 regexp_instr(string text, pattern text [, position int [, occurrence int [, return_opt int [, flags text]]]]) 38 regexp_like(text,text,text) regexp_like(source_string, pattern [, match_parameter]) 39 regexp_matches(string text, pattern text [, flags text]) 40 regexp_replace(string, pattern, replacement [,flags ]) 41 regexp_split_to_array(string text, pattern text [, flags text ]) 42 regexp_split_to_table(string text, pattern text [, flags text]) 43 regexp_substr(source_char, pattern) regexp_substr(string text, pattern text [, position int [, occurrence int [, flags text]]]) 44 repeat(string text, number int ) 45 replace(string text, from text, to text) replace(string, substring) 46 reverse(str) 47 right(str text, n int) 48 rpad(string text, length int [, fill text]) 49 rtrim(string [, characters]) 50 similar_escape(pat text, esc text) 51 split_part(string text, delimiter text, field int) 52 string [NOT] LIKE pattern [ESCAPE escape-character] 53 string || string 或 string || non-string 或 non-string || string 54 string_agg(expression, delimiter) 55 strpos(string, substring) 56 substr(string,from) substr(bytea,from,count) substr(string,from,count) 57 substrb(text,int) substrb(text,int,int) 58 substring(string [from int] [for int]) substring(string from pattern for escape) substring(string from pattern) substring_inner(string [from int] [for int]) 59 translate(string text, from text, to text) 60 trim([leading |trailing |both] [characters] from string) 61 unistr(string) 62 upper(string) 63 PKG_UTIL.LOB_GET_LENGTH 64 PKG_UTIL.LOB_READ 65 PKG_UTIL.LOB_WRITE 66 PKG_UTIL.LOB_APPEND 67 PKG_UTIL.LOB_COMPARE 68 PKG_UTIL.LOB_MATCH 69 PKG_UTIL.LOB_READ_HUGE 70 PKG_UTIL.LOB_WRITEAPPEND_HUGE 71 PKG_UTIL.LOB_APPEND_HUGE 72 PKG_UTIL.LOB_COPY_HUGE 73 PKG_UTIL.LOB_CONVERTTOBLOB_HUGE 74 PKG_UTIL.IO_PRINT 75 PKG_UTIL.RAW_CAST_FROM_VARCHAR2 76 PKG_UTIL.FILE_READ 77 PKG_UTIL.FILE_REA DLI NE 78 PKG_UTIL.APP_READ_CLIENT_INFO 79 PKG_UTIL.APP_SET_CLIENT_INFO 80 PKG_UTIL.LOB_CONVERTTOBLOB 81 PKG_UTIL.LOB_CONVERTTOCLOB 82 PKG_UTIL.MATCH_EDIT_DISTANCE_SIMILARITY 83 PKG_UTIL.RAW_CAST_TO_VARCHAR2 84 PKG_UTIL.APP_SET_MODULE 85 PKG_UTIL.APP_READ_MODULE 86 PKG_UTIL.APP_SET_ACTION 87 PKG_UTIL.APP_READ_ACTION 88 DBE_OUTPUT.PRINT_LINE 89 DBE_OUTPUT.PRINT 90 DBE_OUTPUT.GET_LINE 91 DBE_OUTPUT.GET_LINES 92 DBE_OUTPUT.PUT 93 DBE_OUTPUT.PUT_LINE 94 DBE_UTILITY.CANONICALIZE 95 DBE_UTILITY.COMMA_TO_TABLE 96 DBE_UTILITY.NAME_TOKENIZE 97 DBE_UTILITY.TABLE_TO_COMMA 98 DBE_UTILITY.CANONICALIZE_RET 99 DBE_UTILITY.COMMA_TO_TABLE_FUNC 100 DBE_UTILITY.NAME_SEPARATE 101 DBE_UTILITY.NAME_TOKENIZE_FUNC 102 DBE_UTILITY.NAME_TOKENIZE_LOWER 103 DBE_UTILITY.NAME_TOKENIZE_LOWER_FUNC 104 DBE_UTILITY.TABLE_TO_COMMA_FUNC 表18 入参包含0字符进行报错处理的函数 序号 高级包函数名 1 PKG_UTIL.SESSION_SET_CONTEXT 2 PKG_UTIL.UTILITY_COMPILE_SCHEMA 3 PKG_UTIL.GS_COMPILE_SCHEMA 4 DBE_UTILITY.NAME_RESOLVE 5 DBE_UTILITY.COMPILE_SCHEMA 6 DBE_UTILITY.SEARCH_CLASS_WITH_NSPOID_ONAME_TYPE 7 DBE_UTILITY.SEARCH_OBJE CTS 8 DBE_UTILITY.SEARCH_OBJECTS_SYNONYM_FILL_SCHEMA 9 DBE_UTILITY.SEARCH_PROCEDURE_WITH_NSPOID_ONAME 10 DBE_UTILITY.SEARCH_SYNONYM_WITH_NSPOID_ONAME

performance_schema 参数说明：M-Compatibility模式数据库行为配置项。该参数表示是否支持performance信息的查询。 参数类型：布尔型 参数单位：无 取值范围： on：表示支持performance信息的查询。 off：表示不支持performance信息的查询。 默认值：off 设置方式：该参数暂不支持设置，只能查看。 设置建议：该参数不允许用户进行设置，只能查看。 设置不当的风险与影响：无 该参数仅用于适配MySQL JDBC驱动，仅可通过“SELECT @@performance_schema”查询。

interactive_timeout 参数说明：M-Compatibility模式数据库行为配置项。该参数表示服务端在关闭交互式连接之前等待其活动的秒数。返回值与session_timeout一致。 参数类型：整型 参数单位：s（秒） 取值范围：0 ~ 86400 默认值：600 设置方式：该参数暂不支持设置，只能查看。 设置建议：该参数不允许用户进行设置，只能查看。 设置不当的风险与影响：无 该参数仅用于适配MySQL JDBC驱动，仅可通过“SELECT @@interactive_timeout”查询。

net_buffer_length 参数说明：M-Compatibility模式数据库行为配置项。该参数用于控制客户端线程关联的连接缓冲区和结果集缓冲区的初始大小。 参数类型：整型 参数单位：Byte 取值范围：1024 ~ 1048576 默认值：8192 设置方式：该参数暂不支持设置，只能查看。 设置建议：该参数不允许用户进行设置，只能查看。 设置不当的风险与影响：无 该参数仅用于适配MySQL JDBC驱动，仅可通过“SELECT @@net_buffer_length”查询。

query_cache_size 参数说明：M-Compatibility模式数据库行为配置项。该参数表示为缓存查询结果分配的内存量。 参数类型：整型 参数单位：Byte 取值范围：0 ~ 18446744073709551615 默认值：0 设置方式：该参数暂不支持设置，只能查看。 设置建议：该参数不允许用户进行设置，只能查看。 设置不当的风险与影响：无 该参数仅用于适配MySQL JDBC驱动，仅可通过“SELECT @@query_cache_size”查询。

wait_timeout 参数说明：M-Compatibility模式数据库行为配置项。该参数表示服务端在关闭非交互式连接之前等待活动的秒数。返回值与session_timeout一致。 参数类型：整型 参数单位：s（秒） 取值范围：0 ~ 86400 默认值：600 设置方式：该参数暂不支持设置，只能查看。 设置建议：该参数不允许用户进行设置，只能查看。 设置不当的风险与影响：无 该参数仅用于适配MySQL JDBC驱动，仅可通过“SELECT @@wait_timeout”查询。

query_cache_type 参数说明：M-Compatibility模式数据库行为配置项。该参数表示查询缓存类型。 参数类型：字符串 参数单位：无 取值范围： on：表示支持查询缓存。 off：表示不支持查询缓存。 默认值：off 设置方式：该参数暂不支持设置，只能查看。 设置建议：该参数不允许用户进行设置，只能查看。 设置不当的风险与影响：无 该参数仅用于适配MySQL JDBC驱动，仅可通过“SELECT @@query_cache_type”查询。

system_time_zone 参数说明：M-Compatibility模式数据库行为配置项。该参数表示服务端系统时区。同log_timezone。 参数类型：字符串 参数单位：无 取值范围：与log_timezone一致。 默认值：根据OS时区设置。 设置方式：该参数暂不支持设置，只能查看。 设置建议：该参数不允许用户进行设置，只能查看。 设置不当的风险与影响：无 该参数仅用于适配MySQL JDBC驱动，仅可通过“SELECT @@system_time_zone”查询。

time_zone 参数说明：M-Compatibility模式数据库行为配置项。该参数表示当前会话时区。同TimeZone。 参数类型：字符串 参数单位：无 取值范围：支持'+08:00'的HH:MM时间格式和'Asia/Shanghai'的地域形式取值。 时间格式为：[+][H]H[:MM]、-[H]H[:MM]，以'+'或'-'开头，'+'可省略。取值范围为：'-12:59' ~ '+13:00'。 默认值："PRC" 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。 该参数仅用于适配MySQL JDBC驱动，可通过“SELECT @@time_zone”查询。将m_format_dev_version设置为's2'后，才可支持设置time_zone参数。

net_write_timeout 参数说明：M-Compatibility模式数据库行为配置项。该参数用于设置在中止写入之前等待块写入连接的秒数。多租场景下，该参数可在PDB级别设置。 参数类型：整型 参数单位：s（秒） 取值范围：1 ~ 31536000 默认值：60。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值不能带单位。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。 该参数仅用于适配MySQL JDBC驱动，功能暂不生效。

enable_force_create_obj 参数说明：用于控制一次性入库功能的开启与关闭。开启该参数后，若创建或重建函数、包时存在未定义的对象，会创建一个虚拟的对象用于编译，并在函数体编译的过程中通过try catch捕获异常，使创建或重建过程能够运行成功。多租场景下，该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围： on：打开一次性入库功能。 off：关闭一次性入库功能。 默认值：off。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据需求场景进行配置。若无特殊情况，建议开启对应功能。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

max_allowed_packet 参数说明：M-Compatibility模式数据库行为配置项，用于表示字符串函数返回值上限。若实际结果超过该上限，则会告警，并返回NULL值。 参数类型：整型 参数单位：字节 取值范围：1024 ~ 1073741824（取值只能是1024的倍数，非倍数时将向下舍入到最接近的倍数）。 默认值：4194304 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

div_precision_increment 参数说明：M-Compatibility模式数据库行为配置项。用于设置除法结果精度提升值，即除法运算结果的小数位数等于被除数的小数位数加上该参数值。多租场景下，该参数可在PDB级别设置。 参数类型：整型 参数单位：无 取值范围：0 ~ 30 默认值：4。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

enable_m_format_hook 参数说明：M-Compatibility模式数据库行为配置项。该参数控制M-Compatibility模式hook是否生效。多租场景下，该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围： on：表示M-Compatibility模式数据库允许挂载对应解析执行hook。 off：表示M-Compatibility模式数据库不挂载对应解析执行hook。 默认值：on。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：当前参数仅针对当前未完全适配的外部工具使用，不允许用户使用。 设置不当的风险与影响：无

m_err_sql_dialect 参数说明：M-Compatibility模式数据库行为配置项。用于控制错误码信息的显示方式。 参数类型：字符串 参数单位：无 取值范围： GaussDB：表示报错信息使用GaussDB内核的错误码信息。 MySQL：表示报错信息使用M-Compatibility模式数据库的错误码信息。 默认值："GaussDB"。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

ddl_invalid_mode 参数说明：用于控制在对函数或包做DROP操作时，对依赖其的对象（函数或包）进行的行为。多租场景下，该参数可在PDB级别设置。 级联失效依赖对象的过程中，当出现了已失效的对象时，中断级联失效操作。 参数类型：枚举类型 参数单位：无 取值范围： delete：对函数或包做DROP操作时，级联删除依赖其的对象（函数或包）。 invalid：对函数或包做DROP操作时，级联失效依赖其的对象（函数或包）。 默认值：delete。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据需求场景进行配置。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

init_connect 参数说明：M-Compatibility模式数据库行为配置项。该参数表示服务端为每个连接的客户端执行的字符串。 参数类型：字符串 参数单位：无 取值范围：无 默认值："" 设置方式：该参数暂不支持设置，只能查看。 设置建议：该参数不允许用户进行设置，只能查看。 设置不当的风险与影响：无 该参数仅用于适配MySQL JDBC驱动，仅可通过“SELECT @@init_connect”查询，并需要将m_format_dev_version设置为's2'。