gbase数据、南大通用产品文档：gbase,数据,gbase数据,南大通用 GBase8afunc

函数原型
void func_clear(UDF_INIT* initid, char* is_null, char* error)；
函数说明

GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953（2022-09-15）
南大通用数据技术股份有限公司
1396
重置分组buf(func_max_buffer_length 函数指定大小)。用户可以通过initid->ptr 对
分组buf 进行初始值设置或者清空。

步骤3 部署node-exporter
一般地，
对于Prometheus 监控平台都需要部署node-exporter 用于监控Linux 操作系统，
后文提到的部分AI 功能也需要依赖node-exporter 采集Linux 系统指标，故也需要用户来部
署；只不过，该node-exporter 为Prometheus 自带组件，
需要用户自行下载安装，下载地址为https://prometheus.io/download/ #node_exporter，
使
用
方
法
详
见
：
https://prometheus.io/docs/guides/node-exporter/#installing-and-running-the-node-exporter。
用户可解压压缩包后直接运行该node-exporter 进程，其默认端口号为9100，启动命令
行为：
./node_exporter
步骤4 配置Prometheus-server，修改配置文件prometheus.yml，添加下述内容：
scrape_configs:
...
job_name: 'opengauss_exporter' static_configs:
- targets: ['192.168.1.100:9187']
job_name: 'reprocessing_exporter' scheme: https
tls_config: ca_file: xxx.crt

GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
365
static_configs:
- targets: ['127.0.0.1:8181']
job_name: 'node_exporter' static_configs:
- targets: ['127.0.0.1:9100']
...
----结束

openGauss-exporter 中连接数据库的用户需要monitor admin 或以上权限，
否则会出现部
分指标无法采集的情况。

openGauss-exporter
会从
dbe_perf.statement_history
中抽样慢
SQL
信息，
dbe_perf.statement_history 视图慢SQL 记录与GUC 参数log_min_duration_statement 和
track_stmnt_stat_level 相关，
其中log_min_duration_statement 是慢SQL 阈值，
单位毫秒，
具体值由用户设置；track_stmnt_stat_level 是SQL 记录级别，默认为'OFF,L0'，即只记
录慢SQL 信息，级别为L0，用户在详细了解参数意义与作用情况下谨慎修改。

openGauss-exporter 采集数据库相关信息，主要包括部分系统表和视图中的数据（具体
参见代码中opengauss_exporter 中的配置文件），node-exporter 采集系统指标信息，主
要与系统磁盘、CPU 等相关，reprocessing_exporter 基于prometheus-server 中的某些指
标（具体参见代码中reprocessing_exporter 中的配置文件）进行二次加工，最终提供加
工后的数据供用户使用。

prometheus-server 在拉取exporter 数据时有超时机制，
超时时间由scrape_timeout
（默认
10s）
控制，
因此当exporter 采集数据量较大时，
用户可根据实际情况增大scrape_timeout
以防止超时报错，
另外需要注意的是scrape_interval
（采集间隔）不能比scrape_timeout
小，否则会出现异常。

如果数据库时区设置和系统不相同，
可能会出现时间相关指标时间与系统时间不一致的
情况，因此需要将用户时区与系统保持同步。

当使用https 通信时，工具会检测证书与密钥文件权限以及证书有效期，如果文件权限
大于600 则会出现报警，证书有效期小于90 天会出现报警。

当存在指标重复采集时，openGauss-exporter 会出现异常，异常信息会打印到日志中。

openGauss-exporter
的
--config
、
--disable-settings-metrics
、
--disable-
statement-history-metrics 三个参数需要注意，其存在以下几种情况：

GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
366

用户不指定其中任何参数，
则工具会同时对yamls 目录下的三个配置文件
中的指标进行采集。

用户显式指定--config，则工具不会采集yamls 目录下default.yml 中的指
标，而会采集用户指定配置文件中的指标，同时pg_settings.yml 和statements.yml
正常
采集，此时用户需要注意指定的配置文件中的指标和pg_settings.yml、
statements.yml 中的指标不能存在重复采集的现象。

用户显式指定--disable-settings-metrics，则工具不会采集yamls 目录下
pg_settings.yml 中的指标，
用户显式指定--disable-statement-history- metrics，
则工具
不会采集yamls 目录下statements.yml（慢SQL 相关）中的指标。

1.
从命令提示符，通过使用下列命令之一来启动安装程序：
ₒ
要在图形模式下启动：
java -jar dir/setup.jar -i gui
ₒ
要在控制台模式下启动：
java -jar dir/setup.jar -i console
在此，dir 是 setup.jar 文件的位置。
2.
阅读许可协议，并接受条款。如安装指导的那样来响应提示。

GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 12 -
3.
当出现提示时，请接受缺省目录，或指定不同的目录。
在 Windows™ 平台上，
缺省目录是 C:\Program Files\GBASE\GBASEDBT_JDBC_Driver
在安装和卸载过程中，要防止错误，请不要在安装路径中使用感叹号（!）。
4.
当出现提示时，请核实安装路径的位置。
安装程序安装 GBase 8s JDBC Driver，并通知您正在将卸载程序添加至安装目录。
提示：当连接至挂载了 NFS 的文件系统时，如果安装停顿，则应首先解决 NFS 问题。
在某些情况下，卸载和重新挂载共享可解决该问题。否则，请强制终止卸载，清理任何孤
立的进程，并重新启动安装。
5.
当您看到此消息时，请指定 Finish：
Congratulations. GBase 8s JDBC Driver has been successfully installed to:

gbase数据、南大通用产品文档：GBase8afunc_clear（）