华为云用户手册

nls_timestamp_tz_format 参数说明：设置带时区时间戳默认格式。 参数类型：字符串 参数单位：无 取值范围：字符串 默认值："DD-Mon-YYYY HH:MI:SS.FF AM" 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。 此参数在参数a_format_version值为10c和a_format_dev_version值为s1的情况下有效。

enable_multiple_charset 参数说明：该参数用于控制在M-Compatibility模式下，是否可以创建表、列、schema指定字符集和当前数据库字符集不同。 参数类型：布尔型 参数单位：无 取值范围： on：可以创建表、列、schema指定字符集和当前数据库字符集不同。 off：不可以创建表、列、schema指定字符集和当前数据库字符集不同。 默认值：on。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据实际业务需求设置。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

MY_SUBPART_KEY_COLUMNS MY_SUBPART_KEY_COLUMNS视图显示了当前用户所拥有的二级分区表或分区索引的分区键列的相关信息。该视图所有用户可访问，仅可查看当前用户所属信息。该视图同时存在于PG_CATA LOG 和SYS Schema下。分布式暂不支持二级分区表，该视图所有字段值为null。 表1 MY_SUBPART_KEY_COLUMNS字段 名称 类型 描述 name character varying(128) 暂不支持，值为NULL。 object_type character varying(128) 暂不支持，值为NULL。 column_name character varying(4000) 暂不支持，值为NULL。 column_position numeric 暂不支持，值为NULL。 collated_column_id numeric 暂不支持，值为NULL。 父主题： 分区表

PG_USER_MAPPINGS PG_USER_MAPPINGS视图显示用户映射的信息。所有用户均可查看。 表1 PG_USER_MAPPINGS字段 名称 类型 引用 描述 umid oid PG_USER_MAPPING.oid 用户映射的OID。 srvid oid PG_FOREIGN_SERVER.oid 包含这个映射的外部服务器的OID。 srvname name PG_FOREIGN_SERVER.srvname 外部服务器的名称。 umuser oid PG_AUTHID.oid 被映射的本地角色的OID，如果用户映射是公共的则为0。 usename name - 被映射的本地用户的名称。 umoptions text[] - 如果当前用户是外部服务器的所有者，则为用户映射指定选项， 使用“keyword=value”字符串，否则为NULL。 父主题： 用户和权限管理

gs_check_index(index_oid oid, partindex_oid oid, duration text, need_repair bool, mode text) 描述：校验堆表和索引的正向数据一致性。 约束：支持Astore、Ustore存储引擎，不支持MOT；支持备节点进行校验，不支持logger节点；堆表支持普通行存表、ILM压缩表、Hashbucket表的校验，不支持临时表、全局临时表、unlogged表。索引支持B-tree、UB-tree索引的校验，兼容段页式存储。 参数说明：详见表7 gs_check_index参数说明。 返回值类型：record 表7 gs_check_index参数说明 参数类型 参数名 类型 描述 输入参数 index_oid oid 索引oid： 普通索引：索引 oid。 全局索引：GPI oid。 local索引：主索引oid。 输入参数 partindex_oid oid 分区索引oid： 普通索引：0。 全局索引：0。 local索引：分区索引oid(一级/二级)。 local索引扫描全部分区：0。 输入参数 duration text 校验时长，支持设置毫秒、秒、分钟、小时、天，例如“500ms”“60s”，“10min”，“2h”，“1d”最长可设置时长为24h，可能存在毫秒级、秒级误差或分钟级误差，设置为0则默认校验完成结束。校验时长为实际执行时间和设置时间的最小值，执行超过设置时间会中止并记录当前校验位置，下次扫描支持从当前位置断点续作。 输入参数 need_repair bool 是否需要自动修复不一致，即按照堆表来增加或删除索引元组，当前仅支持设置为false。预埋参数，本版本暂不支持自动修复能力。 输入参数 mode text 校验模式预埋参数，取值范围包含{”increment”，”full”}。支持断点续做、增量（”increment”）校验，全量（”full”）校验等能力。 输出参数 error_code int 错误码。 输出参数 output_filepath text 解析后落盘相对路径。路径为gs_log/dump目录下，落盘文件名为dbverify_错误码_堆表oid_时间戳.log，例如： /$GAUSSLOG/gs_log/dump/dbverify_0_16384_123456.log 使用示例时请根据参数说明传参，使用实际存在且匹配的oid，否则将报错。 示例1： gaussdb=# select * from gs_check_index((select oid from pg_class where relname='index_t1'),0, '1h', false, 'full'); verify_code | output_filepath -------------+--------------------------------------------------------------------------------------- 0 | /$GAUSSLOG/gaussdb/single_node/gs_log/dump/dbverify_0_17302_766074761373434.log (1 row) 示例2： gaussdb=# select * from gs_check_index((select oid from pg_class where relname='index_range_2'),(select oid from pg_partition where parentid=(select oid from pg_class where relname='index_range_2')and relname='p1_a_idx'), '10s', false, 'full'); verify_code | output_filepath -------------+--------------------------------------------------------------------------------------- 0 | /$GAUSSLOG/gaussdb/single_node/gs_log/dump/dbverify_0_17306_766074834795344.log (1 row) 该接口当前支持Astore、Ustore表和B-tree、UB-tree索引的一致性校验。如果校验完成后未发现一致性问题，错误码为"0”；如出现非"0"错误码，请联系华为工程师辅助定位。 关于断点续做和增量校验： 断点续做和增量校验的相关信息不会进行持久化，数据库进程重启后之前的校验会丢失，重新校验时会从头开始进行全量校验。 校验模式为“increment”且上一次对该表和索引的校验未完成时会触发断点续做，从上次校验中断的位置开始校验。 校验模式为“increment”且上一次对该表和索引的校验已完成时会触发增量校验，校验增量修改页面。 校验模式为“full”时，从头开始进行全量校验。 关于IO流控： 默认设置io_priority为低优先级进行IO流控。 关于使用权限： 执行校验系统函数需要有初始用户、系统管理员、运维管理员或监控管理员权限，只能校验当前数据库的数据表或索引。 推荐使用场景： 校验推荐使用在业务低峰期，尽量保证校验期间大部分数据为静态数据，保证校验的完整性和准确性。 调用本系统函数属于高危风险操作，请用户谨慎使用。

