git commit: HBASE-12049 Help for alter command is a bit confusing (Ashish Singhi)
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 mstanleyjo...@cloudera.com Authored: Wed Oct 1 16:23:48 2014 +1000 Committer: Misty Stanley-Jones mstanleyjo...@cloudera.com 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:
git commit: HBASE-12049 Help for alter command is a bit confusing (Ashish Singhi)
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 mstanleyjo...@cloudera.com Authored: Wed Oct 1 16:23:48 2014 +1000 Committer: Misty Stanley-Jones mstanleyjo...@cloudera.com 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: