HBase shell commands | Arenadata Docs

These commands are intended for experts only. They help to perform operations with Regions, such as: split, merge, compaction, etc. Use them carefully.

assign

Assigns a Region

unassign

Unassigns a Region

close_region

Deprecated. Use unassign instead

compact

Runs compaction for the defined table/Region/column family

compact_rs

Compacts all Regions within the defined Region Server

major_compact

Runs Major compaction for the defined table/Region/column family

compaction_state

Gets the table compaction status

splitormerge_enabled

Checks whether split or merge operations are enabled

splitormerge_switch

Enables/disables split or merge operations

merge_region

Merges two Regions

split

Splits the entire table or the specified Region

move

Moves a Region

flush

Flushes all Regions for the table/Region Server or all Regions with the specified name

wal_roll

Rolls the WAL writer

list_deadservers

Lists all dead Region Servers

clear_deadservers

Clears all/specified dead Region Servers

clear_block_cache

Clears blocks of the specified table from BlockCache

clear_compaction_queues

Clears compaction queues at the Region Server

balance_switch

Enables/disables the cluster Balancer

balancer_enabled

Checks the Balancer state

balancer

Triggers the cluster Balancer

catalogjanitor_switch

Enables/disables the CatalogJanitor

catalogjanitor_enabled

Checks the CatalogJanitor state

catalogjanitor_run

Runs the CatalogJanitor

cleaner_chore_switch

Enables/disables the Cleaner chore

cleaner_chore_enabled

Checks the Cleaner chore state

cleaner_chore_run

Runs the Cleaner chore

normalizer_switch

Enables/disables the Region Normalizer

normalizer_enabled

Checks the Region Normalizer state

normalize

Runs the Region Normalizer

is_in_maintenance_mode

Checks whether the Master is in maintenance mode

zk_dump

Shows the dump status of the HBase cluster, as seen by ZooKeeper

trace

Starts/stops/checks tracing via HTrace

Replication commands

These commands are used for configuring replication.

add_peer

Adds a replication relationship (peer)

append_peer_namespaces

Appends replicable namespaces to the replication peer

append_peer_tableCFs

Appends replicable tables/column families to the replication peer

set_peer_namespaces

Sets all replicable namespaces for the replication peer

set_peer_tableCFs

Sets all replicable tables/column families for the replication peer

set_peer_bandwidth

Sets the source bandwidth for the replication peer (per Region Server)

set_peer_replicate_all

Sets the REPLICATE_ALL flag for the replication peer

set_peer_exclude_namespaces

Sets not replicable namespaces for the replication peer

set_peer_exclude_tableCFs

Sets not replicable tables/column families for the replication peer

disable_table_replication

Disables replication for all column families of the table

enable_table_replication

Enables replication for all column families of the table

disable_peer

Disables a replication peer

enable_peer

Enables the previously disabled replication peer

get_peer_config

Lists configuration parameters of the replication peer

update_peer_config

Updates configuration parameters of the replication peer

list_peer_configs

Lists configuration parameters of all replication peers

list_peers

Lists all replication peers

list_replicated_tables

Lists all tables and column families replicated from the cluster

show_peer_tableCFs

Shows replicable tables/column families for the replication peer

remove_peer_namespaces

Removes namespaces from the replication peer configuration

remove_peer_tableCFs

Removes tables/column families from the replication peer configuration

remove_peer

Disables and removes a replication peer

Snapshots commands

These commands allow to work with table snapshots.

snapshot

Takes a snapshot of the specified table

list_snapshots

Returns a list of snapshots — all or matching the given regex

list_table_snapshots

Returns snapshots of the specified table

restore_snapshot

Restores the specified snapshot

clone_snapshot

Creates a new table by cloning the specified snapshot

delete_snapshot

Deletes a snapshot with the specified name

delete_all_snapshot

Deletes all snapshots with the name matching the given regex

delete_table_snapshots

Deletes snapshots of the specified table

Configuration commands

These commands are used to reload configuration parameters without restarting a cluster.

