table replica edit
Edits the properties of a replica of a HPE Ezmeral Data Fabric Database binary or JSON table.
Permissions Required
To run this command, your user ID must have the following permissions:
readAce
andwriteAce
on both the source volume and the target volumelookupdir
on directories in the paths of both tablesreadperm
andreplperm
permissions on the source table
Syntax
- CLI
-
maprcli table replica edit -path <table path> -replica <replica table path> [ -newreplica <renamed table path> ] [ -columns <comma separated list of <family>[:<column>]> ] [ -throttle <throttle replication ops> ] [ -networkencryption <enable on-wire encryption> ] [ -synchronous <is synchronous replication> ] [ -networkcompression <on-wire compression type: off|on|lzf|lz4|zlib> ]
- REST
-
curl -k -X POST 'http[s]://<host>:<port>/rest/table/replica/edit?path=<path>&replica=<path>&<parameters>' -u <username>:<password>
Parameters
Parameter | Description |
---|---|
path |
The path to the source table that you want to replicate.
|
replica |
The path to the replica.
|
newreplica |
The updated replica path due to a renamed replica table, renamed cluster, or
changed table path. The table specified in the |
columns |
By default, all columns in the source table are replicated. If you do not want to replicate all columns in the table, you can
specify specific columns to replicate:
|
throttle | A Boolean value that specifies whether or not to throttle replication
operations. Throttle the replication stream to minimize the impact of the
replication process on incoming operations during periods of heavy load. The values
are true or false . No throttle
(false ) is the default. |
networkencryption | A Boolean value that specifies whether or not to enable on-wire encryption. The
values are true or false . No encryption
(false) is the default. If you set this to true,
the local cluster and any other cluster that is part of the replication process must
be enabled for security. |
synchronous |
A Boolean value that specifies whether replication is synchronous or
asynchronous. The values are |
networkcompression |
The type of on-wire compression. The types are:
lz4 is the default compression which it set by parameter values on or lz4. |
Examples
Changes the replica path to reflect that replica t2dst
is renamed to
t2dst_new
:
- CLI
-
maprcli table replica edit -path /volume1/t1src -replica /volume1/t2dst \ -newreplica /volume1/t2dst_new
- REST
curl -k -X POST \ 'https://r1n1.sj.us:8443/rest/table/replica/edit?path=%2Fvolume1%2Ft1&replica=%2Fvolume1%2Ft2&newreplica=%2Fvolume1%2Ft2_new' \ -u mapr:mapr
Changes the column families to replicate:
- CLI
maprcli table replica edit -path /volume1/custAsrc -replica /volume2/custAdst \ -columns purchases, reviews, returns
- REST
curl -k -X POST \ 'https://r1n1.sj.us:8443/rest/table/replica/edit?path=%2Fvolume1%2FcustAsrc&replica=%2Fvolume2%2FcustAdst&columns=purchases,reviews,returns' \ -u mapr:mapr