华为云用户手册

count(*)和count(column)的区别是什么？ 答：count()函数用于计算行数的聚合函数，区别如下： count(*)统计包括了所有列的行数，在统计结果时不会忽略值为NULL的数据。 count(column)只包括列名那一列，在统计结果时会忽略值为NULL的数据。 --建表并插入数据。 gaussdb=# CREATE TABLE test(c1 int); gaussdb=# INSERT INTO test VALUES(1),(2),(3); gaussdb=# INSERT INTO test VALUES(NULL); --count(*)统计行数,不忽略值为NULL的数据。 gaussdb=# SELECT count(*) FROM test; count ------- 4 (1 row) --count(column)统计行数,忽略值为NULL的数据。 gaussdb=# SELECT count(c1) from test; count ------- 3 (1 row) --删除。 gaussdb=# DROP TABLE test; 父主题： FAQ

GS_SPM_EVOLUTION GS_SPM_EVOLUTION系统表是用于存储计划演进结果的系统表，具备sysadmin权限的用户可以对该系统表进行读操作，但只有初始用户才可以对该系统表进行写的操作。 表1 GS_SPM_EVOLTOIN字段 名称 类型 描述 sql_namespace oid schema oid。 sql_hash bigint SPM中SQL的唯一标识。 plan_hash bigint plan id。 better boolean 是否是正向收益演进： t表示正向收益演进。 f表示负向收益演进。 refer_plan bigint 报告生成主要参考的plan hash。 status integer 演进过程中是否出现异常： 0表示没有发生异常。 1表示发生了异常。 reason text 演进报告的内容。 user oid 生成演进结果的用户。 creation_time timestamp with time zone 创建演进结果的时间。 父主题： SPM计划管理

DB_SUBPART_COL_STATIS TICS DB_SUBPART_COL_STATISTI CS 视图显示当前用户可访问的分区对象的子分区的列统计信息和直方图信息。所有用户都可以访问该视图。该视图同时存在于PG_CATA LOG 和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) 列所属的名称空间的名称。 父主题： 分区表

GLOBAL_PARALLEL_DECODE_STATUS GLOBAL_PARALLEL_DECODE_STATUS视图用于查看当前节点上的复制槽的并行解码信息，如表1所示。 表1 GLOBAL_PARALLEL_DECODE_STATUS字段 名称 类型 描述 node_name name 节点名称。 slot_name text 复制槽的名称。 parallel_decode_num integer 该复制槽的并行解码线程数。 read_change_queue_length text 将每个解码线程读取日志队列的当前长度拼接后输出。 decode_change_queue_length text 将每个解码线程解码结果队列的当前长度拼接后输出。 reader_lsn text 当前reader线程读取的日志位置。 working_txn_cnt bigint 当前拼接-发送线程中正在拼接的事务个数。 working_txn_memory bigint 拼接-发送线程中拼接事务占用总内存（单位：字节）。 decoded_time timestamp with time zone 该复制槽最后一次读取逻辑日志的时间。 父主题： Utility

语法 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语句，它使得错误重新被处理。

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。 父主题： 其他系统视图

为什么查询中无法识别表名或者列名？ 答：无法识别名称最常见的原因是创建过程中表名或者列名使用了双引号引入了大小写。使用双引号时，表名和列名（称为标识符）在存储是区分大小写的，所以在查询时必须使用双引号且大小写需要与创建时匹配。因为某些接口或应用程序在创建时会自动引入双引号，所以建议创建时统一使用小写。 示例如下： --创建表。 gaussdb=# CREATE TABLE "TB_test" ("Tid" int, num int); --查询表时不加双引号，默认都为小写，会报错。 gaussdb=# SELECT * FROM TB_test; ERROR: relation "tb_test" does not exist LINE 1: SELECT * FROM TB_test; gaussdb=# SELECT Tid FROM "TB_test"; ERROR: Column "tid" does not exist LINE 1: SELECT Tid FROM "TB_test" --查询时加双引号。 gaussdb=# SELECT "Tid" FROM "TB_test"; Tid ----- (0 rows) --删除表。 gaussdb=# DROP TABLE "TB_test"; 父主题： FAQ

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

