stream replica list
Lists the replicas of a given stream.
Permissions Required on the Source Cluster
To run this command, your user ID must have the following permissions:readAce
on the volumelookupdir
on directories in the pathadminperm
permission on the source stream
NOTE
The mapr
user is not treated as a
superuser. HPE Ezmeral Data Fabric Streams does not allow the
mapr
user to run this command unless that user is given the relevant
permission or permissions with access-control expressions.Syntax
CLI |
|
REST | http[s]://<host>:<port>/rest/stream/replica/list?path=<path> |
Parameters
Parameter | Description |
---|---|
path |
The path and name of the stream that you want to list the replicas of. |
refreshnow |
A boolean value that specifies whether to trigger an immediate update of the
replica statistics. The values are true or false .
By default, the value is false and the command lists the current
version of the replica statistics, which could be a maximum of five minutes
old. |
Sample with Output
# maprcli stream replica list -path /srcVol/srcStream -json
{
"timestamp":1507758209755,
"timeofday":"2017-10-11 02:43:29.755 GMT-0700",
"status":"OK",
"total":1,
"data":[
{
"cluster":"my.cluster.com",
"stream":"/destVol",
"type":"MapRStream",
"replicaPath":"/destVol",
"replicaState":"REPLICA_STATE_CREATE_SCHEDULE",
"paused":false,
"throttle":false,
"idx":1,
"networkencryption":false,
"synchronous":false,
"networkcompression":"lz4",
"propagateExistingData":false,
"isUptodate":true,
"minPendingTS":0,
"maxPendingTS":0,
"bytesPending":0,
"bucketsPending":0,
"copyTableCompletionPercentage":0,
}
]
}
Data Fields
Data Fields | Description |
---|---|
cluster | The cluster on which the replica stream resides. |
stream | The path of the replica stream. |
type | Identifies the type of table: HPE Ezmeral Data Fabric Database table or HPE Ezmeral Data Fabric Streams stream. |
replicaPath | The replica location of the source stream. |
replicaState | The replication state indicates when stream replication is in progress and it also displays the status of operations related to replica autosetup with directcopy. |
paused | A Boolean values that specifies if replication is paused. |
throttle | A Boolean value that specifies if replication is throttled. |
idx | The index number of the replica stream. |
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. |
propagateExistingData | Used to identify whether existing data in a CDC table is propagated to stream topic. |
isUptodate | A Boolean value that specifies if the replica is up-to-date. |
minPendingTS | The epoch time in milliseconds of the oldest message that has yet to be replicated. |
maxPendingTS | The epoch time in milliseconds of the newest message that has yet to be replicated. |
bytesPending | The number of bytes that have yet to be replicated. |
bucketsPending | The number of buckets that have yet to be replicated. |
copyTableCompletionPercentage | The percentage of data replication completed from the source stream to the
destination stream. NOTE When replicating HPE Ezmeral Data Fabric Database
data, the copyTablePercentageCompletion data may re-adjust to a lower rate. This
depends on table region (also referred to as tablets) splits and merges as well as
the rate of incoming data to replicating data. |