华为云用户手册

max_process_memory 参数说明：设置一个数据库节点可用的最大物理内存。 参数类型：整型 参数单位：kB 取值范围：2097152 ~ 2147483647 默认值： 独立部署：360GB（60核CPU/480G内存）；192GB（32核CPU/256G内存）；96GB（16核CPU/128G内存）；40GB（8核CPU/64G内存）；20GB（4核CPU/32G内存）；10GB（4核CPU/16G内存） 金融版（标准型）： CN：300GB（196核CPU/1536G内存）；200GB（128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；160GB（96核CPU/768G内存）；130GB（80核CPU/640G内存）；120GB（72核CPU/576G内存）；100GB（64核CPU/512G内存，60核CPU/480G内存）；50GB（32核CPU/256G内存）；20GB（16核CPU/128G内存）；10GB（8核CPU/64G内存） DN：550GB（196核CPU/1536G内存）；350GB（128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；260GB（96核CPU/768G内存）；220GB（80核CPU/640G内存）；200GB（72核CPU/576G内存）；180GB（64核CPU/512G内存）；160GB（60核CPU/480G内存）；80GB（32核CPU/256G内存）；40GB（16核CPU/128G内存）；20GB（8核CPU/64G内存） 企业版： CN：200GB（196核CPU/1536G内存）；150GB（128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；110GB（96核CPU/768G内存）；90GB（80核CPU/640G内存）；80GB（72核CPU/576G内存）；75GB（80核CPU/512G内存，64核CPU/512G内存）；70GB（60核CPU/480G内存）；35GB（32核CPU/256G内存）；15GB（16核CPU/128G内存）；9GB（8核CPU/64G内存） DN：400GB（196核CPU/1536G内存）；250GB（128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；190GB（96核CPU/768G内存）；160GB（80核CPU/640G内存）；140GB（72核CPU/576G内存）；125GB（80核CPU/512G内存，64核CPU/512G内存）；120GB（60核CPU/480G内存）；60GB（32核CPU/256G内存）；25GB（16核CPU/128G内存）；15GB（8核CPU/64G内存） 金融版（数据计算型）： CN：160GB（196核CPU/1536G内存）；120GB（128核CPU/1024G内存）；100GB（96核CPU/768G内存）；60GB（72核CPU/576G内存，64核CPU/512G内存）；20GB（32核CPU/256G内存） DN：300GB（196核CPU/1536G内存）；200GB（128核CPU/1024G内存）；150GB（96核CPU/768G内存）；110GB（72核CPU/576G内存）；100GB（64核CPU/512G内存）；40GB（32核CPU/256G内存） 当该值设置不合理，即大于服务器物理内存，可能导致操作系统OOM问题。

local_syscache_threshold 参数说明：系统表cache在单个session缓存的大小。如果enable_global_plancache已打开，为保证GPC生效，local_syscache_threshold设置值小于16MB时不会生效，最小为16MB。如果enable_global_syscache和enable_thread_pool打开，该参数描述的是当前线程和绑定到当前线程上的session缓存的总大小。 参数类型：整型 参数单位：kB 取值范围： 方式一：设置为不带单位的整数，整数范围为1*1024～512*1024。建议设置为1024的整数倍。例如设置为2048，表示2048kB。 方式二：设置为带单位的值，范围为1*1024kB～512*1024kB。例如设置为32MB，表示32MB的大小。单位仅限于“kB”、“MB”和“GB”。 默认值： 独立部署：16MB 金融版（标准型）： 32MB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存）；16MB（72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存） 企业版： 32MB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，80核CPU/512G内存，72核CPU/576G内存，64核CPU/512G内存）；16MB（60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存） 金融版（数据计算型）：16MB