report_application_error() 描述：PL执行过程中，可以使用此函数来抛ERROR。 返回值类型：void 表1 report_application_error参数说明 参数 类型 说明 是否必选 log text error消息的内容。 是 code int4 error消息对应的error code，范围为：-20999 ~ -20000。 否 示例： gaussdb=# CREATE OR REPLACE FUNCTION GET_RESULT_UNKNOWN( gaussdb(# IN context_id int, /*context_id*/ gaussdb(# IN col_type text /*col_type*/ gaussdb(# )RETURNS INTEGER gaussdb-# AS $$ gaussdb$# BEGIN gaussdb$# if col_type is NULL then gaussdb$# PG_CATALOG.REPORT_APPLICATION_ERROR('invalid input for the third parameter col_type should not be null'); gaussdb$# end if; gaussdb$# PG_CATALOG.REPORT_APPLICATION_ERROR('UnSupport data type for column_value(context: '||context_id||', '||PG_CATALOG.QUOTE_LITERAL(col_type)||')'); gaussdb$# return -1; gaussdb$# END; gaussdb$# $$ LANGUAGE plpgsql; CREATE FUNCTION gaussdb=# CALL GET_RESULT_UNKNOWN(NULL, NULL); ERROR: invalid input for the third parameter col_type should not be null CONTEXT: SQL statement "CALL pg_catalog.report_application_error('invalid input for the third parameter col_type should not be null')" PL/pgSQL function get_result_unknown(integer,text) line 4 at PERFORM

enable_bypass_insert_sequence 参数说明：控制执行含自增列表的INSERT语句时，是否支持SQLBYPASS优化。 参数类型：布尔型 参数单位：无 取值范围： on：表示支持SQLBYPASS优化。 off：表示不支持SQLBYPASS优化。 默认值：on 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：该参数默认开启，含自增列表的INSERT语句不需要SQLBYPASS优化时设置为off。

delete_cctmp_table 参数说明：控制是否删除Ustore在线创建/重建索引过程中产生的临时表。该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围： on：表示删除临时表。 off：表示保留临时表。 默认值：on。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：该参数默认开启，需要保留在线创建/重建索引过程中产生的临时表时设置为off。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

