getClusterChunksStatus
Syntax
getClusterChunksStatus()
Details
This function obtains the metadata about all database chunks (file chunks and tablet chunks) on the data nodes in a cluster. It can be executed only on a controller. It returns a table containing the following columns:
chunkId: the chunk ID.
file: the chunk path.
size: The disk space occupied by the file chunk (in Bytes). Return 0 for a tablet chunk. Use getTabletsMeta to check the disk usage of a tablet chunk.
version: the version number of the current chunk.
vcLength: length of the version chain.
versionChain: version chain of the chunk, e.g. “18441:76:1:346 -> 18441:0:0:346 -> “, where
18441 |
76 |
1 |
346 |
|---|---|---|---|
cid (chunk ID) |
chunk size |
version number |
sid (snapshot ID) |
state: the chunk state. It can be
CONSTRUCTING: in transaction;
RECOVERING: recovering;
COMPLETE: transaction completed.
replicas: the replica information of the chunk, e.g., “local8848:1:0:false:1671075776643574000”, where
local8848 |
1 |
0 |
false |
1671075776643574000 |
|---|---|---|---|---|
node alias where the replica is located |
version number |
whether the replica is corrupted |
whether a transaction is in resolution |
the latest report timestamp on the node |
replicaCount: the number of replica(s).
lastUpdated: the timestamp for last update. Note that lastUpdated column is supported since version 1.30.21. For a chunk created before version 1.30.21, it returns a NULL value.
permission: the chunk permission. It can be READ_WRITE (default), READ_ONLY, WRITE_ONLY, and UNKNOWN. Chunks that are being transferred or stored in S3 are READ_ONLY.
For READ_ONLY chunks:
(1) Data cannot be appended or updated. Only drop operations can be performed to delete records. Transaction is supported in the READ_ONLY chunks (except for those stored in S3).
(2) Operations such as recovery and rebalance cannot be performed.
Examples
$ rpc(getControllerAlias(), getClusterChunksStatus);
chunkId |
file |
size |
version |
vcLength |
versionChain |
state |
replicas |
replicaCount |
lastUpdated |
permission |
|---|---|---|---|---|---|---|---|---|---|---|
092d5e12-e595-6f… |
/testDB/pt2.tbl |
49 |
1 |
1 |
2052:49:1 -> |
COMPLETE |
P1-node1:1:0,P2-… |
2 |
2022.03.31T18:09:41.138 |
READ_WRITE |
42936e31-8be0-fa… |
/testDB/9/i |
0 |
2 |
2 |
2053:0:2 -> 2051… |
COMPLETE |
P3-node1:2:0,P1-… |
2 |
2022.03.31T18:09:41.138 |
READ_WRITE |
d31e6b47-18f0-37… |
/testDB/7/i |
0 |
2 |
2 |
2053:0:2 -> 2051… |
COMPLETE |
P1-node1:2:0,P2-… |
2 |
2022.03.31T18:09:41.138 |
READ_WRITE |
647a5fd6-cd85-3b… |
/testDB/6/i |
0 |
2 |
2 |
2053:0:2 -> 2051… |
COMPLETE |
P1-node1:2:0,P3-… |
2 |
2022.03.31T18:09:41.138 |
READ_WRITE |
8bec6445-bc6d-36… |
/testDB/5/i |
0 |
2 |
2 |
2053:0:2 -> 2051… |
COMPLETE |
P2-node1:2:0,P3-… |
2 |
2022.03.31T18:09:41.138 |
READ_WRITE |
ca690ba5-be73-a6… |
/testDB/4/i |
0 |
2 |
2 |
2053:0:2 -> 2051… |
COMPLETE |
P3-node1:2:0,P1-… |
2 |
2022.03.31T18:09:41.138 |
READ_WRITE |