更新日期：2024年09月11日
授予特权
您可以生成有关 GRANT 语句授权者的 dbschema 信息。
在 dbschema 输出中，AS 关键字指示 GRANT 语句的授权者。以下示例
输出指示 norma 发出了 GRANT 语句：
GRANT ALL ON 'tom'.customer TO 'claire' AS 'norma'
当 dbschema 输出中出现 GRANT 和 AS 关键字时，您可能需要授予特
权，才能将 dbschema 输出作为 SQL 脚本运行。根据前面的示例输出行，以
下条件必须为真，您才能将该语句作为脚本的一部分运行：
用户 norma 必须具有到数据库的 Connect 特权。
用户 norma 必须具有表 tom.customer 的所有特权 WITH GRANT
OPTION。
有关 GRANT、GRANT FRAGMENT 和 REVOKE FRAGMENT 语句的更
多信息，请参阅《GBase 8s SQL 指南：语法》
。
service 子命令
该子命令可用于对配置目录进行初始化，同时也可以实现启动和停止后台任务。
配置目录初始化
用户可通过gs_dbmind service setup 子命令进行配置目录的初始化。
该配置文件中可包
括DBMind 的配置文件、日志等内容。该目录中的部分文件说明：
dbmind.conf：DBMind 的参数配置文件，用户可通过gs_dbmind set 命令进行修改，也
可通过文本编辑器进行手动修改。
dynamic_config.db：DBMind 服务保存在本地节点的元信息，主要包括算法的超参数、
监控阈值等；该文件为DBMind 服务元信息，不可由用户直接配置。
metric_map.conf：监控指标映射表，可用于适配到不同采集平台中。例如，在DBMind
中，
监控到的系统cpu 使用率名为os_cpu_usage, 而用户自行实现的指标采集工具将cpu
使用率命名为my_cpu_usage_rate. 则在该种情况下，
如果想要DBMind 代表cpu 使用率
的指标名为my_cpu_usage_rate, 则需要修改该配置选项。即添加“os_cpu_usage =
my_cpu_usage_rate”配置项进行映射。对于普通用户，建议直接使用DBMind 配套的采
集组件和方案，则不涉及修改该配置文件。
logs: 该目录中用于存储DBMind 服务产生的日志。用户可通过两种方式进行配置目录
的初始化，
一种为交互式，
另一种为非交互式。
例如，
待初始化的配置目录名为confpath,
则分别通过下述方法进行配置：
交互式模式
gs_dbmind service setup -c confpath --interactive
执行完毕上述命令后，用户可通过命令行终端对配置项进行交互式配置。
非交互式模式
非交互式模式总共分为三个步骤，即启动配置，修改配置项，初始化配置。其中第二个
步骤需要用户通过文本编辑器手动编辑配置文件。具体步骤如下：
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
358
步骤1 启动配置，执行下述命令：
gs_dbmind service setup -c confpath
步骤2 执行完上述命令后，会在confpath 目录下生成dbmind.conf 配置文件，用户需要
利用文本编辑器进行手动修改。需要修改的配置部分为“指标数据源数据库信息区
【TSDB】”、“预测结果存储数据库信息区【METADATABASE】”和“自监控参数
配置区【SELF-MONITORING】”相关参数的说明如下：
[TSDB] # 时序数据库相关信息，即指标数据源信息
name = prometheus # 时序数据库类型. 当前仅支持选择'prometheus'. host = # 时序数据库
IP 地址.
port = # 时序数据库端口号.
[METADATABASE] # 元数据库相关信息，及预测结果存储方式
dbtype = # 元数据库类型. 可选择: sqlite, gbase, postgresql。
若该配置项名为gbase, 需关注
Python 驱动事宜，可参考下文中关于Python 驱动的提示。
host = # 元数据库地址.
port = # 元数据库端口号.
username = # 元数据库用户信息.
password = # 元数据库密码，将会被加密存储
database = # 元数据库库名. 如果选择的数据库类型为SQLite, 则无需填写上述配置项，
仅需填写此处。
DBMind 会根据database 配置项的内容，在配置目录中生成对应文件名的SQLite 数据库
文件。
[SELF-MONITORING] # 自监控参数配置
detection_interval = 600 # 单位秒. 对GBase 8c 进行健康检查的时间间隔（仅慢SQL 根因
诊断使用）.
last_detection_time = 600 # 单位秒. 用于健康检查的监控数据长度
（仅慢SQL 根因诊断使
用）.
forecasting_future_time = 3600 # 单位秒，时序预测的长度（供时序预测特性使用），同时
也是预测功能调度周期
# 待时序预测进行预测的关键指标项（仅供时序预测特性使用）
golden_kpi = os_cpu_usage, os_mem_usage, gaussdb_qps_by_instance
[LOG] # 日志相关信息
maxbytes = 10485760 # 默认值为10Mb, 单个日志文件的最大大小.如果maxbytes 为零，
则文件无限增长（建议该值不要设置太小，默认即可）.
backupcount = 1 # 日志文件最大数量.
level = INFO # 日志级别，也可配置为DEBUG, INFO, WARNING, ERROR 模式。
步骤3 待用户手动修改完上述参数后，需要执行下述命令进行配置项的初始化。在该
阶段中，DBMind 会初步检查配置项的正确性、加密配置项中出现的明文密码、同时初
始化用于存储结果数据的元数据库。
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
359
gs_dbmind service setup --initialize -c confpath
步骤4 完成配置目录初始化过程，可基于该配置目录启动DBMind 后台服务。
----结束
(1)
配置文件注释信息用于在交互模式下对用户进行提示，
有特殊含义不要手动修改或
删除；
(2)
需要确保配置项的值与注释信息之间通过空格符分割，
否则系统会将注释信息识别
为配置项的值；
(3)
配置项中的特殊字符，如果需要转移，则通过转义符“百分号”（%）来转义，例
如，用户配置的密码为
"password%", 则应通过“百分号”进行转义，即
"password%%"。
启动服务
当用户完成配置目录的初始化后，
可基于此配置目录启动DBMind 后台服务。
例如配置
目录为confpath，则启动命令如下：
gs_dbmind service start -c confpath
当执行上述命令后，会提示服务已启动。
在未指定任何附加参数时，
该命令默认会启动
所有的后台任务。如果用户只想启动某一个后台任务，需要添加参数--only-run. 例如，用
户只想启动慢SQL 根因分析服务，则为：
gs_dbmind service start -c confpath --only-run slow_query_diagnosis
关闭服务
关闭服务与启动服务类似，其命令行结构更加简单，只需指定配置目录的地址即可。例
如配置目录为confpath，则为：
gs_dbmind service stop -c confpath
DBMind 服务会在后台执行完正在运行的任务后自行退出。
(1)
[METADATABASE]中的元数据库用户需要具有在该数据库下的创表和数据插入
更新权限，否则工具执行会出现异常。
(2)
当前不支持同一配置文件下分开启动多个服务。
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
360
(3)
工具提供了requirement.txt 文件，用户可以通过该文件安装所需的第三方依赖。
命令参考
用户可以通过--help 选项获得该模式的帮助信息，例如：
gs_dbmind service --help
usage: service [-h] -c DIRECTORY [--only-run {slow_query_diagnosis,forecast}] [--interactive
| --initialize]
{setup,start,stop}
positional arguments:
{setup,start,stop}
perform an action for service
optional arguments:
-h, --help
show this help message and exit
-c DIRECTORY, --conf DIRECTORY
set the directory of configuration files
--only-run {slow_query_diagnosis,forecast}
explicitly set a certain task running in the backend
--interactive configure and initialize with interactive mode
--initialize
initialize and check configurations after configuring.
表11- 2 gs_dbmind service 子命令说明
参数
参数说明
取值范围
action
动作参数
setup：初始化配置目录。
start：服务启动。
stop：服务停止。
-c，--conf
配置文件目录地址
——
--initialize
配置参数初始化
——
--interactive
交互式输入配置参数
——
--only-run
选择只运行的模块
forecast：预测模块。
slow_query_diagnosis：
慢SQL
根因分析模块。
-h, --help
帮助命令
——
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
361