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
curl -X POST 
  'http[s]://<host>:<port>/rest/table/upstream/add?path=<path>&upstream=<name>' 
  -u <username>:<password>
NOTE
The mapr user is not treated as a superuser. HPE Ezmeral Data Fabric Database 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
curl -k -X POST \
  'https://r1n1.sj.us:8443/rest/table/upstream/add?path=%2Fvolume2%2Fcompany1dst&upstream=%2Fvolume1%2Fcompany1src' \
  -u mapr:mapr