The set of configuration parameters that can be currently changed by this command is limited. See more details in the HBase documentation.

update_all_config

Reloads a subset of configuration parameters on all cluster servers

update_config

Reloads a subset of configuration parameters on the specified cluster servers

Quotas commands

These commands are used to work with quotas — resource and other restrictions applied to database objects.

Before using the commands from this group, add the following property to hbase-site.xml and restart your cluster.

Configuration

<property>
   <name>hbase.quota.enabled</name>
   <value>true</value>
</property>

set_quota

Sets a new quota for the defined user/table/namespace

list_quotas

Returns quotas added to HBase — all or matching the given regex

list_quota_table_sizes

Returns the computed size of each table in the cluster

list_quota_snapshots

Returns information about tables with defined space quotas

list_snapshot_sizes

Returns the size of snapshots made for tables with defined space quotas

Security commands

These commands are useful for security configuring needs.

Before using the commands from this group, add the following properties to hbase-site.xml and restart your cluster. If properties hbase.coprocessor.master.classes or hbase.coprocessor.region.classes already have another values, use comma-separated lists for keeping several values for them.

Configuration

<property>
   <name>hbase.coprocessor.master.classes</name>
   <value>org.apache.hadoop.hbase.security.access.AccessController</value>
</property>
<property>
   <name>hbase.coprocessor.region.classes</name>
   <value>org.apache.hadoop.hbase.security.access.AccessController</value>
</property>
<property>
   <name>hbase.rpc.engine</name>
   <value>org.apache.hadoop.hbase.ipc.SecureRpcEngine</value>
</property>
<property>
   <name>hbase.security.authorization</name>
   <value>true</value>
</property>

grant

Grants a user the specific rights

list_security_capabilities

Returns supported security capabilities

revoke

Revokes a user access rights

user_permission

Returns permissions for the specified user

Procedures commands

These commands are used to work with HBase procedures.

list_procedures

Returns all the procedures in HBase

abort_procedure

Aborts running of the procedure with the specified ID

list_locks

Returns all the locks in HBase

Visibility labels commands

These commands are used to control visibility labels, which permit users, associated with the given label, to read or access cells with that label.

Before using the commands from this group, add the following properties to hbase-site.xml and restart your cluster. If properties hbase.coprocessor.master.classes or hbase.coprocessor.region.classes already have another values, use comma-separated lists for keeping several values for them.

Configuration

<property>
   <name>hbase.coprocessor.master.classes</name>
   <value>org.apache.hadoop.hbase.security.visibility.VisibilityController</value>
</property>
<property>
   <name>hbase.coprocessor.region.classes</name>
   <value>org.apache.hadoop.hbase.security.visibility.VisibilityController</value>
</property>
<property>
   <name>hbase.security.authorization</name>
   <value>true</value>
</property>
<property>
   <name>hfile.format.version</name>
   <value>3</value>
</property>

add_labels

Adds a set of visibility labels

list_labels

Returns a list of available visibility labels

set_auths

Assigns a set of visibility labels to the defined user or group

get_auths

Gets visibility labels assigned to the defined user or group

clear_auths

Clears visibility labels assigned to the defined user or group

set_visibility

Sets the visibility expression on one or more existing table cells

Rsgroup commands

These commands allow to manage Region Server groups — logical unions of Region Servers. Each group can mount different tables, if necessary. Thus, each group is equivalent to a logical subcluster. It helps to achieve resource isolation and to reduce management costs. The default Region Server group is called default.

Before using the commands from this group, add the following properties to hbase-site.xml and restart your cluster. If properties hbase.coprocessor.master.classes or hbase.coprocessor.region.classes already have another values, use comma-separated lists for keeping several values for them.

Configuration

<property>
   <name>hbase.coprocessor.master.classes</name>
   <value>org.apache.hadoop.hbase.rsgroup.RSGroupAdminEndpoint</value>
</property>
<property>
   <name>hbase.master.loadbalancer.class</name>
   <value>org.apache.hadoop.hbase.rsgroup.RSGroupBasedLoadBalancer</value>
</property>