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

Last updated on Nov 13, 2025

Was this page helpful?