Repository: hbase Updated Branches: refs/heads/master 456e9fa7a -> 231bc9876
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/231bc987 Tree: http://git-wip-us.apache.org/repos/asf/hbase/tree/231bc987 Diff: http://git-wip-us.apache.org/repos/asf/hbase/diff/231bc987 Branch: refs/heads/master Commit: 231bc987611b4e2d9d7aa6e86a06891934b0e5b2 Parents: 456e9fa 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:02 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/231bc987/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:
