Repository: hbase Updated Branches: refs/heads/master d22a05084 -> d782ae820
HBASE-18718 Document the coprocessor.Export Project: http://git-wip-us.apache.org/repos/asf/hbase/repo Commit: http://git-wip-us.apache.org/repos/asf/hbase/commit/d782ae82 Tree: http://git-wip-us.apache.org/repos/asf/hbase/tree/d782ae82 Diff: http://git-wip-us.apache.org/repos/asf/hbase/diff/d782ae82 Branch: refs/heads/master Commit: d782ae820f7226d14757ba664da91e532babe309 Parents: d22a050 Author: Chia-Ping Tsai <[email protected]> Authored: Sat Sep 9 15:16:14 2017 +0800 Committer: Chia-Ping Tsai <[email protected]> Committed: Sat Sep 9 15:16:14 2017 +0800 ---------------------------------------------------------------------- src/main/asciidoc/_chapters/ops_mgt.adoc | 46 ++++++++++++++++++++++++++- 1 file changed, 45 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/hbase/blob/d782ae82/src/main/asciidoc/_chapters/ops_mgt.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/_chapters/ops_mgt.adoc b/src/main/asciidoc/_chapters/ops_mgt.adoc index 771e3be..4a9815c 100644 --- a/src/main/asciidoc/_chapters/ops_mgt.adoc +++ b/src/main/asciidoc/_chapters/ops_mgt.adoc @@ -444,12 +444,56 @@ See Jonathan Hsieh's link:https://blog.cloudera.com/blog/2012/06/online-hbase-ba === Export Export is a utility that will dump the contents of table to HDFS in a sequence file. -Invoke via: +The Export can be run via a Coprocessor Endpoint or MapReduce. Invoke via: +*mapreduce-based Export* ---- $ bin/hbase org.apache.hadoop.hbase.mapreduce.Export <tablename> <outputdir> [<versions> [<starttime> [<endtime>]]] ---- +*endpoint-based Export* +---- +$ bin/hbase org.apache.hadoop.hbase.coprocessor.Export <tablename> <outputdir> [<versions> [<starttime> [<endtime>]]] +---- + +*The Comparison of Endpoint-based Export And Mapreduce-based Export* +|=== +||Endpoint-based Export|Mapreduce-based Export + +|HBase version requirement +|2.0+ +|0.2.1+ + +|Maven dependency +|hbase-endpoint +|hbase-mapreduce (2.0+), hbase-server(prior to 2.0) + +|Requirement before dump +|mount the endpoint.Export on the target table +|deploy the MapReduce framework + +|Read latency +|low, directly read the data from region +|normal, traditional RPC scan + +|Read Scalability +|depend on number of regions +|depend on number of mappers (see TableInputFormatBase#getSplits) + +|Timeout +|operation timeout. configured by hbase.client.operation.timeout +|scan timeout. configured by hbase.client.scanner.timeout.period + +|Permission requirement +|READ, EXECUTE +|READ + +|Fault tolerance +|no +|depend on MapReduce +|=== + + NOTE: To see usage instructions, run the command with no options. Available options include specifying column families and applying filters during the export.