示例 一次性入库使用示例。 -- 设置如下参数。 SET ddl_invalid_mode='invalid'; SET SET enable_force_create_obj=on; SET -- 新建函数，入参使用的类型不存在。 CREATE OR REPLACE FUNCTION func1(var type_not_exist) RETURN int IS BEGIN RETURN NULL; END; / WARNING: Type type_not_exist does not exist. WARNING: Function created with compilation errors. CREATE FUNCTION -- 查询状态。 SELECT proname,valid FROM pg_object obj JOIN pg_proc proc ON obj.object_oid = proc.oid AND proname = 'func1' AND propackageid = 0; proname | valid ---------+------- func1 | f (1 row) -- 新建PACKAGE，入参使用的类型不存在。 CREATE OR REPLACE PACKAGE pkg IS FUNCTION func1(var type_not_exist) RETURN int; END pkg; / WARNING: Type type_not_exist does not exist. WARNING: Package created with compilation errors. CREATE PACKAGE CREATE OR REPLACE PACKAGE BODY pkg IS FUNCTION func1(var type_not_exist) RETURN int AS DECLARE BEGIN RETURN NULL; END; END pkg; / WARNING: Type type_not_exist does not exist. WARNING: Package Body created with compilation errors. CREATE PACKAGE BODY -- 查询状态。 SELECT pkgname,object_type,valid FROM pg_object obj JOIN gs_package pkg ON obj.object_oid = pkg.oid AND pkgname = 'pkg'; pkgname | object_type | valid ---------+-------------+------- pkg | B | f pkg | S | f -- 重新创建入参使用的类型。 CREATE TYPE type_not_exist AS (f1 int, f2 text); CREATE TYPE ALTER PACKAGE pkg COMPILE; ALTER PACKAGE SELECT pkgname,object_type,valid FROM pg_object obj JOIN gs_package pkg ON obj.object_oid = pkg.oid AND pkgname = 'pkg'; pkgname | object_type | valid ---------+-------------+------- pkg | S | t pkg | B | t (2 rows) 不支持场景报错示例。 view%rowtype、type%rowtype作为函数参数类型使用示例。 -- view%rowtype、type%rowtype作为函数参数类型，正向创建报错。 DROP FUNCTION IF EXISTS func1; DROP VIEW IF EXISTS teview; DROP TABLE IF EXISTS tetab; CREATE TYPE tp1 IS (a int,b int); CREATE TABLE tetab(a int,b int); CREATE OR REPLACE VIEW teview AS SELECT * FROM tetab; gaussdb=# CREATE OR REPLACE FUNCTION func1(a teview%rowtype) gaussdb-# RETURN INTEGER gaussdb-# AS gaussdb$# BEGIN gaussdb$# RETURN 1; gaussdb$# END; gaussdb$# / ERROR: relation does not exist when parse word. DETAIL: relation "teview" referenced by %ROWTYPE does not exist. gaussdb=# CREATE OR REPLACE FUNCTION func1(param1 tp1%rowtype) RETURN INTEGER gaussdb-# AS gaussdb$# BEGIN gaussdb$# RETURN 1; gaussdb$# END; gaussdb$# / ERROR: relation does not exist when parse word. DETAIL: relation "tp1" referenced by %ROWTYPE does not exist. -- 调换顺序后可以入库，无法执行。 DROP FUNCTION IF EXISTS func1; DROP VIEW IF EXISTS teview; DROP TABLE IF EXISTS tetab; CREATE OR REPLACE FUNCTION func1(a teview%rowtype) RETURN INTEGER AS BEGIN RETURN 1; END; / CREATE TABLE tetab(a int,b int); CREATE OR REPLACE VIEW teview AS SELECT * FROM tetab; -- 执行和编译报错。 gaussdb=# SELECT func1((1,2)); ERROR: Function func1(record) does not exist. LINE 1: SELECT func1((1,2)); ^ HINT: No function matches the given name and argument types. You might need to add explicit type casts. CONTEXT: referenced column: func1 gaussdb=# ALTER FUNCTION func1 COMPILE; ERROR: relation does not exist when parse word. DETAIL: relation "teview" referenced by %ROWTYPE does not exist. CREATE OR REPLACE FUNCTION func1(param1 tp1%rowtype) RETURN INTEGER AS BEGIN RETURN 1; END; / CREATE TYPE tp1 IS (a int,b int); gaussdb=# SELECT func1((1,2)); ERROR: Function func1(record) does not exist. LINE 1: SELECT func1((1,2)); ^ HINT: No function matches the given name and argument types. You might need to add explicit type casts. CONTEXT: referenced column: func1 gaussdb=# ALTER FUNCTION func1 COMPILE; ERROR: relation does not exist when parse word. DETAIL: relation "tp1" referenced by %ROWTYPE does not exist. catalog.schema.type%rowtype、catalog.package.type%rowtype作为函数参数类型使用示例。 -- CATALOG相关，跨数据库访问。 DROP DATABASE IF EXISTS tedb1; DROP DATABASE IF EXISTS tedb2; CREATE DATABASE tedb1; CREATE DATABASE tedb2; \c tedb1 CREATE SCHEMA sch1; CREATE TYPE sch1.tp1 IS (a int,b int); CREATE OR REPLACE PACKAGE pkg1 AS TYPE tp1 IS record(a int,b int); END PKG1; / \c tedb2 tedb2=# CREATE OR REPLACE FUNCTION func1(param tedb1.sch1.tp1%rowtype) RETURN INTEGER tedb2-# AS tedb2$# BEGIN tedb2$# RETURN 1; tedb2$# END; tedb2$# / ERROR: cross-database references are not implemented: "tedb1.sch1.tp1" tedb2=# CREATE OR REPLACE FUNCTION func1(param tedb1.pkg1.tp1%rowtype) RETURN INTEGER tedb2-# AS tedb2$# BEGIN tedb2$# RETURN 1; tedb2$# END; tedb2$# / ERROR: cross-database references are not implemented: "tedb1.pkg1.tp1" catalog.package.type作为函数参数类型使用示例。 -- CATALOG相关，跨数据库访问。 DROP DATABASE IF EXISTS tedb1; DROP DATABASE IF EXISTS tedb2; CREATE DATABASE tedb1; CREATE DATABASE tedb2; \c tedb1 CREATE SCHEMA sch1; CREATE TYPE sch1.tp1 IS (a int,b int); CREATE OR REPLACE PACKAGE pkg1 AS TYPE tp1 IS record(a int,b int); END pkg1; / \c tedb2 CREATE OR REPLACE FUNCTION func1(param tedb1.sch1.tp1) RETURN INTEGER AS BEGIN RETURN 1; END; / -- 执行报错，编译无效。 tedb2=# SELECT func1((1,2)); WARNING: Type tp1 does not exist. CONTEXT: SQL statement "alter function public.func1 compile" PL/pgSQL function inline_code_block line 11 at SQL statement WARNING: Function func1 recompile with compilation errors. CONTEXT: SQL statement "alter function public.func1 compile" PL/pgSQL function inline_code_block line 11 at SQL statement ERROR: Function func1(record) does not exist. LINE 1: SELECT func1((1,2)); ^ HINT: No function matches the given name and argument types. You might need to add explicit type casts. CONTEXT: referenced column: func1 tedb2=# alter function func1 compile WARNING: Type tp1 does not exist. WARNING: Function func1 recompile with compilation errors. ALTER FUNCTION CREATE OR REPLACE FUNCTION func1(param tedb1.pkg1.tp1) RETURN INTEGER AS BEGIN RETURN 1; END; / -- 执行报错，编译无效。 tedb2=# SELECT func1((1,2)); WARNING: Type tp1 does not exist. CONTEXT: SQL statement "alter function public.func1 compile" PL/pgSQL function inline_code_block line 11 at SQL statement WARNING: Function func1 recompile with compilation errors. CONTEXT: SQL statement "alter function public.func1 compile" PL/pgSQL function inline_code_block line 11 at SQL statement ERROR: Function func1(record) does not exist. LINE 1: SELECT func1((1,2)); ^ HINT: No function matches the given name and argument types. You might need to add explicit type casts. CONTEXT: referenced column: func1 tedb2=# alter function func1 compile; WARNING: Type tp1 does not exist. WARNING: Function func1 recompile with compilation errors. ALTER FUNCTION package.type%rowtype作为函数参数类型使用示例。 -- package.type%rowtype作为函数参数类型。 DROP PACKAGE IF EXISTS pkg1; DROP FUNCTION IF EXISTS func1; CREATE OR REPLACE PACKAGE pkg1 IS TYPE rec IS record(c1 int, c2 varchar); var1 rec; END pkg1; / CREATE OR REPLACE FUNCTION func1(p pkg1.rec%rowtype) RETURN INTEGER IS BEGIN RETURN 1; END; / -- 执行报错，编译无效。 gaussdb=# SELECT func1((1,'var1')); WARNING: relation does not exist when parse word. DETAIL: relation "pkg1.rec" referenced by %ROWTYPE does not exist. CONTEXT: SQL statement "alter function public.func1 compile" PL/pgSQL function inline_code_block line 11 at SQL statement WARNING: Function func1 recompile with compilation errors. CONTEXT: SQL statement "alter function public.func1 compile" PL/pgSQL function inline_code_block line 11 at SQL statement ERROR: Function func1(record) does not exist. LINE 1: SELECT func1((1,'var1')); ^ HINT: No function matches the given name and argument types. You might need to add explicit type casts. CONTEXT: referenced column: func1 gaussdb=# alter function func1 compile; WARNING: relation does not exist when parse word. DETAIL: relation "pkg1.rec" referenced by %ROWTYPE does not exist. WARNING: Function func1 recompile with compilation errors. ALTER FUNCTION -- 变更顺序。 DROP PACKAGE IF EXISTS pkg1; DROP FUNCTION IF EXISTS func1; CREATE OR REPLACE FUNCTION func1(p pkg1.rec%rowtype) RETURN INTEGER IS BEGIN RETURN 1; END; / CREATE OR REPLACE PACKAGE pkg1 IS TYPE rec IS record(c1 int, c2 varchar); var1 rec; END PKG1; / -- 执行报错，编译无效。 gaussdb=# SELECT func1((1,'var1')); WARNING: relation does not exist when parse word. DETAIL: relation "pkg1.rec" referenced by %ROWTYPE does not exist. CONTEXT: SQL statement "alter function public.func1 compile" PL/pgSQL function inline_code_block line 11 at SQL statement WARNING: Function func1 recompile with compilation errors. CONTEXT: SQL statement "alter function public.func1 compile" PL/pgSQL function inline_code_block line 11 at SQL statement ERROR: Function func1(record) does not exist. LINE 1: SELECT func1((1,'var1')); ^ HINT: No function matches the given name and argument types. You might need to add explicit type casts. CONTEXT: referenced column: func1 gaussdb=# alter function func1 compile; WARNING: relation does not exist when parse word. DETAIL: relation "pkg1.rec" referenced by %ROWTYPE does not exist. WARNING: Function func1 recompile with compilation errors. ALTER FUNCTION

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

