teracli使用说明

./teracli help即可看到相关的命令和使用方法

1. create 创建表格

1.1 基本命令

  1. ./teracli  create        <table-schema>  [<tablet-delimiter-file>]
  2. ./teracli  createbyfile  <schema-file>   [<tablet-delimiter-file>]

说明：

  • table-schema是一个描述表格结构的字符串。
  • 表名规范：首字符为字母（大小写均可），
  • 有效字符包括大小写的英文字母(a-zA-Z)、数字(0-9)、下划线(_)、连字符(-)、点(.)。 1 <= 有效长度 <=
  • 512
  • Tera支持在建立表格时预分配若干tablet，tablet分隔的key写在tablet-delimiter-file中，按“\n”分隔。
  • 如果表格schema比较复杂，可以将其写入文件中，通过createbyfile命令进行创建。

1.2 创建table模式存储

表格结构中包含表名、locality groups定义、column families定义，一个典型的表格定义如下（可写入文件）

  1. # tablet分裂阈值为4096M，合并阈值为512M
  2. # 三个lg，分别配置为flash、flash、磁盘存储
  3. table_hello <splitsize=4096, mergesize=512> {
  4.     lg_index <storage=flash, blocksize=4> {
  5.         update_flag <maxversions=1>
  6.     },
  7.     lg_props <storage=flash, blocksize=32> {
  8.         level,
  9.         weight
  10.     },
  11.     lg_raw <storage=disk, blocksize=128> {
  12.         data <maxversions=10>
  13.     }
  14. }

如果只希望简单的使用tera，对性能没有很高要求，那么schema只需指定表名和所需列名即可（如需要，所有的属性也是可配的）：

  1. table_hello {cf0, cf1, cf2}

1.3 创建key-value表

tera支持高性能的key-value存储，其schema只需指定表名即可，若需要指定存储介质等属性，可选择性添加：

  1.  # 表名为key-value，默认storage为disk, splitsize为512M, mergesize为0
  2. ./teracli  create kv_hello   
  3.  # 配置若干属性                                            
  4. ./teracli  create "kv_hello <storage=flash, splitsize=2048, mergesize=128>"

1.4 表格各级属性

span 属性名 意义 有效取值 单位 默认值 其它说明
table splitsize 某个tablet增大到此阈值时分裂为2个子tablets >=0，等于0时关闭split MB 512
table mergesize 某个tablet减小到此阈值时和相邻的1个tablet合并 >=0，等于0时关闭merge MB 0

splitsize至少要为mergesize的3倍,建议为mergesize的10倍，避免merge后又分裂 lg | storage | 存储类型 | “disk” / “flash” / “memory” | - | “disk” | lg | blocksize | LevelDB中block的大小 | >0 | KB | 4 | lg | use_memtable_on_leveldb | 是否启用内存compact | “true” / “false” | - | false | lg | sst_size | 第一层sst文件大小 | >0 | MB | 8 | cf | maxversions | 保存的最大版本数 | >0 | - | 1 | cf | ttl | 数据有效时间 | >=0，等于0时此数据永远有效 | second | 0 | 和minversions冲突时以minversions为准

2 update 更新表格schema

更新时使用schema语法和建表时的语法基本一致， 不同主要在于更新时只需指定要更新的属性，不需要改动的属性无需列出。

2.1 基本语法

  1. ./teracli update <tableschema>

2.2 分类

主要分为两大类更新：

  • 更新table模式schema
  • 更新kv模式schema

2.3 更新table模式schema

支持表格、cf属性热更新

2.3.1 更新table的属性（不更新lg、cf属性）
  1. ./teracli update "table_hello<mergesize=512>" //更新mergesize
  2. ./teracli update "table_hello<splitsize=1024,mergesize=128>" //更新mergesize和splitsize
2.3.2 更新lg属性时，需要disable表格
  1. ./teracli disable table_hello
  2. ./teracli update "table_hello{lg0<sst_size=9>}"
  3. ./teracli update "table_hello<splitsize=1536>{lg0<sst_size=9>}" //也可以同时修改table属性
2.3.3 更新cf属性
  1. ./teracli update "table_hello{lg0{cf0<ttl=999>}}"
  2. #也可以同时修改table或者lg属性
  3. ./teracli update "table_hello<splitsize=512>{lg0<sst_size=9>{cf0<ttl=999>}}"
