
# 常用视图工具
| 视图类型 | 类型                                                     | 功能描述                                                                                                                                            | 使用场景                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 函数名称                            |
|:---|:---|:---|:---|:---|
| 解析   | 全类型                                                    | 用于解析指定表页面，并返回存放解析内容的路径。                                                                                                                         | - 查看页面信息。  - 查看元组（非用户数据）信息。  - 页面或者元组损坏。  - 元组可见性问题。  - 校验报错问题。                                                                                                                                                                                                 | gs_parse_page_bypath            |
| 解析   | 索引回收队列（URQ）                                            | 用于解析UB-tree索引回收队列关键信息。                                                                                                                          | - UB-tree索引空间膨胀。  - UB-tree索引空间回收异常。  - 校验报错问题。                                                                                                                                                                                                                                                                                                                                                                                                                          | gs_urq_dump_stat                |
| 解析   | 回滚段（Undo）                                              | 用于解析指定Undo Record的内容，不包含旧版本元组的数据。                                                                                                               | - undo空间膨胀。  - undo回收异常。  - 回滚异常。  - 日常巡检。  - 校验报错。  - 可见性判断异常。  - 修改参数。   | gs_undo_dump_record             |
| 解析   | 回滚段（Undo）                                              | 用于解析指定事务生成的所有Undo Record，不包含旧版本元组的数据。                                                                                                           | - undo空间膨胀。  - undo回收异常。  - 回滚异常。  - 日常巡检。  - 校验报错。  - 可见性判断异常。  - 修改参数。   | gs_undo_dump_xid                |
| 解析   | 回滚段（Undo）                                              | 用于解析指定UndoZone中所有Transaction Slot信息。                                                                                                            | - undo空间膨胀。  - undo回收异常。  - 回滚异常。  - 日常巡检。  - 校验报错。  - 可见性判断异常。  - 修改参数。   | gs_undo_translot_dump_slot      |
| 解析   | 回滚段（Undo）                                              | 用于解析指定事务对应Transaction Slot信息，包括事务XID和该事务生成的Undo Record范围.                                                                                       | - undo空间膨胀。  - undo回收异常。  - 回滚异常。  - 日常巡检。  - 校验报错。  - 可见性判断异常。  - 修改参数。   | gs_undo_translot_dump_xid       |
| 解析   | 回滚段（Undo）                                              | 用于解析指定Undo Zone的元信息，显示Undo Record和Transaction Slot指针使用情况。                                                                                       | - undo空间膨胀。  - undo回收异常。  - 回滚异常。  - 日常巡检。  - 校验报错。  - 可见性判断异常。  - 修改参数。   | gs_undo_meta_dump_zone          |
| 解析   | 回滚段（Undo）                                              | 用于解析指定Undo Zone对应Undo Space的元信息，显示Undo Record文件使用情况。                                                                                            | - undo空间膨胀。  - undo回收异常。  - 回滚异常。  - 日常巡检。  - 校验报错。  - 可见性判断异常。  - 修改参数。   | gs_undo_meta_dump_spaces        |
| 解析   | 回滚段（Undo）                                              | 用于解析指定Undo Zone对应Slot Space的元信息，显示Transaction Slot文件使用情况。                                                                                       | - undo空间膨胀。  - undo回收异常。  - 回滚异常。  - 日常巡检。  - 校验报错。  - 可见性判断异常。  - 修改参数。   | gs_undo_meta_dump_slot          |
| 解析   | 回滚段（Undo）                                              | 用于解析数据页和数据页上数据的所有历史版本，并返回存放解析内容的路径。                                                                                                             | - undo空间膨胀。  - undo回收异常。  - 回滚异常。  - 日常巡检。  - 校验报错。  - 可见性判断异常。  - 修改参数。   | gs_undo_dump_parsepage_mv       |
| 解析   | 预写日志 （WAL） | 用于解析指定LSN范围之内的Xlog日志，并返回存放解析内容的路径。可以通过pg_current_xlog_location()获取当前Xlog位置。                                                                     | - WAL日志出错。  - 日志回放出错。  - 页面损坏。                                                                                                                                                                                                                                                                                                                                                                                                                                 | gs_xlogdump_lsn                 |
| 解析   | 预写日志 （WAL） | 用于解析指定XID的Xlog日志，并返回存放解析内容的路径。可以通过txid_current()获取当前事务ID。                                                                                       | - WAL日志出错。  - 日志回放出错。  - 页面损坏。                                                                                                                                                                                                                                                                                                                                                                                                                                 | gs_xlogdump_xid                 |
| 解析   | 预写日志 （WAL） | 用于解析指定表页面对应的日志，并返回存放解析内容的路径。                                                                                                                    | - WAL日志出错。  - 日志回放出错。  - 页面损坏。                                                                                                                                                                                                                                                                                                                                                                                                                                 | gs_xlogdump_tablepath           |
| 解析   | 预写日志 （WAL） | 用于解析指定表页面和表页面对应的日志，并返回存放解析内容的路径。可以看作一次执行gs_parse_page_bypath和gs_xlogdump_tablepath。该函数执行的前置条件是表文件存在。如果想查看已删除的表的相关日志，请直接调用gs_xlogdump_tablepath。 | - WAL日志出错。  - 日志回放出错。  - 页面损坏。                                                                                                                                                                                                                                                                                                                                                                                                                                 | gs_xlogdump_parsepage_tablepath |
| 统计   | 回滚段（Undo）                                              | 用于显示Undo模块的统计信息，包括Undo Zone使用情况、Undo链使用情况、Undo模块文件创建删除情况和Undo模块参数设置推荐值。                                                                         | - Undo空间膨胀。  - Undo资源监控。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | gs_stat_undo                    |
| 统计   | 预写日志 （WAL） | 用于统计预写日志（WAL）写盘时的内存状态表内容。                                                                                                                       | - WAL写/刷盘监控。  - WAL写/刷盘hang住。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | gs_stat_wal_entrytable          |
| 统计   | 预写日志 （WAL） | 用于统计预写日志（WAL）刷盘状态、位置统计信息。                                                                                                                       | - WAL写/刷盘监控。  - WAL写/刷盘hang住。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | gs_walwriter_flush_position     |
| 统计   | 预写日志 （WAL） | 用于统计预写日志（WAL）写刷盘次数频率、数据量以及刷盘文件统计信息。                                                                                                             | - WAL写/刷盘监控。  - WAL写/刷盘hang住。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | gs_walwriter_flush_stat         |
| 校验   | 堆表/索引                                                  | 用于离线校验表或者索引文件磁盘页面数据是否异常。                                                                                                                        | - 页面损坏或者元组损坏。  - 可见性问题。  - 日志回放出错问题。                                                                                                                                                                                                                                                                                                                                                                                                                                  | ANALYZE VERIFY                  |
| 校验   | 堆表/索引                                                  | 用于校验当前实例当前库物理文件是否存在丢失。                                                                                                                          | 文件丢失。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | gs_verify_data_file             |
| 校验   | 索引回收队列（URQ）                                            | 用于校验UB-tree索引回收队列（潜在队列/可用队列/单页面）数据是否异常。                                                                                                         | - UB-tree索引空间膨胀。  - UB-tree索引空间回收异常。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | gs_verify_urq                   |
| 校验   | 回滚段（Undo）                                              | 用于离线校验Undo Record数据是否存在异常。                                                                                                                      | - Undo Record异常或者损坏。  - 可见性问题。  - 回滚出错或者异常。                                                                                                                                                                                                                                                                                                                                                                                                                                  | gs_verify_undo_record           |
| 校验   | 回滚段（Undo）                                              | 用于离线校验Transaction Slot数据是否存在异常。                                                                                                                 | - Undo Record异常或者损坏。  - 可见性问题。  - 回滚出错或者异常。                                                                                                                                                                                                                                                                                                                                                                                                                   | gs_verify_undo_slot             |
| 校验   | 回滚段（Undo）                                              | 用于离线校验Undo元信息数据是否存在异常。                                                                                                                          | - 因Undo meta引起的节点无法启动问题。  - Undo空间回收异常。  - Snapshot too old问题。                                                                                                                                                                                                                                                                                                                                                                                                  | gs_verify_undo_meta             |
| 修复   | 堆表/索引/Undo文件                                           | 用于基于备机修复主机丢失的物理文件。                                                                                                                              | 堆表/索引/Undo文件丢失。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | gs_repair_file                  |
| 修复   | 堆表/索引/Undo页面                                           | 用于校验并基于备机修复主机受损页面。                                                                                                                              | 堆表/索引/Undo页面损坏。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | gs_verify_and_tryrepair_page    |
| 修复   | 堆表/索引/Undo页面                                           | 用于基于备机页面直接修复主机页面。                                                                                                                               | 堆表/索引/Undo页面损坏。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | gs_repair_page                  |
| 修复   | 堆表/索引/Undo页面                                           | 用于基于偏移量对页面的备份进行字节修改。                                                                                                                            | 堆表/索引/Undo页面损坏。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | gs_edit_page_bypath             |
| 修复   | 堆表/索引/Undo页面                                           | 用于将修改后的页面覆盖写入到目标页面。                                                                                                                             | 堆表/索引/Undo页面损坏。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | gs_repair_page_bypath           |
| 修复   | 回滚段（Undo）                                              | 用于重建Undo元信息，如果校验发现Undo元信息没有问题则不重建。                                                                                                              | Undo元信息异常或者损坏。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | gs_repair_undo_byzone           |
| 修复   | 索引回收队列（URQ）                                            | 用于重建UB-tree索引回收队列。                                                                                                                              | 索引回收队列异常或者损坏。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | gs_repair_urq                   |
   
