华为云用户手册

SUMMARY_STAT_BAD_BLOCK 获得数据库各节点的表、索引等文件的读取失败信息的汇总求和结果（其中first_time取最早的时间，last_time取最新的时间），如表1所示。 表1 SUMMARY_STAT_BAD_BLOCK字段 名称 类型 描述 databaseid integer database的oid。 tablespaceid integer tablespace的oid。 relfilenode integer relation的file node。 forknum bigint fork编号。 error_count bigint error的数量。 first_time timestamp with time zone 页面损坏第一次出现的时间。 last_time timestamp with time zone 页面损坏最后出现的时间。 父主题： Object

hashbucket系统函数 gs_redis_get_plan(origin_group_id OID，target_group_id OID) 描述：获取完整的迁移计划。当前版本暂不支持。 gs_redis_get_bucket_statistics 描述：获取日志流传输状态。当前版本暂不支持。 gs_redis_set_distributed_db(db_name CS TRING) 描述：设置当前正在hashbucket重分布的db。当前版本暂不支持。 gs_redis_hashbucket_update_segment_header(origin_group_id OID，target_group_id OID) 描述：更新当前数据库所有hashbucket表的header。当前版本暂不支持。 gs_redis_local_get_segment_header(table_name REGCLASS，bucketlist OIDVECTOR_EXTEND) 描述：获取段页式表header。当前版本暂不支持。 gs_redis_local_update_segment_header(table_name REGCLASS，header_info CSTRING) 描述：更新段页式表header。当前版本暂不支持。 gs_redis_hashbucket_update_inverse_pointer(buckets TEXT, origin_dn_name TEXT, new_dn_name TEXT) 描述：更新当前db所有hashbucket表本批次bucket的反向指针。当前版本暂不支持。 gs_redis_local_get_inverse_pointer(buckets TEXT，origin_dn_name TEXT, new_dn_name TEXT) 描述：获取反向指针。当前版本暂不支持。 gs_redis_local_update_inverse_pointer(table_name TEXT，header_info TEXT, bucketlist TEXT) 描述：记录更新反向指针的X LOG 。当前版本暂不支持。 gs_redis_local_set_hashbucket_frozenxid 描述：修改hashbucket表在系统表中的relfrozenxid64值。当前版本暂不支持。 gs_redis_set_hashbucket_frozenxid(origin_group_id OID，target_group_id OID) 描述：修改新DN节点hashbucket表在系统表中的relfrozenxid64值。当前版本暂不支持。 gs_redis_set_nextxid(xid BIGINT) 描述：修改DN节点next_xid值。当前版本暂不支持。 gs_redis_set_csn(csn BIGINT) 描述：修改DN节点next_csn值。当前版本暂不支持。 gs_redis_check_bucket_flush(dn_array NAME[]) 描述：查询RTO回放私有buffer是否全部刷下去。当前版本暂不支持。 gs_redis_get_flush_page_lsn(isclean bool) 描述：查询bucket扩容回放的刷页信息。当前版本暂不支持。 gs_redis_show_bucketxid(bucketid_list OIDVECTOR_EXTEND) 描述：查询指定bucket对应的bucketxid。当前版本暂不支持。 gs_redis_drop_bucket_files(origin_group_id OID，target_group_id OID) 描述：删除源节点已经物理搬迁的文件。当前版本暂不支持。 gs_redis_local_drop_bucket_files(bucketlist CSTRING，bucketnum SMALLINT) 描述：删除对应的bucket list。当前版本暂不支持。 父主题： 系统管理函数

DB_SUBPART_COL_STATIS TICS DB_SUBPART_COL_STATISTICS视图显示当前用户可访问的分区对象的子分区的列统计信息和直方图信息。所有用户都可以访问该视图。该视图同时存在于PG_CATALOG和SYS Schema下。 表1 DB_SUBPART_COL_STATISTICS字段 名称 类型 描述 owner character varying(128) 表的所有者。 table_name character varying(128) 表名。 subpartition_name character varying(128) 子分区名称。 column_name character varying(4000) 列名。 num_distinct numeric 暂不支持，值为NULL。 low_value raw 暂不支持，值为NULL。 high_value raw 暂不支持，值为NULL。 density numeric 暂不支持，值为NULL。 num_nulls numeric 暂不支持，值为NULL。 num_buckets numeric 暂不支持，值为NULL。 sample_size numeric 暂不支持，值为NULL。 last_analyzed timestamp(0) without time zone 暂不支持，值为NULL。 global_stats character varying(3) 暂不支持，值为NULL。 user_stats character varying(3) 暂不支持，值为NULL。 notes character varying(41) 暂不支持，值为NULL。 avg_col_len numeric 暂不支持，值为NULL。 histogram character varying(15) 暂不支持，值为NULL。 schema character varying(64) 列所属的名称空间的名称。 父主题： 分区表

