table upstream add

Adds a binary table as upstream source for a replica.

Note: You do not need to use this command if you use the table replica autosetup command.

Syntax

CLI
maprcli table upstream add
  -path <table path>
  -upstream <upstream table path>
            
REST
http[s]://<host>:<port>/rest/table/upstream/add?path=<path>&upstream=<name>
Note: The 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 replica.

  • For a path to a table on the local cluster, start the path at the volume mount point. For example, for a table named testdst under volume1 which has a mount point at /volume1, specify the following path: /volume1/testdst
  • For a path to a table on a remote cluster, you must also specify the cluster name in the path. For example, for a table named customerdst under volume1 in the sanfrancisco cluster, specify the following path: /mapr/sanfrancisco/volume1/customerdst
upstream

The path to the source table.

  • For a path on the local cluster, start the path at the volume mount point. For example, for a table named testsrc under volume1 which has a mount point at /volume1, specify the following path: /volume1/testsrc
  • For a path on another cluster, you must also specify the cluster name in the path. For example, for a table named customersrc under volume1 in the sanfrancisco cluster, specify the following path: /mapr/sanfrancisco/volume1/customersrc

Example

Adds company1src as the upstream source for replica company1dst:

CLI
maprcli table upstream add -path /volume2/company1dst -upstream /volume1/company1src
REST
https://<host>:<port>/rest/table/upstream/add?path=%2Fvolume2%2Fcompany1dst&upstream=%2Fvolume1%2Fcompany1src