双数据库实例容灾查询函数
- gs_get_local_barrier_status()
描述:基于流式复制的异地容灾特性开启后,主数据库实例和灾备数据库实例进行日志同步,通过barrier日志在主数据库实例的落盘,在灾备数据库实例的回放来确定主数据库实例归档日志进度与灾备数据库实例日志回放进度。gs_get_local_barrier_status用于查询灾备数据库实例每个节点当前的日志回放情况。
返回值类型:text
barrier_id:灾备数据库实例某节点当前回放到的最新barrier ID。
barrier_lsn:灾备数据库实例某节点当前回放到的最新barrier ID的Log Sequence Number ( LSN )。
archive_lsn:灾备数据库实例某节点当前已获得归档日志的位置,该参数当前未生效。
flush_lsn:灾备数据库实例某节点当前已完成刷盘日志位置。
- gs_hadr_in_recovery()
描述:基于流式复制的异地容灾特性开启后,查询当前节点是否处于基于目标barrier的日志恢复中,还在恢复中返回true。只有完成日志恢复,才会启动switchover流程中的灾备数据库实例升为生产数据库实例的步骤(需要系统管理员角色)。
返回值类型:Boolean
备注:该函数只有在容灾数据库实例启动计划内switchover时使用。
- gs_streaming_dr_get_switchover_barrier()
描述:基于流式复制的异地容灾解决方案中,查询灾备数据库实例的DN实例是否已接收到switchover barrier日志并完成回放,已完成返回true。灾备数据库实例只有在所有DN实例都完成switchover barrier日志回放,才会启动switchover流程中的灾备数据库实例升为生产数据库实例的步骤(需要系统管理员角色)。
返回值类型:Boolean
备注:该函数只有在流式容灾解决方案中容灾数据库实例启动计划内switchover时使用。
- gs_streaming_dr_service_truncation_check()
描述:基于流式复制的异地容灾解决方案中,查询主数据库实例的DN实例是否已完成switchover barrier日志发送,已完成返回true。只有完成日志发送,才会启动switchover流程中的生产数据库实例降为灾备数据库实例的步骤(需要系统管理员角色)。
返回值类型:Boolean
备注:该函数只有在容灾数据库实例启动计划内switchover时使用。
- gs_hadr_local_rto_and_rpo_stat()
描述:显示流式容灾的主数据库实例和备数据库实例日志流控信息(只可在主数据库实例的主DN使用,备DN以及备数据库实例均上不可获取到统计信息)。
返回值类型:record,具体各个字段的类型和含义如表1所示。
表1 gs_hadr_local_rto_and_rpo_stat参数说明 参数
类型
描述
hadr_sender_node_name
text
节点的名称,包含主数据库实例和备数据库实例首备。
hadr_receiver_node_name
text
备数据库实例首备名称。
source_ip
text
主数据库实例主DN IP地址。
source_port
int
主数据库实例主DN通信端口。
dest_ip
text
备数据库实例首备DN IP地址。
dest_port
int
备数据库实例首备DN通信端口。
current_rto
int
流控的信息,当前主备数据库实例的日志RTO时间(单位:秒)。
target_rto
int
流控的信息,目标主备数据库实例间的RTO时间(单位:秒)。
current_rpo
int
流控的信息,当前主备数据库实例的日志RPO时间(单位:秒)。
target_rpo
int
流控的信息,目标主备数据库实例间的RPO时间(单位:秒)。
rto_sleep_time
int
RTO流控信息,为了达到目标RTO,预期主机walsender所需要的睡眠时间(单位:微秒)。
rpo_sleep_time
int
RPO流控信息,为了达到目标RPO,预期主机xlogInsert所需要的睡眠时间(单位:微秒)。
- gs_hadr_remote_rto_and_rpo_stat()
- disaster_cluster_run_mode()
描述:此函数用于判断当前数据库实例运行模式,查询该函数返回-1。
返回值类型:int
- gs_hadr_create_recovery_pause_barrier()
- gs_is_wal_truncate_complete()
描述:投产模式下,用于投产失败后查询当前灾备数据库实例的日志在线截断是否完成,已完成返回true。
返回值类型:Boolean
- gs_hadr_local_replay_delay_stat()
描述:灾备数据库实例延迟回放场景下,显示灾备数据库实例barrier接收、barrier回放以及延迟时间等信息。
返回值类型:record
表2 gs_hadr_local_replay_delay_stat返回参数说明 参数名
类型
描述
node_name
text
实例名。
receive_barrier
text
接收携带时间戳的日志信息。
receive_barrier_lsn
text
接收携带时间戳的日志LSN。
receive_time
timestamp with time zone
解析接收时间戳。
replay_barrier
text
回放携带时间戳的日志信息。
replay_barrier_lsn
text
回放携带时间戳的日志LSN。
replay_time
timestamp with time zone
解析回放时间戳。
delay_replay
int8
延迟回放配置值。
current_remain_interval
int8
延迟实际间隔。
示例:
gaussdb=# SELECT * FROM gs_hadr_local_replay_delay_stat(); node_name | receive_barrier | receive_barrier_lsn | receive_time | replay_barrier | replay_barrier_lsn | replay_time | delay_replay | current_remain_interval -------------------+-----------------------------------------+---------------------+----------------------------+-----------------------------------------+--------------------+----------------------------+--------------+------------------------- dn_6001_6002_6003 | hadr_00000000000000001395_1768893018504 | 00000000/12176D98 | 2026-01-20 15:10:18.504+08 | hadr_00000000000000001395_1768893018504 | 00000000/12176D98 | 2026-01-20 15:10:18.504+08 | 0 | 0 (1 row) - gs_change_dorado_state(device_name cstring, dorado_state cstring, term int)
描述:更改dorado共享盘通道状态,仅数据库初始化用户可以执行该函数。
返回值类型:Boolean
表3 gs_change_dorado_state返回参数说明 参数类型
参数名
类型
描述
输入参数
device_name
text
共享盘通道名称。
输入参数
dorado_state
text
共享盘状态。
输入参数
term
int
当前数据库实例term值。
示例:
gaussdb=# SELECT * FROM gs_change_dorado_state('/dev/my_disk_6001','online',10); result -------- t (1 row) - gs_get_dorado_state()
返回值类型:record
表4 gs_get_dorado_state返回参数说明 参数类型
参数名
类型
描述
输出参数
device_name
text
共享盘通道名称。
输出参数
dorado_health
text
共享盘健康状态。
输出参数
dorado_state
text
共享盘运行状态。
输出参数
sharestorage_term
int
当前数据库实例term值。
示例:
gaussdb=# SELECT * FROM gs_get_dorado_state(); device_name | dorado_health | dorado_state | sharestorage_term ----------------------+---------------+--------------+------------------- /dev/my_disk_6001 | health | online | 1 /dev/my_disk_6001_ex | health | online | 1 (2 rows)