更新日期：2024年09月11日
前提条件
需要保证GBase 8c 处于正常状态，
用户通过身份验证成功登录数据库；
用户执行的SQL
语法正确无报错，且不会导致数据库异常等；历史性能数据窗口内GBase 8c 并发量稳定，
表结构、表数量不变，数据量无突变，涉及查询性能的guc 参数不变；进行预测时，需要保
证模型已训练并收敛；AiEngine 运行环境稳定。
请求样例
AiEngine 进程与内核进程使用https 发送请求进行通信，请求样例如下：
curl -X POST -d '{"modelName":"modelname"}' -H 'Content-Type: application/json'
'https://IP-address:port/request-API'
表11- 20 AI-Engine 对外接口
Request-API
功能
/check
检查模型是否被正常拉起
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
419
/configure
设置模型参数
/train
模型训练
/track_process
查看模型训练日志
/setup
加载历史模型
/predict
模型预测
证书生成
使用此功能前需使用openssl 工具生成通信双方认证所需的证书，保证通信安全。
(1)
搭建证书生成环境，证书文件保存路径为$GAUSSHOME/CA。
拷贝证书生成脚本及相关文件
cp path_to_predictor/install/ssl.sh $GAUSSHOME/
cp path_to_predictor/install/ca_ext.txt $GAUSSHOME/
copy 配置文件openssl.cnf 到$GAUSSHOME 路径下
cp $GAUSSHOME/share/om/openssl.cnf
$GAUSSHOME/
修改openssl.conf 配置参数
dir
= $GAUSSHOME/CA/demoCA
default_md
= sha256
至此证书生成环境准备完成
(2)
生成证书及密钥
cd $GAUSSHOME
sh ssl.sh
根据提示设置密码，假如为Test@123：
密码要求至少3 种不同类型字符，长度至少为8 位
Please enter your password:
根据提示输入选项：
Certificate Details:
Serial Number: 1 (0x1)
Validity
Not Before: May 15 08:32:44 2020 GMT
Not After : May 15 08:32:44 2021 GMT
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
420
Subject:
countryName
= CN
stateOrProvinceName
= SZ
organizationName
= HW
organizationalUnitName
= GS
commonName
= CA
X509v3 extensions:
X509v3 Basic Constraints:
CA:TRUE
Certificate is to be certified until May 15 08:32:44 2021 GMT (365 days)
Sign the certificate? [y/n]:y
1 out of 1 certificate requests certified, commit? [y/n]y
输入拉起AIEngine 的IP 地址，如IP 为127.0.0.1：
Please enter your aiEngine IP: 127.0.0.1
根据提示输入选项：
Certificate Details:
Serial Number: 2 (0x2)
Validity
Not Before: May 15 08:38:07 2020 GMT
Not After : May 13 08:38:07 2030 GMT
Subject:
countryName
= CN
stateOrProvinceName
= SZ
organizationName
= HW
organizationalUnitName
= GS
commonName
= 127.0.0.1
X509v3 extensions:
X509v3 Basic Constraints:
CA:FALSE
Certificate is to be certified until May 13 08:38:07 2030 GMT (3650 days)
Sign the certificate? [y/n]:y
1 out of 1 certificate requests certified, commit? [y/n]y
输入启动IP 地址，如IP 为127.0.0.1：
Please enter your gaussdb IP: 127.0.0.1
根据提示输入选项：
Certificate Details:
Serial Number: 3 (0x3)
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
421
Validity
Not Before: May 15 08:41:46 2020 GMT
Not After : May 13 08:41:46 2030 GMT
Subject:
countryName
= CN
stateOrProvinceName
= SZ
organizationName
= HW
organizationalUnitName
= GS
commonName
= 127.0.0.1
X509v3 extensions:
X509v3 Basic Constraints:
CA:FALSE
Certificate is to be certified until May 13 08:41:46 2030 GMT (3650 days)
Sign the certificate? [y/n]:y
1 out of 1 certificate requests certified, commit? [y/n]y
至此，相关证书及密钥已生成，（$GAUSSHOME/CA）内容如下：
环境准备
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
422
将工具代码文件夹拷贝至目标环境
假设安装路径为$INSTALL_FOLDER，目标环境路径为/home/ai_user :
scp -r $INSTALL_FOLDER/bin/dbmind/predictor
ai_user@127.0.0.1:path_to_Predictor
拷贝CA 证书文件夹至aiEngine 环境中某路径下：
cp -r $GAUSSHOME/CA
ai_user@127.0.0.1:path_to_CA
安装predictor/install/requirements(-gpu).txt 工具
（该功能比较特殊，
与其他AI 功能不同，
需要独立安装依赖）：
有GPU：pip install -r requirements-gpu.txt
无GPU：pip install -r requirements.txt
拉起AiEngine
切换至aiEngine 环境（即拷贝predictor 的目标环境ai_user）：
设置predictor/python/settings.py 中的相关参数：
DEFAULT_FLASK_SERVER_HOST = '127.0.0.1' （aiEngine 运行IP 地址）
DEFAULT_FLASK_SERVER_PORT = '5000' （aiEngine 运行端口号）
PATH_SSL = "path_to_CA" (CA 文件夹路径)
运行aiEngine 启动脚本：
python path_to_Predictor/python/run.py
此时，aiEngine 即在相应端口保持拉起状态，等待内核侧时间预测功能的请求指令。
至此，aiEngine 工具部署完成。从内核中发起执行时间预测功能指令步骤，请参考使用
指导。