华为云用户手册

语法格式 单表删除： [ WITH [ RECURSIVE ] with_query [, ...] ] DELETE [/*+ plan_hint */] [FROM] [ ONLY ] {table_name [ * ] [ [ [partition_clause] [ [ AS ] alias ] ] | [ [ [ AS ] alias ] [partitions_clause] ] ] | subquery [ [ AS ] alias ] | view_name [ [ AS ] alias ]} [ USING using_list ] [ WHERE condition | WHERE CURRENT OF cursor_name ] [ ORDER BY { expression [ ASC | DESC | USING operator ] } ] [ LIMIT { count } ] [ RETURNING { * | { output_expr [ [ AS ] output_name ] } [, ...] } ];

示例 --创建一个表tb_for_masking。 gaussdb=# CREATE TABLE tb_for_masking(idx int, col1 text, col2 text, col3 text, col4 text, col5 text, col6 text, col7 text,col8 text); --给表tb_for_masking插入数据。 gaussdb=# INSERT INTO tb_for_masking VALUES(1, '9876543210', 'usr321usr', 'abc@huawei.com', 'abc@huawei.com', '1234-4567-7890-0123', 'abcdef 123456 ui 323 jsfd321 j3k2l3', '4880-9898-4545-2525', 'this is a llt case'); 、 --创建资源标签标记敏感列col1。 gaussdb=# CREATE RESOURCE LABEL mask_lb1 ADD COLUMN(tb_for_masking.col1); --创建资源标签标记敏感列col2。 gaussdb=# CREATE RESOURCE LABEL mask_lb2 ADD COLUMN(tb_for_masking.col2); --创建资源标签标记敏感列col3。 gaussdb=# CREATE RESOURCE LABEL mask_lb3 ADD COLUMN(tb_for_masking.col3); --创建一个名为maskpol1的脱敏策略。 gaussdb=# CREATE MASKING POLICY maskpol1 maskall ON LABEL(mask_lb1); --创建一个名为maskpol2的脱敏策略。 gaussdb=# CREATE MASKING POLICY maskpol2 randommasking ON LABEL(mask_lb2); --创建一个名为maskpol3的脱敏策略。 gaussdb=# CREATE MASKING POLICY maskpol3 basicemailmasking ON LABEL(mask_lb3); --删除一个脱敏策略。 gaussdb=# DROP MASKING POLICY IF EXISTS maskpol1; --删除一组脱敏策略。 gaussdb=# DROP MASKING POLICY IF EXISTS maskpol2, maskpol3; --删除资源标签 gaussdb=# DROP RESOURCE LABEL mask_lb1; gaussdb=# DROP RESOURCE LABEL mask_lb2; gaussdb=# DROP RESOURCE LABEL mask_lb3; --删除表 gaussdb=# DROP TABLE tb_for_masking;

示例 --创建并切换至测试数据库。 gaussdb=# CREATE DATABASE test_event WITH DBCOMPATIBILITY = 'b'; gaussdb=# \c test_event --创建表。 test_event=# CREATE TABLE t_ev(num int); --创建一个执行一次的定时任务，五秒后执行一次，执行完后定时任务自动删除。 test_event=# CREATE EVENT IF NOT EXISTS event_e1 ON SCHEDULE AT sysdate + interval 5 second DO INSERT INTO t_ev VALUES(0); --五秒后查询表。 test_event=# SELECT * FROM t_ev; num ----- 0 (1 row) --创建一个每隔一分钟执行一次的定时任务。 test_event=# CREATE EVENT IF NOT EXISTS event_e2 ON SCHEDULE EVERY 1 minute DO INSERT INTO t_ev VALUES(1); --每隔一分钟查询表，会看到新增一条数据。 test_event=# SELECT * FROM t_ev; num ----- 0 1 1 (3 rows) --删除定时任务。 test_event=# DROP EVENT event_e2; --删除表。 test_event=# DROP TABLE t_ev; --切换回初始数据库，并删除测试数据库。请用真实的数据库名替换postgres。 test_event=#\c postgres gaussdb=# DROP DATABASE test_event;

示例 --创建表。 gaussdb=# CREATE TABLE load_data_tbl1(load_col1 INT UNIQUE, load_col2 INT, load_col3 CHAR(10)); --向表中插入一条数据。 gaussdb=# INSERT INTO load_data_tbl1 VALUES(0,0,'load0'); --从文件/home/omm/load1.csv中复制数据到load_data_tbl表,指定列名，设置.load_col3列值统一为"load"。 gaussdb=# LOAD DATA INFILE '/home/omm/load1.csv' INTO TABLE load_data_tbl1(load_col1, load_col2) SET load_col3 = 'load'; --后面导入数据load_col3列值均为'load' gaussdb=# SELECT * FROM load_data_tbl1; load_col1 | load_col2 | load_col3 -----------+-----------+------------ 0 | 0 | load0 3 | 3 | load 1 | 1 | load 2 | 2 | load (4 rows) --从文件/home/omm/load2.csv中复制数据到load_data_tbl表.，指定IGNORE忽略冲突 gaussdb=# LOAD DATA INFILE '/home/omm/load2.csv' IGNORE INTO TABLE load_data_tbl1; --表load_data_tbl1中数据不变，冲突数据跳过。 gaussdb=# SELECT * FROM load_data_tbl1; load_col1 | load_col2 | load_col3 -----------+-----------+------------ 0 | 0 | load0 3 | 3 | load 1 | 1 | load 2 | 2 | load (4 rows) --创建分区表 gaussdb=# CREATE TABLE load_data_tbl2 ( load_col_col1 INT, load_col_col2 INT ) PARTITION BY RANGE (load_col_col2) ( PARTITION load_p1 VALUES LESS THAN(3), PARTITION load_p2 VALUES LESS THAN(9), PARTITION load_p3 VALUES LESS THAN(MAXVALUE) ); --从文件/home/omm/load3.csv中复制数据到load_data_tbl2表.，指定PARTITION。 gaussdb=# LOAD DATA INFILE '/home/omm/load3.csv' INTO TABLE load_data_tbl2 PARTITION (load_p2); --数据导入到load_data_tbl2表中指定分区 gaussdb=# SELECT * FROM load_data_tbl2; load_col_col1 | load_col_col2 ---------------+--------------- 4 | 4 5 | 5 (2 rows) --创建表 gaussdb=# CREATE TABLE load_data_tbl3(load_col_col1 CHAR(30)); --从文件/home/omm/load4.csv中复制数据到load_data_tbl3表.，指定FIELDS ENCLOSED BY; gaussdb=# LOAD DATA INFILE '/home/omm/load4.csv' INTO TABLE load_data_tbl3 FIELDS ENCLOSED BY '"'; --数据"load test quote"双引号被去掉，'load test single_quote'单引号保留 gaussdb=# select * from load_data_tbl3; load_col_col1 -------------------------------- load test quote 'load test single_quote' (2 rows) --删除表。 gaussdb=# drop table load_data_tbl1; gaussdb=# DROP TABLE load_data_tbl2; gaussdb=# DROP TABLE load_data_tbl3;

