华为云用户手册

gs_redis_set_csn(csn BIGINT) 描述：修改DN节点next_csn值。只支持在扩容期间调用；只支持管理员权限用户查询；只支持DN上调用；只支持在GTM_FREE模式下调用。 参数说明： csn：预期next_csn的值。 返回值类型：void 示例： gaussdb=# SELECT * FROM gs_redis_set_csn('15268817'); gs_redis_set_csn ------------------------------------------- 0 (1 row)

gs_redis_get_flush_page_lsn(isclean bool) 描述：查询bucket扩容回放的刷页信息。 权限：只支持debug版本调用，只支持在扩容期间调用;只支持管理员权限用户查询。 参数说明：isclean：BOOLEAN类型，是否清理刷页信息。 返回值说明： 名称 类型 描述 node_name TEXT 页面所在dn名 space_id OID 表空间id db_id OID 数据库id file_id OID 数据文件编号，取值范围1-5 bucket_id OID bucket分区id，取值范围0-1023 forknum OID 数据文件分支，取值范围0-2 blocknum OID 物理页面在数据文件中的偏移页面号 latest_flush_lsn UINT8 刷脏页面最新的lsn 示例： gaussdb=# SELECT * FROM gs_redis_get_flush_page_lsn(false); node_name | space_id | db_id | file_id | bucket_id | forknum | blocknum | last_flush_lsn ------------------------------------------------------------------------------------------- datanode2 | 1633 | 16387 | 1 | 66 | 0 | 20 | 1571838992 (1 row)

bucket_lock_status 描述：查询打开事务所持有的bucket锁信息，所有用户均可执行该函数。 参数说明：void 返回值说明： 名称 类型 描述 database oid 被锁定对象所在数据库的OID。 virtualtransaction text 持有此锁或者在等待此锁的事务的虚拟ID。 pid bigint 持有或者等待这个锁的服务器线程的逻辑ID。如果锁是被一个预备事务持有的，则为NULL。 sessionid bigint 持有或者等待这个锁的会话ID。 mode text 这个线程持有的或者是期望的锁模式。 可能取值为：AccessShareLock、AccessExclusiveLock。 granted boolean 如果锁是持有锁，则为TRUE。 如果锁是等待锁，则为FALSE。 fastpath boolean 如果通过fast-path获得锁，则为TRUE；如果通过库级别锁信息获得锁或者两阶段提交时的锁，则为FALSE。 global_sessionid text 全局会话ID。 bucketlist text 被锁定的bucket在所属bucket组中的位置。 bucket_group smallint 被锁定的bucket所在的bucket组。 示例： gaussdb=# SELECT * FROM bucket_lock_status(); database | virtualtransaction | pid | sessionid | mode | granted | fastpath | global_sessionid | bucketlist | bucket_group ----------+--------------------+-----------------+-----------+-----------------+---------+----------+------------------+------------+-------------- 14934 | 8/25 | 140376742557440 | 2 | AccessShareLock | t | t | 1938253334:2#0 | (977,978) | 2 (1 row)

gs_redis_hashbucket_update_inverse_pointer(buckets TEXT, origin_dn_name TEXT, new_dn_name TEXT) 描述：更新当前db所有hashbucket表本批次bucket的反向指针。只支持在扩容期间调用；只支持管理员权限用户查询；只支持CN上调用。 参数说明： 名称 类型 描述 buckets TEXT 本次上线的bucket列表。 origin_dn_name TEXT 源节点名称。 new_dn_name TEXT 新节点名称。 返回值类型：void 示例： gaussdb=# SELECT * FROM gs_redis_hashbucket_update_inverse_pointer('0,1,2,3,4,5,6,7,8,9,10','datanode1','datanode3'); gs_redis_hashbucket_update_inverse_pointer ------------------------------------------- 0 (1 row)

gs_redis_set_distributed_db(db_name CS TRING, bucketgroup SMALLINT) 描述：设置当前正在hashbucket重分布的数据库和bucketgroup。只支持在扩容期间调用；只支持管理员权限用户查询；只支持DN上调用。 参数说明： db_name：本次要重分布的数据库库名。 返回值说明：void 示例： gaussdb=# SELECT gs_redis_set_distributed_db('gaussdb', 0); gs_redis_set_distributed_db ----------------------------- 0 (1 row)

