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

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

源代码发布还包含给可选的过程语言和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编码时运行。