语法格式 LOAD DATA [LOCAL] INFILE 'file_name' [REPLACE | IGNORE] INTO TABLE tbl_name [PARTITION (partition_name [, partition_name] ...)] [CHARACTER SET charset_name] [{FIELDS | COLUMNS} [TERMINATED BY 'string'] [[OPTIONALLY] ENCLOSED BY 'char'] [ESCAPED BY 'char'] ] [LINES [STARTING BY 'string'] [TERMINATED BY 'string'] ] [IGNORE number {LINES | ROWS}] [(col_name_or_user_var [, col_name_or_user_var] ...)] [SET col_name={expr | DEFAULT} [, col_name={expr | DEFAULT}] ...]

参数说明 LOCAL 指定导入文件的位置。 不指定LOCAL时，若'file_name'为相对路径，则默认导入路径为数据目录； 若指定LOCAL参数则需要指定'file_name'为绝对路径，当指定为相对路径时默认导入路径为数据库二进制所在路径，即$GAUSSHOME/bin/。 当导入数据与表中数据冲突或文件中字段数小于指定表中字段数时，指定LOCAL与指定IGNORE作用一致。 REPLACE | IGNORE 当导入数据与表中原有数据冲突时，若指定REPLACE，则替换冲突行数据；若指定IGNORE则跳过冲突行数据，继续导入。若数据冲突但不指定REPLACE，IGNORE或LOCAL中任意一个则终止导入并报错。 若文件字段数小于指定表列数，指定LOCAL或IGNORE参数会为剩余列赋默认值。不指定IGNORE或LOCAL参数会报错。 PARTITION 当导入表为分区表时，此参数用来指定分区。若数据与指定分区范围不一致则报错。 CHARACTER SET 指定数据文件的编码格式名称，缺省为当前客户端编码格式。 FIELDS | COLUMNS TERMINATED BY 指定两列之间分隔符，缺省为'\t'。 指定换行符不能与分隔符相同。 [OPTIONALLY] ENCLOSED BY 指定引号字符，缺省为''。 OPTIONALLY参数为可选参数，无实际作用。 引号符仅支持单字符，不支持字符串。 ESCAPED BY 指定转义符，缺省为'\'。 转义字符仅支持单字符，不支持字符串。 LINES STARTING BY 指定导入数据文件起始字段样式。 TERMINATED BY 指定导入数据文件换行符样式。 IGNORE 指定数据导入时，跳过数据文件的前 number行。 col_name_or_user_var 可选的待复制字段列表。 取值范围：如果没有声明字段列表，将使用所有字段。 指定列参数不支持重复指定列。 LOAD DATA语法指定列时，col_name_or_user_var支持指定为表中存在列或用户变量。若指定为用户变量，需设置GUC参数b_format_behavior_compat_options值包含enable_set_variables（set b_format_behavior_compat_options = 'enable_set_variables'）。 SET 指定列值，可以指定为表达式或DEFAULT。 表达式中不支持列名。 若表达式结果类型与被赋值列对应类型之间不存在隐式转换函数则报错。

GS_STAT_XACT_ALL_PARTITIONS GS_STAT_XACT_ALL_PARTITIONS视图显示命名空间中所有分区表分区的事务状态信息，此视图信息通过gs_stat_get_xact_all_partitions_stats()函数查询。 表1 GS_STAT_XACT_ALL_PARTITIONS字段 名称 类型 描述 partition_oid oid 分区的OID。 schemaname name 该分区的模式名。 relname name 该分区所在表的表名。 partition_name name 该分区所在一级分区名。 sub_partition_name 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 热更新行数（比如没有更新所需的单独索引）。 父主题： 分区表

DV_SESSIONS DV_SESSIONS视图显示当前所有活动的后台线程的信息。默认只有系统管理员权限才可以访问，普通用户需要授权才可以访问。多租场景下，non-PDB访问该视图时返回全部信息，PDB访问该视图时仅返回该PDB相关信息。 表1 DV_SESSIONS字段 名称 类型 描述 sid bigint 当前活动的后台线程的OID。 serial# integer 当前活动的后台线程的序号，在 GaussDB 中为0。 user# oid 登录此后台线程的用户的OID。oid为0表示此后台线程为全局辅助线程（auxiliary）。 username name 登录此后台线程的用户名。username为空表示此后台线程为全局辅助线程（auxiliary）。 可以通过和pg_stat_get_activity()关联查询，识别出application_name。 例如： SELECT s.*,a.application_name FROM DV_SESSIONS AS s LEFT JOIN pg_stat_get_activity(NULL) AS a ON s.sid=a.sessionid; 父主题： 其他系统视图