语法 RAISE语法 有以下五种语法格式： 图1 raise_format::= 图2 raise_condition::= 图3 raise_sqlstate::= 图4 raise_option::= 图5 raise::= 参数说明： level选项用于指定错误级别，有DEBUG、LOG、INFO、NOTICE、WARNING以及EXCEPTION（默认值）。EXCEPTION抛出一个正常终止当前事务的异常，其他的仅产生不同异常级别的信息。特殊级别的错误信息是否报告到客户端、写到服务器日志由log_min_messages和client_min_messages这两个GUC配置参数控制。 format：格式字符串，指定要报告的错误消息文本。格式字符串后可跟表达式，用于向消息文本中插入。在格式字符串中，%由format后面跟着的参数的值替换，%%用于打印出%。例如： --v_job_id 将替换字符串中的 %： RAISE NOTICE 'Calling cs_create_job(%)',v_job_id; option = expression：向错误报告中添加另外的信息。关键字option可以是MESSAGE、DETAIL、HINT以及ERRCODE，并且每一个expression可以是任意的字符串。 MESSAGE，指定错误消息文本，这个选项不能用于在USING前包含一个格式字符串的RAISE语句中。 DETAIL，说明错误的详细信息。 HINT，用于打印出提示信息。 ERRCODE，向报告中指定错误码（SQLSTATE）。可以使用条件名称或者直接用五位字符的SQLSTATE错误码。 condition_name：错误码对应的条件名。 sqlstate：错误码。 如果在RAISE EXCEPTION命令中既没有指定条件名也没有指定SQLSTATE，默认用RAISE EXCEPTION (P0001)。如果没有指定消息文本，默认用条件名或者SQLSTATE作为消息文本。 当由SQLSTATE指定了错误码，则不局限于已定义的错误码，可以选择任意包含五个数字或者大写的ASCII字母的错误码，而不是00000。建议避免使用以三个0结尾的错误码，因为这种错误码是类别码，会被整个种类捕获。 兼容O模式下，SQLCODE等于SQLSTATE。 图5所示的语法不接受任何参数。这种形式仅用于一个BEGIN块中的EXCEPTION语句，它使得错误重新被处理。

参数说明 name 已有外部数据封装的名称。 HANDLER handler_function 为外部数据封装指定一个新的处理函数。 NO HANDLER 这个参数用来指定外部数据封装不再拥有处理函数。 使用外部数据封装但没有handler的外表不能访问。 VALIDATOR validator_function 为外部数据封装指定一个新的验证函数。 根据新的验证器，外部数据封装器或依赖的服务器、 用户映射或外部表的已经存在的选项是有可能是无效的。用户在使用外部数据封装之前需要保证这些选项是正确的。 不过，ALTER FOREIGN DATA WRAPPER 命令中指定的任何选项都将使用新的验证函数检查。 NO VALIDATOR 这个用来指定外部数据封装不再有验证函数。 OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) 修改外部数据封装的选项。 ADD, SET, 和 DROP 指定表现的动作。如果没有明确指定操作默认是ADD。选项名必须唯一。 使用外部数据封装验证函数时，名字和取值也会被验证。

示例 --创建一个外部数据封装dbi。 gaussdb=# CREATE FOREIGN DATA WRAPPER dbi OPTIONS (bar 'true'); --修改一个外部数据封装dbi，增加选项foo，删除bar。 gaussdb=# ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP 'bar'); --修改外部数据封装dbi验证器为file_fdw_validator。 gaussdb=# ALTER FOREIGN DATA WRAPPER dbi VALIDATOR file_fdw_validator; --修改外部数据封装dbi处理函数为file_fdw_handler。 gaussdb=# ALTER FOREIGN DATA WRAPPER dbi HANDLER file_fdw_handler;

语法格式 设置外部数据封装属性 ALTER FOREIGN DATA WRAPPER name [ HANDLER handler_function | NO HANDLER ] [ VALIDATOR validator_function | NO VALIDATOR ] [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ]) ];

DB_VIEWS DB_VIEWS视图显示当前用户可访问的所有视图的描述信息。该视图同时存在于PG_CATALOG和SYS Schema下。 表1 DB_VIEWS字段 名称 类型 描述 owner name 视图的所有者。 view_name name 视图的名称。 text text 视图文本。 text_length integer 视图文本长度。 text_vc character varying(4000) 视图创建语句。此列可能会截断视图文本。BEQUEATH子句将不会作为此视图中的text_vc列的一部分出现。 type_text_length numeric 暂不支持，值为NULL。 type_text character varying(4000) 暂不支持，值为NULL。 oid_text_length numeric 暂不支持，值为NULL。 oid_text character varying(4000) 暂不支持，值为NULL。 view_type_owner character varying(128) 暂不支持，值为NULL。 view_type character varying(128) 暂不支持，值为NULL。 superview_name character varying(128) 暂不支持，值为NULL。 editioning_view character varying(1) 暂不支持，值为NULL。 read_only character varying(1) 暂不支持，值为NULL。 container_data character varying(1) 暂不支持，值为NULL。 bequeath character varying(12) 暂不支持，值为NULL。 origin_con_id character varying(256) 暂不支持，值为NULL。 default_collation character varying(100) 暂不支持，值为NULL。 containers_default character varying(3) 暂不支持，值为NULL。 container_map character varying(3) 暂不支持，值为NULL。 extended_data_link character varying(3) 暂不支持，值为NULL。 extended_data_link_map character varying(3) 暂不支持，值为NULL。 has_sensitive_column character varying(3) 暂不支持，值为NULL。 admit_null character varying(3) 暂不支持，值为NULL。 pdb_local_only character varying(3) 暂不支持，值为NULL。 父主题： 其他系统视图