定义新的范围类型 用户可以定义自己的范围类型。这样做最常见的原因是为了使用内建范围类型中提供的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。

构造范围 每一种范围类型都有一个与其同名的构造器函数。使用构造器函数通常比写一个范围文字常数更方便，因为它避免了对界限值的额外引用。构造器函数接受两个或三个参数。两个参数的形式以标准的形式构造一个范围（下界是包含的，上界是排除的），而三个参数的形式按照第三个参数指定的界限形式构造一个范围。第三个参数必须是下列字符串之一： “()”、 “(]”、 “[)”或者 “[]”。 例如： -- 完整形式是：下界、上界以及指示界限包含性/排除性的文本参数。 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)

无限（无界）范围 一个范围的下界可以被忽略，意味着所有小于上界的值都被包括在范围中。 同样，如果范围的上界被忽略，那么所有比下界大的值都被包括在范围中。如果上下界都被忽略，该元素类型的所有值都被认为在该范围中。 规定缺失的包括界限自动转换为排除。 可以认为这些缺失值为 +/- 无穷大，但它们是特殊范围类型值，并且被视为超出任何范围元素类型的 +/- 无穷大值。 具有“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)

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

GS_LOGICAL_ATTRDEF GS_LOGICAL_ATTRDEF系统表记录逻辑解码需要使用的存储列的默认值。 表1 GS_LOGICAL_ATTRDEF字段 字段名称 字段类型 说明 adid oid 属性描述符的标识符。 adrelid oid 所属表的OID。 adnum smallint 属性号。 csnmin bigint 插入元组时的CSN（提交序列号）。 csnmax bigint 更新或删除元组时的CSN。 createtime timestamp with time zone 插入元组的时间戳。 originid integer 元组的来源标识符。 dbnode oid 数据库OID。 adbin pg_node_tree 默认值表达式。 adgencol "char" 是否为GENERATED列。 父主题： 逻辑解码

