extraRegionsInMeta (Hbck2)
Reports regions that exist in hbase:meta but do not have corresponding region directories on the filesystem. The hbase:meta table must be online for this command to run.
Command Syntax
hbase hbck -j <path-to-hbck2-jar> extraRegionsInMeta [<NAMESPACE | NAMESPACE:TABLENAME>... | -i <INPUT_FILE>...]
Options
Option | Description |
-f, --fix | Removes all extra regions found in hbase:meta. |
-i, --inputFiles <file1> [<file2>...] | Specifies one or more files containing namespaces or table names, one per line. |
Description
For each specified namespace or table, this command compares the regions recorded in hbase:meta with the region directories present on the filesystem.
A region is reported as extra when:
- It exists in hbase:meta, and
- No matching region directory exists on the filesystem.
If you specify the --fix option, all such extra regions will be removed from hbase:meta.
Important Considerations
- Before running --fix, verify whether the reported extra regions overlap with existing valid regions.
- If an overlap exists, using extraRegionsInMeta --fix is typically the safest and most effective option.
- If the extra regions do not overlap, the assigns command may be a simpler alternative because it can recreate missing region directories when needed.
Examples
- Report extra regions for table_1 and table_2 in the default namespace:
hbase hbck -j <path-to-hbck2-jar> extraRegionsInMeta default:table_1 default:table_2
- Report extra regions for table_1 in the default namespace and all tables in namespace ns1:
hbase hbck -j <path-to-hbck2-jar> extraRegionsInMeta default:table_1 ns1
- Fix (remove) extra regions for tables listed in fileName1 and fileName2:
hbase hbck -j <path-to-hbck2-jar> extraRegionsInMeta --fix -i fileName1 fileName2