2.3.4 增加、删除cf
  1. # 在lg0下增加cf1，并设置属性ttl值为123.
  2. # op意为操作，op=add需要放在cf属性的最前面
  3. ./teracli update "table_hello{lg0{cf1<op=add,ttl=123>}}"
  5. # 从lg0中删除cf1
  6. ./teracli update "table_hello{lg0{cf1<op=del>}}"

2.4 更新kv模式schema

  1. # 更新部分属性时需要disable表格，程序会在运行时给出提示
  2. ./teracli update "kv_hello<splitsize=1024>"

3. update-check

4. enable

将处于disable状态的表格重新enable，恢复读、写服务。

  1. ./teracli enable <tablename>

5. disable

将处于表格置于disable状态，不再提供读、写服务。

  1. ./teracli enable <tablename>

6. drop

删除处于disable状态的表格，此操作不可回滚。

  1. ./teracli drop <tablename>

7. rename 重命名表格

  1. #语法：
  2. ./teracli rename <old table_name> <new table_name>

示例：

  1. ./teracli rename tb1 tb2

8. put 向表中写入一个value

向表中写入以rowkey为key,列为columnfamily:qualifier的值value.对于kv模式的表来说，无需columnfamily:qualifier.

  1. #语法：
  2. ./teracli put <tablename> <rowkey> [<columnfamily:qualifier>] <value>

示例：

  1. ./teracli put mytable rowkey cf0:qu0 value

9. put-ttl 新增的ttl字段表示这个value的有效时间

  1. #语法：
  2. ./teracli put-ttl <tablename> <rowkey> [<columnfamily:qualifier>] <value> <ttl(second)>

示例：

  1. #这个value在20秒内有效，超时就读不到了。
  2. ./teracli put-ttl mytable rowkey cf0:qu0 value 20

10. putif 原子操作，如果不存在才能put成功

  1. #语法：
  2. ./teracli putif <tablename> <rowkey> [<columnfamily:qualifier>] <value>

11. get 读取一个value

  1. #语法：
  2. ./teracli get <tablename> <rowkey> [<columnfamily:qualifier>]

示例：

  1. #这个value在20秒内有效，超时就读不到了。
  2. ./teracli get mytable rowkey cf0:qu0

12. scan 扫描一个表

将表中key从[startkey, endkey)范围的所有数据扫描出来。 每个value可以有多个版本(versions)，scan命令默认只输出每个value的最新版本， 想要获取全部版本可以使用scanallv命令。

  1. #语法：
  2. ./teracli scan[allv] <tablename> <startkey> <endkey>

示例：

  1. #扫描整个表
  2. ./teracli scan mytable "" ""

13. delete 删除一个value

如果只想删除某列最新的一个版本可以用delete1v命令。

  1. #语法：
  2. ./teracli delete[1v] <tablename> <rowkey> [<columnfamily:qualifier>]

14. put_counter 写入一个counter（计数器）

  1. #语法：
  2. ./teracli put_counter <tablename> <rowkey> [<columnfamily:qualifier>] <integer(int64_t)>

示例：

  1. #写入一个初始值为3的计数器：
  2. ./teracli put_counter mytable rowkey cf0:qu0 3

15. get_counter 读取一个counter

  1. #语法：
  2. ./teracli get_counter <tablename> <rowkey> [<columnfamily:qualifier>]

示例：

  1. #读取之前写入的那个counter：
  2. ./teracli get_counter mytable rowkey cf0:qu0

16. add 给某个counter加上一个delta值

  1. #语法：
  2. ./teracli add <tablename> <rowkey> <columnfamily:qualifier> delta

示例：

  1. #读取之前写入的那个counter：
  2. ./teracli get_counter mytable rowkey cf0:qu0

17. putint64 写入一个int64类型counter（计数器）

  1. #语法：
  2. ./teracli putint64 <tablename> <rowkey> [<columnfamily:qualifier>] <integer(int64_t)>

示例：

  1. #写入一个初始值为67的计数器：
  2. ./teracli putint64 mytable row1 cf0:qu0 67

18. getint64 读取一个int64类型的counter

  1. #语法：
  2. ./teracli getint64 <tablename> <rowkey> [<columnfamily:qualifier>]

示例：

  1. ./teracli getint64 mytable row1 cf0:qu0

