table replica autosetup
Sets up and starts replication between a source binary table and replica binary table.
The maprcli table replica autosetup
command performs the following
steps to set up replication:
- Creates a table with the required column families in the destination cluster.
- Declares the new table to be a replica of the source table and ensures that replication does not begin immediately after the next step.
- Declares the source table as an upstream source for the replica.
- Runs the
CopyTable
utility to load a copy of the source data into the replica. - Clears the paused replication state to start the replication stream.
Required Permissions
The user that runs the command must have the following permissions for the replica:
- Write permission on the directory where you want to create the replica
The user that runs the command must have the following permissions on the source table:
- ACE permissions to perform column-family and column reads (readperm).
- ACE permissions to perform replication (replperm)
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.Syntax
- CLI
-
maprcli table replica autosetup -path table path -replica replica table path [ -columns comma separated list of <family>[:<column>] ] [ -synchronous is synchronous replication. default: false ] [ -multimaster is multi master replication. default: false ] [ -throttle throttle replication ops. default: false ] [ -networkencryption enable on-wire encryption. default: false ] [ -networkcompression on-wire compression type: off|on|lzf|lz4|zlib. default: on ]
- REST
-
http[s]://<host>:<port>/rest/table/replica/autosetup?path=<path>&replica=<path>...
Parameters
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 replica path
you specify points to table that already exists.
|
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
NOTE: While the column families that you specify must already exist in the
source table, the columns that you specify do not have to exist in the
destination table for replication to succeed. If the column is added at a
later date, replication for that column will start at that time.
|
synchronous | A Boolean value that specifies whether replication is synchronous or
asynchronous. The values are true or
false. Asynchronous (false ) is the
default. |
multimaster | A Boolean value that specifies whether or not to set up a multi-master
topology. The values are true or false.
Basic master-slave topology (false ) is the default. |
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. |
networkcompression |
The type of on-wire compression. The types are:
lz4 is the default compression which it set by parameter values |
Example
- CLI
-
maprcli table replica autosetup -path /volume1/custBsrc -replica /volume2/custBdst
- REST
-
https://<host>:<port>/rest/table/replica/autosetup?path=%2Fvolume2%2FcustAsrc&replica=%2Fvolume2%2FcustBdst