配置文件中opengauss端的用户名不能为数据库初始用户

配置文件中opengauss端的用户名不能为数据库初始用户，因为opengauss端禁止使用数据库初始用户进行远程连接。

使用说明

社区提供的兼容性评估工具软件包解压后包含start.sh，compatibility-assessment-5.1.0.jar和assessment.properties三个文件，分别为工具启动脚本，可执行jar包以及配置模板文件。

评估使用如下命令启动：

sh start.sh -d [file|collect] -c assessment.properties -o report.html

上述命令中，-d用于指定sql语句来源。file表示sql以文件形式输入，collect表示从mysql端采集数据。两种输入形式均需要在配置文件中配置相关的信息。

-c用于指定配置文件路径，该参数为可选。若不指定，则默认使用当前目录下的assessment.properties作为配置文件。

-o用于指定输出报告文件，该参数为可选。报告文件必须为.html格式，若不指定，则默认在当前路径下生成report.html文件。

不同输入形式下，配置文件使用方法如下：

• 若sql以文件形式出入(-d file)，需要配置输入文件的目录，示例如下：

  filedir = /data/testfiles/
  
  #opengauss端数据库用户，禁止使用数据库初始用户
  opengauss.user = opengauss
  opengauss.password = **********
  opengauss.port = 5432
  opengauss.host = 127.0.0.1
  #指定评估库
  opengauss.dbname = assessment_db
  
  #指定评估库和提供操作系统用户名和密码二选一
  osuser = opengauss_init_user
  ospassword = ***********
  

  配置完成配置文件后，通过执行如下命令进行评估：

  sh start.sh -d file -c assessment.properties -o report.html
  

  工具支持四种类型的输入文件，将不同类型的文件放入指定的目录下，工具扫描目录并通过后缀对文件类型进行识别，sql文件、general log日志、slow log日志、mybatis映射文件对应的后缀分别为：.sql， .general，.slow，.xml。为了区分general log日志和slow log日志，目前需要手动修改文件后缀名以便工具自动识别。

• 若从mysql数据库端采集sql(-d collect)，需要在配置文件中指定评估类型，sql语句类型以及mysql数据库信息。示例如下：

  #评估类型，object:对象评估; sql：评估sql语句; all: 同时进行对象评估和sql语句评估。
  assessmenttype = sql
  #sql类型， slow：评估慢sql; general：评估全量sql。该参数仅需要在assessmenttype为sql或all时指定，用于表示需进行评估的sql语句类型
  sqltype = slow
  
  mysql.password = ********
  mysql.user = mysql
  mysql.port = 3389
  mysql.host = 127.0.0.1
  #通过mysql数据库端获取sql时，需指定mysql端的库名
  mysql.dbname = test
  
  opengauss.user = opengauss
  opengauss.password = ***********
  opengauss.port = 5432
  opengauss.host = 127.0.0.1
  opengauss.dbname = assessment_db
  
  #指定评估库和提供操作系统用户名和密码二选一
  osuser = omm
  ospassword = *********
  

  配置完成配置文件后，通过执行如下命令进行评估：

  sh start.sh -d collect -c assessment.properties -o report.html
  

  进行评估之前，用户可以手动创建好评估库，然后通过opengauss.dbname指定评估库；或者用户不指定评估库，通过提供数据库节点所在主机的操作系统用户名和密码，由工具自动创建评估库，工具自动创建评估库是通过ssh远程登陆到对应主机，并通过gsql连接到数据库节点，然后创建对应的评估库，所以使用这种方式进行评估时，用户需要保证osuser登录主机时能自动加载到数据库环境变量。当opengauss.dbname和(osuser, ospassword)同时指定时，会优先使用opengauss.dbname指定的库作为评估库。

• 详情查看：https://opengauss.org
  详情查看：https://docs-opengauss.osinfra.cn