page_version_check 参数说明：基于页面版本信息，开启底层存储故障校验和页面漏置脏校验功能的总开关，page_version_check是一个三级开关。其中，底层存储故障校验功能是检测从底层存储读取的页面是否为正确版本，防止磁盘掉电等故障情况导致的页面版本信息丢失；页面漏置脏校验功能用于检测被修改页面是否忘记置脏，它由单独开关page_missing_dirty_check进行控制。 参数类型：枚举类型 参数单位：无 取值范围： off：表示完全关闭底层存储故障校验和页面漏置脏校验的功能开关。 memory：表示打开纯内存态的页面版本校验功能（即底层存储故障校验和页面漏置脏校验），页面版本信息只缓存在内存当中，重启丢失。 persistence：表示打开持久态的页面版本校验功能（即底层存储故障校验和页面漏置脏校验），页面版本信息会持久化到文件中，重启不丢失。 默认值：memory 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据不同机器规格，建议如下设置：off（4核CPU/16GB内存、4核CPU32GB内存、8核CPU/64GB内存）；memory（16核CPU/128GB内存、32核CPU/256GB内存、60核CPU/480GB内存、64核CPU/512GB内存、72核CPU/576GB内存、80核CPU/640GB内存、96核CPU/768GB内存、96核CPU/1024GB内存、104核CPU/1024GB内存、128核CPU/1024GB内存、196核CPU/1536GB内存）。开关设置为memory，对性能有一定影响，机器规格越小，影响越大（参考：16核CPU/128GB内存，TPCC模型影响7%左右）。在系统需要频繁重启的场景下，建议设置为persistence，能够确保页面版本信息不丢失，但会进一步影响性能。

示例 示例1：Union中的待定类型解析。unknown类型文本'b'将被解析成text类型。 1 2 3 4 5 6 gaussdb=# SELECT text 'a' AS "text" UNION SELECT 'b'; text ------ a b (2 rows) 示例2：简单Union中的类型解析。文本1.2的类型为numeric，而且integer类型的1可以隐含地转换为numeric，因此使用这个类型。 1 2 3 4 5 6 gaussdb=# SELECT 1.2 AS "numeric" UNION SELECT 1; numeric --------- 1 1.2 (2 rows) 示例3：转置Union中的类型解析。类型real不能被隐含转换成integer，但是integer可以隐含转换成real，那么联合的结果类型将是real。 1 2 3 4 5 6 gaussdb=# SELECT 1 AS "real" UNION SELECT CAST('2.2' AS REAL); real ------ 1 2.2 (2 rows) 示例4：TD模式下，coalesce参数输入int和varchar类型，那么解析成varchar类型。ORA模式下会报错。 --在Oracle模式下，创建Oracle兼容模式的数据库oracle_1。 gaussdb=# CREATE DATABASE oracle_1 dbcompatibility = 'ORA'; --切换数据库为oracle_1。 gaussdb=# \c oracle_1 --创建表t1。 oracle_1=# CREATE TABLE t1(a int, b varchar(10)); --查看coalesce参数输入int和varchar类型的查询语句的执行计划。 a_1=# EXPLAIN SELECT coalesce(a, b) FROM t1; ERROR: COALESCE types integer and character varying cannot be matched LINE 1: EXPLAIN SELECT coalesce(a, b) FROM t1; ^ CONTEXT: referenced column: coalesce --删除表。 oracle_1=# DROP TABLE t1; --切换数据库为testdb。 oracle_1=# \c testdb --在TD模式下，创建TD兼容模式的数据库td_1。 gaussdb=# CREATE DATABASE td_1 dbcompatibility = 'TD'; --切换数据库为td_1。 gaussdb=# \c td_1 --创建表t2。 td_1=# CREATE TABLE t2(a int, b varchar(10)); --查看coalesce参数输入int和varchar类型的查询语句的执行计划。 td_1=# EXPLAIN VERBOSE select coalesce(a, b) from t2; QUERY PLAN --------------------------------------------------------------------------------------- Data Node Scan (cost=0.00..0.00 rows=0 width=0) Output: (COALESCE((t2.a)::character varying, t2.b)) Node/s: All datanodes Remote query: SELECT COALESCE(a::character varying, b) AS "coalesce" FROM public.t2 (4 rows) --删除表。 td_1=# DROP TABLE t2; --切换数据库为testdb。 td_1=# \c testdb --删除Oracle和TD模式的数据库。 gaussdb=# DROP DATABASE oracle_1; gaussdb=# DROP DATABASE td_1; 示例5：ORA模式下，将整个表达式最终的返回值类型定为result1的数据类型，或者与result1同类型范畴的更高精度的数据类型。 --在ORA模式下，创建ORA兼容模式的数据库ora_1。 gaussdb=# CREATE DATABASE ora_1 dbcompatibility = 'A'; --切换数据库为ora_1。 gaussdb=# \c ora_1 --开启Decode兼容性参数。 set sql_beta_feature='a_style_coerce'; --创建表t1。 ora_1=# CREATE TABLE t1(c_int int, c_float8 float8, c_char char(10), c_text text, c_date date); --插入数据。 ora_1=# INSERT INTO t1 VALUES(1, 2, '3', '4', date '12-10-2010'); --result1类型为char，defresult类型为text，text精度更高，返回值的类型由char更新为text。 ora_1=# SELECT decode(1, 2, c_char, c_text) AS result, pg_typeof(result) FROM t1; result | pg_typeof --------+----------- 4 | text (1 row) --result1类型为int，属于数值类型范畴，返回值的类型置为numeric。 ora_1=# SELECT decode(1, 2, c_int, c_float8) AS result, pg_typeof(result) FROM t1; result | pg_typeof --------+----------- 2 | numeric (1 row) --不存在defresult数据类型向result1数据类型之间的隐式转换，报错处理。 ora_1=# SELECT decode(1, 2, c_int, c_date) FROM t1; ERROR: CASE types integer and timestamp without time zone cannot be matched LINE 1: SELECT decode(1, 2, c_int, c_date) FROM t1; ^ CONTEXT: referenced column: c_date --关闭Decode兼容性参数。 set sql_beta_feature='none'; --删除表。 ora_1=# DROP TABLE t1; DROP TABLE --切换数据库为testdb。 ora_1=# \c testdb --删除ORA模式的数据库。 gaussdb=# DROP DATABASE ora_1; DROP DATABASE