MY_CONSTRAINTS MY_CONSTRAINTS视图显示当前用户下表中约束的信息。该视图同时存在于PG_CATA LOG 和SYS Schema下。 表1 MY_CONSTRAINTS字段 名称 类型 描述 constraint_name character varying(64) 约束名。 constraint_type text 约束类型： c表示检查约束。 f表示外键约束。 p表示主键约束。 u表示唯一约束。 table_name character varying(64) 约束相关的表名。 index_owner character varying(64) 约束相关的索引的所有者（只针对唯一约束和主键约束）。 index_name character varying(64) 约束相关的索引的名称（只针对唯一约束和主键约束）。 owner character varying(64) 约束创建者。 父主题： 其他系统视图

PLAN_TABLE PLAN_TABLE显示用户通过执行EXPLAIN PLAN收集到的计划信息。计划信息的生命周期是session级别，session退出后相应的数据将被清除。同时不同session和不同user间的数据是相互隔离的。该视图同时存在PG_CATALOG和SYS schema下。 表1 PLAN_TABLE字段 名称 类型 描述 statement_id character varying(30) 用户输入的查询标签。 plan_id bigint 查询标识。 id integer 查询生成的计划中的每一个执行算子的编号。 operation character varying(30) 计划中算子的操作描述。 options character varying(255) 操作选项。 object_name name 操作对应的对象名，非查询中使用到的对象别名。来自于用户定义。 object_type character varying(30) 对象类型。 object_owner name 对象所属schema，来自于用户定义。 projection character varying(4000) 操作输出的列信息。 cost double precision 优化器对算子估算的执行代价。 cardinality double precision 优化器对算子估算的结果行数。 remarks character varying(4000) 暂不支持，值为NULL。 timestamp timestamp(0) without time zone 暂不支持，值为NULL。 object_node character varying(128) 暂不支持，值为NULL。 object_alias character varying(261) 暂不支持，值为NULL。 object_instance numeric 暂不支持，值为NULL。 optimizer character varying(255) 暂不支持，值为NULL。 search_columns numeric 暂不支持，值为NULL。 parent_id numeric 暂不支持，值为NULL。 depth numeric 暂不支持，值为NULL。 position numeric 暂不支持，值为NULL。 bytes numeric 暂不支持，值为NULL。 other_tag character varying(255) 暂不支持，值为NULL。 partition_start character varying(255) 暂不支持，值为NULL。 partition_stop character varying(255) 暂不支持，值为NULL。 partition_id numeric 暂不支持，值为NULL。 other character varying 暂不支持，值为NULL。 other_xml clob 暂不支持，值为NULL。 distribution character varying(20) 暂不支持，值为NULL。 cpu_cost numeric 暂不支持，值为NULL。 io_cost numeric 暂不支持，值为NULL。 temp_space numeric 暂不支持，值为NULL。 access_predicates character varying(4000) 暂不支持，值为NULL。 filter_predicates character varying(4000) 暂不支持，值为NULL。 time numeric 暂不支持，值为NULL。 qblock_name character varying(128) 暂不支持，值为NULL。 object_type取值范围为PG_CLASS中定义的relkind类型（TABLE普通表，INDEX索引，SEQUENCE序列，VIEW视图，COMPOSITE TYPE复合类型，TOASTVALUE TOAST表）和计划使用到的rtekind(SUBQUERY, JOIN, FUNCTION, VALUES, CTE, REMOTE_QUERY)。 object_owner对于RTE来说是计划中使用的对象描述，非用户定义的类型不存在object_owner。 statement_id、object_name、object_owner、projection字段内容遵循用户定义的大小写存储，其它字段内容采用大写存储。 支持用户对PLAN_TABLE进行SELECT和DELETE操作，不支持其它DML操作。 父主题： 其他系统视图

GS_ILM_OBJECT GS_ILM_OBJECT记录数据对象与策略的关系，同时记录策略在该数据对象上的调度信息等。注意当给分区表的表上设置策略时，此表会为每一个分区/子分区都生成独立的一条记录。 表1 GS_ILM_OBJECT字段 名称 类型 描述 pidx integer 策略编号。 objoid oid 逻辑数据对象oid有分区的表、有二级分区的分区。 dataobjoid oid 物理数据对象oid，真正需要执行策略的实体，树级分区关系的叶子。 objtype "char" 当前数据对象类型： 表（‘r’） 分区（‘p’） 二级分区（‘s’） origobjoid oid 定义该策略的原始对象oid。 origobjtype "char" 定义该策略的原始数据对象类型： 表（‘r’） 分区（‘p’） 二级分区（‘s’） lastchktime timestamp with time zone 最近一次ADO Task时间。 lastexetime timestamp with time zone 最近一次ADO Job时间。 roundcnt smallint 成功回合的次数。 failcnt smallint 失败次数。 lastjobstatus "char" 上一次Job的执行状态。 lastroundstarttime timestamp with time zone 该轮全表扫描开始的时间。 lastjobblkid bigint 上一次Job处理完成的BlockId。 flag smallint 取值范围： 0：启用对象压缩策略。 1：禁用对象压缩策略。 2：启用对象压缩策略，上次压缩调度完成1次全表扫描。 lasthashbktpos ARRAY 记录上一轮压缩调度最后压缩的位置信息，记录两个值[bucketid, blockid]。 父主题： OLTP表压缩