gs_redis_hashbucket_update_segment_header(origin_group_id OID，target_group_id OID) 描述：更新当前数据库所有hashbucket表的header。只支持在扩容期间调用；只支持管理员权限用户查询；只支持CN上调用。 参数说明： 名称 类型 描述 origin_group_id OID 源节点的node group。 target_group_id OID 新节点的node group。 返回值类型：Boolean 示例： gaussdb=# SELECT * FROM gs_redis_hashbucket_update_segment_header(16388, 16417); gs_redis_hashbucket_update_segment_header ------------------------------------------- t (1 row)

gs_redis_local_get_segment_header(table_name REGCLASS，bucketlist OIDVECTOR_EXTEND) 描述：获取段页式表header。只支持DN上调用。 参数说明： 名称 类型 描述 table_name REGCLASS 表名 bucketlist OIDVECTOR_EXTEND bucket列表。 返回值类型：header_info 示例： gaussdb=# SELECT * FROM gs_redis_local_get_segment_header('mytable', '256'); gs_redis_local_get_segment_header ---------------------------------------------------------------------------------------------------------------------------- 4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,...(数据较多，仅展示部分) (1 row)

gs_redis_local_update_segment_header(table_name REGCLASS，header_info CSTRING) 描述：更新段页式表header。只支持DN上调用。 参数说明： 名称 类型 描述 table_name REGCLASS 表名 header_info CSTRING 段页式表header。 返回值类型：void 示例： gaussdb=# SELECT * FROM gs_redis_local_update_segment_header('mytable', '4294967295,4294967295,4294967295,4294967295,....'); (数据较多，仅展示部分) gs_redis_local_update_segment_header ------------------------------------------- 0 (1 row)

gs_redis_local_get_inverse_pointer(buckets TEXT，origin_dn_name TEXT, new_dn_name TEXT) 描述：获取反向指针。只支持在扩容期间调用；只支持管理员权限用户查询；只支持DN上调用。 参数说明： 名称 类型 描述 buckets TEXT 本次上线的bucket列表。 origin_dn_name TEXT 源节点名称。 new_dn_name TEXT 新节点名称。 返回值类型：void 示例： gaussdb=# SELECT * FROM gs_redis_hashbucket_update_inverse_pointer('0,1,2,3,4,5,6,7,8,9,10','datanode1','datanode3'); gs_redis_hashbucket_update_inverse_pointer ------------------------------------------- 0 (1 row)

gs_redis_get_plan(origin_group_id OID，target_group_id OID) 描述：获取完整的迁移计划。只支持在扩容期间调用；只支持管理员权限用户查询；只支持CN上调用。 参数说明： 名称 类型 描述 origin_group_id OID 源节点的node group。 target_group_id OID 新节点的node group。 返回值说明： 名称 类型 描述 sender_id OID 源节点的node oid。 sender_name CSTRING 源节点的节点名称。 receiver_id OID 新节点的node oid。 receiver_name CSTRING 新节点的节点名称。 bucket_number INT4 bucket_list中包含的bucket个数。 bucket_list OIDVECTOR_EXTEND 迁移计划涉及的bucket列表。 示例： gaussdb=# SELECT * FROM gs_redis_get_plan(16388, 16417); sender_id | sender_name | receiver_id | receiver_name | bucket_number | bucket_list -----------+-------------+-------------+---------------+---------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 16385 | datanode1 | 16415 | datanode3 | 256 | 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 18 8 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 2 48 249 250 251 252 253 254 255 16386 | datanode2 | 16416 | datanode4 | 256 | 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 55 3 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 6 13 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 (2 rows)