support_binary_copy_version 参数说明：COPY FROM的BINARY模式下导出数据时，是否包含当前数据库服务端的编码信息。 参数类型：字符串 参数单位：无 取值范围：''、header_encoding。 默认值：header_encoding 设置方式：该参数属于USERSET类型参数，请参见表1对应设置方法进行设置。 设置建议：无特殊情况时建议配置为默认取值，仅做前向兼容时需另行配置为空。 表1 兼容性配置项 兼容性配置项 兼容性行为控制 header_encoding 使用COPY FROM的BINARY模式进行导出时，二进制文件头中包含当前数据库服务端的编码信息。 空值 做前向兼容处理时配置，以原二进制格式进行导出。

copy_special_character_version 参数说明：控制COPY导入导出数据时对非法编码的字符处理的相关表现。 参数类型：字符串 参数单位：无 取值范围：''、no_error、per_byte。 默认值：'' 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 使用gsql连接数据库，使用set方式设置时不区分大小写，使用gs_guc设置时仅能设置小写。 设置建议：无 表2 兼容性配置项 兼容性配置项 兼容性行为控制 no_error 控制使用COPY导入数据文件时，当文件编码与服务端编码相同时，对数据文件中不满足编码信息的数据进行容错处理，按照原编码插入表中。 per_byte 控制使用COPY导出文本格式的数据文件时，对文件编码为GBK或ZHS16GBK文件的处理方式。 设置per_byte后，一次导出一个字节数据，否则一次导出两个字节数据（GBK编码下，一个字符占两个字节）。 空值 参数默认配置，不影响任何功能使用，做前向兼容处理。即COPY存在非法编码时报错。 为保证导入表中数据的合法性，COPY中需要对数据编码的合法性进行校验。当开启此参数后，会屏蔽非法校验操作并导致字段内出现非法字符，请酌情考虑开启此参数。 当前屏蔽数据编码校验仅在服务端编码与数据编码保持一致时生效，即copy_special_character_version='no_error'时，数据库服务端编码须与数据文件编码保持一致，否则会报错；未指定数据编码时，数据编码默认为客户端编码。 如需记录非法编码字段，建议使用COPY语法中的log errors参数或log errors data参数。 二进制模式下copy_special_character_version='no_error'时，仅对TEXT、CHAR、VARCHAR、NVARCHAR2、CLOB类型的字段生效。 此参数仅在UTF-8、GB18030、GB18030_2022、ZHS16GBK、LATIN1字符集数据库下使用生效。 客户端编码与服务端编码都为GBK或ZHS16GBK，且数据库内存在非法编码的数据时，如果不设置copy_special_character_version为per_byte，导出的数据文件中可能会存在预期外的数据。 设置copy_special_character_version值为no_error时无法与COPY内COMPATIABLE_ILLEGAL_CHARS参数同时使用。