19. addint64 对int64类型的counter执行原子加操作

  1. #语法：
  2. ./teracli addint64 <tablename> <rowkey> <columnfamily:qualifier>  delta

示例：

  1. #对之前写入的counter执行-3的操作：
  2. # addint64操作执行完以后，该counter的值为 64
  3. ./teracli addint64 mytable row1 cf0:qu0 -3

20. append 原子操作：追加内容到一个Cell

  1. #语法：
  2. ./teracli append <tablename> <rowkey> [<columnfamily:qualifier>] <value>

示例：

  1. ./teracli put mytalbe rowkey cf0:qu0 hello
  2. ./teracli append mytable rowkey cf0:qu0 world
  3. #此时再去get会得到helloworld
  4. ./teracli get mytable rowkey cf0:qu0

20. batchput 批量写数据

  1. #语法：
  2. ./teracli batchput <tablename> <input file>

21. batchget 批量读数据

  1. #语法：
  2. ./teracli batchget <tablename> <input file>

22. show 显示表格信息

  1. #语法：
  2. ./teracli show[x]  [<tablename>]

示例：

  1. #查看某个table的信息：
  2. ./teracli show mytable
  3. #查看集群内所有table的信息：
  4. ./teracli show

23. showx 显示表格详细信息

  1. #语法：
  2. ./teracli show[x]  [<tablename>]

示例：

  1. #查看某个table的信息：
  2. ./teracli showx mytable

24. showschema 显示表格schema

表格schema里含有很多属性（例如某个cf保留的最小版本数），创建表格时，没有显示指定的属性都取默认值， 这些属性在showschema时不会显示出来；想要显示全部属性，可以使用showschemax命令。

  1. #语法：
  2. ./teracli showschema[x] <tablename>

25. showts 显示tabletnode的信息

带上后缀’x’得到的信息会更详细（showtsx）。

  1. #语法：
  2. ./teracli showts [<tabletnode_addr>]

示例：

  1. #显示某个tabletnode的信息：
  2. ./teracli showts "example.company.com:7770"
  3. #显示集群内所有tabletnode的信息:
  4. ./teracli showts

26. range 显示表的范围

  1. #语法：
  2. ./teracli range <tablename>

27. txn 事务（仅支持单事务行操作）

  1. #语法：
  2. ./teracli txn <operation> <params>
  3. operation包括start和commit
  4. ./teracli txn start <tablename> <row_key>
  5. ./teracli txn commit

28. user用户管理

  1. #语法：
  2. ./teracli user <operation> <params>
  3. operation包括create、changepwd、show、delete、addtogroup和deletefromgroup
  4. user <operation> <params>
  5.           create          <username> <password>
  6.           changepwd       <username> <new-password>
  7.           show            <username>
  8.           delete          <username>
  9.           addtogroup      <username> <groupname>
  10.           deletefromgroup <username> <groupname>

29. tablet

  1. #语法：
  2. ./teracli tablet <operation> <params>
  3. operation包括move、reload、compact、split、merge和scan
  4. tablet <operation> <params>
  5.             move    <tablet_path> <target_addr>
  6.             reload  <tablet_path>
  7.                     force to unload and load on the same ts
  8.             compact <tablet_path>
  9.             split   <tablet_path>
  10.             merge   <tablet_path>
  11.             scan    <tablet_path>

30. compact

  1. #语法：
  2. ./teracli compact <tablename>

31. safemode

  1. #语法：
  2. ./teracli safemode [get|enter|leave]

32. meta

meta for master memory, meta2 for meta table.

  1. #语法：
  2. ./teracli meta[2] [backup|check|repair|show]

33. findmaster master的位置

  1. #语法：
  2. ./teracli findmaster

34. reload

  1. #语法：
  2. ./teracli reload config hostname:port

35. kick

  1. #语法：
  2. ./teracli kick <tablename>

36. findtablet

  1. #语法：
  2. ./teracli findtablet <tablename> <rowkey-prefix>
  3. ./teracli findtablet <tablename> <start-key> <end-key>

37. cookie

  1. #语法：
  2. ./teracli  cookie <command> <args>
  3. cookie <command> <args>
  4.             dump     cookie-file     -- dump contents of specified files
  5.             findkey  cookie-file key -- find the info of a key

38. version版本

  1. #语法：
  2. ./teracli version