更新时间:2026-10-21 GMT+08:00
分享

双数据库实例容灾查询函数

  • 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()

    描述:投产模式下,主数据库实例产生能使灾备数据库实例回放卡住的一致性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()

    描述:查看dorado共享盘通道的健康和运行状态。

    返回值类型: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)

相关文档