Repository: hbase Updated Branches: refs/heads/branch-1 3a4be7f2a -> 50a301925
HBASE-12049 Help for alter command is a bit confusing (Ashish Singhi) Project: http://git-wip-us.apache.org/repos/asf/hbase/repo Commit: http://git-wip-us.apache.org/repos/asf/hbase/commit/50a30192 Tree: http://git-wip-us.apache.org/repos/asf/hbase/tree/50a30192 Diff: http://git-wip-us.apache.org/repos/asf/hbase/diff/50a30192 Branch: refs/heads/branch-1 Commit: 50a3019255a6b019ae864b549d047f819cec0ef9 Parents: 3a4be7f Author: Misty Stanley-Jones <[email protected]> Authored: Wed Oct 1 16:23:48 2014 +1000 Committer: Misty Stanley-Jones <[email protected]> Committed: Wed Oct 1 16:24:30 2014 +1000 ---------------------------------------------------------------------- hbase-shell/src/main/ruby/shell/commands/alter.rb | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/hbase/blob/50a30192/hbase-shell/src/main/ruby/shell/commands/alter.rb ---------------------------------------------------------------------- diff --git a/hbase-shell/src/main/ruby/shell/commands/alter.rb b/hbase-shell/src/main/ruby/shell/commands/alter.rb index 7ef185f..18cafa8 100644 --- a/hbase-shell/src/main/ruby/shell/commands/alter.rb +++ b/hbase-shell/src/main/ruby/shell/commands/alter.rb @@ -22,12 +22,17 @@ module Shell class Alter < Command def help return <<-EOF -Alter a table. Depending on the HBase setting ("hbase.online.schema.update.enable"), -the table must be disabled or not to be altered (see help 'disable'). -You can add/modify/delete column families, as well as change table -configuration. Column families work similarly to create; column family -spec can either be a name string, or a dictionary with NAME attribute. -Dictionaries are described on the main help command output. +Alter a table. If the "hbase.online.schema.update.enable" property is set to +false, then the table must be disabled (see help 'disable'). If the +"hbase.online.schema.update.enable" property is set to true, tables can be +altered without disabling them first. Altering enabled tables has caused problems +in the past, so use caution and test it before using in production. + +You can use the alter command to add, +modify or delete column families or change table configuration options. +Column families work in a similar way as the 'create' command. The column family +specification can either be a name string, or a dictionary with the NAME attribute. +Dictionaries are described in the output of the 'help' command, with no arguments. For example, to change or add the 'f1' column family in table 't1' from current value to keep a maximum of 5 cell VERSIONS, do:
