Lists replicas and the associated replica statistics for a specified table.  By default, replica statistics are updated every five minutes.

Syntax

CLI

maprcli table replica list
-path table path
[ -refreshnow refreshnow. default: false ]

REST
http[s]://<host>:<port>/rest/table/replica/list?path=<path>...

Parameter

ParameterDescription
path

The path to the table that you want to list replicas for.

  • For a table on the local cluster, start the path at the volume mount point. For example, for a table named test under a volume with a mount point at /volume1, specify the following path: /volume1/test

  • For a table on another cluster, you must also specify the cluster name in the path. For example, for a table named customer under volume1 in the sanfranciscocluster, specify the following path: /mapr/sanfrancisco/volume1/customer

refreshnowA 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 Fields

The following fields display for each replica:

FieldDescription
clusterThe cluster on which the replica resides.
tableThe table name for the replica.
typeThe table type.
pausedA Boolean values that specifies if replication is paused.
throttleA Boolean value that specifies if replication is throttled.
idxThe internal index value.
networkencryptionA Boolean value that specifies if replication is encrypted.
synchronousA Boolean value that specifies whether replication is synchronous or asynchronous.
networkcompressionThe type of on-wire compression.
isUptodateA Boolean value that specifies if the replica is up-to-date.
minPendingTSThe epoch time in milliseconds of the oldest operation that has yet to be replicated to the replica.
maxPendingTSThe epoch time in milliseconds of the newest operation that has yet to be replicated to the replica.
bytesPendingThe number of bytes that have yet to be replicated to the replica.
putsPendingThe number of puts that have yet to be replicated to the replica.
bucketsPendingThe number of buckets that have yet to be replicated to the replica.
uuidThe table UUID.

Sample Output

{
       "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: 

CLImaprcli table replica list -path /volume1/custA
REST

https://<hostIP>:8443/rest/table/replica/list?path=%2Fvolume1%2FcustA