方式一：国密TLS单向认证 前置条件：用户已经获取服务端所需要的国密TLS证书和私钥文件，并完成服务端配置；同时已经获取客户端所需要的cacert.pem根证书，以下步骤4介绍如何将根证书配置在客户端。关于证书生成和获取、服务端配置的具体操作，请联系管理员或参见Openssl相关文档和命令。 使用国密TLS单向认证的方式连接数据库的命令如下： 导入java.sql.Connection、java.sql.DriverManager、java.util.Properties。 此外，用户需要根据实际的应用场景，再导入其他的接口和类，详见JDBC接口参考。 import java.sql.Connection; import java.sql.DriverManager; import java.util.Properties; 指定数据库urls（$ip、$port、database需要用户自行修改）、用户名和密码。 从环境变量EXAMPLE_USERNAME_ENV和EXAMPLE_PASSWORD_ENV获取的用户名和密码设置为Properties对象的属性值。 String urls = "jdbc:gaussdb://$ip:$port/database"; String userName = System.getenv("EXAMPLE_USERNAME_ENV"); String password = System.getenv("EXAMPLE_PASSWORD_ENV"); Properties urlProps = new Properties(); urlProps.setProperty("user", userName); urlProps.setProperty("password", password); 设置SSL属性为true，设置sslmode为verify-ca。 urlProps.setProperty("ssl", "true"); urlProps.setProperty("sslmode", "verify-ca"); 国密TLS单向认证：在客户端配置cacert.pem根证书，sslgmcipher仅允许配置为ECC_SM4_SM3。 sslrootcert和sslgmcipher参数的具体说明，详见sslrootcert和sslgmcipher。 urlProps.setProperty("sslrootcert", "cacert.pem"); urlProps.setProperty("sslgmcipher", "ECC_SM4_SM3"); 加载驱动。 在代码运行工具（如IDE）中添加gaussdbjdbc.jar包。 执行以下命令加载数据库驱动程序“com.huawei.gaussdb.jdbc.Driver”。 Class.forName("com.huawei.gaussdb.jdbc.Driver"); 创建数据库连接。 调用DriverManager.getConnection(String url, Properties info)，进行数据库连接。 Connection conn = DriverManager.getConnection(urls,urlProps);

方式二：国密TLS双向认证 前置条件：用户已经获取服务端所需要的国密TLS证书和私钥文件，并完成服务端配置；同时已经获取客户端所需要的client.key.pk8、client_enc.key.pk8、client.crt、client_enc.crt、cacert.pem证书与私钥文件，以下步骤4介绍如何将证书配置在客户端。关于证书生成和获取、服务端配置的具体操作，请联系管理员或参见Openssl相关文档和命令。 使用国密TLS双向认证的方式连接数据库的前三个步骤和国密TLS单向认证方式的前三个步骤一样，具体如下：

java.sql.Statement java.sql.Statement是SQL语句接口。 表1 对java.sql.Statement的支持情况 方法名 返回值类型 支持JDBC4 支持计划外ALT addBatch(String sql) void Yes Yes clearBatch() void Yes Yes clearWarnings() void Yes Yes close() void Yes Yes closeOnCompletion() void Yes Yes execute(String sql) boolean Yes Yes execute(String sql, int autoGeneratedKeys) boolean Yes Yes execute(String sql, int[] columnIndexes) boolean Yes Yes execute(String sql, String[] columnNames) boolean Yes Yes executeBatch() boolean Yes Yes executeQuery(String sql) ResultSet Yes Yes executeUpdate(String sql) int Yes Yes executeUpdate(String sql, int autoGeneratedKeys) int Yes Yes executeUpdate(String sql, int[] columnIndexes) int Yes Yes executeUpdate(String sql, String[] columnNames) int Yes Yes getConnection() Connection Yes Yes getFetchDirection() int Yes Yes getFetchSize() int Yes Yes getGeneratedKeys() ResultSet Yes Yes getMaxFieldSize() int Yes Yes getMaxRows() int Yes Yes getMoreResults() boolean Yes Yes getMoreResults(int current) boolean Yes Yes getResultSet() ResultSet Yes Yes getResultSetConcurrency() int Yes Yes getResultSetHoldability() int Yes Yes getResultSetType() int Yes Yes getQueryTimeout() int Yes Yes getUpdateCount() int Yes Yes getWarnings() SQLWarning Yes Yes isClosed() boolean Yes Yes isCloseOnCompletion() boolean Yes Yes isPoolable() boolean Yes Yes setCursorName(String name) void Yes Yes setEscapeProcessing(boolean enable) void Yes Yes setFetchDirection(int direction) void Yes Yes setMaxFieldSize(int max) void Yes Yes setMaxRows(int max) void Yes Yes setPoolable(boolean poolable) void Yes Yes setQueryTimeout(int seconds) void Yes Yes setFetchSize(int rows) void Yes Yes cancel() void Yes Yes executeLargeUpdate(String sql) long No Yes getLargeUpdateCount() long No Yes executeLargeBatch() long No Yes executeLargeUpdate(String sql, int autoGeneratedKeys) long No Yes executeLargeUpdate(String sql, int[] columnIndexes) long No Yes executeLargeUpdate(String sql, String[] columnNames) long No Yes enableStreamingResults() void Yes Yes 通过setFetchSize可以减少结果集在客户端的内存占用情况。它的原理是通过将结果集打包成游标，然后分段处理，所以会加大数据库与客户端的通信量，但会有性能损耗。 由于数据库游标是事务内有效，所以，在设置setFetchSize的同时，需要将连接设置为非自动提交模式，setAutoCommit(false)。同时在业务数据需要持久化到数据库中时，在连接上执行提交操作。 LargeUpdate相关方法必须在JDBC4.2及以上版本使用。 enableStreamingResults()是开启流式读的一个自定义接口，该接口间接调用setFetchSize(Integer.MIN_VALUE)。若要开启流式读功能，需要将url中的enableStreamingQuery设置为true，同时调用setFetchSize(Integer.MIN_VALUE)或者enableStreamingResults()。除开启流式读功能外，setFetchSize()的入参只能为正数或者0。 当提交模式为autocommit时，执行executeBatch前如果驱动JDBC侧将 batchMode设置为OFF，executeBatch会将整个batch展开为单独事务执行，等同于批量语句内部包含commit或者abort，执行后不支持ALT重放。 父主题： JDBC接口参考

