Note
This view is available starting with V4.0.0.
Purpose
This view displays the distribution of log stream (LS) replicas in the current tenant.
Columns
| Column | Type | Nullable? | Description |
|---|---|---|---|
| CREATE_TIME | datetime(6) | NO | The time when the log stream was created. |
| MODIFY_TIME | datetime(6) | NO | The time when the log stream was last modified. |
| 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. LEADERFOLLOWER |
| MEMBER_LIST | varchar(4480) | NO | The list of replicas, separated by commas.
|
| PAXOS_REPLICA_NUMBER | bigint(20) | NO | The number of Paxos replicas required for a consensus. When the role is LEADER, this field is valid; otherwise, it is NULL. |
| REPLICA_TYPE | varchar(18) | NO | The type of the replica. FULL: a full-featured replica.READONLY: a read-only replica. |
| LEARNER_LIST | longtext | YES | The list of read-only replicas of the log stream, separated by commas. The format of a single replica is svr_ip:svr_port:timestamp:flag. Where:
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 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