功能目标

为了对Table的一些行为进行控制，Pegasus提供了Table环境变量，又称之为app envs。

Table环境变量以kv-map的形式存储在Table的元数据app_info中，并持久化到Zookeeper上。通过shell的ls命令查看表信息，最后一列envs_count记录Table环境变量的kv对个数：

>>> ls
app_id    status              app_name            app_type            partition_count     replica_count       is_stateful         drop_expire_time    envs_count          
1         AVAILABLE           temp                pegasus             8                   3                   true                -                   1     

如果要查看具体的Table环境变量，则需要使用get_app_envs命令。

Table环境变量具有如下特性：

• 作为Table的元数据持久化到Zookeeper上。
• 可以通过命令动态修改，修改成功后会立即更新到Zookeeper上。
• 通过meta server和replica server的定期同步消息config_sync同步给各个replica生效。由于是定期同步，所以环境变量更新后不会立即生效，而是有一个同步过程，这个过程的时间依赖于配置文件config_sync_interval_ms的值，默认是30秒。

• 环境变量的key通过都是采用.分隔的字段的形式，方便组织。 目前通过Table环境变量支持的功能包括：

• Manual-Compact功能

• Usage-Scenario功能

操作命令

Pegasus的Shell工具中提供了操作Table环境变量的命令。这些命令执行前都需要先执行use xxx选择表。

get_app_envs

获取环境变量列表，用法：get_app_envs

示例：

>>> use temp
OK
>>> get_app_envs
get app envs succeed, count = 1
=================================
rocksdb.usage_scenario = normal
=================================

set_app_envs

设置环境变量，用法：set_app_envs <key> <value> [key value…]

示例：

>>> use temp
OK
>>> set_app_envs rocksdb.usage_scenario bulk_load
set app envs succeed
>>> get_app_envs
get app envs succeed, count = 1
=================================
rocksdb.usage_scenario = bulk_load
=================================

del_app_envs

删除环境变量，用法：del_app_envs <key> [key…]

示例：

>>> use temp
OK
>>> del_app_envs rocksdb.usage_scenario
del app envs succeed
=============================
deleted keys:
    rocksdb.usage_scenario
=============================
>>> get_app_envs
get app envs succeed, count = 0

clear_app_envs

清理环境变量，或者叫批量删除环境变量，用法：clear_app_envs <-a|—all> <-p|—prefix str>

两种方式：

• 全部清理：使用-a选项。
• 通过前缀清理：使用-p选项指定前缀，匹配时会先自动在前缀后面加上.，然后按照字符串前缀匹配。 譬如：

>>> use temp
OK
>>> set_app_envs k.x v1 k.y v2
set app envs succeed
>>> get_app_envs
get app envs succeed, count = 2
=================================
k.x = v1
k.y = v2
=================================
>>> clear_app_envs -p k
clear app envs succeed
=============================
deleted keys:
    k.x
    k.y
=============================
>>> get_app_envs
get app envs succeed, count = 0

支持列表