PG_TRIGGER PG_TRIGGER系统表存储触发器信息。 表1 PG_TRIGGER字段 名称 类型 描述 oid oid 行标识符（隐含属性，必须明确选择）。 tgrelid oid 触发器所在表的OID。 tgname name 触发器名。 tgfoid oid 要被触发器调用的函数。 tgtype smallint 触发器类型。 tgenabled "char" O：表示触发器在“origin”和“local”模式下触发。 D：表示触发器被禁用。 R：表示触发器在“replica”模式下触发。 A：表示触发器始终触发。 tgisinternal boolean 内部触发器标识，如果为true表示内部触发器。 tgconstrrelid oid 完整性约束引用的表。 tgconstrindid oid 完整性约束的索引。 tgconstraint oid 约束触发器在12.2.15.30 PG_CONSTRAINT中的OID。 tgdeferrable boolean 约束触发器是否为DEFERRABLE类型。 t（true）：表示是。 f（false）：表示不是。 tginitdeferred boolean 约束触发器是否为INITIALLY DEFERRED类型。 t（true）：表示是。 f（false）：表示不是。 tgnargs smallint 触发器函数入参个数。 tgattr int2vector 当触发器指定列时的列号，未指定则为空数组。 tgargs bytea 传递给触发器的参数。 tgqual pg_node_tree 表示触发器的WHEN条件，如果没有则为null。 tgowner oid 触发器的所有者。 父主题： 其他系统表

TRANSACTIONS_RUNNING_XA CTS 显示当前节点运行事务的信息，如表1所示。多租场景下，non-PDB访问该视图时返回全部信息，PDB访问该视图时仅返回该PDB相关信息。 表1 TRANSACTIONS_RUNNING_XACTS字段 名称 类型 描述 handle integer 事务对应的事务管理器中的槽位句柄，该值恒为-1。 gxid xid 事务id号。 state tinyint 事务状态（3：prepared或者0：starting）。 node text 节点名称。 xmin xid 节点上当前数据涉及的最小事务号xmin。 vacuum boolean 标志当前事务是否是lazy vacuum事务（lazy vacuum是一种vacuum机制，在需要时进行vacuum）。 true：表示是。 false：表示否。 timeline bigint 标志数据库重启次数。 prepare_xid xid 处于prepared状态的事务的id号，若不在prepared状态，值为0。 pid bigint 事务对应的线程id。 next_xid xid 其余节点发送给当前节点的事务id，该值恒为0。 dbid oid 事务对应的数据库id。 父主题： Transaction

SNAPSHOT.SNAPSHOT SNAPSHOT表记录当前系统中存储的WDR快照数据的索引信息、开始和结束时间。只能在系统库中查询到结果，用户库中无法查询，WDR Snapshot在启动后（打开GUC参数enable_wdr_snapshot）会触发创建该表，如表1所示。 表1 SNAPSHOT表属性 名称 类型 描述 示例 snapshot_id bigint WDR快照序号。 1 start_ts timestamp WDR快照的开始时间。 2019-12-28 17:11:27.423742+08 end_ts timestamp WDR快照的结束时间。 2019-12-28 17:11:43.67726+08 version int WDR快照的版本信息。 1 snap_flag bigint WDR快照的属性。 NULL：代表该快照为旧版本快照。 0：表示该次快照为全量快照。 1：表示该次快照为增量快照。 0 base_snapshot_id bigint WDR快照对应的的全量快照id。 1 父主题： WDR Snapshot原信息

java.sql.PreparedStatement java.sql.PreparedStatement是预处理语句接口。 表1 对java.sql.PreparedStatement的支持情况 方法名 返回值类型 支持JDBC4 支持计划外ALT clearParameters() void Yes Yes execute() boolean Yes Yes executeQuery() ResultSet Yes Yes excuteUpdate() int Yes Yes executeLargeUpdate() long No Yes getMetaData() ResultSetMetaData Yes Yes getParameterMetaData() ParameterMetaData Yes Yes setArray(int parameterIndex, Array x) void Yes Yes setAsciiStream(int parameterIndex, InputStream x, int length) void Yes Yes setBinaryStream(int parameterIndex, InputStream x) void Yes No setBinaryStream(int parameterIndex, InputStream x, int length) void Yes No setBinaryStream(int parameterIndex, InputStream x, long length) void Yes No setBlob(int parameterIndex, InputStream inputStream) void Yes No setBlob(int parameterIndex, InputStream inputStream, long length) void Yes No setBlob(int parameterIndex, Blob x) void Yes No setCharacterStream(int parameterIndex, Reader reader) void Yes No setCharacterStream(int parameterIndex, Reader reader, int length) void Yes No setClob(int parameterIndex, Reader reader) void Yes No setClob(int parameterIndex, Reader reader, long length) void Yes No setClob(int parameterIndex, Clob x) void Yes No setDate(int parameterIndex, Date x, Calendar cal) void Yes Yes setNull(int parameterIndex, int sqlType) void Yes Yes setNull(int parameterIndex, int sqlType, String typeName) void Yes Yes setObject(int parameterIndex, Object x) void Yes No setObject(int parameterIndex, Object x, int targetSqlType) void Yes No setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) void Yes No setSQLXML(int parameterIndex, SQLXML xmlObject) void Yes Yes setTime(int parameterIndex, Time x) void Yes Yes setTime(int parameterIndex, Time x, Calendar cal) void Yes Yes setTimestamp(int parameterIndex, Timestamp x) void Yes Yes setTimestamp(int parameterIndex, Timestamp x, Calendar cal) void Yes Yes setUnicodeStream(int parameterIndex, InputStream x, int length) void Yes Yes setURL(int parameterIndex, URL x) void Yes Yes setBoolean(int parameterIndex, boolean x) void Yes Yes setBigDecimal(int parameterIndex, BigDecimal x) void Yes Yes setByte(int parameterIndex, byte x) void Yes Yes setBytes(int parameterIndex, byte[] x) void Yes Yes setDate(int parameterIndex, Date x) void Yes Yes setDouble(int parameterIndex, double x) void Yes Yes setFloat(int parameterIndex, float x) void Yes Yes setInt(int parameterIndex, int x) void Yes Yes setLong(int parameterIndex, long x) void Yes Yes setShort(int parameterIndex, short x) void Yes Yes setString(int parameterIndex, String x) void Yes Yes setNString(int parameterIndex, String x) void Yes Yes addBatch() void Yes Yes executeBatch() int[] Yes Yes addBatch()、execute()必须在clearBatch()之后才能执行。 调用executeBatch()方法并不会清除batch。用户必须显式使用clearBatch()清除。 在添加了一个batch的绑定变量后，用户若想重用这些值(再次添加一个batch)，无需再次使用set*()方法。 以下方法是从java.sql.Statement继承而来：close、execute、executeQuery、executeUpdate、getConnection、getResultSet、getUpdateCount、isClosed、setMaxRows、setFetchSize、enableStreamingResults。 executeLargeUpdate()方法必须在JDBC4.2及以上版本使用。 当提交模式为autocommit时，执行executeBatch前如果驱动JDBC侧将 batchMode设置为OFF，executeBatch会将整个batch展开为单独事务执行，等同于批量语句内部包含commit或者abort，执行后不支持ALT重放。 父主题： JDBC接口参考

