This is an automated email from the ASF dual-hosted git repository.
wchevreuil pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/hbase.git
The following commit(s) were added to refs/heads/master by this push:
new 25c639f9d6d HBASE-28251 [SFT] Add description for specifying SFT impl
during snapshot recovery (#5570)
25c639f9d6d is described below
commit 25c639f9d6deb52367089e2631004f4d6862daea
Author: Wellington Ramos Chevreuil <[email protected]>
AuthorDate: Mon Dec 11 10:17:33 2023 +0000
HBASE-28251 [SFT] Add description for specifying SFT impl during snapshot
recovery (#5570)
Signed-off-by: Duo Zhang <[email protected]>
Signed-off-by: Nihal Jain <[email protected]>
Signed-off-by: Peter Somogyi <[email protected]>
---
.../asciidoc/_chapters/bulk_data_generator_tool.adoc | 8 ++++----
src/main/asciidoc/_chapters/store_file_tracking.adoc | 19 +++++++++++++++++++
2 files changed, 23 insertions(+), 4 deletions(-)
diff --git a/src/main/asciidoc/_chapters/bulk_data_generator_tool.adoc
b/src/main/asciidoc/_chapters/bulk_data_generator_tool.adoc
index 3ac6ca69312..b04fcdeb726 100644
--- a/src/main/asciidoc/_chapters/bulk_data_generator_tool.adoc
+++ b/src/main/asciidoc/_chapters/bulk_data_generator_tool.adoc
@@ -18,8 +18,8 @@
* limitations under the License.
*/
////
-
-== Bulk Data Generator Tool
+[[BulkDataGeneratorTool]]
+= Bulk Data Generator Tool
:doctype: book
:numbered:
:toc: left
@@ -29,7 +29,7 @@
This is a random data generator tool for HBase tables leveraging Hbase bulk
load.
It can create pre-splited HBase table and the generated data is *uniformly
distributed* to all the regions of the table.
-=== How to Use
+== Usage
[source]
----
@@ -53,7 +53,7 @@ hbase
org.apache.hadoop.hbase.util.bulkdatagenerator.BulkDataGeneratorTool -t TE
hbase org.apache.hadoop.hbase.util.bulkdatagenerator.BulkDataGeneratorTool -t
TEST_TABLE -mc 10 -r 100 -sc 10 -Dmapreduce.map.memory.mb=8192
----
-=== How it Works
+== Overview
==== Table Schema
Tool generates a HBase table with single column family, i.e. *cf* and 9
columns i.e.
diff --git a/src/main/asciidoc/_chapters/store_file_tracking.adoc
b/src/main/asciidoc/_chapters/store_file_tracking.adoc
index 74d802f386c..b6c1f7e7339 100644
--- a/src/main/asciidoc/_chapters/store_file_tracking.adoc
+++ b/src/main/asciidoc/_chapters/store_file_tracking.adoc
@@ -143,3 +143,22 @@ example, that would be as follows:
----
alter 'my-table', CONFIGURATION => {'hbase.store.file-tracker.impl' => 'FILE'}
----
+
+### Specifying trackers during snapshot recovery
+
+It's also possible to specify a given store file tracking implementation when
recovering a snapshot
+using the _CLONE_SFT_ option of _clone_snasphot_ command. This is useful when
recovering old
+snapshots, taken prior to a change in the global configuration, or if the
snapshot has been
+imported from a different cluster that had a different store file tracking
setting.
+Because snapshots preserve table and colum family descriptors, a simple
restore would reload
+the original configuration, requiring the additional steps described above to
convert the
+table/column family to the desired tracker implementation.
+An example of how to use _clone_snapshot_ to specify the *FILE* tracker
implementation
+is shown below:
+
+----
+clone_snapshot 'snapshotName', 'namespace:tableName', {CLONE_SFT=>'FILE'}
+----
+
+NOTE: The option to specify the tracker during snapshot recovery is only
available for the
+_clone_snapshot_ command. The _restore_snapshot_ command does not support this
parameter.