gds_debug_mod 参数说明：为了增强对Gauss Data Service （以下简称GDS）相关问题的分析定位能力，可以通过此参数选择是否开启GDS的debug功能。参数开启后，将在集群节点对应的日志中输出GDS每次收发的包裹类型、命令交互的对端以及其他交互相关的细节信息，方便记录Gaussdb端状态机的状态跳转，以及目前所处的状态信息。此参数打开会输出额外日志，增加日志IO开销，进而影响性能和日志的信息有效性，因此请仅在定位GDS问题时开启。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围： on表示开启GDS debug功能。 off表示不开启GDS debug功能。 默认值：off

safe_data_path 参数说明：设置初始用户以外的路径前缀限制，目前包括copy和高级包路径限制。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串（小于4096个字符） 默认值：NULL 如果safe_data_path目录下存在软链接文件，则会按软链接实际指向的文件路径进行处理，实际路径如果不在safe_data_path下会报错处理。 如果safe_data_path目录下存在硬链接文件，则可以正常使用。为安全起见，请谨慎使用硬链接文件，切勿在safe_data_path目录下创建指向目录以外的硬链接文件，并确保safe_data_path目录权限最小化。

enable_copy_server_files 参数说明：是否开启copy服务器端文件的权限。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示开启copy服务端文件的权限。 off表示不开启copy服务端文件的权限。 默认值：off 当参数enable_copy_server_files关闭时，只允许初始用户执行COPY FROM FILENAME或COPY TO FILENAME命令，当参数enable_copy_server_files打开，允许具有SYSADMIN权限的用户或继承了内置角色gs_role_copy_files权限的用户执行。

default_transaction_isolation 参数说明：设置默认的事务隔离级别。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 当前版本暂不支持设置默认的事务隔离级别，默认为read committed，请勿自行修改。 取值范围：枚举类型 read committed表示事务读已提交。 repeatable read表示事务可重复读。 serializable， GaussDB 目前功能上不支持此隔离级别，等价于repeatable read。 默认值：read committed

vacuum_freeze_table_age 参数说明：指定VACUUM对全表的扫描冻结元组的时间。如果当前事务号与表pg_class.relfrozenxid64字段的差值已经大于参数指定的时间时，VACUUM对全表进行扫描。 参数类型：整型 参数单位：无 取值范围：0～576 460 752 303 423 487 尽管随时可以将此参数设为上述取值范围之间的值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的95%以内。定期的手动VACUUM可以在对该表的反重叠自动清理启动之前运行。 默认值：4000000000 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。