Instance Efficiency Percentages Instance Efficiency Percentages指标名称及描述如表1 Instance Efficiency Percentages报表主要内容所示。 表1 Instance Efficiency Percentages报表主要内容 指标名称 描述 Buffer Hit % Buffer Pool命中率。 Effective CPU % CPU time占DB time的比例。 WalWrite NoWait % 访问WAL Buffer的event次数占总wait event的比例。 Soft Parse % 软解析的次数占总的解析次数的比例。 Non-Parse CPU % 非parse的时间占执行总时间的比例。 父主题： WDR报告信息介绍

MY_ERRORS MY_ERRORS视图显示用户拥有的存储对象的最新编译错误信息。该视图所有用户可访问，仅可查看当前用户所属信息。该视图同时存在于PG_CATALOG和SYS Schema下。 表1 MY_ERRORS字段 名称 类型 描述 name character varying(128) 对象的名称。 type character varying(12) 对象类型： PROCEDURE FUNCTION PACKAGE PACKAGE BODY sequence numeric 序列号。 line numeric 发生错误的行号。 position numeric 发生错误的行中的位置。 text character varying(4000) 错误文本。 attribute character varying(9) 属性标记：错误（ERROR）。 message_number numeric 暂不支持，值为NULL。 父主题： 其他系统视图

STAT_USER_TABLES 显示当前节点所有Schema中用户自定义普通表的状态信息，如表1所示。 表1 STAT_USER_TABLES字段 名称 类型 描述 relid oid 表的OID。 schemaname name 该表所在的Schema名。 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更新行数（即没有更新索引列的行数）。 n_live_tup bigint 估计活跃行数。 n_dead_tup bigint 估计不活跃行数。在Ustore表中仅代表不活跃行指针数量。 last_vacuum timestamp with time zone 最后一次该表是手动清理的（不计算VACUUM FULL）时间。 last_autovacuum timestamp with time zone 上次被autovacuum守护线程清理的时间。 last_analyze timestamp with time zone 上次手动分析该表的时间。 last_autoanalyze timestamp with time zone 上次被autovacuum守护线程分析的时间。 vacuum_count bigint 该表被手动清理的次数（不计算VACUUM FULL）。 autovacuum_count bigint 该表被autovacuum清理的次数。 analyze_count bigint 该表被手动分析的次数。 autoanalyze_count bigint 该表被autovacuum守护线程分析的次数。 last_updated timestamp with time zone 视图中该对象监控数据最后一次更新的时间。 父主题： Object

注意事项 TIMECAPSULE TABLE语句的用法主要分为两大类：闪回旧版本数据和从回收站中闪回。 TO TIMECAPSULE和TO CS N能够将表闪回到过去的某个版本，当前仅支持Ustore存储引擎。 回收站记录了DROP和TRUNCATE的对象数据。TO BEFORE DROP和TO BEFORE TRUNCATE就是从回收站中闪回，当前支持Ustore以及Astore存储引擎。 不支持闪回表的对象类型：系统表、DFS表、全局临时表、本地临时表、UNLOGGED表、序列表、hashbucket表、密态表。 不支持含有自定义类型表的闪回。 开启闪回后，回收站里的表可以进行表级备份，无法进行表级恢复。 闪回点和当前点之间，执行过修改表结构或影响物理存储的语句（DDL、DCL、VACUUM FULL），则闪回失败。 执行闪回删除需要用户具有如下权限：用户必须具有垃圾对象所在Schema的CREATE和USAGE权限，并且用户必须是Schema的所有者或者是垃圾对象的所有者。 执行闪回TRUNCATE需要用户具有如下权限：用户必须具有垃圾对象所在Schema的CREATE和USAGE权限，并且用户必须是Schema的所有者或者是垃圾对象的所有者，另外用户必须具有垃圾对象的TRUNCATE权限。 不适用闪回DROP/TRUNCATE功能的场景或表： 回收站关闭场景：enable_recyclebin = off。 系统处于维护态（xc_maintenance_mode = on）或从不支持的基线版本升级到支持的版本的升级场景。 多对象删除场景：DROP/TRUNCATE TABLE命令同时指定多个对象。 系统表、DFS表、全局临时表、本地临时表、UNLOGGED表、序列表、hashbucket表、密态表。 回收站对象被清理后无法闪回DROP/TRUNCATE，recyclebin_retention_time参数用于设置回收站对象保留时间。 回收站对象禁止DML、DCL、DDL等写操作，不支持DQL查询操作。 truncate表和闪回truncate操作之间，执行过修改表结构或影响物理文件的语句（DDL、DCL、VACUUM FULL、增加/删除/切割/合成等分区操作），闪回失败。 整表删除或截断时，分区会随着整表放入回收站，单个删除的分区不支持放入回收站，避免破坏数据一致性。 如果表依赖的对象为外部对象（如表列为复合类型、自定义类型等），则采用物理删除，不将表放入回收站。 DROP闪回约束 可以指定原始用户指定的表的名称，或对象删除时数据库分配的系统生成名称。 回收站中系统生成的对象名称是唯一的。因此，如果指定系统生成名称，那么数据库检索指定的对象。使用“SELECT * FROM gs_recyclebin;”语句查看回收站中的内容。 如果指定了用户指定的名称，且回收站中包含多个该名称的对象，那么数据库检索回收站中最近移动的对象。如果需要检索更早版本的表，请按以下步骤执行： 指定需要检索的表的系统生成名称。 执行TIMECAPSULE TABLE ... TO BEFORE DROP语句，直到找到要检索的表。 恢复DROP表时，只恢复基表名，其他子对象名均保持回收站对象名。用户可根据需要，执行DDL命令手工调整子对象名。 如果表存在缺省值引用序列和自定义函数，那么闪回DROP表成功但不会恢复缺省值。 如果表存在视图引用，DROP表时需要级联删除视图，那么闪回DROP表成功但不会恢复视图。 回收站对象不支持DML、DCL、DDL等写操作，不支持DQL查询操作（后续支持）。 recyclebin_retention_time配置参数用于设置回收站对象保留时间，超过该时间的回收站对象将被自动清理。 TRUNCATE闪回约束 TRUNCATE闪回后，统计信息无变化，仍显示为0，可以在业务低峰期（降低性能影响）时候手动ANALYZE来修正统计信息。 RENAME TO仅支持DROP闪回操作为检索表指定新名称，不支持TRUNCATE闪回。 TRUNCATE闪回不能跨越影响表结构或物理存储的语句，否则会报错。即闪回点和当前点之间，如果执行过修改表结构或影响物理存储的语句（DDL、DCL、VACUUM FULL、增加/删除/切割/合成等分区操作），则闪回失败。执行过DDL的表进行闪回操作报错：“ERROR：The table definition of %s has been changed.”。涉及namespace、表名改变等操作的DDL执行闪回操作报错：“ERROR: recycle object %s desired does not exist.”。

