通过lindorm-cli（HBase模式）访问宽表引擎

数据定义语言（DDL）

• list：展示所有表，可选正则表达式过滤表名。

• create：创建表（至少指定一个列族）。

• describe（别名desc）：展示指定表的详细信息，包括表属性、列族结构等。

• exists：验证表是否存在。

• disable：禁用表（使表离线，无法读写）。

• enable：启用表（使表重新上线）。

• alter：修改表或列族属性。

• drop：删除指定表（需先disable）。

数据操作语言（DML）

• put：写入或更新特定单元格中的值。

• get：获取指定行或单元格的内容。

• delete：删除表中单元格的值（单个版本）。

• deleteall：删除指定行、列族或列的所有单元格。

• scan：扫描并返回表数据。

• count：计算并返回表中的行数。

Namespace命令

• create_namespace：创建命名空间。

• list_namespace：列出所有命名空间。

• drop_namespace：删除命名空间（同时删除其下所有表）。

建表并插入数据

1. 创建表。创建时必须输入表和列族的名称。

   # 创建一个名称为 test、列族名为 cf 的表
   create 'test', 'cf'

   也可以在建表时以Hash形式为列族指定属性（如版本数VERSIONS）：

   create 'test', {NAME => 'cf', VERSIONS => 3}

2. 插入数据。

   put 'test', 'row1', 'cf:a', 'value1'
   put 'test', 'row2', 'cf:b', 'value2'
   put 'test', 'row3', 'cf:c', 'value3'

   其中row1为表test的Rowkey，cf:a表示列族名与列名，value1为值。put还可携带可选的时间戳（版本号），例如put 'test','row1','cf:a','value2', 1735689600000。

查询

• 查询所有表的信息。支持使用正则表达式过滤表名。

  list
  list 'test'
  list 't.*'

• 查询指定表的数据（scan）。scan可用于扫描全表或查询固定范围的数据。

  scan 'test'

  在默认（table）格式下，返回采用HBase原生风格（ROW / COLUMN+CELL两列）：

  ROW                     COLUMN+CELL
  row1                    column=cf:a, timestamp=1735689600000, value=value1
  row2                    column=cf:b, timestamp=1735689600000, value=value2
  row3                    column=cf:c, timestamp=1735689600000, value=value3
  3 row(s) in 0.0230 seconds

  scan支持以Hash形式指定扫描属性，例如起止行键、限制行数与过滤器：

  scan 'test', {STARTROW => 'row1', STOPROW => 'row3', LIMIT => 100}
  scan 'test', {FILTER => "PrefixFilter('row')"}

• 查询表的单条数据（get）。

  get 'test', 'row1'

  在默认（table）格式下，返回COLUMN / CELL两列：

  COLUMN                  CELL
  cf:a                    timestamp=1735689600000, value=value1
  1 row(s) in 0.0350 seconds

  可携带Hash属性只读取指定列：get 'test', 'row1', {COLUMN => 'cf:a'}。

• 统计行数（count）。

  count 'test'

  说明

  get / scan在-format json下，每个单元格渲染为一行，固定字段为row_key / column_family / qualifier / timestamp / value，便于程序解析。行数限制可通过-max-rows控制（对scan有效）。

查看表结构（describe）

describe 'test'

在默认（table）格式下，describe按列族聚合为HBase原生风格输出。

禁用和启用表

如果要对一张表执行删除、修改设置或其他操作，请先使用disable命令禁用这张表；完成后再使用enable命令重新启用。

disable 'test'
enable 'test'

删除表

删除指定表（需先禁用）：

disable 'test'
drop 'test'

常用配置参考

可通过alter命令为表或列族调整常用配置。

# 为列族设置数据压缩算法
alter 'test', {NAME => 'cf', COMPRESSION => 'ZSTD'}

# 为列族设置版本数
alter 'test', {NAME => 'cf', VERSIONS => 5}

# 为列族设置数据有效期TTL（单位秒，2592000 秒 = 30 天）
alter 'test', {NAME => 'cf', TTL => 2592000}

修改后可通过describe 'test'验证是否生效。