Documentation Home
MySQL 9.0 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 40.0Mb
PDF (A4) - 40.1Mb
Man Pages (TGZ) - 258.8Kb
Man Pages (Zip) - 365.9Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


15.7.7.35 SHOW REPLICAS Statement

SHOW REPLICAS

Displays a list of replicas currently registered with the source. SHOW REPLICAS requires the REPLICATION SLAVE privilege.

SHOW REPLICAS should be executed on a server that acts as a replication source. The statement displays information about servers that are or have been connected as replicas, with each row of the result corresponding to one replica server, as shown here:

mysql> SHOW REPLICAS;
+------------+-----------+------+-----------+--------------------------------------+
| Server_id  | Host      | Port | Source_id | Replica_UUID                         |
+------------+-----------+------+-----------+--------------------------------------+
|         10 | iconnect2 | 3306 |         3 | 14cb6624-7f93-11e0-b2c0-c80aa9429562 |
|         21 | athena    | 3306 |         3 | 07af4990-f41f-11df-a566-7ac56fdaf645 |
+------------+-----------+------+-----------+--------------------------------------+
  • Server_id: The unique server ID of the replica server, as configured in the replica server's option file, or on the command line with --server-id=value.

  • Host: The host name of the replica server, as specified on the replica with the --report-host option. This can differ from the machine name as configured in the operating system.

  • User: The replica server user name, as specified on the replica with the --report-user option. Statement output includes this column only if the source server is started with the --show-replica-auth-info option.

  • Password: The replica server password, as specified on the replica with the --report-password option. Statement output includes this column only if the source server is started with the --show-replica-auth-info option.

  • Port: The port on the source to which the replica server is listening, as specified on the replica with the --report-port option.

    A zero in this column means that the replica port (--report-port) was not set.

  • Source_id: The unique server ID of the source server that the replica server is replicating from. This is the server ID of the server on which SHOW REPLICAS is executed, so this same value is listed for each row in the result.

  • Replica_UUID: The globally unique ID of this replica, as generated on the replica and found in the replica's auto.cnf file.