示例 闪回到某个时间点 需要设置undo_retention_time参数，用于设置旧版本undo的保留时间。 参数使用请联系管理员处理。 --建表并插入数据。 gaussdb=# CREATE TABLE tbl_test(c1 int, c2 int); gaussdb=# INSERT INTO tbl_test VALUES (1,1),(2,2),(3,3); --查询当前时间和全局所有节点上的next_csn。 gaussdb=# SELECT now(); now ------------------------------- 2023-11-27 17:06:34.840698+08 (1 row) gaussdb=# SELECT int8in(xidout(next_csn)) FROM gs_get_next_xid_csn(); int8in -------- 25391 (6 row) --修改数据。 gaussdb=# UPDATE tbl_test SET c1=111, c2=222 WHERE c1=1; --查询数据。 gaussdb=# SELECT * FROM tbl_test; c1 | c2 -----+----- 111 | 222 2 | 2 3 | 3 (3 rows) --将数据闪回至修改之前，需要按照实际情况替换时间 gaussdb=# TIMECAPSULE table tbl_test TO TIMESTAMP to_timestamp('2023-11-27 17:06:34.840698','YYYY-MM-DD HH24:MI:SS.FF'); --也可使使用如下SQL。 gaussdb=# TIMECAPSULE table tbl_test TO CSN 25391; gaussdb=# SELECT * FROM tbl_test; c1 | c2 ----+---- 2 | 2 3 | 3 1 | 1 (3 rows) --删除。 gaussdb=# DROP TABLE tbl_test; 从回收站中闪回数据 前提条件： 开启enable_recyclebin参数，启用回收站，参数使用请联系管理员处理。 recyclebin_retention_time参数用于设置回收站对象保留时间，超过该时间的回收站对象将被自动清理，参数使用请联系管理员处理。 --建表并插入数据。 gaussdb=# CREATE TABLE tbl_test1(c1 int, c2 varchar(10)); gaussdb=# INSERT INTO tbl_test1 VALUES (1,'AAA'),(2,'BBB'); --删除表。 gaussdb=# DROP TABLE tbl_test1; --闪回至表删除之前。 gaussdb=# TIMECAPSULE TABLE tbl_test1 TO BEFORE DROP; --查询数据。 gaussdb=# SELECT * FROM tbl_test1; c1 | c2 ----+----- 1 | AAA 2 | BBB (2 rows) --删除表（添加PURGE参数,级联删除回收站该表数据）。 gaussdb=# DROP TABLE tbl_test1 PURGE;

参数说明 schema 指定模式包含的表。如果缺省，则为当前模式。 table_name 指定表名。 TO CSN 指定要返回表的时间点对应的事务提交序列号（CSN）。expr必须计算一个数字，代表有效的CSN。 TO TIMESTAMP 指定要返回表的时间点对应的时间戳。expr必须计算一个过去有效的时间戳（使用TO_TIMESTAMP函数将字符串转换为时间类型）。表将被闪回到指定时间戳大约3秒内的时间点。 说明：闪回点过旧时，因旧版本被回收导致无法获取旧版本，会导致闪回失败并报错：Restore point too old。 TO BEFORE DROP 使用这个子句检索回收站中已删除的表及其子对象。 RENAME TO 为从回收站中检索的表指定一个新名称。 TO BEFORE TRUNCATE 闪回到TRUNCATE之前。

GS_PACKAGE GS_PACKAGE系统表记录PACKAGE内的信息。 表1 GS_PACKAGE字段 名称 类型 描述 oid oid 行标识符（隐含属性，必须明确选择）。 pkgnamespace oid package所属schema。 pkgowner oid package的所属者。 pkgname name package的名字。 pkgspecsrc text package specification的内容。 pkgbodydeclsrc text package body的内容。 pkgbodyinitsrc text package init的内容。 pkgacl aclitem[] 访问权限。 pkgsecdef boolean package是否是定义者权限。 父主题： 其他系统表

