华为openGauss 使用指南

数据收集

1. 打开数据收集。

   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的作业被全量收集。

2. 关闭数据收集。

   1. 设置ActiveSQL operator信息相关参数：

      enable_resource_track=off 或 resource_track_level=none 或 resource_track_level=query

   2. 执行业务查询语句。

      等待三分钟之后查看当前节点上的数据：

      select * from gs_wlm_plan_operator_info;

      预期：所查表和视图无新增数据。

3. 数据持久化保存。

   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的作业被全量收集。

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

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

1. 新增模型：

   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约束。
   - 其他参数设置见产品文档最佳实践部分。

2. 修改模型参数：

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

3. 删除模型：

   DELETE FROM gs_opt_model WHERE model_name = <target_model_name>;

4. 查询现有模型及其状态：

   SELECT * FROM gs_opt_model;

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

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

   例：

   模型添加：

   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>;

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

   删除原有encoding数据：

   DELETE FROM gs_wlm_plan_encoding_table;

   进行数据编码，需要指定数据库名：

   SELECT gather_encoding_info('postgres');

   开始训练：

   SELECT model_train_opt('rlstm', 'default');

3. 查看模型训练状态：

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

   返回Tensorboard所用URL：

   

   打开URL查看模型训练状态：

   

模型预测

说明：
- 模型预测功能需在数据库状态正常、指定模型已被训练且收敛的条件下进行。
- 目前，模型训练参数的标签设置中需要包含“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');

1. 调用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”列为标签预测值。