表管理

ls

获取所有表的列表。

用法：

USAGE:  ls                       [-a|-all] [-d|--detailed] [-o|--output file_name]
                                 [-s|--status all|available|creating|dropping|dropped]

说明：

• -a选项：如果指定，则显示包括已被删除的所有表。
• -d选项：如果指定，则显示各个表的详细信息，主要是partition的健康状况。
• -o选项：如果指定，则将结果输出到参数所指定的文件中。
• -s选项：如果指定，则只显示符合参数所指定的状态的表。示例：

>>> ls -d -o ls.txt

app

获取某个表的基本信息。

用法：

USAGE:  app                      <app_name> [-d|--detailed] [-o|--output file_name]

说明：

• -d选项：如果指定，则显示各个表的详细信息，如partition的分布和健康状况。
• -o选项：如果指定，则将结果输出到参数所指定的文件中。示例：

>>> app temp

app_stat

获取表的读写和存储统计信息，如get、put、del等。

用法：

USAGE: app_stat                [-a|--app_name str] [-q|--only_qps] [-u|--only_usage]
                               [-o|--output file_name]

示例：

>>> app_stat temp

说明：

• -a选项：如果指定，则按照指定表的partition分类显示详细信息。
• -q选项：如果指定，则仅显示指定表的qps信息。
• -u选项：如果指定，则仅显示指定表的usage信息。
• -o选项：如果指定，则把结果输出到指定文件中。

app_disk

获取某个表的详细存储信息。

用法：

USAGE: app_disk                   <app_name> [-d|--detailed] [-o|--output file_name]

说明：

• -d选项：如果指定，则可以获取表的详细信息，如primary和second情况。
• -o选项：如果指定，则将结果输出到参数所指定的文件中。示例：

>>> app_disk temp

create

创建表

用法：

USAGE: create                    <app_name> [-p|--partition_count num] [-r|--replica_count num]
                                            [-e|--envs k1=v1,k2=v2...]

说明：

• -p选项：如果指定，则可以设置分片数，要求分片数是2的指数倍。
• -r选项：如果指定，则可以指定副本数，推荐副本数为3。
• -e选项：如果指定，则可是设置环境变量，参见Table环境变量。示例：

>>> create temp

drop

删除表

用法：

USAGE: drop                      <app_name> [-r|--reserve_seconds num]

说明：

• -r选项：如果指定，则设置数据的保留时间（删除时间开始计算，单位为秒）。如果不指定，则使用配置文件hold_seconds_for_dropped_app指定的值，默认为7天，参见使用drop命令删除表。示例：

>>> drop temp

recall

恢复已经删除的表

用法：

USAGE: recall                    <app_id> [new_app_name]

说明：

• 注意该命令通过app_id进行表恢复。
• new_app_name参数：如果不指定新表名，则会使用原表名，否则使用指定的新表名，如果原表名已存在（删表后新建了同名表），则必须指定另外一个不同的新表名，否则会失败。
• 详细信息参见使用recall命令恢复表。示例：

>>> recall 19

get_app_envs

获取表的环境变量，关于环境变量请参见Table环境变量。

用法：

USAGE: get_app_envs                      

说明：

• 该命令输出当前表的环境变量，使用前请首先使用use [app_name]选定特定表，参见get_app_envs。示例：

>>> use temp
>>> get_app_envs

set_app_envs

设置表的环境变量，关于环境变量请参见Table环境变量。

用法：

USAGE: set_app_envs              <key> <value> [key value...]        

说明：

• 该命令设置当前表的环境变量，使用前请首先使用use [app_name]选定特定表，参见set_app_envs。示例：

>>> use temp
>>> set_app_envs rocksdb.usage_scenario bulk_load

del_app_envs

删除表的环境变量，关于环境变量请参见Table环境变量。

用法：

USAGE: del_app_envs              <key> [key...]    

说明：

• 该命令删除当前表的环境变量，使用前请首先使用use [app_name]选定特定表，参见del_app_envs。示例：

>>> use temp
>>> del_app_envs rocksdb.usage_scenario

clear_app_envs

清理表的环境变量，关于环境变量请参见Table环境变量。

用法：

USAGE: clear_app_envs              [-a|--all] [-p|--prefix str]

说明：

• 该命令删除当前表的环境变量，使用前请首先使用use [app_name]选定特定表，参见clear_app_envs。
• -a选项：如果指定，则清理所有的环境变量。
• -p选项：如果指定，则可以清理以特定字符串为前缀的环境变量。示例：

>>> use temp
>>> clear_app_envs -p rocksdb