开发设计建议概述 开发设计建议约定数据库建模和数据库应用程序开发过程中，应当遵守的设计规则。根据这些规则进行建模，能够更好地契合 GaussDB 的处理架构，输出更高效的业务SQL代码。 开发设计建议中所陈述的“建议”和“关注”含义如下： 建议：用户应当遵守的设计规则。遵守这些规则，能够保证业务的高效运行。违反这些规则，将导致业务性能的大幅下降或某些业务逻辑错误。 关注：在业务开发过程中用户需要注意的细则。用于标识容易导致用户理解错误的知识点（实际上遵守SQL标准的SQL行为），或者程序中潜在的用户不易感知的默认行为。 父主题： 开发设计建议

GLOBAL_SESSION_MEMORY_DETAIL 统计各节点的线程的内存使用情况，以MemoryContext节点来统计，如表1所示。 表1 GLOBAL_SESSION_MEMORY_DETAIL字段 名称 类型 描述 node_name name 节点名称。 sessid text 线程启动时间+线程标识。 sesstype text 线程名称。 contextname text 内存上下文名称。 level smallint 内存上下文的重要级别。 parent text 父级内存上下文名称。 totalsize bigint 总申请内存大小（单位：字节）。 freesize bigint 空闲内存大小（单位：字节）。 usedsize bigint 使用内存大小（单位：字节）。 父主题： Session/Thread

参数说明 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;

注意事项 须使用CASCADE级联删除依赖用户的对象（除数据库外）。当删除用户的级联对象时，如果级联对象处于锁定状态，则此级联对象无法被删除，直到对象被解锁或锁定级联对象的线程被终止。 在数据库中删除用户时，如果依赖用户的对象在其他数据库中或者依赖用户的对象是其他数据库，请用户先手动删除其他数据库中的依赖对象或直接删除依赖数据库，再删除用户。即DROP USER不支持跨数据库进行级联删除。 在删除用户时，需要先删除该用户拥有的所有对象并且收回该用户在其他对象上的权限，或者通过指定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用于扩容，不适用于集中式。 父主题： 其他系统表

GLOBAL_STATIO_SYS_INDEXES GLOBAL_STATIO_SYS_INDEXES视图显示各节点的命名空间中所有系统表索引的I/O状态信息，如表1所示。 表1 GLOBAL_STATIO_SYS_INDEXES字段 名称 类型 描述 node_name name 节点名称。 relid oid 索引的表的OID。 indexrelid oid 该索引的OID。 schemaname name 该索引的模式名。 relname name 该索引的表名。 indexrelname name 索引名称。 idx_blks_read numeric 从索引中读取的磁盘块数。 idx_blks_hit numeric 索引命中缓存数。 父主题： Cache/IO

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。 父主题： 其他系统视图

算子说明 WorkTable Scan是一种基于内存的查询优化技术，它可以将查询结果缓存在内存中，以提高查询性能。当GaussDB执行一个查询语句时，它会将查询结果存储在一个临时表中，然后使用WorkTable Scan来扫描这个临时表，以获取查询结果。WorkTable Scan的优点是可以减少磁盘I/O操作，提高查询性能。但是，它也有一些缺点，比如会消耗大量的内存空间，可能会导致内存溢出等问题。因此，在使用WorkTable Scan时，需要根据具体情况进行调整和优化。

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更新行数（比如没有更新所需的单独索引）。 父主题： 其他系统视图