workload 级别索引推荐
对于workload 级别的索引推荐，用户可通过运行数据库外的脚本使用此功能，本功能
将包含有多条DML 语句的workload 作为输入，最终生成一批可对整体workload 的执行表
现进行优化的索引。同时，本功能提供从日志中抽取业务数据SQL 流水的功能。
前提条件
数据库状态正常、客户端能够正常连接。
当前执行用户下安装有gsql 工具，该工具路径已被加入到PATH 环境变量中。
若使用本功能提供的业务数据抽取功能，需提前将要收集的节点的GUC 参数按如下设
置：
log_min_duration_statement = 0
log_statement= 'all'
业务数据抽取完毕建议将上述GUC 参数复原，否则容易导致日志文件膨胀。
业务数据抽取脚本使用步骤
(1)
按前提条件中要求设置相关GUC 参数。
(2)
执行根据日志抽取SQL 语句的功能，命令如下：
gs_dbmind component extract_log [l LOG_DIRECTORY] [f OUTPUT_FILE] [p
LOG_LINE_PREFIX] [-d DATABASE] [-U USERNAME][--start_time] [--sql_amount]
[--statement] [--json] [--max_reserved_period] [--max_template_num]
其中的输入参数依次为：
LOG_DIRECTORY：pg_log 的存放目录。
OUTPUT_PATH：输出SQL 流水文件文件的保存路径，即抽取出的业务数据存放的文
件路径。
LOG_LINE_PREFIX：指定每条日志信息的前缀格式。
DATABASE：（可选）数据库名称，不指定默认所有数据库。
USERNAME：（可选）用户名称，不指定默认所有用户。
start_time：（可选）日志收集的开始时间，不指定默认所有文件。
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
389
sql_amount：（可选）收集SQL 数量的最大值，不指定默认收集所有SQL。
statement：（可选）表示收集pg_log 日志中statement 标识开头的SQL，不指定默认不
收集。
json：
（可选）指定收集日志的文件存储格式为SQL 归一化后的json，不指定默认格式
每条SQL 占一行。
max_reserved_period：（可选）指定json 模式下，增量收集日志中保留的模板的最大的
更新时长，不指定默认都保留，单位/天。
max_template_num：（可选）指定json 模式下保留的最大模板数量，不指定默认都保
留。
使用示例：
gs_dbmind component extract_log $GAUSSLOG/pg_log/dn_6001 sql_log.txt
'%m %c %d %p %a %x %n %e' -d postgres -U gbase --start_time '2021-07-06 00:00:00'
--statement
若指定-d/-U 参数，日志打印每条日志信息的前缀格式需包含%d、%u，若需要抽取事
务，
必须指定%p，
详见log_line_prefix 参数。
max_template_num 参数设置建议不超5000
条，避免workload 索引推荐执行时间过长。
(3)
将1 中设置的GUC 参数还原为设置前的值。
索引推荐脚本使用步骤
(1)
准备好包含有多条DML 语句的文件作为输入的workload，文件中每条语句占据一行。
用户可从数据库的离线日志中获得历史的业务语句。
(2)
运行本功能，命令如下：
gs_dbmind component index_advisor [p PORT] [d DATABASE] [f FILE] [--h HOST] [-U
USERNAME] [-W PASSWORD][--schema SCHEMA]
[--max_index_num MAX_INDEX_NUM][--max_index_storage MAX_INDEX_STORAGE]
[--multi_iter_mode] [--multi_node]
[--json] [--driver] [--show_detail]
其中的输入参数依次为：
PORT：连接数据库的端口号。
DATABASE：连接数据库的名字。
FILE：包含workload 语句的文件路径。
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
390
HOST：（可选）连接数据库的主机号。
USERNAME：（可选）连接数据库的用户名。
PASSWORD：（可选）连接数据库用户的密码。
SCHEMA：模式名称。
MAX_INDEX_NUM：（可选）最大的索引推荐数目。
MAX_INDEX_STORAGE：（可选）最大的索引集合空间大小。
multi_node：（可选）指定当前是否为分布式数据库实例。
multi_iter_mode：（可选）算法模式，可通过是否设置该参数来切换算法。
json：（可选）指定workload 语句的文件路径格式为SQL 归一化后的json，默认格式
每条SQL 占一行。
driver：（可选）指定是否使用python 驱动器连接数据库，默认gsql 连接。
show_detail：（可选）是否显示当前推荐索引集合的详细优化信息。
例如：
gs_dbmind component index_advisor 6001 postgres tpcc_log.txt --schema public
--max_index_num 10 --multi_iter_mode
推荐结果为一批索引，以多个创建索引语句的格式显示在屏幕上，结果示例。
create index ind0 on public.bmsql_stock(s_i_id,s_w_id);
create index ind1 on public.bmsql_customer(c_w_id,c_id,c_d_id);
create index ind2 on public.bmsql_order_line(ol_w_id,ol_o_id,ol_d_id);
create index ind3 on public.bmsql_item(i_id);
create index ind4 on public.bmsql_oorder(o_w_id,o_id,o_d_id);
create index ind5 on public.bmsql_new_order(no_w_id,no_d_id,no_o_id);
create index ind6 on public.bmsql_customer(c_w_id,c_d_id,c_last,c_first);
create index ind7 on public.bmsql_new_order(no_w_id);
create index ind8 on public.bmsql_oorder(o_w_id,o_c_id,o_d_id);
create index ind9 on public.bmsql_district(d_w_id);
multi_node 参数需严格按照当前数据库架构进行指定，否则推荐结果不全，甚至导致无
推荐结果。
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
391