Skip to main content
Skip to main content

SHOW-REPLICA-STATUS

SHOW-REPLICA-STATUS

Name

SHOW REPLICA STATUS

Description

This statement is used to display replica status information for a table or partition.

grammar:

SHOW REPLICA STATUS FROM [db_name.]tbl_name [PARTITION (p1, ...)]
[where_clause];

illustrate

  1. where_clause: WHERE STATUS [!]= "replica_status"

  2. replica_status: OK: replica is healthy DEAD: The Backend where the replica is located is unavailable VERSION_ERROR: replica data version is missing SCHEMA_ERROR: The schema hash of the replica is incorrect MISSING: replica does not exist

Example

  1. View the status of all replicas of the table

    SHOW REPLICA STATUS FROM db1.tbl1;
  2. View a copy of a table with a partition status of VERSION_ERROR

    SHOW REPLICA STATUS FROM tbl1 PARTITION (p1, p2)
    WHERE STATUS = "VERSION_ERROR";
  3. View all unhealthy replicas of the table

    SHOW REPLICA STATUS FROM tbl1
    WHERE STATUS != "OK";

Keywords

SHOW, REPLICA, STATUS

Best Practice