Note
This view is available starting with V4.0.0.
Purpose
This view displays the distribution of log stream (LS) replicas across all tenants.
Columns
| Column | Type | Nullable? | Description |
|---|---|---|---|
| CREATE_TIME | datetime(6) | NO | The creation time of the log stream. |
| MODIFY_TIME | datetime(6) | NO | The modification time of the log stream. |
| TENANT_ID | bigint(20) | NO | The tenant ID. |
| LS_ID | bigint(20) | NO | The log stream ID. |
| 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. The format for a single replica is svr_ip:svr_port:timestamp. The following table describes the parameters in this format.
|
| PAXOS_REPLICA_NUMBER | bigint(20) | NO | The number of Paxos replicas required for a consensus: 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 for a single replica is svr_ip:svr_port:timestamp:flag. The following table describes the parameters in this format.
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 across all tenants.
obclient [oceanbase]> SELECT * FROM oceanbase.CDB_OB_LS_LOCATIONS;
The query result is as follows:
+----------------------------+----------------------------+-----------+-------+----------------+----------+----------+-------+--------+-----------------------+----------------------+--------------+--------------+---------+
| CREATE_TIME | MODIFY_TIME | TENANT_ID | LS_ID | SVR_IP | SVR_PORT | SQL_PORT | ZONE | ROLE | MEMBER_LIST | PAXOS_REPLICA_NUMBER | REPLICA_TYPE | LEARNER_LIST | REBUILD |
+----------------------------+----------------------------+-----------+-------+----------------+----------+----------+-------+--------+-----------------------+----------------------+--------------+--------------+---------+
| 2024-09-04 09:49:41.360880 | 2024-09-04 09:49:41.360880 | 1 | 1 | 172.xx.xxx.xxx | 2882 | 2881 | zone1 | LEADER | 172.xx.xxx.xxx:2882:1 | 1 | FULL | | FALSE |
| 2024-09-03 11:24:40.666453 | 2024-09-03 11:24:44.012831 | 1001 | 1 | 172.xx.xxx.xxx | 2882 | 2881 | zone1 | LEADER | 172.xx.xxx.xxx:2882:1 | 1 | FULL | | FALSE |
| 2024-09-03 11:24:50.890232 | 2024-09-03 11:24:53.272771 | 1002 | 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 | 1002 | 1001 | 172.xx.xxx.xxx | 2882 | 2881 | zone1 | LEADER | 172.xx.xxx.xxx:2882:1 | 1 | FULL | | FALSE |
| 2024-09-03 11:25:20.454418 | 2024-09-03 11:25:22.781502 | 1003 | 1 | 172.xx.xxx.xxx | 2882 | 2881 | zone1 | LEADER | 172.xx.xxx.xxx:2882:1 | 1 | FULL | | FALSE |
| 2024-09-03 11:25:29.853284 | 2024-09-03 11:25:32.239761 | 1004 | 1 | 172.xx.xxx.xxx | 2882 | 2881 | zone1 | LEADER | 172.xx.xxx.xxx:2882:1 | 1 | FULL | | FALSE |
| 2024-09-03 11:25:42.831141 | 2024-09-03 11:25:45.241945 | 1004 | 1001 | 172.xx.xxx.xxx | 2882 | 2881 | zone1 | LEADER | 172.xx.xxx.xxx:2882:1 | 1 | FULL | | FALSE |
+----------------------------+----------------------------+-----------+-------+----------------+----------+----------+-------+--------+-----------------------+----------------------+--------------+--------------+---------+
7 rows in set