工具使用学习
- 工具使用学习
- 安装中出现的问题
声明：本文的工具学习内容来自于《小宇带你学pg内核分析》
工具的代码仓库链接为：
https://github.com/shenyuflying/pgNodeGraph
此外，我还参考了以下文章：
https://rng-songbaobao.blog.csdn.net/article/details/104023090
在此非常感谢以上博主所提供的资源！！！
工具使用学习
工具的用途：通过这个工具我们可以十分方便的把日志文件的输出（文字形式）转化为图片。
使用步骤：
- 在代码仓库中拉取代码
- 获取日志文件中的抽象语法树
要让 PostgreSQL 服务器在日志中打印解析和计划节点树，你可以按照以下步骤进行设置：
- 打开 PostgreSQL 配置文件 postgresql.conf，可以通过以下命令定位到配置文件的位置：`psql -c “SHOW config_file;”
- 编辑 postgresql.conf 文件，在文件中找到 logging_collector 配置项，并确保其值为 on，表示启用日志收集器。
- 找到 log_destination 配置项，并确保其值中包含 csvlog，例如：
log_destination = 'stderr,csvlog'- 找到 logging_collector 配置项，并确保其值为 on，表示启用日志收集器。
- 找到 log_statement 配置项，并将其值设置为 all，表示记录所有类型的 SQL 语句。如果你只想记录解析和计划节点树的信息，可以将其设置为 parse。
- 找到 debug_print_parse、debug_print_rewritten 和 debug_print_plan 配置项，并将它们的值设置为 on，表示启用打印解析和计划节点树的调试输出。
- 保存配置文件，并重新启动 PostgreSQL 服务器，使配置生效。
完成上述步骤后，PostgreSQL 服务器将在日志中打印解析和计划节点树的详细信息。你可以通过查看日志文件来获取相应的输出信息。
- 进行gdb调试
- 首先在exec_simple_query函数中打上断点：
b exec_simple_query- 单步调试进入函数pg_analyze_and_rewrite
- 单步调试进入函数parse_analyze
- 单步调试进入函数transformTopLevelStmt
- 单步调试进入函数transformOptionalSelectInto
- 使用 bt 查看当前调用堆栈的回溯信息，即显示当前正在执行的函数以及它们的调用关系，如下所示：
- 得到分析树 parseTree
- 随后在GDB调试中执行如下操作：
call elog_node_display(15,”name”,要显示的结果的地址,1);
这句代码是 PostgreSQL 中的调试输出语句，用于将查询树（parseTree）以更美观的格式打印出来，并输出到日志。该函数是由宏 elog_node_display 来实现的。具体参数的意思如下：
（1）15：这是日志的日志级别，表示 LOG 级别，即输出为信息性消息。
（2）“name”：这是打印出来的查询树的标题，相当于给打印的内容起一个名称，可以用来区分不同的输出。
（3）parseTree：这是要打印的查询树，通常是 Query 结构体类型的指针。
（4）1：这是打印的详细程度级别，为 1 表示最详细的打印方式。
- 在日志文件中查找最新的记录（日志文件路径：
postgresql/data/log）
- 将生成的文件在工具文件包的 “node” 文件夹下拷贝一份，文件后缀名为 .node
- 运行命令：
./pgNodeGraph
- 最后在 pic 文件中可以查看生成的图片文件。
安装中出现的问题
在执行命令./pgNodeGraph时出现报错如下：
原因：似乎是内存问题，通过查找资料了解到是说内存超过2G会出现问题。需要添加编译选项：-mcmodel。
解决办法：修改 pgNodeGraph 中的 gcc命令如下：gcc -mcmodel=medium -g node2dot.c -o node2dot