示例 --创建并切换至测试数据库。 gaussdb=# CREATE DATABASE test_event WITH DBCOMPATIBILITY = 'b'; gaussdb=# \c test_event --创建表。 test_event=# CREATE TABLE t_ev(num int); --创建一个状态为DISABLE的定时任务，表示此定时任务不开启。 test_event=# CREATE EVENT IF NOT EXISTS event_e1 ON SCHEDULE AT sysdate + interval 5 second DISABLE DO insert into t_ev values(0); --查询定时任务，ENABLE值为'f'。 test_event=# SHOW EVENTS; job_name | schema_name | log_user | priv_user | job_status | start_date | interval | end_date | enable | failure_msg ----------+-------------+----------+-----------+------------+---------------------+----------+---------------------+--------+------------- event_e1 | public | omm | omm | s | 2023-11-28 09:10:58 | null | 3999-12-31 16:00:00 | f | (1 row) --修改定时任务状态为ENABLE,并五秒后查询表。 test_event=# ALTER EVENT event_e1 ENABLE; test_event=# SELECT * FROM t_ev; num ----- 0 (1 row) --创建一个每隔一分钟执行一次的定时任务。 test_event=# CREATE EVENT IF NOT EXISTS event_e2 ON SCHEDULE EVERY 1 minute DO insert into t_ev values(1); --每隔一分钟查询表，会看到新增一条数据。 test_event=# SELECT * FROM t_ev; num ----- 0 1 1 (3 rows) --修改定时任务中待执行语句并查询表。 test_event=# ALTER EVENT event_e2 DO insert into t_ev values(3); test_event=# SELECT * FROM t_ev; num ----- 0 1 1 3 (4 rows) --修改定时任务名称。 test_event=# ALTER EVENT event_e2 RENAME TO event_ee; --删除定时任务。 test_event=# DROP EVENT event_ee; --删除表。 test_event=# DROP TABLE t_ev; --切换回初始数据库，并删除测试数据库。请用真实的数据库名替换postgres。 test_event=# \c postgres gaussdb=# DROP DATABASE test_event;

参数说明 DEFINER 定时任务待执行语句在执行时使用的权限。默认情况下使用当前创建定时任务者的权限，当definer被指定时，使用被指定用户user的用户权限。 definer参数只有具有sysadmin权限的用户有权指定。 ON SCHEDULE 定时任务执行时刻。其中schedule子句与CREATE EVENT中schedule一致。 RENAME TO 更新定时任务名。 ON COMPLETION [NOT] PRESERVE 默认情况下，一旦事务处于完成状态，系统表中就会立刻删除该定时任务。用户可以通过设置ON COMPLETION PRESERVE来覆盖默认行为。 ENABLE | DISABLE | DISABLE ON SLAVE 创建定时任务后，定时任务默认处于ENABLE状态，即到规定时间立即执行待执行语句。用户可以使用DISABLE关键字，改变定时任务的活动状态。DISABLE ON SLAVE表现与DISABLE一致。 COMMENT 用户可以给定时任务添加注释，注释内容在GS_JOB_ATTRIBUTE表中查看。 DO 定时任务待执行语句。 interval 时间间隔。interval的取值可以使用下划线代替TO。例如，YEAR_MONTH、DAY_HOUR等。 该参数在B兼容模式下，GUC参数b_format_version = '5.7'、b_format_dev_version = 's1'时才可使用。

注意事项 定时任务相关操作只有sql_compatibility = 'B'时支持。 只有定时任务的所有者有权修改对应的定时任务，系统管理员默认拥有修改所有定时任务的权限。 可以通过SHOW EVENTS或在PG_JOB表中查看log_user列来获得job的所有者信息。 每次修改定时任务成功后，会更新被修改job的所有者为当前用户，若修改定时任务时指定了definer，则更新为被指定的definer。 definer选项场景限制与CREATE EVENT章节中对definer限制场景一致。 系统管理员修改其他用户创建的定时任务后，被修改定时任务的所有者将切换为系统管理员，待执行语句将使用系统管理员的权限执行。

语法格式 ALTER [DEFINER = user] EVENT event_name [ON SCHEDULE schedule] [ON COMPLETION [NOT] PRESERVE] [RENAME TO new_event_name] [ENABLE | DISABLE | DISABLE ON SLAVE] [COMMENT 'string'] [DO event_body]; schedule： 1 2 3 4 5 6 { AT timestamp [+ INTERVAL interval] ... | EVERY interval [STARTS timestamp [+ INTERVAL interval] ...] [ENDS timestamp [+ INTERVAL interval] ...] } interval： quantity {YEAR | MONTH | DAY | HOUR | MINUTE | SECOND | YEAR TO MONTH | DAY TO HOUR | DAY TO MINUTE | DAY TO SECOND | HOUR TO MINUTE | HOUR TO SECOND | MINUTE TO SECOND}

注意事项 当参数enable_copy_server_files关闭时，只允许初始用户执行COPY FROM FILENAME或COPY TO FILENAME命令，当参数enable_copy_server_files打开时，允许具有SYSADMIN权限的用户或继承了内置角色gs_role_copy_files权限的用户执行，但默认禁止对数据库配置文件，密钥文件，证书文件和审计日志执行COPY FROM FILENAME或COPY TO FILENAME，以防止用户越权查看或修改敏感文件。同时enable_copy_server_files打开时，管理员可以通过guc参数safe_data_path设置普通用户可以导入导出的路径必须为设置路径的子路径，未设置此guc参数时候（默认情况），不对普通用户使用的路径进行拦截。该参数会对copy使用路径中的相对路径进行报错处理。在多租场景下，仅有初始用户可在PDB内部执行COPY FROM FILENAME或COPY TO FILENAME命令。 COPY只能用于表，不能用于视图。 COPY TO需要读取的表的SELECT权限，COPY FROM需要插入的表的INSERT权限。 如果声明了一个字段列表，COPY将只在文件和表之间复制已声明字段的数据。如果表中有任何不在字段列表里的字段，COPY FROM将为那些字段插入缺省值。 如果声明了数据源文件，服务器必须可以访问该文件；如果指定了STDIN，数据将在客户前端和服务器之间流动，输入时，表的列与列之间使用TAB键分隔，在新的一行中以反斜杠和句点（\.）表示输入结束。 如果数据文件的任意行包含比预期多或者少的字段，COPY FROM将抛出一个错误。 数据的结束可以用一个只包含反斜杠和句点（\.）的行表示。如果从文件中读取数据，数据结束的标记是不必要的；如果在客户端应用之间复制数据，必须要有结束标记。 COPY FROM中\N为空字符串，如果要输入实际数据值\N ，使用\\N。