使用指导

使用指导

数据收集

打开数据收集。
1. 设置ActiveSQL operator信息相关参数:
```
enable_resource_track=on
resource_track_level=operator
enable_resource_record=on
resource_track_cost=10（默认值为100000）
```
  说明：
  - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。
  - Cgroups功能正常加载。
2. 信息收集：
  
  执行业务查询语句。
  
  查看实时收集数据：
```
select * from gs_wlm_plan_operator_history;
```
  预期：满足resource_track_duration和resource_track_cost的作业被全量收集。
关闭数据收集。
1. 设置ActiveSQL operator信息相关参数：
```
enable_resource_track=off 或
resource_track_level=none 或
resource_track_level=query
```
2. 执行业务查询语句。
  
  等待三分钟之后查看当前节点上的数据：
```
select * from gs_wlm_plan_operator_info;
```
  预期：所查表和视图无新增数据。
数据持久化保存。
1. 设置ActiveSQL operator信息相关参数：
```
enable_resource_track=on
resource_track_level=operator
enable_resource_record=on
resource_track_duration=0（默认值为60s）
resource_track_cost=10（默认值为100000）
```
  说明：
  - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。
  - Cgroups功能正常加载。
2. 执行业务查询语句。
  
  等待三分钟之后查看当前节点上的数据：
```
select * from gs_wlm_plan_operator_info;
```
  预期：满足resource_track_duration和resource_track_cost的作业被全量收集。

模型管理（系统管理员用户）

说明： 模型管理操作需要在数据库正常的状态下进行。

新增模型：

INSERT INTO gs_opt_model values(‘……’)；

示例：
```
INSERT INTO gs_opt_model values('rlstm', 'model_name', 'datname', '127.0.0.1', 5000, 2000, 1, -1, 64, 512, 0 , false, false, '{S, T}', '{0,0}', '{0,0}', 'Text');
```
说明：
- 具体模型参数设置请参考GS_OPT_MODEL。
- 目前 “template_name” 列只支持 “rlstm”;
- “datname” 列请和用于模型使用和训练的数据库保持一致，否则无法使用。
- “model_name” 一列需要满足unique约束。
- 其他参数设置见产品文档最佳实践部分。

修改模型参数：

UPDATE gs_opt_model SET <attribute> = <value> WHERE model_name = <target_model_name>;

删除模型：

DELETE FROM gs_opt_model WHERE model_name = <target_model_name>;

查询现有模型及其状态：
```
SELECT * FROM gs_opt_model;
```

模型训练（系统管理员用户）

配置/添加模型训练参数：参考模型管理（系统管理员用户）进行模型添加、模型参数修改，来指定训练参数。

例：

模型添加：

INSERT INTO gs_opt_model values('rlstm', 'default', 'postgres', '127.0.0.1', 5000, 2000, 1, -1, 64, 512, 0 , false, false, '{S, T}', '{0,0}', '{0,0}', 'Text');

训练参数更新：

UPDATE gs_opt_model SET <attribute> = <value> WHERE model_name = <target_model_name>;

前提条件为数据库状态正常且历史数据正常收集：

删除原有encoding数据：
```
DELETE FROM gs_wlm_plan_encoding_table;
```
进行数据编码，需要指定数据库名：
```
SELECT gather_encoding_info('postgres');
```
开始训练：
```
SELECT model_train_opt('rlstm', 'default');
```

获取AI Engine侧模型训练日志相对路径：

SELECT * FROM track_model_train_opt('rlstm', 'default');

模型预测

说明：

模型预测功能需在数据库状态正常、指定模型已被训练且收敛的条件下进行。
目前，模型训练参数的标签设置中需要包含“S”标签，explain中才可显示“p-time”预测值。例：INSERT INTO gs_opt_model values(‘rlstm’, ‘default’, ‘postgres’, ‘127.0.0.1’, 5000, 1000, 1, -1, 50, 500, 0 , false, false, ‘{S, T}’, ‘{0,0}’, ‘{0,0}’, ‘Text’);

调用explain接口：

explain (analyze on, predictor <model_name>)
SELECT ...

预期结果：

例：Row Adapter  (cost=110481.35..110481.35 rows=100 p-time=99..182 width=100) (actual time=375.158..375.160 rows=2 loops=1)
其中，“p-time”列为标签预测值。

其他功能

检查AiEngine是否可连接:

postgres=# select check_engine_status('aiEngine-ip-address',running-port);

查看模型对应日志在AiEngine侧的保存路径：

postgres=# select track_model_train_opt('template_name', 'model_name');