gs_plan_simulator

    前提条件

    • 用户数据库正常运行。
    • 用户可以连接到数据库并正常执行功能。
    • 用于复现的OS环境和生产环境应该一致。
    • 用于复现的环境安装的openGauss安装包应和生产环境的安装包一致。
    • 使用gs_collector收集数据时默认不会收集与执行计划相关数据,因为收集该类数据可能会需要很长时间。收集执行计划相关数据需要修改配置文件,详情见使用步骤。
    • 在复现环境上需要配置GAUSSHOME和LD_LIBRARY_PATH。
    • 工具使用时需要注意集群状态,扩容状态等影响执行计划相关数据的情况下,勿使用此工具。

    使用步骤

    1. 使用gs_collector收集数据。收集执行计划相关数据时,需要先写配置文件,例如plan.json,建议配置文件内容如下:

      这里Content内容为“*”,用于收集所有数据库的相关数据,也可以指定数据库进行收集如“test1,test2”。

      收集命令示例:

      更多使用方法见一节。

    2. 拷贝数据文件夹到复现环境。

      数据收集成功后,放在指定的压缩包内,解压压缩包会有各个节点的压缩包。解压任意一个压缩包,目标数据在planSimulatorfiles文件夹下,进入planSimulatorfiles文件夹可以看到以数据库命名的文件夹,拷贝planSimulatorfiles文件夹到复现环境。

      1. 使用普通用户创建用于复现执行计划的目录。例如plan文件夹。
      2. 在该目录中解压GaussDB安装包,再解压安装包解压出来的bin文件。
      3. 配置GAUSSHOME为plan文件夹的路径,配置LD_LIBRARY_PATH为plan/lib文件夹的路径。
    • 复现数据库环境。

    • 关闭数据库。

    • 打开数据库。

    参数说明

    • -m

      工具的功能信息,表示工具要执行的操作。

      取值范围:

      • restore:利用收集的数据库信息来复现数据库环境,同时创建数据库。
      • off:关闭已经存在的由该工具复现数据库。
      • start:启动由该工具复现的数据库。
    • -A