gs_get_standby_bad_block_info() 描述：显示备机上已经检测到但是还未修复的页面。默认只有在备DN节点上，使用初始用户、具有sysadmin权限的用户以及在运维模式下具有运维管理员权限的用户、以及监控用户可以查看，其余用户需要赋权后才可以使用。返回值invalid_type列共有4种类型：NOT_PRESENT（页面不存在）、 NOT_INITIALIZED（页面初始化失败）、 LSN_CHECK_ERROR（LSN校验失败）、CRC_CHECK_ERROR（CRC校验失败）。 返回值类型：record 示例（若不存在已检测到但未修复的页面则输出0行）： gaussdb=# SELECT * FROM gs_get_standby_bad_block_info(); spc_node | db_node | rel_node | bucket_node | fork_num | block_num | invalid_type | master_page_lsn ----------+---------+----------+-------------+----------+-----------+-----------------+----------------- 1663 | 16552 | 24745 | -1 | 0 | 0 | CRC_CHECK_ERROR | 0/B2009E8 (1 rows)

gs_urq_dump_stat(index_oid oid, partindex_oid oid) 描述：查询指定索引回收队列相关信息。 显示信息：recentGlobalDataXmin和globalFrozenXid是回收队列判断索引页面是否可以被回收时使用的两个oldestxmin，next_xid为下一个最新的事务xid，urq_blocks为回收队列总页面数以及free queue（可用队列）、empty queue（潜在队列）有效页面里的相关信息。对于PCR版本的索引，输出的recentGlobalDataXmin会被替换成影响PCR索引页面回收的globalRecycleXid。 参数说明：如表4 gs_urq_dump_stat参数说明所示。 表4 gs_urq_dump_stat参数说明 参数类型 参数名 类型 描述 输入参数 index_oid oid UBTree索引oid： 普通索引：索引oid。 全局索引：GPI oid。 local索引：主索引oid。 输入参数 partindex_oid oid UBTree分区索引oid： 普通索引：0。 全局索引：0。 local索引：分区索引oid（一级/二级）。 输出参数 result text 索引回收队列的详细统计信息。 使用示例时请根据实际情况按参数说明传参，使用实际存在的oid，否则将报错。 示例（RCR）： gaussdb=# SELECT * FROM gs_urq_dump_stat(16387, 0); result --------------------------------------------------------------------------------------------------------------------------------- urq stat info: recentGlobalDataXmin = 213156, globalFrozenXid = 213156, next_xid = 214157, urq_blocks = 6, + free queue: head page blkno = 0 min_xid = 211187 max_xid = 214157, tail page blkno = 0 min_xid = 211187 max_xid = 214157,+ middle page min_xid = 1152921504606846975 max_xid = 0, valid_pages = 1, valid_items = 6, can_use_item = 3 + empty queue: head page blkno = 1 min_xid = 212160 max_xid = 213160, tail page blkno = 3 min_xid = 213162 max_xid = 214156,+ middle page min_xid = 1152921504606846975 max_xid = 0, valid_pages = 2, valid_items = 999, can_use_item = 498 + (1 row) 示例（PCR）： gaussdb=# SELECT gs_urq_dump_stat(17260,0); gs_urq_dump_stat ------------------------------------------------------------------------------------------------------------------------------------------------- urq stat info: globalRecycleXid = 22113, globalFrozenXid = 22107, next_xid = 22116, urq_blocks = 6, + free queue: head page blkno = 0 min_xid = 1152921504606846975 max_xid = 0, tail page blkno = 0 min_xid = 1152921504606846975 max_xid = 0,+ middle page min_xid = 1152921504606846975 max_xid = 0, valid_pages = 1, valid_items = 0, can_use_item = 0 + empty queue: head page blkno = 1 min_xid = 1152921504606846975 max_xid = 0, tail page blkno = 1 min_xid = 1152921504606846975 max_xid = 0,+ middle page min_xid = 1152921504606846975 max_xid = 0, valid_pages = 1, valid_items = 0, can_use_item = 0 + (1 row) 该接口当前仅支持USTORE索引表。

gs_repair_urq(index_oid oid, partindex_oid oid) 描述：重建（有损）索引回收队列（潜在队列和可用队列）。删除当前索引的回收队列文件，重新创建一个空的回收队列文件。重建成功显示reinitial the recycle queue of index relation successfully。 参数说明：如表5 gs_repair_urq参数说明所示。 备注：当前函数仅支持在主节点进行调用。 表5 gs_repair_urq参数说明 参数类型 参数名 类型 描述 输入参数 index_oid oid UBTree索引oid： 普通索引：索引oid。 全局索引：GPI oid。 local索引：主索引oid。 输入参数 partindex_oid oid UBTree分区索引oid： 普通索引：0。 全局索引：0。 local索引：分区索引oid（一级/二级）。 输出参数 result text 重建成功显示reinitial the recycle queue of index relation successfully，否则为失败。 使用示例时请根据实际情况按参数说明传参，使用实际存在的oid，否则将报错。 示例： gaussdb=# SELECT * FROM gs_repair_urq(16387, 0); result ------------------------------------------------------------ reinitial the recycle queue of index relation successfully. (1 row) 该接口当前仅支持USTORE索引表。

