Note
This view is available starting with V4.0.0.
Purpose
This view displays the distribution information of log stream (LS) replicas in the current tenant.
Columns
Column |
Type |
Nullable |
Description |
|---|---|---|---|
| CREATE_TIME | datetime(6) | NO | The creation time. |
| MODIFY_TIME | datetime(6) | NO | The modification time. |
| LS_ID | bigint(20) | NO | The ID of the log stream. |
| SVR_IP | varchar(46) | NO | The IP address of the server. |
| SVR_PORT | bigint(20) | NO | The port number of the server. |
| SQL_PORT | bigint(20) | NO | The SQL port number. |
| ZONE | varchar(128) | NO | The name of the zone. |
| ROLE | varchar(8) | NO | The role of the replica:
|
| MEMBER_LIST | varchar(4480) | NO | The list of replicas, separated by commas. The format of a single replica is svr_ip:svr_port:timestamp. The details are as follows:
|
| PAXOS_REPLICA_NUMBER | bigint(20) | NO | The number of Paxos replicas. This field is valid only when the role is LEADER. Otherwise, it is NULL. |
| REPLICA_TYPE | varchar(18) | NO | The type of the replica:
|
| LEARNER_LIST | longtext | YES | The list of read-only replicas of the current log stream, separated by commas. The format of a single replica is svr_ip:svr_port:timestamp:flag. The details are as follows:
Example: 172.xx.xxx.xxx:2882:1:0 NoteThis field is available starting with V4.2.0. |
| REBUILD | varchar(5) | NO | Indicates whether the replica is being rebuilt.
NoteThis field is available starting with V4.2.1. |
Sample query
Query the distribution information of log stream replicas in the current tenant. The system tenant has only one log stream, log stream 1.
obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_LS_LOCATIONS;
The query result is as follows:
+----------------------------+----------------------------+-------+----------------+----------+----------+-------+--------+-----------------------+----------------------+--------------+--------------+---------+
| CREATE_TIME | MODIFY_TIME | LS_ID | SVR_IP | SVR_PORT | SQL_PORT | ZONE | ROLE | MEMBER_LIST | PAXOS_REPLICA_NUMBER | REPLICA_TYPE | LEARNER_LIST | REBUILD |
+----------------------------+----------------------------+-------+----------------+----------+----------+-------+--------+-----------------------+----------------------+--------------+--------------+---------+
| 2024-09-04 09:47:44.144634 | 2024-09-04 09:47:44.144634 | 1 | 172.xx.xxx.xxx | 2882 | 2881 | zone1 | LEADER | 172.xx.xxx.xxx:2882:1 | 1 | FULL | | FALSE |
+----------------------------+----------------------------+-------+----------------+----------+----------+-------+--------+-----------------------+----------------------+--------------+--------------+---------+
1 row in set