session_replication_role 参数说明：控制当前会话与复制相关的触发器和规则的行为。 该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。 设置此参数会丢弃之前任何缓存的执行计划。 取值范围：枚举类型 origin表示从当前会话中复制插入、删除、更新等操作。 replica表示从其他地方复制插入、删除、更新等操作到当前会话。 local表示函数执行复制时会检测当前登录数据库的角色并采取相应的操作。 默认值：origin

vacuum_freeze_min_age 参数说明：指定VACUUM在扫描一个表时用于判断是否用FrozenXID替换记录的xmin字段(在同一个事务中)。 参数类型：整型 参数单位：无 取值范围：0～576 460 752 303 423 487 尽管随时可以将此参数设为上述取值范围之间的任意值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的50%以内。 默认值：2000000000 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。

default_storage_nodegroup 参数说明：此参数设置当前的默认建表所在的Node Group，目前只适用普通表。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 值为“installation”表示建表会默认建在安装的Node Group上。 值为其他字符串表示建表会默认建在设置的Node Group上。 取值范围：字符串 默认值：installation

default_tablespace 参数说明：当CREATE命令没有明确声明表空间时，所创建对象(表和索引等)的缺省表空间。 值是一个表空间的名称或者一个表示使用当前数据库缺省表空间的空字符串。若指定的是一个非默认表空间，用户必须具有它的CREATE权限，否则尝试创建会失败。 临时表不使用此参数，可以用temp_tablespaces代替。 创建数据库时不使用此参数。默认情况下，一个新的数据库从模板数据库继承表空间配置。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串，其中空表示使用默认表空间。 默认值：空

temp_tablespaces 参数说明：当一个CREATE命令没有明确指定一个表空间时，temp_tablespaces指定了创建临时对象（临时表和临时表的索引）所在的表空间。在这些表空间中创建临时文件用来做大型数据的排序工作。 其值是一系列表空间名的列表。如果列表中有多个表空间时，每次临时对象的创建，GaussDB会在列表中随机选择一个表空间；如果在事务中，连续创建的临时对象被放置在列表里连续的表空间中。如果选择的列表中的元素是一个空串，GaussDB将自动将当前的数据库设为默认的表空间。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建，请参见default_tablespace。 默认值：空

check_function_bodies 参数说明：设置是否在CREATE FUNCTION执行过程中进行函数体字符串的合法性验证。为了避免产生问题（比如避免从转储中恢复函数定义时向前引用的问题），偶尔会禁用验证。开启后主要验证存储过程中PL/SQL的词语法问题，包括数据类型、语句和表达式等，对于其中出现的SQL则在Create阶段不做检查而采用了运行时检查的方式。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示在CREATE FUNCTION执行过程中进行函数体字符串的合法性验证。 off表示在CREATE FUNCTION执行过程中不进行函数体字符串的合法性验证。 默认值：on

current_schema 参数说明：此参数设置当前的模式。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串 默认值："$user",public $user表示与当前会话用户名同名的模式名，如果这样的模式不存在，$user将被忽略。 内核开发过程中如需要获取Schema，请使用search_path对应的值，因为Schema是search_path决定的。为了兼容性，current_schema目的只是作为修改search_path的值使用。

注意事项 当enable_access_server_directory=off时，只允许初始用户删除directory对象。 当enable_access_server_directory=on时，具有SYSADMIN权限的用户、directory对象的属主、被授予了该directory的DROP权限的用户或者继承了内置角色gs_role_directory_drop权限的用户可以删除directory对象。

属性 游标的属性用于控制程序流程或者了解程序的状态。当运行DML语句时，PLSQL打开一个内建游标并处理结果，游标是维护查询结果的内存中的一个区域，游标在运行DML语句时打开，完成后关闭。显式游标的属性为： %FOUND布尔型属性：当最近一次读记录时成功返回，则值为TRUE。 %NOTFOUND布尔型属性：当最近一次读记录时失败返回，则值为TRUE。 %ISOPEN布尔型属性：当游标已打开时返回TRUE。 %ROWCOUNT数值型属性：返回已从游标中读取的记录数。