gs_redis_get_bucket_statistics 描述：获取日志流传输状态。只支持在扩容期间调用；只支持管理员权限用户查询。 参数：void 返回值说明： 名称 类型 描述 bucket_id OID bucket id redis_state INT1 bucket的扩容状态，0表示扩容未开始，1表示扩容基线数据已完成。 xlog_count INT8 bucket在当前database扩容开始后（即上次调用gs_redis_set_distributed_db后）在原DN产生的xlog数量。 sndr_latest_lsn INT8 bucket在当前database扩容开始后（即上次调用gs_redis_set_distributed_db后）在原DN产生的最新LSN。 parser_latest_lsn INT8 bucket在当前database扩容开始后（即上次调用gs_redis_set_distributed_db后）被原DN的扩容相关线程解析到的最新LSN。 parser_latest_lsn_new INT8 bucket在当前database扩容开始后（即上次调用gs_redis_set_distributed_db后）被原DN的扩容相关线程解析到bucketxlog的最新LSN。 rcvr_redo_latest_lsn INT8 bucket在当前database扩容开始后（即上次调用gs_redis_set_distributed_db后）被新DN的扩容相关线程回放到的最新LSN。 rcvr_redo_latest_lsn_new INT8 bucket在当前database扩容开始后（即上次调用gs_redis_set_distributed_db后）被原DN的扩容相关线程解析到bucketxlog的最新LSN。 rcvr_checkpoint INT8 bucket在当前database扩容开始后（即上次调用gs_redis_set_distributed_db后）的checkpoint点。 rcvr_redo_start_lsn INT8 bucket在当前database扩容开始后（即上次调用gs_redis_set_distributed_db后）回放开始的原始LSN。 rcvr_redo_end_lsn INT8 bucket在当前database扩容开始后（即上次调用gs_redis_set_distributed_db后）回放结束的原始LSN。 示例： gaussdb=# SELECT * FROM gs_redis_get_bucket_statistics(); bucket_id | redis_state | xlog_count | sndr_latest_lsn | parser_latest_lsn | parser_latest_lsn_new | rcvr_redo_latest_lsn | rcvr_redo_latest_lsn_new | rcvr_checkpoint | rcvr_redo_start_lsn | rcvr_redo_end_lsn -----------+-------------+------------+-----------------+-------------------+-----------------------+----------------------+--------------------------+-----------------+ --------------------+------------------- 0 | 1 | 1 | 79303808 | 79303808 | 16777352 | 79326320 | 16801904 | 762624525 | 77256412 | 79326320 1 | 1 | 1 | 79303896 | 79303896 | 16777448 | 79326320 | 16801904 | 762624525 | 77256412 | 79326320 2 | 1 | 1 | 79303984 | 79303984 | 16777544 | 79326320 | 16801904 | 762624525 | 77256412 | 79326320 3 | 1 | 1 | 79304072 | 79304072 | 16777640 | 79326320 | 16801904 | 762624525 | 77256412 | 79326320 4 | 1 | 1 | 79304160 | 79304160 | 16777736 | 79326320 | 16801904 | 762624525 | 77256412 | 79326320 ...(数据较多，仅展示部分)

