Note
This view was introduced in OceanBase Database V4.0.0.
Purpose
The oceanbase.DBA_OB_LS_LOCATIONS view displays the distribution of the log stream replicas in the current tenant.
Columns
| Column | Type | Nullable? | Description |
|---|---|---|---|
| CREATE_TIME | datetime(6) | NO | The time when the log stream replica was created. |
| MODIFY_TIME | datetime(6) | NO | The time when the log stream replica was last modified. |
| LS_ID | bigint(20) | NO | The ID of the log stream replica. |
| SVR_IP | varchar(46) | NO | The IP address of the OBServer node. |
| SVR_PORT | bigint(20) | NO | The port number of the OBServer node. |
| 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. Valid values:LEADERFOLLOWER |
| MEMBER_LIST | varchar(4480) | NO | The list of replica members. Multiple replicas are separated with commas (,).
|
| PAXOS_REPLICA_NUMBER | bigint(20) | NO | The quorum of a Paxos group. This column is valid when the value of ROLE is LEADER. In other cases, the value of this column is NULL. |
| REPLICA_TYPE | varchar(18) | NO | The replica type. Valid values: FULL: indicates a full-featured replica.READONLY: indicates a read-only replica. |
| LEARNER_LIST | longtext | YES | The list of read-only replicas in the current log stream. Multiple replicas are separated with commas (,). A single replica is identified in the svr_ip:svr_port:timestamp:flag format. The parameters are described as follows:
Here is an example: 172.xx.xxx.xxx:2882:1:0.
NoteThis column was introduced in OceanBase Database V4.2.0. |
| REBUILD | varchar(5) | NO | Indicates whether the replica is being rebuilt.
NoteThis column was introduced in OceanBase Database V4.2.1. |
Sample query
Query the distribution of the log stream replicas in the current tenant.
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-03 11:24:50.890232 | 2024-09-03 11:24:53.272771 | 1 | 172.xx.xxx.xxx | 2882 | 2881 | zone1 | LEADER | 172.xx.xxx.xxx:2882:1 | 1 | FULL | | FALSE |
| 2024-09-03 11:25:04.074197 | 2024-09-03 11:25:06.474247 | 1001 | 172.xx.xxx.xxx | 2882 | 2881 | zone1 | LEADER | 172.xx.xxx.xxx:2882:1 | 1 | FULL | | FALSE |
+----------------------------+----------------------------+-------+----------------+----------+----------+-------+--------+-----------------------+----------------------+--------------+--------------+---------+
2 rows in set