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 volume
  • lookupdir on directories in the path
  • adminperm 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
maprcli stream replica list
	 -path <stream path> 
	[ -refreshnow <immediately refresh replication statistics> default: false ]
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.