table replica list

Lists replicas and the associated replica statistics for a specified MapR-DB binary or JSON table. By default, replica statistics are updated every five minutes.

Permissions Required

To run this command, your user ID must have the following permissions:
  • readAce on the volume
  • lookupdir on directories in the path
Note: The 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.
CLI
maprcli table replica list
  -path <table path>
  [ -refreshnow <updates the replica stats> default: false ]
REST
http[s]://<host>:<port>/rest/table/replica/list?path=<path>...
Note: The 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.

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

The 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.
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:

CLI
maprcli table replica list -path /volume1/custA
REST

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