filesystem (Hbck2)

Reports on the health and integrity of HFiles, references, and links within the HBase filesystem.

Command Syntax

Bash
    
 
hbase hbck -j <path-to-hbck2-jar> filesystem [OPTIONS] [<TABLENAME>... | -i <INPUT_FILE>...]
Copy

Options

Option	Description
`-f`, `--fix`	Moves corrupt HFiles, invalid references, and bad links to a sideline directory.
`-i`, `--inputFiles <file1> [<file2>...]`	Specifies one or more files containing table names, one per line.

Description

This command checks the HBase data directories on HDFS and reports issues such as:

Corrupt or unreadable HFiles
Broken or invalid internal references
Bad links
General data integrity problems in the filesystem

If you specify the --fix option, all problematic files and links are moved to a sideline directory so they no longer interfere with normal HBase operations.

The --fix option does not repair structural integrity issues such as:

Missing regions (“holes”)
Orphan regions (regions present on disk but not linked properly)

You can provide one or more table names to limit the scope of the check. If no tables are specified, the command scans all tables and also restores the hbase.version file if it is missing.

This command interacts only with the filesystem. Any regions whose files are modified by --fix must be reopened to pick up the changes.

Examples

Report filesystem issues for all tables:

Bash
    
 
hbase hbck -j <path-to-hbck2-jar> filesystem
Copy

Fix filesystem issues for mytable:

Bash
    
 
hbase hbck -j <path-to-hbck2-jar> filesystem --fix mytable
Copy

Report filesystem issues for tables listed in fileName1:

Bash
    
 
hbase hbck -j <path-to-hbck2-jar> filesystem -i fileName1
Copy

Last updated on Nov 13, 2025

Was this page helpful?