优化分析 上述两个特征表明了此SQL语句存在极为严重的计算倾斜。进一步向HashJoin算子的下层分析发现Seq Scan on s_riskrate_setting也存在极为严重的计算倾斜[38.885,2940.983]。根据Scan的含义推测此计划性能问题的根源在于表s_riskrate_setting数据的分布倾斜。实际分析之后确实发现表s_riskrate_setting存在严重的数据倾斜。整改之后性能从94s提升为50s。

现象描述 某局点测试过程中EXPLAIN ANALYZE后有如下情况： 从执行信息上比较明确的可以看出HashJoin是整个计划的性能瓶颈点，并且从HashJoin的执行时间信息[2657.406,93339.924](数值的具体含义请参见SQL执行计划详解)，上可以看出HashJoin在不同的DN上存在严重的计算倾斜。 同时在Memory Information(如下图)中可以看出各个节点的内存资源消耗也存在极为严重的倾斜。

enable_partrouting_optimization 参数说明：控制是否支持分区表插入优化。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示支持分区表插入优化，针对INSERT SELECT语句，当SELECT包含常量分区键时，INSERT只需要做一次分区路由，提升性能。 off表示不支持分区表插入优化，插入每一条数据前都需要做一次分区路由去确定插入哪一张分区表。 默认值：on 分区表插入优化约束： 只支持INSERT SELECT语句。 INSERT INTO ta SELECT FROM tb中，插入a表中所有分区键的值，对应SELECT结果集中的列值必须是常量（可以不存在该列，因为默认值也是恒定的）。 INSERT INTO ta SELECT c,d FROM b WHERE tb.c='1'或SELECT '1' AS c, d FROM tb则可以判断结果列tb.c为常量。 INSERT INTO ta SELECT c,d FROM b WHERE tb.c=func('1'); 如果func()不是volatile函数，也不是包含非常量参数的stable/immutable函数，则可以判断tb.c为常量。 如果列值为聚合函数的返回值，如：INSERT INTO ta SELECT count(c),d FROM b WHERE tb.c='1' GROUP BY c, d; 不能判断count(c)为常量。 不支持UPSERT子句。 不支持包含BEFORE和INSTEAD触发器的表，因为可能改变要插入的数据。

max_concurrent_autonomous_transactions 参数说明：自治事务最大连接数，同一时间自治事务执行的最大并发数。当设置为0时，将无法执行自治事务。 参数类型：整型 参数单位：无 取值范围：0~10000，理论最大值为10000，实际最大值为动态值，计算公式为“262143 - job_queue_processes - autovacuum_max_workers - max_inner_tool_connections - max_connections - AUXILIARY_BACKENDS - AV_LAUNCHER_PRO CS ”，job_queue_processes、autovacuum_max_workers、max_inner_tool_connections和max_connections的值取决于对应GUC参数的设置，AUXILIARY_BACKENDS为预留辅助线程数固定为20，AV_LAUNCHER_PROCS为预留autovacuum的launcher线程数固定为2。 默认值： 独立部署：80（60核CPU/480G内存）；40（32核CPU/256G内存）；20（16核CPU/128G内存）；10（8核CPU/64G内存，4核CPU/32G内存，4核CPU/16G内存） 设置方式：该参数属于POSTMASTER类型参数，请参考表表1中对应设置方法进行设置。 设置建议：根据实际业务需要和硬件配置设置此参数，建议不超过max_connections的1/10。若仅调大此参数，未同比例调整内存参数，业务压力大时，容易出现内存不足，报错提示“memory is temporarily unavailable”。 若升级过程中涉及此参数范围变更，并且在commit前修改了此参数，则如果执行升级回滚，需要将此参数调整至升级前允许的范围，否则可能导致数据库无法启动。