gs_check_table(table_oi...(table_oid oid, partition_oid oid, index_oid oid, partindex_oid oid, start_blk bigint, end_blk bigint, duration text, need_repair bool, mode text) 描述：校验堆表和索引的反向数据一致性。 约束：支持Astore、Ustore存储引擎，不支持MOT；支持备节点进行校验，不支持logger节点；堆表支持普通行存表、ILM压缩表、Hashbucket表的校验，不支持临时表、全局临时表、unlogged表。索引支持B-tree、UB-tree索引的校验，兼容段页式存储。 参数说明：详见表6 gs_check_table参数说明。 返回值类型：record 表6 gs_check_table参数说明 参数类型 参数名 类型 描述 输入参数 table_oid oid 堆表oid： 普通表：堆表 oid。 分区表：主表 oid。 输入参数 partition_oid oid 分区oid： 普通表：0。 分区表：分区 oid。 分区表扫描全分区：0。 输入参数 index_oid oid 索引oid： 普通索引：索引 oid。 全局索引：GPI oid。 local索引：主索引oid。 扫描全部索引：0。 输入参数 partindex_oid oid 分区索引oid： 普通索引：0。 全局索引：0。 local索引：分区索引oid(一级/二级)。 local索引扫描全部分区：0。 输入参数 start_blk bigint 校验开始页面号。和end_blk同时取值-1的场景下默认从头开始校验。分区表扫描全分区时，仅支持从头开始校验，start_blk和end_blk需同时取值为-1。 输入参数 end_blk bigint 校验结束页面号。 输入参数 duration text 校验时长，支持设置毫秒、秒、分钟、小时、天，例如“500ms”、“60s”，“10min”，“2h”，“1d”最长可设置时长为24h，可能存在毫秒级、秒级误差或分钟级误差，设置为0则默认校验完成结束。校验时长为实际执行时间和设置时间的最小值，执行超过设置时间会中止并记录当前校验位置，下次扫描支持从当前位置断点续作。 输入参数 need_repair bool 是否需要自动修复不一致，即按照堆表来增加或删除索引元组，当前仅支持设置为false。预埋参数，本版本暂不支持自动修复能力。 输入参数 mode text 校验模式预埋参数，取值范围包含{”increment”，”full”}。支持断点续做、增量（”increment”）校验，全量（”full”）校验等能力。 输出参数 error_code int 错误码。 输出参数 output_filepath text 解析后落盘相对路径。路径为gs_log/dump目录下，落盘文件名为dbverify_错误码_堆表oid_时间戳.log，例如： /$GAUSSLOG/gs_log/dump/dbverify_0_16384_123456.log 使用示例时请根据参数说明传参，使用实际存在且匹配的oid和blocknum，否则将报错。 示例1： gaussdb=# select * from gs_check_table((select oid from pg_class where relname='t2'),0,0,0,-1,-1, '1h', false, 'full'); verify_code | output_filepath -------------+--------------------------------------------------------------------------------------- 0 | /$GAUSSLOG/gs_log/dump/dbverify_0_17279_766073191583799.log (1 row) 示例2： gaussdb=# select * from gs_check_table((select oid from pg_class where relname='t1'),0,(select oid from pg_class where relname='index_t1'),0,2,10, '2s', false, 'full'); verify_code | output_filepath -------------+--------------------------------------------------------------------------------------- 0 | /$GAUSSLOG/gs_log/dump/dbverify_0_17168_766073338594117.log (1 row) 调用本系统函数属于高危风险操作，请用户谨慎使用。 该接口当前支持Astore、Ustore表和B-tree、UB-tree索引的一致性校验。如果校验完成后未发现一致性问题，错误码为"0”；如出现非"0"错误码，请联系华为工程师辅助定位。 关于断点续做和增量校验： 断点续做和增量校验的相关信息不会进行持久化，数据库进程重启后之前的校验会丢失，重新校验时会从头开始进行全量校验。 校验模式为“increment”且上一次对该表和索引的校验未完成时会触发断点续做，从上次校验中断的位置开始校验。 校验模式为“increment”且上一次对该表和索引的校验已完成时会触发增量校验，校验增量修改页面。 校验模式为“full”时，从头开始进行全量校验。 关于IO流控： 默认设置io_priority为低优先级进行IO流控。 关于使用权限： 执行校验系统函数需要有初始用户、系统管理员、运维管理员或监控管理员权限，只能校验当前数据库的数据表或索引。 推荐使用场景： 校验推荐使用在业务低峰期，尽量保证校验期间大部分数据为静态数据，保证校验的完整性和准确性。

gs_repair_page_bypath(src_path text, src_blkno int64, dest_path text, dest_blkno int64, storage_type text) 描述：传入源文件路径以及页面号，将该页面覆盖写入到目标文件指定页面号上，支持通过主机修复备机页面，也支持基于备机修复主机页面，此外，该视图支持对坏块的初始化操作。分布式环境下该函数需要在DN下执行。 对目标页面进行覆盖写并同步备机，页式修改对象支持Uheap、Ubtree页面，后续支持Undo Record页面、Undo Slot页面、压缩表，以及Astore页面，段页式修改对象支持Astore页面，支持hashbucket。不支持系统表文件的修改，也不支持对数据区的修改。 功能支持将页面覆盖写到目标页面上。覆盖之前会将目标页面备份并落盘到指定目录，支持将备份页面重写回目标页面，在主机对普通表的修改会生成新的WAL日志并同步备机，在备机的修改不会记录WAL日志。 修复视图适用于主节点，或者开启备机读场景下的备节点。用户需要系统管理员或者运维模式下的运维管理员权限，所有修改均会记录数据库日志，并且，建议使用前开启系统函数的审计日志，便于记录审计信息。 在备机上调用修复视图时，仅支持从主机读取页面修复备机。 修复时源页面与目标页面的LSN必须一致，否则修复失败。 对目标页面进行校验。若目标页面为正确的页面，则不支持进行覆盖。当前校验支持Uheap、Ubtree页面。 返回值类型：text 调用本系统函数属于高危风险操作，请用户谨慎使用。 参数类型 参数名 类型 描述 输入参数 src_path text 源文件的路径。支持的路径主要包含以下几类： 数据文件以及索引文件：gs_log/dump/1663_15808_25075_0.editpage。 在主机端指定src_path为'standby'，即从备机端读取页面修复主机。 在备机端可以指定src_path为'primary'，即从主机端读取页面修复备机，备机上仅支持‘primary’修复，并且使用前开启备机读。 在主机端指定src_path为'init_block'，允许极端场景下跳过坏块。 输入参数 src_blkno bigint 源页面的物理块号。 参数范围：0~MaxBlockNumber。 输入参数 dest_path text 目标文件的相对路径。例如：base/15808/25075。 输入参数 dest_blkno bigint 目标页面的逻辑块号。 参数范围：0~MaxBlockNumber。 输入参数 storage_type text 目标文件的存储方式，可选参数： 'page'（页式）。 'segment'（段页式）。 输出参数 output_msg text 覆盖写成功时返回目标页面备份的路径，失败时返回报错信息。落盘文件名格式为relfilepath_blocknum_timestamp.repairpage。 请按照实际情况根据上表传参并确认物理文件存在。传参有异常或修复失败时将报错。 示例1：输入指定路径下的文件，覆盖写入到目标文件中。 gaussdb=# SELECT * FROM gs_repair_page_bypath('gs_log/dump/1663_15991_16767_0.editpage', 0, 'base/15991/16767', 0, 'page'); output_msg ------------------------------------------------------------------------------------------------ /gs_log_dir/dump/1663_15991_16767_0_738039702421788.repairpage (1 row) 示例2：从备机端读取页面修复主机。 gaussdb=# SELECT * FROM gs_repair_page_bypath('standby', 0, 'base/15990/16768', 0, 'page'); output_msg ------------------------------------------------------------------------------------------------- /gs_log_dir/dump/1663_15990_16768_0_738040397197907.repairpage (1 row) 示例3：从主机端读取页面修复备机。 gaussdb=# SELECT * FROM gs_repair_page_bypath('primary', 0, 'base/15990/16768', 0, 'page'); output_msg ------------------------------------------------------------------------------------------------- /gs_log_dir/dump/1663_15990_16768_0_738040506157799.repairpage (1 row) 示例4：初始化目标页面，支持坏块跳过。 gaussdb=# SELECT * FROM gs_repair_page_bypath('init_block', 0, 'base/15990/16768', 0, 'page'); output_msg ------------------------------------------------------------------------------------------------- /gs_log_dir/dump/1663_15990_16768_0_738040768010281.repairpage (1 row)

gs_seg_verify_datafile(IN tablespace_name name, IN database_name name, IN file_id integer, IN bucketnode integer, IN start_block_id bigint default 0, IN end_block_id bigint default UINT32MAX) 功能 描述：校验段页式1~5文件，main fork是否存在页面损坏，将校验结果记录到local_bad_block_info()函数中。 权限：只有具有sysadmin属性的用户以及在运维模式下具有运维管理员属性的用户可以执行。 参数说明 名称 类型 描述 tablespace_name name 表空间名称。 database_name name 数据库名称。 file_id integer 文件名称，1~5。 bucketnode integer 表的bucketnode。 0~1023表示hashbucket表的bucketnode。 1024表示段页式普通表的bucketnode。 当前仅支持hashbucket表与段页式普通表。 start_block_id bigint 校验页面范围开始值，默认值：0。 end_block_id bigint 校验页面范围结束值，默认值：4294967295。 返回值：无。 示例： gaussdb=# SELECT * FROM gs_seg_verify_datafile('seg_tblspc', 'postgres', 2, 1024); WARNING: page verification failed, calculated checksum 60994 but expected 11565, the block num is 4157 gs_seg_verify_datafile ------------------------ (1 row)

gs_repair_undo_byzone(zone_id int) 描述：传入待修复Undo Zone的zone_id，对目标Undo Zone的元信息进行修复，并返回修复结果的详细信息；如果没有进行修复则没有输出信息。 返回值类型：record 备注：当前函数仅支持在主节点进行调用，修复成功后会通过记录xlog日志同步到备机，且调用者必须是系统管理员或者运维模式下的运维管理员，建议使用前开启系统函数的审计日志，便于记录审计信息。 调用本系统函数属于高危风险操作，请用户谨慎使用。 表2 gs_repair_undo_byzone参数说明 参数类型 参数名 类型 描述 输入参数 zone_id int Undo Zone编号： -1：修复所有Undo Zone的元信息。 0~1048575：修复对应zone_id编号的Undo Zone的元信息。 输出参数 zone_id int Undo Zone编号。 输出参数 repair_detail text 对应zone_id的Undo Zone元信息的修复结果，修复成功显示"rebuild undo meta succeed."；修复失败显示"rebuild undo meta failed."及其失败原因。 示例1：输入的zone_id对应的Undo Zone元信息没有损坏时，预期没有输出。 gaussdb=# SELECT * FROM gs_repair_undo_byzone(4); zone_id | repair_detail ---------+--------------- (0 rows) 示例2：输入的zone_id对应的Undo Zone元信息修复成功时，显示修复成功的信息。 gaussdb=# SELECT * FROM gs_repair_undo_byzone(78); zone_id | repair_detail ---------+--------------- 78 | rebuild undo meta succeed. (1 row) 示例3：输入的zone_id对应的Undo Zone元信息修复失败时，显示修复失败的详细信息。 gaussdb=# SELECT * FROM gs_repair_undo_byzone(0); zone_id | repair_detail ---------+--------------- 0 | rebuild undo meta failed. try lock undo zone_id failed. (1 row) 如果待修复的 Undo Zone 已损坏且 zone_id 已经被其他活跃线程占用时，调用该修复函数会将占用 zone_id 的线程结束并强制修复已损坏的 Undo Zone 元信息。

gs_verify_urq(index_oid oid, partindex_oid oid, blocknum bigint, queue_type text) 描述：校验索引回收队列（潜在队列/可用队列/单页面）的正确性。 参数说明：如表3 gs_verify_urq参数说明所示。 返回值类型：record 表3 gs_verify_urq参数说明 参数类型 参数名 类型 描述 输入参数 index_oid oid UBTree索引oid： 普通索引：索引oid。 全局索引：GPI oid。 local索引：主索引oid。 输入参数 partindex_oid oid UBTree分区索引oid： 普通索引：0。 全局索引：0。 local索引：分区索引oid（一级/二级）。 输入参数 blocknum bigint 页面号： 队列类型为single page时，校验单个页面blocknum的所有元组正确性。取值范围为[0，队列文件大小/8192）。 队列类型为empty queue或free queue时，blocknum是一个无效值。 输入参数 queue_type text 队列类型： empty queue：潜在队列。 free queue：可用队列。 single page：队列单页面。 输出参数 error_code text 错误码。 输出参数 detail text 具体报错及其他关键信息。 使用示例时请根据参数说明传参，使用实际存在的oid和blocknum，否则将报错。 示例1： gaussdb=# SELECT * FROM gs_verify_urq(16387, 0, 1, 'free queue'); error_code | detail ------------+-------- (0 rows) 示例2： gaussdb=# SELECT * FROMgs_verify_urq(16387, 0, 1, 'empty queue'); error_code | detail -----------------------+--------------------------------------------------------------------------------------------------------------- VERIFY_URQ_PAGE_ERROR | invalid urq meta: oid 16387, blkno 1, head_blkno = 1, tail_blkno = 3, nblocks_upper = 4294967295, nblocks_lower = 1; urq_blocks = 6, index_blocks = 12 (1 row) 该接口当前仅支持USTORE索引表。如果索引回收队列校验正常，则该视图不输出错误码和报错详细信息，否则输出错误码和报错详细信息，错误码包含"VERIFY_URQ_PAGE_ERROR"、"VERIFY_URQ_LINK_ERROR"、"VERIFY_URQ_HEAD_MISSED_ERROR"和"VERIFY_URQ_TAIL_MISSED_ERROR"，如出现以上错误码，请联系华为工程师辅助定位。

local_clear_bad_block_info() 描述：清理local_bad_block_info中已修复页面的数据，也就是repair_time不为空的信息。默认只有初始用户、具有sysadmin属性的用户以及在运维模式下具有运维管理员属性的用户、以及监控用户可以查看，其余用户需要赋权后才可以使用。 返回值类型：Boolean 示例： gaussdb=# SELECT * FROM local_clear_bad_block_info(); result -------- t

gs_verify_data_file(verify_segment bool) 描述：校验当前实例当前库是否存在文件丢失的情况。校验只包括数据表主文件是否有中间段丢失的情况。默认参数是false，表示不校验段页式表数据文件。参数设置为true时仅校验段页式表文件。默认只有初始用户、具有sysadmin属性的用户以及在运维模式下具有运维管理员属性的用户可以查看，其余用户需要赋权后才可以使用。 返回的结果： 非段页式表：rel_oid和rel_name是对应文件的表oid和表名，miss_file_path表示丢失文件的相对路径。 段页式表：因所有表存放在相同文件中，所以rel_oid和rel_name无法显示具体表的信息。对于段页式表，如果第一个文件损坏，不会检查出后面的.1 .2等文件。例如3、3.1、3.2损坏，只能检查出3损坏。当段页式文件不足5个时，使用函数检测时，未生成的文件也会校验出来，例如只有1和2文件，校验段页式时，也会检测出3，4，5文件。以下示例，第一个是校验非段页式表的示例，第二是校验段页式表的示例。 参数说明： verify_segment 指定文件校验的范围。false校验非段页式表；true校验段页式表。 取值范围：true和false，默认是false。 返回值类型：record 示例（仅当发现有异常时才会输出异常行，否则输出0行）： 校验非段页式表： gaussdb=# SELECT * FROM gs_verify_data_file(); node_name | rel_oid | rel_name | miss_file_path ------------------+---------+--------------+------------------ dn_6001_6002_6003 | 16554 | test | base/16552/24745 校验段页式表： gaussdb=# SELECT * FROM gs_verify_data_file(true); node_name | rel_oid | rel_name | miss_file_path -------------------+---------+----------+---------------- dn_6001_6002_6003 | 0 | none | base/16573/2

gs_verify_and_tryrepair_page (path text, blocknum Oid, verify_mem bool, is_segment bool) 描述：校验本实例指定页面的情况。默认只有在主DN节点上，使用初始用户、具有sysadmin属性的用户以及在运维模式下具有运维管理员属性的用户可以查看，其余用户需要赋权后才可以使用。返回的结果信息，disk_page_res表示磁盘上页面的校验结果，mem_page_res表示内存中页面的校验结果，is_repair表示在校验的过程中是否触发修复功能，t表示已修复，f表示未修复。 当DN实例上存在页面损坏时，进行升主会校验出错，报PANIC退出而无法升主，这属于正常现象。不支持hashbucket表页面损坏的修复。 此函数触发的修复仅支持修复内存中的页面，需要在内存页面落盘后的物理页面修复后，才能正式生效。 参数说明： path 损坏文件的路径，依据local_bad_block_info中file_path一列填写。如果要对存储类型为USTORE的表进行UNDO页面校验，请直接填写需要校验的UNDO页面路径。 取值范围：字符串。 blocknum 损坏文件的页号，依据local_bad_block_info中block_num一列填写。如果要对存储类型为USTORE的表进行UNDO页面校验，请直接填写需要校验的UNDO页面的块号。 取值范围：Oid，0 - 4294967295。注意：输入负值等都会被强制转成非负整数类型。 verify_mem 指定是否校验内存中的指定页面。设定为false时，只校验磁盘上的页面。设置为true时，校验内存中的页面和磁盘上的页面。如果发现磁盘上页面损坏，会将内存中的页面做一个基本信息校验刷盘，修复磁盘上页面。如果校验内存页面时发现页面不在内存中，会经内存接口读取磁盘上的页面。此过程中如果磁盘页面有问题，则会触发远程读自动修复功能。 取值范围：bool，true和false。 is_segment 是否是段页式表。根据local_bad_block_info中的bucket_node列值决定。如果bucket_node为-1时，表示不是段页式表，将is_segment设置为false；非-1的情况将is_segment设置为true。支持段页式存储。 取值范围：bool，true和false。 返回值类型：record 示例（请依据local_bad_block_info的输出传参，否则报错）： 页式存储： gaussdb=# SELECT * FROM gs_verify_and_tryrepair_page('base/16552/24745',0,false,false); node_name | path | blocknum | disk_page_res | mem_page_res | is_repair ------------------+------------------+------------+-----------------------------+---------------+---------- dn_6001_6002_6003 | base/16552/24745 | 0 | page verification succeeded.| | f 段页式存储： gaussdb=# SELECT * FROM gs_verify_and_tryrepair_page('base/14365/1',4494,false,true); node_name | path | blocknum | disk_page_res | mem_page_res | is_repair ------------------+--------------+----------+------------------------------+--------------+----------- dn_6001_6002_6003 | base/14365/1 | 4494 | page verification succeeded. | | f

gs_repair_page(path text, blocknum oid, is_segment bool, timeout int) 描述：修复本实例指定页面，仅支持有正常主备连接的主DN使用。默认只有在主DN节点上，使用初始用户、具有sysadmin属性的用户以及在运维模式下具有运维管理员属性的用户可以查看，其余用户需要赋权后才可以使用。 注意：当DN实例上存在页面损坏时，进行升主会校验出错，报PANIC退出无法升主，为正常现象。不支持hashbucket表、压缩表页面损坏的修复。 参数说明 path 损坏页面的路径。根据local_bad_block_info中file_path一列设置，或者是gs_verify_and_tryrepair_page函数中path一列设置。 取值范围：字符串。 blocknum 损坏页面的页面号。根据local_bad_block_info中block_num一列设置，或者是gs_verify_and_tryrepair_page函数中blocknum一列设置。 取值范围：Oid，0 - 4294967295。注意：输入负值等数值都会被强制转成非负整数类型。 is_segment 是否是段页式表。根据local_bad_block_info中的bucket_node列值决定，如果bucket_node为-1时，表示不是段页式表，将is_segment设置为false，非-1的情况将is_segment设置为true。支持段页式存储。 取值范围：bool，true或者false。 timeout 等待备DN回放的时长。修复页面需要等待备DN回放到当前主DN对应的位置，根据备DN回放所需时长设定。 取值范围：60s - 3600s。 返回值类型：bool 示例（请根据local_bad_block_info的输出传参，否则报错）： 页式存储： gaussdb=# SELECT * FROM gs_repair_page('base/16552/24745',0,false,60); result -------- t 段页式存储： gaussdb=# SELECT * FROM gs_repair_page('base/16552/1',4494,true,60); result -------- t

local_bad_block_info() 描述：显示本实例页面损坏的情况。从磁盘读取页面，发现页面CRC校验失败时进行记录。默认只有初始用户、具有sysadmin属性的用户、具有监控管理员属性的用户以及在运维模式下具有运维管理员属性的用户、以及监控用户可以查看，其余用户需要赋权后才可以使用。file_path是损坏文件的相对路径，支持段页式。block_num是该文件损坏的具体页面号，页面号从0开始。check_time表示发现页面损坏的时间。repair_time表示修复页面的时间。 返回值类型：record 示例：（仅当有损坏记录时输出相关条目，否则输出0行。） gaussdb=# SELECT * FROM local_bad_block_info(); node_name | spc_node | db_node | rel_node| bucket_node | fork_num | block_num | file_path | check_time | repair_time -----------------+-------+--------+--------+--------------+----------+-----------+-----------------+--------------------------+------------------------------- dn_6001_6002_6003| 1663 | 16552 | 24745 | -1 | 0 | 0 | base/16552/24745 | 2022-01-13 20:19:08.385004+08 | 2022-01-13 20:19:08.407314+08

gs_repair_file(tableoid Oid, path text, timeout int) 描述：根据传入的参数修复文件，仅支持有正常主备连接的主DN使用。只支持数据表主文件修复，参数依据gs_verify_data_file函数返回的oid和路径填写。段页式表tableoid赋值为0到4294967295的任意值（内部校验根据文件路径判断是否是段页式表文件，段页式表文件则不使用tableoid）。修复成功返回值为true，修复失败会显示具体失败原因。默认只有在主DN节点上，使用初始用户、具有sysadmin属性的用户以及在运维模式下具有运维管理员属性的用户可以查看，其余用户需要赋权后才可以使用。 当DN实例上存在文件损坏时，进行升主会校验出错，报PANIC退出无法升主，为正常现象。 当文件存在但是大小为0时，此时不会去修复该文件，若想要修复该文件，需要将为0的文件删除后再修复。 删除文件需要等文件句柄（fd，file descriptor）自动关闭后再修复，人工操作可以执行重启进程，主备切换等命令。 该修复函数要求主备机待修复的文件路径应保持一致，如果不一致，则修复失败。也就是说，如果使用RELATIVE LOCATION表空间，其路径因tblspcversiondir不同，导致路径不同，修复失败。 参数说明： tableoid 要修复的文件对应的表oid，依据gs_verify_data_file函数返回的列表中rel_oid一列填写。 取值范围： Oid，0 - 4294967295。注意：输入负值等数值都会被强制转成非负整数类型。 path 需要修复的文件路径，依据gs_verify_data_file函数返回的列表中miss_file_path一列填写。 取值范围：字符串。 timeout 等待备DN回放的时长，修复文件需要等待备DN回放到当前主DN对应的位置，根据备DN回放所需时长设定。 取值范围：60s - 3600s。 返回值类型：Boolean 示例（按照gs_verify_data_file的输出填写tableoid和path）： 页式存储： gaussdb=# SELECT * FROM gs_repair_file(16554,'base/16552/24745',360); gs_repair_file ---------------- t 段页式存储： gaussdb=# SELECT * FROM gs_repair_file(16554,'base/16573/2',360); gs_repair_file ---------------- t

gs_inconsistency_info(reset bool) 描述：显示/重置数据库中存在的数据不一致相关信息，入参reset为true时进行重置，为false时则进行显示。默认只有初始用户、具有sysadmin属性的用户、具有监控管理员属性的用户、在运维模式下具有运维管理员属性的用户以及监控用户可以查看，其余用户需要赋权后才可以使用。其中，inconsistency_type是不一致的类型，node_name是节点名，spc_node是表空间ID，db_node是库节点ID，rel_node是表ID，bucket_node是hashbucket的ID，backend是临时表的ID，index_oid是索引的oid，tuple_blkno是元组所在堆表的页号，tuple_offset是元组所在堆表页的偏移，count是这一条不一致信息出现的次数，last_update_time是最后更新这条不一致信息的时间。 返回值类型：record 示例：（在入参reset为false，且当有不一致信息被校验出来时，才会输出相关条目；其他情况下输出0行。） gaussdb=# SELECT * FROM gs_inconsistency_info(false); inconsistency_type | node_name | spc_node | db_node | rel_node | bucket_node | backend | index_oid | tuple_blkno | tuple_offset | count | last_update_time ---------------------+-----------+----------+---------+----------+-------------+---------+-----------+-------------+--------------+-------+------------------------------ INCONSISTENCY_INDEX | sgnode | 1663 | 12902 | 16722 | -1 | -1 | 16728 | 0 | 1 | 1 | 2024-11-20 16:18:56.85289-05

PG_STATIO_SYS_TABLES PG_STATIO_SYS_TABLES视图显示命名空间中所有系统表的I/O状态信息。具体字段信息如表1所示。 表1 PG_STATIO_SYS_TABLES字段 名称 类型 描述 relid oid 表OID。 schemaname name 该表的模式名。 relname name 表名。 heap_blks_read bigint 从该表中读取的磁盘块数。 heap_blks_hit bigint 该表命中缓存数。 idx_blks_read bigint 从表中所有索引读取的磁盘块数。 idx_blks_hit bigint 表中所有索引命中缓存数。 toast_blks_read bigint 从该表的TOAST表读取的磁盘块数（如果存在）。 toast_blks_hit bigint 该表的TOAST表命中缓存数（如果存在）。 tidx_blks_read bigint 从该表的TOAST表索引读取的磁盘块数（如果存在）。 tidx_blks_hit bigint 该表的TOAST表索引命中缓存数（如果存在）。 父主题： 其他系统视图

GLOBAL_WLM_RESPOOL_MEMORY_INFO 该视图用于查看分布式下所有节点实时的资源池内存使用情况。查询该视图需要sysadmin权限或者monadmin权限。 该视图只能查询主DN节点上的数据，备节点需要登录到备节点上后使用系统函数gs_wlm_respool_memory_info()查询内存使用情况。 表1 GLOBAL_WLM_RESPOOL_MEMORY_INFO字段 名称 类型 描述 node_name name 节点名称。 respool_name name 资源池名称。 max_dynamic_memory integer 最大可使用的动态内存。 current_dynamic_memory integer 当前已经使用的动态内存。 max_shared_memory integer 最大可使用的共享内存。 current_shared_memory integer 当前已经使用的共享内存。 shared_memory_hits_percent integer 该功能不可用，留待后续演进。字段保留，恒为0。 示例： 1 2 3 4 5 6 7 8 gaussdb=# SELECT * FROM GLOBAL_WLM_RESPOOL_CONCURRENCY_INFO; node_name | respool_name | max_dynamic_memory | current_dynamic_memory | max_shared_memory | current_shared_memory | shared_memory_hits_percent --------------+--------------+--------------------+------------------------+-------------------+-----------------------+---------------------------- coordinator1 | default_pool | -1 | 9415kB | -1 | 3856kB | 0 datanode1 | default_pool | -1 | 10724kB | -1 | 2808kB | 0 datanode2 | default_pool | -1 | 10724kB | -1 | 2808kB | 0 datanode3 | default_pool | -1 | 10724kB | -1 | 560kB | 0 (4 rows) 父主题： 负载管理

示例 --创建一个兼容性为ORA的数据库。 gaussdb=# CREATE DATABASE ora_test_db DBCOMPATIBILITY 'ORA'; --切换数据库。 gaussdb=# \c ora_test_db --创建拥有系统管理员权限的用户。 ora_test_db=# CREATE USER user1 WITH SYSADMIN PASSWORD '********'; ora_test_db=# SET ROLE user1 PASSWORD '********'; --创建私有dblink，host也可以是IPv6地址。 ora_test_db=# CREATE DATABASE LINK private_dblink CONNECT TO 'user1' IDENTIFIED BY '********' USING (host '192.168.11.11',port '54399',dbname 'db01'); --删除私有dblink。 ora_test_db=# DROP DATABASE LINK private_dblink; --创建公共dblink，host也可以是IPv6地址。 ora_test_db=# CREATE PUBLIC DATABASE LINK public_dblink CONNECT TO 'user1' IDENTIFIED BY '********' USING (host '192.168.11.11',port '54399',dbname 'db01'); --删除公共dblink。 ora_test_db=# DROP PUBLIC DATABASE LINK public_dblink; --删除创建出的用户。 ora_test_db=# RESET ROLE; ora_test_db=# DROP USER user1; --切换回初始数据库，并删除测试数据库。请用真实的数据库名替换postgres。 ora_test_db=# \c postgres gaussdb=# DROP DATABASE ora_test_db;

MY_PART_TABLES MY_PART_TABLES视图显示当前用户下分区表的信息。该视图同时存在于PG_CATALOG和SYS Schema下。 表1 MY_PART_TABLES字段 名称 类型 描述 table_owner character varying(64) 分区表的所有者名称。 table_name character varying(64) 分区表的名称。 partitioning_type text 分区表的分区策略。 说明： 当前分区表策略支持范围请参见CREATE TABLE PARTITION。 partition_count bigint 分区表的分区个数。 partitioning_key_count integer 分区表的分区键个数。 def_tablespace_name name 分区表的表空间名称。 schema character varying(64) 分区表的模式。 subpartitioning_type text 二级分区表的分区策略。如果分区表是一级分区表，则显示NONE。分布式不支持二级分区，值为NONE。 def_subpartition_count integer 默认创建二级分区的个数，二级分区表为1，一级分区表为0。分布式不支持二级分区，值为0。 subpartitioning_key_count integer 分区表二级分区键的个数。分布式不支持二级分区，值为0。 status character varying(8) 暂不支持，值为valid。 def_pct_free numeric 添加分区时使用的PCTFREE默认值。 def_pct_used numeric 暂不支持，值为NULL。 def_ini_trans numeric 添加分区时使用的INITRANS默认值。 def_max_trans numeric 添加分区时使用的MAXTRANS默认值。 def_initial_extent character varying(40) 暂不支持，值为NULL。 def_next_extent character varying(40) 暂不支持，值为NULL。 def_min_extents character varying(40) 暂不支持，值为NULL。 def_max_extents character varying(40) 暂不支持，值为NULL。 def_max_size character varying(40) 暂不支持，值为NULL。 def_pct_increase character varying(40) 暂不支持，值为NULL。 def_freelists numeric 暂不支持，值为NULL。 def_freelist_groups numeric 暂不支持，值为NULL。 def_logging character varying(7) 暂不支持，值为NULL。 def_compression character varying(8) 添加分区时使用的默认压缩： NONE ENABLED DISABLED def_compress_for character varying(30) 添加分区时使用的默认压缩。 说明： 可用的压缩方法和压缩级别请参见•WITH ( { storage_parameter = value } [, ... ] )。 def_buffer_pool character varying(7) 暂不支持，值为DEFAULT。 def_flash_cache character varying(7) 暂不支持，值为NULL。 def_cell_flash_cache character varying(7) 暂不支持，值为NULL。 ref_ptn_constraint_name character varying(128) 暂不支持，值为NULL。 interval character varying(1000) 区间值字符串。 autolist character varying(3) 暂不支持，值为NO。 interval_subpartition character varying(1000) 暂不支持，值为NULL。 autolist_subpartition character varying(3) 暂不支持，值为NO。 is_nested character varying(3) 暂不支持，值为NO。 def_segment_creation character varying(4) 暂不支持段页式设置，当启用segment时，值为YES。 def_indexing character varying(3) 暂不支持，值为ON。 def_inmemory character varying(8) 暂不支持，值为NONE。 def_inmemory_priority character varying(8) 暂不支持，值为NULL。 def_inmemory_distribute character varying(15) 暂不支持，值为NULL。 def_inmemory_compression character varying(17) 暂不支持，值为NULL。 def_inmemory_duplicate character varying(13) 暂不支持，值为NULL。 def_read_only character varying(3) 暂不支持，值为NO。 def_cellmemory character varying(24) 暂不支持，值为NULL。 def_inmemory_service character varying(12) 暂不支持，值为NULL。 def_inmemory_service_name character varying(1000) 暂不支持，值为NULL。 父主题： 分区表

数据类型 数据类型是数据的一个基本属性，用于区分不同类型的数据。不同的数据类型所占的存储空间不同，能够进行的操作也不相同。数据库中的数据存储在数据表中。数据表中的每一列都定义了数据类型，用户存储数据时，须遵从这些数据类型的属性，否则可能会出错。 GaussDB 支持某些数据类型间的隐式转换，具体转换关系请参见PG_CAST。 数值类型 货币类型 布尔类型 字符类型 二进制类型 日期/时间类型 几何类型 网络地址类型 位串类型 UUID类型 JSON/JSONB类型 HLL数据类型 范围类型 对象标识符类型 伪类型 账本数据库使用的数据类型 XML类型 XMLTYPE类型 aclitem类型 数组类型 向量数据类型 向量化引擎支持的数据类型 父主题： SQL参考

GS_POLICY_LABEL GS_POLICY_LABEL系统表记录资源标签配置信息，一个资源标签对应着一条或多条记录，每条记录标记了数据库资源所属的资源标签。需要有系统管理员或安全策略管理员权限才可以访问此系统表。 FQDN（Fully Qualified Domain Name）标识了数据库资源所属的绝对路径。 表1 GS_POLICY_LABEL表字段 名称 类型 描述 oid oid 行标识符（隐含属性，必须明确选择）。 labelname name 资源标签名称。 labeltype name 资源标签类型，目前仅为RESOURCE。 fqdnnamespace oid 被标识的数据库资源所属的namespace oid。 fqdnid oid 被标识的数据库资源的oid，若数据库资源为列，则该列为所属表的oid。 relcolumn name 列名，若被标识的数据库资源为列，该列指出列名，否则该列为空。 fqdntype name 被标识的数据库资源的类型名称，例如schema、table、column、view等。 父主题： 其他系统表

GS_MY_PLAN_TRACE GS_MY_PLAN_TRACE是系统表GS_PLAN_TRACE的视图，该视图主要用来查看当前用户的plan trace。具体字段信息如表1所示。分布式场景下不支持plan trace特性，所以在分布式下该视图中无数据。 表1 GS_MY_PLAN_TRACE字段 名称 类型 描述 query_id text 当前请求的唯一id。 query text 当前请求的sql语句，该字段大小不会超过系统参数track_activity_query_size指定的大小。 unique_sql_id bigint 当前请求sql的唯一id。 plan text 当前请求sql对应的查询计划文本。该字段大小不会超过10K。 plan_trace text 当前请求sql对应的查询计划生成过程的明细，该字段大小不会超过300M。 modifydate timestamp with time zone 当前plan trace的更新时间（当前指的是plan trace创建时间）。 父主题： 其他系统视图

参数 表1 SQLSetEnvAttr参数 关键字 参数说明 EnvironmentHandle 环境句柄。 Attribute 需设置的环境属性，可为如下值： SQL_ATTR_ODBC_VERSION：指定ODBC版本。 SQL_CONNECTION_POOLING：连接池属性。 SQL_OUTPUT_NTS：指明驱动器返回字符串的形式。 ValuePtr 指向对应Attribute的值。依赖于Attribute的值，ValuePtr可能是32位整型值，或为以空结束的字符串。 StringLength 如果ValuePtr指向字符串或二进制缓冲区，则这个参数是*ValuePtr长度，如果ValuePtr指向整型，忽略StringLength。

原型 1 2 3 4 SQLRETURN SQLSetEnvAttr(SQLHENV EnvironmentHandle, SQLINTEGER Attribute, SQLPOINTER ValuePtr, SQLINTEGER StringLength);

GLOBAL_STAT_ALL_INDEXES 显示集群内数据库各节点中每个索引的访问信息（在CN节点使用，每个索引在每个节点下的状态信息不汇总），如表1所示。 表1 GLOBAL_STAT_ALL_INDEXES字段 名称 类型 描述 node_name name 节点名称。 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