table replica list
Lists replicas and the associated replica statistics for a specified binary table. By default, replica statistics are updated every five minutes.
- CLI
-
maprcli table replica list
-path table path
[ -refreshnow refreshnow. default: false ]
- REST
-
http[s]://<host>:<port>/rest/table/replica/list?path=<path>...
mapr
user is not treated as a superuser.
MapR-DB does not allow the mapr
user to run this command unless that user
is given the relevant permission or permissions with access-control expressions.Parameter | Description |
---|---|
path |
The path to the table that you want to list replicas for.
|
refreshnow | A Boolean value that specifies if you want to trigger an immediate update of
the replica statistics. The values are true or
false . By default, the value is false ; the
command lists the current version of the replica statistics, which could be a
maximum of five minutes old. |
Output
Lists information about each replica for the specified table.
Output Data FieldsThe following fields display for each replica:
Field | Description |
---|---|
cluster | The cluster on which the replica resides. |
table | The table name for the replica. |
type | The table type. |
paused | A Boolean values that specifies if replication is paused. |
throttle | A Boolean value that specifies if replication is throttled. |
idx | The internal index value. |
networkencryption | A Boolean value that specifies if replication is encrypted. |
synchronous | A Boolean value that specifies whether replication is synchronous or asynchronous. |
networkcompression | The type of on-wire compression. |
isUptodate | A Boolean value that specifies if the replica is up-to-date. |
minPendingTS | The epoch time in milliseconds of the oldest operation that has yet to be replicated to the replica. |
maxPendingTS | The epoch time in milliseconds of the newest operation that has yet to be replicated to the replica. |
bytesPending | The number of bytes that have yet to be replicated to the replica. |
putsPending | The number of puts that have yet to be replicated to the replica. |
bucketsPending | The number of buckets that have yet to be replicated to the replica. |
uuid | The table UUID. |
{
"timestamp":1424844685320,
"timeofday":"2015-02-25 06:11:25.320 GMT+0000",
"status":"OK",
"total":5,
"data":[
{
"cluster":"lak_bigcluster2",
"table":"/tables/largetab-all",
"type":"MapRDB",
"paused":false,
"throttle":false,
"idx":6,
"networkencryption":false,
"synchronous":false,
"networkcompression":"lz4",
"isUptodate":false,
"minPendingTS":1424819600,
"maxPendingTS":1424844684,
"bytesPending":913109600201,
"putsPending":13444505,
"bucketsPending":9643,
"uuid":"f534956f-d1e6-180e-27ff-057c28ec5400"
},
Example
Lists replicas for the custA table:
- CLI
- maprcli table replica list -path /volume1/custA
- REST
-
https://<hostIP>:8443/rest/table/replica/list?path=%2Fvolume1%2FcustA