GLOBAL_WAL_SENDER_STATUS GLOBAL_WAL_SENDER_STATUS视图显示当前集群主DN实例的redo日志传输和回放状态。该视图只有monitor admin和sysadmin权限可以查看。 表1 GLOBAL_WAL_SENDER_STATUS字段 名称 类型 描述 nodename text 主节点名。 source_ip text 主节点IP。 source_port integer 主节点端口。 dest_ip text 备节点IP。 dest_port integer 备节点端口。 sender_pid integer 发送线程PID。 local_role text 主节点类型。 UNKNOWN_MODE： 状态未知。 NORMAL_MODE：单主机节点类型。 PRIMARY_MODE：节点类型为主节点。 STANDBY_MODE：节点类型为备节点。 CASCADE_STANDBY_MODE：节点类型为级联备节点。 PENDING_MODE：该节点在仲裁阶段。 RECOVERY_MODE：该节点在恢复阶段。 STANDBY_CLUSTER_MODE：该节点类型为备集群节点。 MAIN_STANDBY_MODE：该节点类型为首备集群节点。 说明： 主节点类型期望值为: NORMAL_MODE、PRIMARY_MODE、PENDING_MODE、RECOVERY_MODE。如出现其他节点类型，请联系华为技术工程师提供技术支持。 peer_role text 备节点类型。 UNKNOWN_MODE： 状态未知。 NORMAL_MODE：单主机节点类型。 PRIMARY_MODE：节点类型为主节点。 STANDBY_MODE：节点类型为备节点。 CASCADE_STANDBY_MODE：节点类型为级联备节点。 PENDING_MODE：该节点在仲裁阶段。 RECOVERY_MODE：该节点在恢复阶段。 STANDBY_CLUSTER_MODE：该节点类型为备集群节点。 MAIN_STANDBY_MODE：该节点类型为首备集群节点。 说明： 备节点类型期望值为: NORMAL_MODE、STANDBY_MODE、CASCADE_STANDBY_MODE、PENDING_MODE、RECOVERY_MODE、STANDBY_CLUSTER_MODE、MAIN_STANDBY_MODE。如出现其他节点类型，请联系华为技术工程师提供技术支持。 peer_state text 备节点状态。 UNKNOWN_STATE：节点状态未知。 NORMAL_STATE：表示节点启动正常。 NEEDREPAIR_STATE：当前节点需要修复。 STARTING_STATE：节点正在启动中。 WAITING_STATE：节点正等待升级中。 DEMOTING_STATE：节点正在降级中。 PROMOTING_STATE：备节点正在升级为主节点的状态 BUILDING_STATE：备机启动失败, 需要重建。 CATCHUP_STATE：备节点正在追赶主节点。 COREDUMP_STATE：节点崩溃。 state text wal sender状态。 WALSNDSTATE_STARTUP：启动状态。 WALSNDSTATE_BACKUP：备份状态。 WALSNDSTATE_CATCHUP：追赶状态。 WALSNDSTATE_STREAMING：流复制状态。 sender_sent_location text 主节点发送位置。 sender_write_location text 主节点落盘位置。 sender_flush_location text 主节点将缓存写入磁盘的位置。 sender_replay_location text 主节点redo位置。 receiver_received_location text 备节点接收位置。 receiver_write_location text 备节点落盘位置。 receiver_flush_location text 备节点将缓存写入磁盘的位置。 receiver_replay_location text 备节点redo位置。 父主题： 其他系统视图

java.sql.ResultSetMetaData java.sql.ResultSetMetaData是对ResultSet对象相关信息的具体描述。 表1 对java.sql.ResultSetMetaData的支持情况 方法名 返回值类型 支持JDBC4 getCatalogName(int column) String Yes getColumnClassName(int column) String Yes getColumnCount() int Yes getColumnDisplaySize(int column) int Yes getColumnLabel(int column) String Yes getColumnName(int column) String Yes getColumnType(int column) int Yes getColumnTypeName(int column) String Yes getPrecision(int column) int Yes getScale(int column) int Yes getSchemaName(int column) String Yes getTableName(int column) String Yes isAutoIncrement(int column) boolean Yes isCaseSensitive(int column) boolean Yes isCurrency(int column) boolean Yes isDefinitelyWritable(int column) boolean Yes isNullable(int column) int Yes isReadOnly(int column) boolean Yes isSearchable(int column) boolean Yes isSigned(int column) boolean Yes isWritable(int column) boolean Yes 父主题： JDBC接口参考

STAT_USER_INDEXES 显示当前节点中用户自定义普通表的索引状态信息，如表1所示。 表1 STAT_USER_INDEXES字段 名称 类型 描述 relid oid 该索引的表的OID。 indexrelid oid 索引的OID。 schemaname name 索引所在的Schema名。 relname name 索引的表名。 indexrelname name 索引名。 idx_scan bigint 该索引上执行的索引扫描次数。 idx_tup_read bigint 该索引上扫描返回的索引项数。 idx_tup_fetch bigint 通过该索引的简单索引扫描在原表中抓取的活跃行数。 last_updated timestamp with time zone 视图中该对象监控数据最后一次更新的时间。 父主题： Object

示例 gaussdb=# DECLARE v_num integer default NULL; BEGIN IF v_num IS NOT NULL THEN raise info 'v_num is NULL'; ELSE NULL; -- 不需要处理任何数据。 END IF; END; / ANONYMOUS BLOCK EXECUTE

