金仓数据库 KingbaseES 插件参考手册 T(2)
103. tsm_system_rows
103.1. 插件tsm_system_rows简介
插件tsm_system_rows是KingbaseES的一个扩展插件。提供了表采样方法SYSTEM_ROWS，它可以用在SELECT命令的TABLESAMPLE子句中。
这种表采样方法接受一个整数参数，它是要读取的最大行数。得到的采样将总是包 含正好这么多行，除非该表中没有足够的行，在那种情况下整个表都会被选择出来。
和内建的SYSTEM采样方法一样，SYSTEM_ROWS执行块级别的采样，所以采样不是完全随机的，而是服从于聚簇效果，特别是只要求少量行时。SYSTEM_ROWS不支持 REPEATABLE子句。
-
插件名为 tsm_system_rows
-
插件版本 V1.0
103.2. 插件tsm_system_rows加载方式
KingbaseES数据库默认不加载tsm_system_rows扩展插件，如果用户想使用tsm_system_rows功能，请使用CREATE EXTENSION命令进行加载。
示例：
CREATE EXTENSION tsm_system_rows;
103.3. 插件tsm_system_rows的参数配置
无需配置任何参数
103.4. 插件tsm_system_rows的使用方法
KingbaseES加载tsm_system_rows插件后，用户使用tsm_system_rows可参考如下示例.
示例：
SELECT * FROM my_table TABLESAMPLE SYSTEM_ROWS(100);
这个命令从表my_table中返回一个100行的采样(除非该表没有100个可见行，那时将会返回其中所有的行)。
103.5. 插件tsm_system_rows卸载方法
如果用户不想再使用tsm_system_rows扩展插件的功能，可以使用DROP EXTENSION命令进行卸载。
示例：
DROP EXTENSION tsm_system_rows;
103.6. 插件tsm_system_rows升级方法
tsm_system_rows扩展插件通常随着KingbaseES安装包一并升级。通常情况下用户无须单独升级些插件。
104. tsm_system_time
104.1. 插件tsm_system_time简介
插件tsm_system_time提供了表采样方法SYSTEM_TIME，它可以用在SELECT命令的TABLESAMPLE子句中。这种表采样方法接受一个浮点类型的参数，指定花在读取上的最大时间，单位毫秒。这个方法可以直接控制采样的查询时间，但代价是采样的大小难以预测。和内建的SYSTEM采样方法一样，SYSTEM_TIME执行块级别的采样，所以采样不是完全随机的，而是服从于聚簇效果，特别是只采样少量行时。
SYSTEM_TIME不支持 REPEATABLE子句。
插件名为 tsm_system_time
插件版本 V1.0
104.2. 插件tsm_system_time加载方式
CREATE EXTENSION tsm_system_time;
104.3. 插件tsm_system_time的参数配置
无需配置任何参数
104.4. 插件tsm_system_time的使用方法
KingbaseES加载tsm_system_time插件后，用户使用tsm_system_time可参考如下示例。
示例：
SELECT * FROM my_table TABLESAMPLE SYSTEM_TIME(1000);
这个命令从表my_table中返回1000毫秒内可以读取到的采样（如果表在时间内被读完将返回所有行）。
104.5. 插件tsm_system_time卸载方法
DROP EXTENSION tsm_system_time;
104.6. 插件tsm_system_time升级方法¶
通过 ALTER EXTENSION升级插件。
示例，升级到 1.1：
ALTER EXTENSION tsm_system_time UPDATE TO '1.1';