table replica add
Registers a binary table as a replica of another binary table.
table replica autosetup
command. Syntax
- CLI
-
maprcli table replica add -path table path -replica replica table path [ -columns comma separated list of <family>[:<column>] ] [ -paused is replication paused. default: false ] [ -throttle throttle replication ops. default: false ] [ -networkencryption enable on-wire encryption. default: false ] [ -synchronous is synchronous replication. default: false ] [ -networkcompression on-wire compression type: off|on|lzf|lz4|zlib. default: on ]
- REST
-
http[s]://<host>:<port>/rest/table/replica/add?path=<path>&replica=<name>...
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.Parameters
Parameter | Description |
---|---|
path |
The path to the source table that you want to replicate.
|
replica |
The path to the replica.
NOTE: For replication to a table, the command will fail if the table in the replica
path does not exist.
|
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.
Provide a comma-separated list of column families or columns from a certain column
family (column family:qualifier). For example, use the following syntax to
replicate the column family purchases and the column stars in the reviews column
family: |
paused |
A Boolean value that specifies whether to pause the replication so that it does
not start immediately. The replication can be resumed using the replica resume
command at a later time. The values are |
throttle | A Boolean value that specifies whether 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
|
Example
Register a table on the local cluster as a replica of another table on the local cluster:
- CLI
-
maprcli table replica add -path /volume1/custA -replica /volume2/custA
- REST
-
https://<host>:<port>/rest/table/replica/add?path=%2Fvolume1%2FcustA&replica=%2Fvolume2%2FcustA