enable_gpi_auto_update 参数说明：控制在分区DDL命令中是否默认更新Global索引。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。该参数必须在CN和DN设置为相同值，否则可能会导致Global索引功能异常。 取值范围：布尔型 on表示默认更新Global索引，此时分区DDL无论带不带UPDATE GLOBAL INDEX子句，都会更新Global索引。 off表示默认不更新Global索引，此时只有当分区DDL带UPDATE GLOBAL INDEX子句，才会更新Global索引。 默认值：off

change_cluster_mode 参数说明：用于表示集群是否处于模式切换过程中，其中“模式切换”是指：一主两备集群切换为一主一备一日志集群，或一主一备一日志集群切换为一主两备集群，或一主一备一日志集群中备DN和日志DN互切。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0~2147483647 0表示不处于集群模式切换过程中。 1表示处于集群模式切换过程中。 其他值无实际意义，效果等同于设置为0。 默认值：0 该参数用于控制“分布式备机读”功能是否正常可用。当设置为1时，“分布式备机读”功能将无法使用，请谨慎设置该参数。

enable_segment_datafile_preallocate 参数说明：指定是否开启段页式文件扩展时立即分配磁盘空间模式。该参数为on时，表示文件扩展时优先使用fallocate立即分配磁盘空间，如果系统不支持fallocate，则使用逐字节写零方式申请磁盘空间；该参数为off时，表示文件扩展时不立即分配磁盘空间，文件以空洞方式增长。该参数属于SIGHUP类型，请参见表1中对应设置方法进行设置。 取值范围：[off,on] 默认值：on

数据库逻辑结构图 集群的每个DN负责存储数据，其存储介质是磁盘，本节主要从逻辑视角介绍每个DN上有哪些对象，以及这些对象之间的关系。另外介绍数据在不同节点的分布方式。数据库逻辑结构如图1所示。 图1 数据库逻辑结构图 Tablespace，即表空间，表空间是一个目录，集群中可以存在多个表空间，其中存储的是它所包含的数据库的各种物理文件。每个表空间可以对应多个Database。 Database，即数据库，用于管理各类数据对象，各数据库间相互隔离。数据库管理的对象可分布在多个Tablespace上。 Datafile Segment，即数据文件，通常每张表只对应一个数据文件。如果某张表的数据大于1GB，则会分为多个数据文件存储。 Table，即表，每张表只能属于一个数据库，也只能对应到一个Tablespace。每张表对应的数据文件必须在同一个Tablespace中。 Block，即数据块，是数据库管理的基本单位，默认大小为8KB。 数据在不同的DN上有四种分布方式，可以在建表的时候指定：REPLICATION、HASH、RANGE、LIST。 父主题： 数据库系统概述

示例 1 2 3 4 5 6 7 8 9 10 11 12 --创建一个角色role1。 gaussdb=# CREATE ROLE role1 IDENTIFIED BY '********'; -- 为用户role1创建一个同名schema，子命令创建的表films和winners的拥有者为role1。 gaussdb=# CREATE SCHEMA AUTHORIZATION role1 CREATE TABLE films (title text, release date, awards text[]) CREATE VIEW winners AS SELECT title, release FROM films WHERE awards IS NOT NULL; --删除schema。 gaussdb=# DROP SCHEMA role1 CASCADE; --删除用户。 gaussdb=# DROP USER role1 CASCADE;