DBE_PLDEBUGGER.step debug端调试过程中，如果当前执行的是一个存储过程，则进入该存储过程继续调试，返回该存储过程第一行的行号等信息，如果当前执行的不是存储过程，则和next行为一致，执行该sql后返回下一行的行号等信息，如表1所示。 表1 step入参和返回值列表 名称 类型 描述 funcoid OUT oid 函数id。 funcname OUT text 函数名。 lineno OUT integer 当前调试运行的下一行行号。 query OUT text 当前调试的下一行函数源码。 父主题： DBE_PLDEBUGGER Schema

GS_ LOG ICAL_NAMESPACE GS_LOGICAL_NAMESPACE系统表存储名称空间相关的信息。 表1 GS_LOGICAL_NAMESPACE字段 字段名称 字段类型 说明 nspid oid 命名空间的OID。 nspname name 命名空间名称。 nspowner oid 命名空间所有者的OID。 nsptimeline bigint 命名空间的时间线标识符。 csnmin bigint 插入元组时的 CSN（提交序列号）。 csnmax bigint 更新或删除元组时的 CSN。 createtime timestamp with time zone 插入元组的时间戳。 originid integer 元组的来源标识符。 dbnode oid 数据库OID。 父主题： 逻辑解码

参数说明 schema_name 模式名称。 模式名不能和当前数据库里其他的模式重名。 模式名不能和当前数据库的初始用户重名。 模式的名称不能以“pg_”开头。 模式的名称不能以“gs_role_”开头。 取值范围：字符串，要符合标识符命名规范。 AUTHORIZATION user_name 指定模式的所有者。当不指定schema_name时，把user_name当作模式名，此时user_name只能是角色名。 取值范围：已存在的用户名/角色名。 WITH BLOCKCHAIN 指定模式的防篡改属性。防篡改模式下的普通行存表为防篡改用户表。 创建防篡改模式，需设置GUC参数enable_ledger为on，该参数默认值为off，级别为SIGHUP。 schema_element 在模式里创建对象的SQL语句。目前仅支持CREATE TABLE、CREATE VIEW、CREATE INDEX、CREATE TABLE PARTITION、CREATE SEQUENCE、CREATE TRIGGER、GRANT子句。 子命令所创建的对象都被AUTHORIZATION子句指定的用户所拥有。 如果当前搜索路径上的模式中存在同名对象时，需要明确指定引用对象所在的模式。可以通过命令SHOW SEARCH_PATH来查看当前搜索路径上的模式。

示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 --创建一个角色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; --创建角色role2。 gaussdb=# CREATE ROLE role2 IDENTIFIED BY '********'; --根据名称创建schema。 gaussdb=# CREATE SCHEMA schema1 AUTHORIZATION role2; CREATE SCHEMA --在进行防篡改属性修改前，需要对enable_ledger参数进行设置，enable_ledger参数默认为off,所以通过gs_guc来设置其为on。 gs_guc reload -Z coordinator -Z datanode -N all -I all -c "enable_ledger=on"; --设置完之后查看其参数状态为on说明设置成功，就可以进行防篡改属性属性配置。 gaussdb=# SHOW enable_ledger; enable_ledger --------------- on (1 row) --指定防篡改属性创建schema。 gaussdb=# CREATE SCHEMA ledgernsp WITH BLOCKCHAIN; CREATE SCHEMA --删除schema。 gaussdb=# DROP SCHEMA role1 CASCADE; gaussdb=# DROP SCHEMA schema1 CASCADE; gaussdb=# DROP SCHEMA ledgernsp CASCADE; --删除用户。 gaussdb=# DROP USER role1 CASCADE; gaussdb=# DROP USER role2 CASCADE;

语法格式 根据指定的名称创建模式。 1 2 CREATE SCHEMA schema_name [ AUTHORIZATION user_name ] [WITH BLOCKCHAIN] [ schema_element [ ... ] ]; 根据用户名创建模式。 1 CREATE SCHEMA AUTHORIZATION user_name [ schema_element [ ... ] ];

