30.1. 运行测试

回归测试可以对一套已经安装好并且在运行中的服务器进行测试, 也可以对编译树里面即将安装的服务器进行测试。详细些说,有"并行" 和"串行"运行测试之分。串行模式顺序运行每个测试,而并行模式启动多个服务器进程, 并发地运行一组测试。并发测试使我们对进程内部通讯和锁的正确工作有足够的信心。

30.1.1. 对临时安装运行测试

编译之后和安装之前运行回归测试,你可以在顶级目录运行(或者进入 src/test/regress子目录然后在那里运行):

gmake check

这样将先编译几个辅助文件,比如一些用户定义的触发器函数,然后再运行测试驱动脚本。 最后你会看到类似下面的东西:

<samp class="literal">=======================
 All 115 tests passed.
=======================</samp>

或者是一些关于某项测试失败的信息。先看看Section 30.2 然后再想想一个"失败"是否代表严重的错误。

因为这个测试方法运行临时的服务器,所以如果你是 root 用户, 那这个方法不能运行(服务器不能以 root 身份启动)。如果你已经以 root 身份编译了, 你就什么也干不了。这时候你应该把测试目录的权限变成某个用户可写, 然后以那个用户身份登陆,再开始测试。比如:

<samp class="literal">root#</samp> <kbd class="literal">chmod -R a+w src/test/regress</kbd>
<samp class="literal">root#</samp> <kbd class="literal">su - joeuser</kbd>
<samp class="literal">joeuser$</samp> <kbd class="literal">cd `_top-level build directory_`</kbd>
<samp class="literal">joeuser$</samp> <kbd class="literal">gmake check</kbd>

这里唯一可能的"安全隐患"就是那个用户可能会背着你修改回归测试的结果。 用你的常识管理用户权限。

如果不是上面那样,安装后就可以运行测试。

如果你配置PostgreSQL安装到一个原来安装有老版本 PostgreSQL的目录里,然后在安装新版本之前执行gmake check, 那么你可能发现测试失败,因为新程序试图使用已经存在的共享库,典型的症状是抱怨未定义的符号。 如果你想在覆盖老版本之前运行测试,那么你需要使用configure --disable-rpath进行编译。 不过,我们不建议你使用这个选项编译作为最终安装的数据库。

并发的回归测试会在你的用户 ID 下启动相当多的进程。目前,最大的并发数是 20 个并发测试脚本, 这意味着 40 个进程:一个服务器进程、每个脚本一个psql进程。因此, 如果你的系统有针对每个用户的进程数限制,那么请确保这个限制至少是 50 , 否则你就可能在并发测试时看到随机出现的失败。如果你没有办法提升该限制, 那么可以通过设置MAX_CONNECTIONS参数降低并发测试程度。比如:

gmake MAX_CONNECTIONS=10 check

将运行最多不超过 10 个并发进程。

30.1.2. 对现有安装运行测试

安装后(参见 (see Chapter 15))运行测试, 像as explained in Chapter 17, 描述的那样初始化一个数据区并启动服务器,然后键入:

gmake installcheck

或者是运行一个并发测试:

gmake installcheck-parallel

该测试将与在本地主机和缺省端口号上运行的服务器进行连接,除非你用PGHOSTPGPORT环境变量设置为其它值。

源代码发布还包含给可选的过程语言和contrib模块使用的回归测试。目前, 这些测试只能用于已经安装的服务器。要给所有编译并安装的过程语言运行测试, 我们可以进入源代码树的src/pl目录然后运行:

gmake installcheck

你还可以在src/pl的任何子目录里只针对一种过程语言进行测试。 要为所有contrib模块运行测试,必须首先编译并安装contrib模块, 然后进入contrib目录运行:

gmake installcheck

你也可以在contrib的子目录里只针对一个模块运行测试。

30.1.3. 测试热备份

源代码发布还包含热备份静态行为的回归测试。测试要求一个运行的主服务器和一个运行的备用服务器, 接受使用基于文件日志传送或流复制的从主服务器改变的新WAL。这些服务器不是自动为你创建的, 设置文件也不是。请查阅所需命令和相关问题的文档的细节。

首先,在主服务器上创建一个命名为"regression"的数据库。

psql -h primary -c "CREATE DATABASE regression"

然后,在主服务器上的回归数据库运行一个准备脚本: src/test/regress/sql/hs_primary_setup.sql, 允许更改传送到备用,例如:

psql -h primary -f src/test/regress/sql/hs_primary_setup.sql regression

现在确认测试的默认连接是接受测试的备用服务器,然后从回归目录运行standbycheck

cd src/test/regress
gmake standbycheck

一些极端行为也可能在主服务器产生,使用脚本: src/test/regress/sql/hs_primary_extremes.sql 允许测试备用服务器的行为。

额外的自动化测试可能在以后的版本中可用。

30.1.4. 区域和编码

默认的,对临时安装的测试使用在当前环境中定义的区域并且由initdb 决定相应的数据库编码。通过设置适当的环境变量来测试不同的区域是有用的,例如:

gmake check LANG=C
gmake check LC_COLLATE=en_US.utf8 LC_CTYPE=fr_CA.utf8

由于实现原因,设置LC_ALL并不能为此工作;所有其他区域相关的环境变量可以。

当对现有安装测试时,区域是由现有数据库集群决定的,并且不能单独为测试运行设置。

你也可以通过设置变量ENCODING明确的选择数据库编码,例如:

gmake check LANG=C ENCODING=EUC_JP

用这种方式设置数据库编码通常只在区域是C的情况下有用;否则编码自动从区域中选择, 并且指定不匹配区域的编码将会导致错误。

编码可以为临时或现有安装测试设置。

30.1.5. 额外的测试

回归测试包含的一些测试文件默认是不运行的,因为它们可能是依赖于平台的或运行需要很长的时间。 你可以通过设置变量EXTRA_TESTS运行它们或其他额外测试文件。 例如,运行numeric_big测试:

gmake check EXTRA_TESTS=numeric_big

运行排序测试:

gmake check EXTRA_TESTS=collate.linux.utf8 LANG=en_US.utf8

collate.linux.utf8测试只在Linux/glibc平台工作, 并且只在数据库使用UTF-8编码时运行。