参数说明 INDEX 重新建立指定的索引。 TABLE 重新建立指定表的所有索引，如果表有从属的“TOAST”表，则这个表也会重建索引。如果表上有索引已经被alter unusable失效，则这个索引无法被重新创建。当指定CONCURRENTLY选项时，暂不支持重建从属“TOAST”表上的索引。 DATABASE 重建当前数据库里的所有索引。当指定CONCURRENTLY选项时，暂不支持重建数据库中表的从属“TOAST”表上的索引。 SYSTEM 在当前数据库上重建所有系统表上的索引。不会处理在用户表上的索引。 option 当前仅支持CROSSBUCKET一种option，且值只能为ON或OFF，用来控制hashbucket表的索引是否在REINDEX过程中转换为跨bucket索引（cross-bucket-index，CBI）或bucket本地索引（local-bucket-index，LBI）索引。此项转换仅支持分布式hashbucket表的索引，不支持GSI索引，当前版本仅标记了扩容流程的Session可以使用在线索引类型转换。 CONCURRENTLY 以不阻塞DML的方式重建索引（加ShareUpdateExclusiveLock锁）。重建索引时，一般会阻塞其他语句对该索引所依赖表的访问。指定此关键字，可以实现重建过程中不阻塞DML。不支持在线重建系统表上的索引。不支持REINDEX INTERNAL TABLE CONCURRENTLY和REINDEX SYSTEM CONCURRENTLY，不支持REINDEX INVALID INDEX CONCURRENTLY。当执行REINDEX DATABASE CONCURRENTLY时，在线重建当前数据库中用户表上的所有索引（不会处理系统表上的索引）。REINDEX CONCURRENTLY不可以在事务内执行。在线重建索引只支持B-tree索引和UB-tree索引，只支持普通索引、GLOBAL索引、LOCAL索引，不支持PCR ubtree索引，不支持二级分区与GSI。在线并行重建索引只支持Astore及Ustore的普通索引、GLOBAL索引、LOCAL索引，其他继承当前版本在线重建索引规格约束。如果在线重建索引失败，对于用户手动取消、唯一索引键值重复、资源不足、启动线程失败、锁超时等场景，为避免占用资源，系统会自动清理新索引，在系统无法自动清理失败新索引的情况下（比如数据库宕机、FATAL、PANIC），需要尽快手动清除（使用DROP INDEX语句）非法新索引及（使用DROP TABLE语句）临时表，以防占用更多资源。一般来说，非法的新索引的后缀名为_ccnew。分布式中只有data node节点会自动清理失败索引，coordinator node节点的失败索引需要手动清理。严重错误场景会导致分布式部分节点中找不到失败索引的元信息，DROP INDEX语句无法删除这些索引，需要用DROP INDEX IF EXISTS删除。REINDEX INDEX CONCURRENTLY对表加4级会话锁，且其前几个阶段与CREATE INDEX CONCURRENTLY相似，因此也可能产生卡住或死锁的问题，具体场景与CREATE INDEX CONCURRENTLY相似（比如两个会话同时对同一个索引或表进行REINDEX CONCURRENTLY操作，会引发死锁问题），详见CONCURRENTLY章节。 重建索引时指定此关键字，Astore需要执行先后两次对全表的扫描来完成build，第一次扫描时创建新索引，不阻塞读写操作，第二次扫描时合并更新第一次扫描到目前为止发生的变更；Ustore需完成一次全表扫描，在扫描过程中并发DML产生的数据会被插入到以“index_oid_cctmp”命名的临时表中，扫描结束后合并临时表到以“_ccnew{n}”为后缀名的新索引中并删除临时表，交换新旧索引，旧索引标记为死亡，启用新索引，重建索引完成。 name 需要重建索引的索引、表、数据库的名称。表和索引可以有模式修饰。 REINDEX DATABASE和SYSTEM只能重建当前数据库的索引，所以name必须和当前数据库名称相同。 FORCE 废弃选项，仅为保持前向兼容，故继续保留。 partition_name 需要重建索引的分区的名称或者索引分区的名称。 取值范围： 如果前面是REINDEX INDEX，则这里应该指定索引分区的名称； 如果前面是REINDEX TABLE，则这里应该指定分区的名称； REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行。 REINDEX、REINDEX CONCURRENTLY不支持单独操作toast表或toast索引。