GLOBAL_SESSION_TIME 用于统计各节点会话线程的运行时间信息，及各执行阶段所消耗时间，如表1所示。 表1 GLOBAL_SESSION_TIME字段 名称 类型 描述 node_name name 节点名称。 sessid text 线程启动时间+线程标识。 stat_id integer 统计编号。 stat_name text 统计会话类型名称。 value bigint 统计会话值。 父主题： Session/Thread

注意事项 在使用CREATE EXTENSION载入扩展到数据库中之前，必须先安装好该扩展的支持文件。 CREATE EXTENSION命令安装一个新的扩展到一个数据库中，必须保证没有同名的扩展已经被安装。 安装一个扩展意味着执行一个扩展的脚本文件，这个脚本会创建一个新的SQL实体，例如函数、数据类型、操作符和索引支持的方法。 安装扩展需要有和创建他的组件对象相同的权限。对于大多数扩展这意味着需要超户或者数据库所有者的权限，对于后续的权限检查和该扩展脚本所创建的实体，运行CREATE EXTENSION命令的角色将变为扩展的所有者。 CREATE EXTENSION时如果数据库中存在与EXTENSION内同名的PACKAGE、同义词、操作符、目录、函数、存储过程、视图、表这些数据库对象，将会导致CREATE EXTENSION失败。 数据库禁止直接创建扩展，因为扩展可能会引起非预期的错误，且在升级后面临不兼容的问题。如果需要创建扩展，需要设置enable_extension为true才能够创建。 CREATE EXTENSION时，如果GUC参数enable_object_special_character为off，且扩展的脚本文件中使用"@extschema@"，那么扩展的支持文件中schema参数的值不能包含["$'\]中任意特殊字符。

参数说明 IF NOT EXISTS 如果系统已经存在一个同名的扩展，不会报错。这种情况下会给出一个提示。请注意该参数不保证系统存在的扩展和现在脚本创建的扩展相同。 extension_name 将被安装扩展的名字，数据库将使用文件SHAREDIR/extension/extension_name.control中的详细信息创建扩展。 schema_name 扩展的实例被安装在该模式下，扩展的内容可以被重新安装。指定的模式必须已经存在，如果没有指定，扩展的控制文件也不指定一个模式，这样将使用默认模式。 扩展不属于任何模式，扩展在一个数据库范围内的名字是不受限制的，但是一个扩展的实例是属于一个模式的。 version 安装扩展的版本，可以作为一个标识符或者字符串，默认的版本在扩展的控制文件中指定。 old_version 当需要升级安装"old style" 模块中没有的内容时,需要指定FROM old_version。通过CREATE EXTENSION运行一个安装脚本将新的内容安装到扩展中，而不是创建一个新的实体。注意：SCHEMA指定了包括这些已存在实体的模式。

示例 在当前数据库安装扩展。例如安装security_plugin： --安装扩展之前需要设置enable_extension为true才能够创建。 gaussdb=# SET enable_extension = true; --安装扩展。 gaussdb=# CREATE EXTENSION IF NOT EXISTS security_plugin; --删除扩展。 gaussdb=# DROP EXTENSION security_plugin;

字符串操作符 SQL定义了一些字符串函数，在这些函数里使用关键字而不是逗号来分隔参数。 octet_length(string) 描述：二进制字符串中的字节数。 返回值类型：int 示例： 1 2 3 4 5 gaussdb=# SELECT octet_length(E'jo\\000se'::bytea) AS RESULT; result -------- 5 (1 row) overlay(string placing string from int [for int]) 描述：替换子串。 返回值类型：bytea 示例： 1 2 3 4 5 gaussdb=# SELECT overlay(E'Th\\000omas'::bytea placing E'\\002\\003'::bytea from 2 for 3) AS RESULT; result ---------------- \x5402036d6173 (1 row) position(substring in string) 描述：特定子字符串的位置。 返回值类型：int 示例： 1 2 3 4 5 gaussdb=# SELECT position(E'\\000om'::bytea in E'Th\\000omas'::bytea) AS RESULT; result -------- 3 (1 row) substring(string [from int] [for int]) 描述：截取子串。 返回值类型：bytea 示例： 1 2 3 4 5 gaussdb=# SELECT substring(E'Th\\000omas'::bytea from 2 for 3) AS RESULT; result ---------- \x68006f (1 row) substr(string, from int [, for int]) 描述：截取子串。 返回值类型：bytea 示例： 1 2 3 4 5 gaussdb=# select substr(E'Th\\000omas'::bytea,2, 3) as result; result ---------- \x68006f (1 row) trim([both] bytes from string) 描述：从string的开头和结尾删除只包含bytes中字节的最长字符串。 返回值类型：bytea 示例： 1 2 3 4 5 gaussdb=# SELECT trim(E'\\000'::bytea from E'\\000Tom\\000'::bytea) AS RESULT; result ---------- \x546f6d (1 row)

二进制字符串函数 GaussDB 也提供了函数调用所使用的常用语法。 btrim(string bytea,bytes bytea) 描述：从string的开头和结尾删除只包含bytes中字节的最长的字符串。 返回值类型：bytea 示例： 1 2 3 4 5 gaussdb=# SELECT btrim(E'\\000trim\\000'::bytea, E'\\000'::bytea) AS RESULT; result ------------ \x7472696d (1 row) get_bit(string, offset) 描述：从字符串中抽取位。 返回值类型：int 示例： 1 2 3 4 5 gaussdb=# SELECT get_bit(E'Th\\000omas'::bytea, 45) AS RESULT; result -------- 1 (1 row) get_byte(string, offset) 描述：从字符串中抽取字节。 返回值类型：int 示例： 1 2 3 4 5 gaussdb=# SELECT get_byte(E'Th\\000omas'::bytea, 4) AS RESULT; result -------- 109 (1 row) set_bit(string,offset, newvalue) 描述：设置字符串中的位。 返回值类型：bytea 示例： 1 2 3 4 5 gaussdb=# SELECT set_bit(E'Th\\000omas'::bytea, 45, 0) AS RESULT; result ------------------ \x5468006f6d4173 (1 row) set_byte(string,offset, newvalue) 描述：设置字符串中的字节。 返回值类型：bytea 示例： 1 2 3 4 5 gaussdb=# SELECT set_byte(E'Th\\000omas'::bytea, 4, 64) AS RESULT; result ------------------ \x5468006f406173 (1 row) rawcmp(raw, raw) 描述：raw数据类型比较函数。 参数：raw, raw。 返回值类型：integer raweq(raw, raw) 描述：raw数据类型比较函数。 参数：raw, raw。 返回值类型：boolean rawge(raw, raw) 描述：raw数据类型比较函数。 参数：raw, raw。 返回值类型：boolean rawgt(raw, raw) 描述：raw数据类型比较函数。 参数：raw, raw。 返回值类型：boolean rawin(cstring) 描述：raw数据类型解析函数。 参数：cstring。 返回值类型：bytea rawle(raw, raw) 描述：raw数据类型解析函数。 参数：raw, raw。 返回值类型：boolean rawlike(raw, raw) 描述：raw数据类型解析函数。 参数：raw, raw。 返回值类型：boolean rawlt(raw, raw) 描述：raw数据类型解析函数。 参数：raw, raw。 返回值类型：boolean rawne(raw, raw) 描述：比较raw类型是否一样。 参数：raw, raw。 返回值类型：boolean rawnlike(raw, raw) 描述：比较raw类型与模式是否不匹配。 参数：raw, raw。 返回值类型：boolean rawout(bytea) 描述：RAW类型的输出接口。 参数：bytea 返回值类型：cstring rawsend(raw) 描述：转换bytea为二进制类型。 参数：raw 返回值类型：bytea rawtohex(text) 描述：raw格式转换为十六进制。 参数：text 返回值类型：text

定义新的范围类型 用户可以定义自己的范围类型。这样做最常见的原因是为了使用内建范围类型中提供的subtype上没有的范围。例如，要创建一个subtype float8的范围类型： gaussdb=# CREATE TYPE floatrange AS RANGE ( subtype = float8, subtype_diff = float8mi ); gaussdb=# SELECT '[1.234, 5.678]'::floatrange; floatrange --------------- [1.234,5.678] (1 row) gaussdb=# DROP TYPE floatrange; 因为float8没有有意义的“步长”，在这个例子中没有定义一个正规化函数。 定义自己的范围类型也允许用户指定使用一个不同的子类型B-树操作符类或者集合， 以便更改排序顺序来决定哪些值会落入到给定的范围中。 如果subtype被认为是具有离散值而不是连续值，CREATE TYPE命令应当指定一个canonical函数。正规化函数接收一个输入的范围值，并且必须返回一个可能具有不同界限和格式的等价的范围值。对于两个表示相同值集合的范围（例如[1, 7]和[1, 8)），正规的输出必须相同。选择哪一种表达作为正规的没有关系，只要两个具有不同格式的等价值总是能被映射到具有相同格式的相同值就行。除了调整包含/排除界限格式外，假设期望的补偿比subtype能够存储的要大，一个正规化函数可能会舍入边界值。例如，一个timestamp之上的范围类型可能被定义为具有一个一小时的步长，这样正规化函数可能需要对不是一小时的倍数的界限进行舍入，或者可能直接抛出一个错误。 subtype差异函数采用两个subtype输入值，并且返回表示为一个float8值的差（即X减Y）。在上面的例子中，可以使用常规float8减法操作符之下的函数。但是对于任何其他subtype，可能需要某种类型转换。还可能需要一些关于如何把差异表达为数字的创新型想法。为了最大的可扩展性，subtype_diff函数应该同意选中的操作符类和排序规则所蕴含的排序顺序，即只要它的第一个参数根据排序顺序大于第二个参数，它的结果就应该是正值。 subtype_diff函数相关示例： gaussdb=# CREATE FUNCTION time_subtype_diff(x time, y time) RETURNS float8 AS 'SELECT EXTRACT(EPOCH FROM (x - y))' LANGUAGE sql STRICT IMMUTABLE; gaussdb=# CREATE TYPE timerange AS RANGE ( subtype = time, subtype_diff = time_subtype_diff ); gaussdb=# SELECT '[11:10, 23:00]'::timerange; timerange --------------------- [11:10:00,23:00:00] (1 row) gaussdb=# DROP TYPE timerange; gaussdb=# DROP FUNCTION time_subtype_diff; 更多关于创建范围类型的信息请参考CREATE TYPE。

无限（无界）范围 一个范围的下界可以被忽略，意味着所有小于上界的值都被包括在范围中。 同样，如果范围的上界被忽略，那么所有比下界大的值都被包括在范围中。如果上下界都被忽略，该元素类型的所有值都被认为在该范围中。 规定缺失的包括界限自动转换为排除。 可以认为这些缺失值为 +/- 无穷大，但它们是特殊范围类型值，并且被视为超出任何范围元素类型的 +/- 无穷大值。 具有“infinity”概念的元素类型可以用它们作为显式边界值。例如，在时间戳范围，[today,infinity)不包括特殊的timestamp值infinity，尽管 [today,infinity] 包括它，就好比 [today,) 和 [today,]。 函数lower_inf和upper_inf分别测试一个范围的无限上下界。

包含和排除边界 每一个非空范围都有两个界限，下界和上界。上下界之间的所有点都被包括在范围内。一个包含界限意味着边界点本身也被包括在范围内，而一个排除边界意味着边界点不被包括在范围内。 在一个范围的文本形式中，一个包含下界被表达为“[”，而一个排除下界被表达为“(”。同样，一个包含上界被表达为“]”，而一个排除上界被表达为“)”（具体请参见范围输入/输出）。 函数lower_inc和upper_inc分别测试一个范围值的上下界。

范围输入/输出 一个范围值的输入必须遵循下列模式之一： (lower-bound,upper-bound) (lower-bound,upper-bound] [lower-bound,upper-bound) [lower-bound,upper-bound] empty 一个范围值的输出必须遵循下列模式之一： [lower-bound,upper-bound) empty 圆括号或方括号指示上下界是否为排除的或者包含的。注意最后一个模式是empty，它表示一个空范围（一个不包含点的范围）。 lower-bound可以是作为subtype的合法输入的一个字符串，或者是空表示没有下界。同样，upper-bound可以是作为 subtype的合法输入的一个字符串，或者是空表示没有上界。 每个界限值可以使用"（双引号）字符引用。如果界限值包含圆括号、方括号、逗号、双引号或反斜线时，必须使用双引号进行引用，否则那些字符会被认作范围语法的一部分。要把一个双引号或反斜线放在一个被引用的界限值中，需在其前面添加一个反斜线（还有，在一个双引号引用的界限值中的一对双引号表示一个双引号字符，这与SQL字符串中的单引号规则类似）。此外，可以避免引用或者使用反斜线转义来保护所有数据字符，否则它们会被当作范围语法的一部分。如果要写一个是空字符串的界限值，则可以写成""，因为什么都不写表示一个无限界限。 范围值前后允许有空格，但是圆括号或方括号之间的任何空格会被当做上下界值的一部分（取决于元素类型，它可能是也可能不是有意义的）。 例子： -- 包括3，不包括7，并且包括3和7之间的所有点。 gaussdb=# SELECT '[3,7)'::int4range; int4range ----------- [3,7) (1 row) -- 既不包括3 也不包括7，但是包括之间的所有点。 gaussdb=# SELECT '(3,7)'::int4range; int4range ----------- [4,7) (1 row) -- 只包括单独一个点4。 gaussdb=# SELECT '[4,4]'::int4range; int4range ----------- [4,5) (1 row) -- 不包括点（并且将被标准化为 '空'）。 gaussdb=# SELECT '[4,4)'::int4range; int4range ----------- empty (1 row)

构造范围 每一种范围类型都有一个与其同名的构造器函数。使用构造器函数通常比写一个范围文字常数更方便，因为它避免了对界限值的额外引用。构造器函数接受两个或三个参数。两个参数的形式以标准的形式构造一个范围（下界是包含的，上界是排除的），而三个参数的形式按照第三个参数指定的界限形式构造一个范围。第三个参数必须是下列字符串之一： “()”、 “(]”、 “[)”或者 “[]”。 例如： -- 完整形式是：下界、上界以及指示界限包含性/排除性的文本参数。 gaussdb=# SELECT numrange(1.0, 14.0, '(]'); numrange ------------ (1.0,14.0] (1 row) -- 如果第三个参数被忽略，则假定为 '[)'。 gaussdb=# SELECT numrange(1.0, 14.0); numrange ------------ [1.0,14.0) (1 row) -- 尽管这里指定了 '(]'，显示时该值将被转换成标准形式，因为int8range是一种离散范围类型（见下文）。 gaussdb=# SELECT int8range(1, 14, '(]'); int8range ----------- [2,15) (1 row) -- 为一个界限使用NULL导致范围在那一边是无界的。 gaussdb=# SELECT numrange(NULL, 2.2); numrange ---------- (,2.2) (1 row)

离散范围类型 一种范围的元素类型具有一个良定义的“步长”，例如integer或date。在这些类型中，如果两个元素之间没有合法值，它们可以被称作是相邻。这与连续范围相反，连续范围中总是（或者几乎总是）可以在两个给定值之间标识其他元素值。例如，numeric类型之上的一个范围就是连续的，timestamp上的范围也是（尽管timestamp具有有限的精度，并且在理论上可以被当做离散的，但是可以认为它是连续的，因为通常并不关心它的步长）。 另一种考虑离散范围类型的方法是对每一个元素值都有一个清晰的“下一个”或“上一个”值。了解了这种思想之后，通过选择原来给定的下一个或上一个元素值来取代它，就可以在一个范围界限的包含和排除表达之间转换。例如，在一个整数范围类型中，[4,8]和(3,9)表示相同的值集合，但是对于numeric上的范围并非如此。 一个离散范围类型应该具有一个正规化函数，它知道元素类型期望的步长。正规化函数负责把范围类型的相等值转换成具有相同的表达，特别是与包含或者排除界限一致。如果没有指定一个正规化函数，那么具有不同格式的范围将总是会被当作不等，即使它们实际上是表达相同的一组值。 内建的范围类型int4range、int8range和daterange都使用一种正规的形式，该形式包括下界并且排除上界，也就是[)。不过，用户定义的范围类型可以使用其他形式。

参数说明 qualified_name 创建snapshot的名称。 取值范围：字符串，需要符合标识符命名规范。 version (可省略)snapshot的版本号，当省略设置。系统会自动顺延编号。 取值范围：字符串，数字编号配合分隔符。 comment_item 指定添加的评论内容。 取值范围：字符串，需要符合标识符命名规范。 insert_item 需要插入的对象名字。 取值范围：字符串，需要符合标识符命名规范。 alias 对当前对象取的别名。 取值范围：字符串，需要符合标识符命名规范。 set_item 当前操作的对象名。 取值范围：字符串，需要符合标识符命名规范。 from_item 用于连接的查询源对象的名称。 取值范围：字符串，需要符合标识符命名规范。 where_item 返回值为布尔型的任意表达式。 取值范围：字符串，需要符合标识符命名规范。 using_item 用于连接的对象名称。 取值范围：字符串，需要符合标识符命名规范。 and_item 需要并列处理的对象名称。 取值范围：字符串，需要符合标识符命名规范。 drop_item 需要drop的对象名称。 取值范围：字符串，需要符合标识符命名规范。 attr_list 目标对象的list集合。 取值范围：字符串，需要符合标识符命名规范。 num 指定的比例值。 取值范围：数字。

示例 --创建数据表t1。 gaussdb=# CREATE TABLE t1 (id int, name varchar); --插入数据。 gaussdb=# INSERT INTO t1 VALUES (1, 'zhangsan'); gaussdb=# INSERT INTO t1 VALUES (2, 'lisi'); gaussdb=# INSERT INTO t1 VALUES (3, 'wangwu'); gaussdb=# INSERT INTO t1 VALUES (4, 'lisa'); gaussdb=# INSERT INTO t1 VALUES (5, 'jack'); --创建快照。 gaussdb=# CREATE SNAPSHOT s1@1.0 comment is 'first version' AS SELECT * FROM t1; --迭代创建快照。 gaussdb=# CREATE SNAPSHOT s1@2.0 FROM @1.0 comment is 'inherits from @1.0' USING (INSERT VALUES(6, 'john'), (7, 'tim'); DELETE WHERE id = 1); --查看快照内容。 gaussdb=# SELECT * FROM DB4AISHOT(s1@1.0); id | name ----+---------- 1 | zhangsan 2 | lisi 3 | wangwu 4 | lisa 5 | jack (5 rows) gaussdb=# SELECT * FROM DB4AISHOT(s1@2.0); id | name ----+-------- 2 | lisi 3 | wangwu 4 | lisa 5 | jack 6 | john 7 | tim (6 rows) --快照采样。 gaussdb=# SAMPLE SNAPSHOT s1@2.0 stratify by name as nick at ratio .5; --删除快照。 gaussdb=# PURGE SNAPSHOT s1@2.0; gaussdb=# PURGE SNAPSHOT s1nick@2.0; gaussdb=# PURGE SNAPSHOT s1@1.0; --删除表格t1。 gaussdb=# DROP TABLE t1;

注意事项 本特性GUC参数db4ai_snapshot_mode，快照存储模型分为MSS和 CSS 两种；GUC参数db4ai_snapshot_version_delimiter，用于设定版本分隔符，仅接受设定单字节参数值，默认为“@”;GUC参数db4ai_snapshot_version_separator，用于设定子版本分隔符，仅接受设定单字节参数值，默认为“.”。 当快照选用增量存储方式时，各个快照中具有依赖关系。删除快照需要按照依赖顺序进行删除。 snapshot特性用于团队不同成员间维护数据，涉及管理员和普通用户之间的数据转写。所以在三权分立(enableSeparationOfDuty=ON)等状态下，数据库不支持snapshot功能特性。 当需要稳定可用的快照用于AI训练等任务时，用户需要将快照发布。

注意事项 须使用CASCADE级联删除依赖用户的对象（除数据库外）。当删除用户的级联对象时，如果级联对象处于锁定状态，则此级联对象无法被删除，直到对象被解锁或锁定级联对象的线程被终止。 在数据库中删除用户时，如果依赖用户的对象在其他数据库中或者依赖用户的对象是其他数据库，请用户先手动删除其他数据库中的依赖对象或直接删除依赖数据库，再删除用户。即DROP USER不支持跨数据库进行级联删除。 在删除用户时，需要先删除该用户拥有的所有对象并且收回该用户在其他对象上的权限，或者通过指定CASCADE级联删除该用户拥有的对象和被授予的权限。

参数说明 IF EXISTS 使用该参数时，如果指定的用户不存在，发出一个notice而不是抛出一个错误，故使用该参数可以避免出现报错。 user_name 待删除的用户名。 取值范围：数据库中已存在的用户名。 CASCADE | RESTRICT CASCADE：级联删除依赖用户的对象，并收回授予该用户的权限。 RESTRICT：如果用户还有任何依赖的对象或被授予了其他对象的权限，则拒绝删除该用户（缺省行为）。 在GaussDB中，存在一个配置参数enable_kill_query，此参数在配置文件gaussdb.conf中。此参数影响级联删除用户对象的行为： 当参数enable_kill_query为on ，且使用CASCADE模式删除用户时，会自动kill锁定用户级联对象的线程，并删除用户。 当参数enable_kill_query为off，且使用CASCADE模式删除用户时，会等待锁定级联对象的线程结束之后再删除用户。

示例 --创建用户jim，登录密码为********。 gaussdb=# CREATE USER jim PASSWORD '********'; --删除不存在的tom用户。 gaussdb=# DROP USER IF EXISTS tom; NOTICE: role "tom" does not exist, skipping DROP ROLE --删除用户。 gaussdb=# DROP USER jim CASCADE;

PG_RESOURCE_POOL PG_RESOURCE_POOL系统表提供了数据库资源池的信息。 表1 PG_RESOURCE_POOL字段 名称 类型 描述 oid oid 行标识符（隐含属性，必须明确选择）。 respool_name name 资源池名称。 mem_percent integer 内存配置的百分比。 cpu_affinity bigint CPU绑定core的数值。 control_group name 资源池所在的control group名称。 active_statements integer 资源池上最大的并发数。 max_dop integer 只用于扩容的接口，表示数据重分布时，扫描并发度。 memory_limit name 资源池最大的内存。 parentid oid 父资源池OID。 io_limits integer 每秒触发I/O的次数上限。单位是万次/秒。 io_priority name I/O利用率高达90%时，重消耗I/O作业进行I/O资源管控时关联的优先级等级。 nodegroup name 表示资源池所在的逻辑数据库的名称。（集中式不支持该字段） is_foreign boolean 表示资源池是否用于控制逻辑数据库之外的用户。（集中式不支持该字段） true：表示资源池用来控制不属于当前资源池的普通用户的资源。 false：表示不控制不属于当前资源池的普通用户的资源。 max_worker integer 只用于扩容的接口，表示扩容数据重分布时，表内插入并发度。 max_connections integer 最大连接数，用来限制资源池可使用的最大连接数。 max_dynamic_memory name 资源池允许使用的最大动态内存值。 max_shared_memory name 资源池允许使用的最大共享内存值。 max_concurrency integer 资源池允许使用的最大并发数。 注：max_dop和max_worker用于扩容，不适用于集中式。 父主题： 其他系统表

字符类型 GaussDB支持的字符类型如表1所示。字符串操作符和相关的内置函数请参见字符处理函数和操作符。 表1 字符类型 名称 描述 存储空间 CHAR(n) CHARACTER(n) NCHAR(n) 定长字符串，不足补空格。n是指字节长度，如不带精度n，默认精度为1。 最大为10MB。 当sql_compatibility = 'B'时，设置参数b_format_version = '5.7'、b_format_dev_version = 's1'后： 类型：n指字符长度，区间[0,10485760]，如不带精度n，默认精度为1。定长字符串，不足补充空格。 输入： 作为表列和临时变量的数据类型：输入字符串字符个数在范围内可以正常输入，sql_mode参数值包含“strict_trans_tables”时，超过范围直接报错，否则按n最大字符长度截断处理并告警。 输出： 作为表列和临时变量的数据类型：sql_mode参数值包含“pad_char_to_full_length”时，输出带有尾部空格的字符串，否则输出不带尾部空格的字符串。 作为函数参数和返回值，存储过程的参数：不支持长度校验（例如：自定义函数入参为CHAR(5)类型，输入一个字符串'123456'，不校验长度，可以直接传入参数）。 最大为10M个字符。 VARCHAR(n) CHARACTER VARYING(n) 变长字符串。PG兼容模式下，n是字符长度。其他兼容模式下，n是指字节长度。 n最大为10485760（即10MB）。 不带n时，最大存储字节长度为1GB-85-4(存储长度参数的空间)-其余列长度，比如(a int, b varchar, c int)，varchar最大长度为1GB-85-4(存储长度参数的空间)-4(a列int的长度)-4(c列int的长度)=1,073,741,727‬。 当sql_compatibility = 'B'时，设置参数b_format_version = '5.7'、b_format_dev_version = 's1'后： n指字符长度，区间[0,10485760]，如不带精度n，默认为不限制长度，长度与TEXT类型相同。 输入： 作为表列和临时变量的数据类型：输入字符串字符个数在范围内可以正常输入，sql_mode参数值包含“strict_trans_tables”时，超过范围直接报错，否则按n最大字符长度截断处理并告警。 输出：原字符串输出。 n最大为10485760（即10MB）。 不带n时，最大存储字节长度为1GB-85-4(存储长度参数的空间)-其余列长度，比如(a int, b varchar, c int)，varchar最大长度为1GB-85-4(存储长度参数的空间)-4(a列int的长度)-4(c列int的长度)=1,073,741,727‬。 VARCHAR2(n) 变长字符串。是VARCHAR(n)类型的别名，为兼容Oracle类型。 n最大为10485760（即10MB）。 不带n时，最大存储字节长度为1GB-85-4(存储长度参数的空间)-其余列长度，比如(a int, b varchar2, c int)，varchar2最大长度为1GB-85-4(存储长度参数的空间)-4(a列int的长度)-4(c列int的长度)=1,073,741,727‬。 NVARCHAR2(n) 变长字符串。在SQL_ASCII字符集下，n表示的字节；在非SQL_ASCII字符集下，n表示的是字符。 n最大为10485760（即10MB）。 不带n时，最大存储字节长度为1GB-85-4(存储长度参数的空间)-其余列长度，比如(a int, b nvarchar2, c int)，nvarchar2最大长度为1GB-85-4(存储长度参数的空间)-4(a列int的长度)-4(c列int的长度)=1,073,741,727‬。 TEXT 变长字符串。 最大存储字节长度为1GB-85-4(存储长度参数的空间)-其余列长度，比如(a int, b text, c int)，text最大长度为1GB-85-4(存储长度参数的空间)-4(a列int的长度)-4(c列int的长度)=1,073,741,727‬。 CLOB 文本大对象，兼容Oracle类型。 在astore下，最大为32TB-1，但还需要考虑到列描述头信息的大小，以及列所在元组的大小限制（也小于32TB-1），因此CLOB类型最大值可能小于32TB-1。 在ustore下，最大为1GB-1，但还需要考虑到列描述头信息的大小，以及列所在元组的大小限制（也小于1GB-1），因此CLOB类型最大值可能小于1GB-1。 TINYTEXT MEDIUMTEXT LONGTEXT 当sql_compatibility = 'B'时，设置参数b_format_version = '5.7'、b_format_dev_version = 's1'后有效。 类型转换成TEXT类型，使用场景与TEXT类型相同。 最大为1GB-1，但还需要考虑到列描述头信息的大小，以及列所在元组的大小限制（也小于1GB-1），因此类型最大值可能小于1GB-1。 除了每列的大小限制以外，每个元组的总大小也不可超过1GB-1字节，主要受列的控制头信息、元组控制头信息以及元组中是否存在NULL字段等影响。 NCHAR为bpchar类型的别名，VARCHAR2(n)为VARCHAR(n)类型的别名。 超过1GB的clob只有dbe_lob相关高级包支持，系统函数不支持大于1GB clob。 在A兼容模式下，默认将接收到的空字符串转换为null。 在GaussDB里另外还有两种定长字符类型。在表2里显示。name类型只用在内部系统表中，作为存储标识符，不建议普通用户使用。该类型长度当前定为64字节（63可用字符加结束符）。类型“char”只用了一个字节的存储空间，在系统内部主要用于系统表，主要作为简单化的枚举类型使用。 表2 特殊字符类型 名称 描述 存储空间 name 用于对象名的内部类型。 64字节。 "char" 单字节内部类型。 1字节。 父主题： 数据类型

ADM_HIST_SNAPSHOT ADM_HIST_SNAPSHOT视图记录当前系统中存储的WDR快照数据信息。默认只有系统管理员权限才可以访问，普通用户需要授权才可以访问。该视图位于PG_CATALOG和SYS Schema下。该视图只有在GUC参数enable_wdr_snapshot为on时才可以访问。访问PG_CATALOG.ADM_HIST_SNAPSHOT和SYS.ADM_HIST_SNAPSHOT视图除需要本视图访问权限外，还需要snapshot schema、snapshot表和tables_snap_timestamp表的访问权限。 表1 ADM_HIST_SNAPSHOT字段 名称 类型 描述 snap_id bigint 唯一快照ID。 dbid oid 快照的数据库ID。 instance_number oid 暂不支持，取值同dbid。 startup_time timestamp(3) without time zone 实例启动时间。 begin_interval_time timestamp without time zone 快照间隔开始的时间（即上次快照的结束时间）。 end_interval_time timestamp without time zone 快照间隔结束的时间。拍摄快照的实际时间（即本次快照的结束时间）。 flush_elapsed interval 执行快照所花费的时间。 snap_level numeric 暂不支持，值为NULL。 error_count numeric 暂不支持，值为NULL。 snap_flag numeric 暂不支持，值为NULL。 snap_timezone interval day to second(0) 快照时区，表示为与UTC（协调世界时）时区的偏移量。 begin_interval_time_tz timestamp with time zone 快照间隔开始的时间（即上次快照的结束时间），带时区。 end_interval_time_tz timestamp with time zone 快照间隔结束的时间。拍摄快照的实际时间（即本次快照的结束时间），带时区。 con_id numeric 暂不支持，值为0。 父主题： 其他系统视图

PG_STAT_XACT_SYS_TABLES PG_STAT_XACT_SYS_TABLES视图显示命名空间中系统表的事务状态信息。 表1 PG_STAT_XACT_SYS_TABLES字段 名称 类型 描述 relid oid 表的OID。 schemaname name 该表的模式名。 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更新行数（比如没有更新所需的单独索引）。 父主题： 其他系统视图