HBase修改表 #

修改表流程
├── 1. 禁用表（部分操作需要）
├── 2. 执行修改操作
├── 3. 重新启用表
└── 4. 验证修改结果

需要禁用表的操作
├── 添加列族
├── 删除列族
├── 修改列族属性
└── 修改表属性

不需要禁用的操作
└── 无（HBase 2.x后部分操作可在线执行）

# 禁用表
disable 'user'

# 检查是否禁用
is_disabled 'user'

# 禁用多个表
disable_all 'user.*'

# 启用表
enable 'user'

# 检查是否启用
is_enabled 'user'

# 启用多个表
enable_all 'user.*'

# 查看表状态
describe 'user'

# 输出包含状态信息
# Table user is ENABLED
# 或
# Table user is DISABLED

# 基本语法
alter '表名', NAME => '新列族名'

# 带属性添加
alter '表名', NAME => '新列族名', VERSIONS => 3

# 禁用表
disable 'user'

# 添加列族
alter 'user', NAME => 'address'

# 添加带属性的列族
alter 'user', NAME => 'history', VERSIONS => 10, TTL => 2592000

# 启用表
enable 'user'

# 验证
describe 'user'

注意事项
├── 表必须先禁用（HBase 1.x）
├── HBase 2.x支持在线添加
├── 新列族初始为空
└── 添加后可立即使用

# 语法
alter '表名', NAME => '列族名', METHOD => 'delete'

# 或使用简化语法
alter '表名', 'delete' => '列族名'

# 禁用表
disable 'user'

# 删除列族
alter 'user', NAME => 'address', METHOD => 'delete'

# 或简化写法
alter 'user', 'delete' => 'address'

# 启用表
enable 'user'

# 验证
describe 'user'

注意事项
├── 表必须先禁用
├── 删除列族会删除所有数据
├── 操作不可逆
├── 不能删除最后一个列族
└── 删除后空间不会立即释放（需Major Compaction）

# 语法
alter '表名', NAME => '列族名', 属性名 => 新值

# 示例：修改版本数
alter 'user', NAME => 'info', VERSIONS => 5

# 禁用表
disable 'user'

# 修改版本数
alter 'user', NAME => 'info', VERSIONS => 5

# 启用表
enable 'user'

# 验证
describe 'user'

# 修改TTL为30天
alter 'user', NAME => 'history', TTL => 2592000

# 修改TTL为永不过期
alter 'user', NAME => 'history', TTL => FOREVER

# 修改压缩算法
alter 'user', NAME => 'info', COMPRESSION => 'SNAPPY'

# 注意：需要执行Major Compaction使压缩生效
major_compact 'user'

# 修改布隆过滤器类型
alter 'user', NAME => 'info', BLOOMFILTER => 'ROWCOL'

# 修改HFile块大小
alter 'user', NAME => 'info', BLOCKSIZE => 131072  # 128KB

# 禁用块缓存
alter 'user', NAME => 'info', BLOCKCACHE => false

# 启用块缓存
alter 'user', NAME => 'info', BLOCKCACHE => true

# 设置常驻内存
alter 'user', NAME => 'info', IN_MEMORY => true

# 取消常驻内存
alter 'user', NAME => 'info', IN_MEMORY => false

# 修改Region最大大小为20GB
alter 'user', MAX_FILESIZE => '21474836480'

# 查看当前设置
describe 'user'

# 设置为只读
alter 'user', READONLY => true

# 取消只读
alter 'user', READONLY => false

# 设置Region副本数
alter 'user', REGION_REPLICATION => 2

# 修改表级配置
alter 'user', CONFIGURATION => {'hbase.hregion.max.filesize' => '21474836480'}

# 禁用表
disable 'user'

# 同时修改多个列族属性
alter 'user',
    {NAME => 'info', VERSIONS => 5, COMPRESSION => 'SNAPPY'},
    {NAME => 'history', VERSIONS => 10, TTL => 2592000}

# 启用表
enable 'user'

# 修改多个列族的压缩算法
alter 'user',
    {NAME => 'info', COMPRESSION => 'SNAPPY'},
    {NAME => 'history', COMPRESSION => 'SNAPPY'},
    {NAME => 'settings', COMPRESSION => 'SNAPPY'}

# 原始表结构
# create 'user', 'info'

# 禁用表
disable 'user'

# 添加新列族
alter 'user', NAME => 'settings'
alter 'user', NAME => 'history', VERSIONS => 10

# 修改info列族属性
alter 'user', NAME => 'info', VERSIONS => 3, COMPRESSION => 'SNAPPY'

# 启用表
enable 'user'

# 验证
describe 'user'

# 原始表结构
# create 'log', 'data'

# 禁用表
disable 'log'

# 修改TTL为7天
alter 'log', NAME => 'data', TTL => 604800

# 添加压缩
alter 'log', NAME => 'data', COMPRESSION => 'SNAPPY'

# 启用表
enable 'log'

# 执行Major Compaction使压缩生效
major_compact 'log'

# 原始表结构
# create 'order', 'detail'

# 禁用表
disable 'order'

# 添加商品列族
alter 'order', NAME => 'items', COMPRESSION => 'SNAPPY'

# 修改detail列族
alter 'order', NAME => 'detail', VERSIONS => 1, BLOOMFILTER => 'ROW'

# 启用表
enable 'order'

# 查看表结构
describe 'user'

# 输出示例
Table user is ENABLED
user, {TABLE_ATTRIBUTES => {MAX_FILESIZE => '10737418240', ...}
COLUMN FAMILIES DESCRIPTION
{NAME => 'history', BLOOMFILTER => 'ROW', VERSIONS => '10', ...}
{NAME => 'info', BLOOMFILTER => 'ROW', VERSIONS => '3', ...}
{NAME => 'settings', BLOOMFILTER => 'ROW', VERSIONS => '1', ...}

# 查看表结构中的列族信息
describe 'user'

# 关注输出中的 COLUMN FAMILIES DESCRIPTION 部分

# 测试版本数修改
put 'user', 'test', 'info:name', 'value1'
put 'user', 'test', 'info:name', 'value2'
put 'user', 'test', 'info:name', 'value3'
put 'user', 'test', 'info:name', 'value4'
put 'user', 'test', 'info:name', 'value5'

# 查询所有版本（应该返回5个版本）
get 'user', 'test', {COLUMN => 'info:name', VERSIONS => 10}

# 错误：Table is enabled
# 解决：先禁用表

disable 'user'
alter 'user', NAME => 'info', VERSIONS => 5
enable 'user'

# 错误：Column family does not exist
# 解决：检查列族名称

describe 'user'  # 查看现有列族

# 错误：Cannot remove last column family
# 解决：至少保留一个列族

# 如果需要清空表结构，建议删除表重建
disable 'user'
drop 'user'
create 'user', 'new_cf'

# 问题：修改压缩算法后，旧数据未压缩
# 解决：执行Major Compaction

major_compact 'user'

# 修改前建议备份表结构
describe 'user'

# 或导出表结构
echo "describe 'user'" | hbase shell > user_schema.txt

修改建议
├── 在业务低峰期执行修改
├── Major Compaction消耗资源，避免高峰执行
└── 大表修改需评估影响

验证步骤
├── 修改后在测试环境验证
├── 检查表结构是否正确
├── 测试读写功能
└── 监控性能指标