SUMMARY_STAT_XACT_SYS_TABLES 显示集群内所有节点的Schema中系统表的事务状态统计信息（在CN节点使用，按表名对每个节点中表的事务状态统计信息汇总求和），如表1所示。 表1 SUMMARY_STAT_XACT_SYS_TABLES字段 名称 类型 描述 schemaname name 该表所在的Schema名。 relname name 表名。 seq_scan numeric 该表发起的顺序扫描数。 seq_tup_read numeric 顺序扫描抓取的活跃行数。 idx_scan numeric 该表发起的索引扫描数。 idx_tup_fetch numeric 索引扫描抓取的活跃行数。 n_tup_ins numeric 插入行数。 n_tup_upd numeric 更新行数。 n_tup_del numeric 删除行数。 n_tup_hot_upd numeric HOT更新行数（即没有更新索引列的行数）。 父主题： Object

MY_COLL_TYPES MY_COLL_TYPES视图显示当前用户创建的集合类型信息。默认所有用户都可以访问。该视图同时存在于PG_CATALOG和SYS Schema下。具体字段信息如表1所示。 表1 MY_COLL_TYPES字段 名称 类型 描述 owner character varying(128) 集合的所有者。 type_name character varying(128) 集合的名称。 coll_type character varying(128) 集合的描述。 upper_bound numeric 暂不支持，值为NULL。 elem_type_mod character varying(7) 暂不支持，值为NULL。 elem_type_owner character varying(128) 集合基于的元素类型的所有者。该值主要用于用户定义的类型。 elem_type_name character varying(128) 集合所依据的数据类型或用户定义类型的名称。 length numeric 暂不支持，值为NULL。 precision numeric 暂不支持，值为NULL。 scale numeric 暂不支持，值为NULL。 character_set_name character varying(44) 暂不支持，值为NULL。 elem_storage character varying(7) 暂不支持，值为NULL。 nulls_stored character varying(3) 暂不支持，值为NULL。 char_used character varying(1) 暂不支持，值为NULL。 父主题： 其他系统视图

_PG_FOREIGN_TABLE_COLUMNS 显示外部表的列信息，如表1所示。该视图只有sysadmin权限可以查看。 表1 _PG_FOREIGN_TABLE_COLUMNS字段 名称 类型 描述 nspname name schema名称。 relname name 表名称。 attname name 列名称。 attfdwoptions text[] 外部数据封装器的属性选项，使用“keyword=value”格式的字符串。 父主题： Information Schema

参数说明 agg_name 聚集函数的名称 agg_type 聚集函数参数的类型 source_type 类型转换的源数据类型。 target_type 类型转换的目标数据类型。 object_name 对象名。 table_name.column_name view_name.column_name 列名称。前缀可加表名称或者视图名称。 constraint_name 表约束的名称。 table_name 表的名称。 function_name 函数名称。 argmode,argname,argtype 函数参数的模式、名称、类型。 large_object_oid 大对象的OID。 operator_name 操作符名称。 left_type,right_type 操作参数的数据类型（可以用模式修饰）。当前置或者后置操作符不存在时，可以增加NONE选项。 text 注释。

示例 --建表。 gaussdb=# CREATE TABLE emp( empno varchar(7), ename varchar(50), job varchar(50), mgr varchar(7), deptno int ); --表添加注释。 gaussdb=# COMMENT ON TABLE emp IS '部门表'; --字段添加注释。 gaussdb=# COMMENT ON COLUMN emp.empno IS '员工编号'; gaussdb=# COMMENT ON COLUMN emp.ename IS '员工姓名'; gaussdb=# COMMENT ON COLUMN emp.job IS '职务'; gaussdb=# COMMENT ON COLUMN emp.mgr IS '上司编号'; gaussdb=# COMMENT ON COLUMN emp.deptno IS '部门编号'; --查看表的注释。 gaussdb=# \d+ Schema | Name | Type | Owner | Size | Storage | Description --------+-------------+----------+-------+------------+----------------------------------+------------- public | emp | table | omm | 0 bytes | {orientation=row,compression=no} | 部门表 --查看字段注释。 gaussdb=# \d+ emp Table "public.emp" Column | Type | Modifiers | Storage | Stats target | Description --------+-----------------------+-----------+----------+--------------+------------- empno | character varying(7) | | extended | | 员工编号 ename | character varying(50) | | extended | | 员工姓名 job | character varying(50) | | extended | | 职务 mgr | character varying(7) | | extended | | 上司编号 deptno | integer | | plain | | 部门编号 Has OIDs: no Distribute By: HASH(empno) Location Nodes: ALL DATANODES Options: orientation=row, compression=no --删除表emp。 gaussdb=# DROP TABLE emp;

语法格式 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 COMMENT ON { AGGREGATE agg_name (agg_type [, ...] ) | CAST (source_type AS target_type) | COLLATION object_name | COLUMN { table_name.column_name | view_name.column_name } | CONSTRAINT constraint_name ON table_name | CONVERSION object_name | DATABASE object_name | DOMAIN object_name | EXTENSION object_name | FOREIGN DATA WRAPPER object_name | FOREIGN TABLE object_name | FUNCTION function_name ( [ {[ argname ] [ argmode ] argtype} [, ...] ] ) | INDEX object_name | OPERATOR operator_name (left_type, right_type) | OPERATOR CLASS object_name USING index_method | OPERATOR FAMILY object_name USING index_method | [ PROCEDURAL ] LANGUAGE object_name | ROLE object_name | SCHEMA object_name | SERVER object_name | TABLE object_name | TABLESPACE object_name | TEXT SEARCH CONFIGURATION object_name | TEXT SEARCH DICTIONARY object_name | TEXT SEARCH PARSER object_name | TEXT SEARCH TEMPLATE object_name | TYPE object_name | VIEW object_name | TRIGGER trigger_name ON table_name } IS 'text';

注意事项 每个对象只存储一条注释，因此要修改一个注释，对同一个对象发出一条新的COMMENT命令即可。要删除注释，在文本字符串的位置写上NULL即可。当删除对象时，注释自动被删除。 目前注释浏览没有安全机制，任何连接到某数据库上的用户都可以看到所有该数据库对象的注释。共享对象（比如数据库、角色、表空间）的注释是全局存储的，连接到任何数据库的任何用户都可以看到它们。因此，不要在注释里存放与安全有关的敏感信息。 对大多数对象，只有对象的所有者或者被授予了对象COMMENT权限的用户可以设置注释，系统管理员默认拥有该权限。 角色没有所有者，所以COMMENT ON ROLE命令仅可以由系统管理员对系统管理员角色执行，有CREATE ROLE权限的角色也可以为非系统管理员角色设置注释。系统管理员可以对所有对象进行注释。

PG_SECLABELS PG_SECLABELS视图显示安全标签的信息。 表1 PG_SECLABELS字段 名称 类型 引用 描述 objoid oid 任意OID属性 该安全标签所属的对象的OID。 classoid oid PG_CLASS.oid 该安全标签所属的对象所在系统表的OID。 objsubid integer - 对于一个在表字段上的安全标签，该字段是字段序号（引用表本身的objoid和classoid）。 对于所有其他对象类型，该字段为0。 objtype text - 该标签所属的对象的类型，文本格式。例如： table：表类型。 column：列类型。 objnamespace oid PG_NAMESPACE.oid 该对象的名称空间的OID，如果不适用，取值为NULL。 objname text - 该标签所属的对象的名称，文本格式。 provider text PG_SECLABEL.provider 该标签的提供者。 label text PG_SECLABEL.label 安全标签名称。 父主题： 用户和权限管理

SUMMARY_STAT_XACT_USER_FUNCTIONS 显示集群内各节点，本事务内函数执行的统计信息的汇总求和结果（在CN节点使用），如表1所示。 表1 SUMMARY_STAT_XACT_USER_FUNCTIONS字段 名称 类型 描述 schemaname name 函数所在的Schema名。 funcname name 函数名称。 calls numeric 函数被调用的次数。 total_time double precision 此函数及其调用的所有其他函数所花费的总时间。 self_time double precision 在此函数本身中花费的时间（不包括它调用的其他函数）。 父主题： Object

time_to_target_rpo 参数说明：双集群异地灾备模式下，主集群日志将被归档到OBS。该参数设置主集群发生异常时至已归档到OBS的恢复点所允许的时间。 参数类型：整型 参数单位：s（秒） 取值范围：0 ~ 3600 0是指不开启日志流控。 1 ~ 3600表示主集群发生异常时至已归档到OBS的恢复点所允许的时间，保证主集群因灾难崩溃时，最多可能丢失数据的时长在允许范围内。 默认值：10 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置过小会影响主机性能，设置过大会失去流控效果。