| PostgreSQL 9.3.1 中文手册 | ||||
|---|---|---|---|---|
| 上一页 | 上一级 | 章 30. 回归测试 | 下一页 | |
回归测试可以对一套已经安装好并且在运行中的服务器进行测试， 也可以对编译树里面即将安装的服务器进行测试。详细些说，有"并行" 和"串行"运行测试之分。串行模式顺序运行每个测试，而并行模式启动多个服务器进程， 并发地运行一组测试。并发测试使我们对进程内部通讯和锁的正确工作有足够的信心。
编译之后和安装之前运行回归测试，你可以在顶级目录运行(或者进入 src/test/regress子目录然后在那里运行)：
gmake check
这样将先编译几个辅助文件，比如一些用户定义的触发器函数，然后再运行测试驱动脚本。 最后你会看到类似下面的东西：
======================= All 115 tests passed. =======================
或者是一些关于某项测试失败的信息。先看看第 30.2 节 然后再想想一个"失败"是否代表严重的错误。
因为这个测试方法运行临时的服务器，所以如果你是 root 用户， 那这个方法不能运行(服务器不能以 root 身份启动)。如果你已经以 root 身份编译了， 你就什么也干不了。这时候你应该把测试目录的权限变成某个用户可写， 然后以那个用户身份登陆，再开始测试。比如：
root# chmod -R a+w src/test/regress root# su - joeuser joeuser$ cd top-level build directory joeuser$ gmake check
这里唯一可能的"安全隐患"就是那个用户可能会背着你修改回归测试的结果。 用你的常识管理用户权限。
如果不是上面那样，安装后就可以运行测试。
如果你配置PostgreSQL安装到一个原来安装有老版本 PostgreSQL的目录里，然后在安装新版本之前执行gmake check， 那么你可能发现测试失败，因为新程序试图使用已经存在的共享库，典型的症状是抱怨未定义的符号。 如果你想在覆盖老版本之前运行测试，那么你需要使用configure --disable-rpath进行编译。 不过，我们不建议你使用这个选项编译作为最终安装的数据库。
并发的回归测试会在你的用户 ID 下启动相当多的进程。目前，最大的并发数是 20 个并发测试脚本， 这意味着 40 个进程：一个服务器进程、每个脚本一个psql进程。因此， 如果你的系统有针对每个用户的进程数限制，那么请确保这个限制至少是 50 ， 否则你就可能在并发测试时看到随机出现的失败。如果你没有办法提升该限制， 那么可以通过设置MAX_CONNECTIONS参数降低并发测试程度。比如：
gmake MAX_CONNECTIONS=10 check
将运行最多不超过 10 个并发进程。
安装后(参见 (see 第 15 章))运行测试， 像as explained in 第 17 章, 描述的那样初始化一个数据区并启动服务器，然后键入：
gmake installcheck
或者是运行一个并发测试：
gmake installcheck-parallel
该测试将与在本地主机和缺省端口号上运行的服务器进行连接，除非你用PGHOST 和PGPORT环境变量设置为其它值。
源代码发布还包含给可选的过程语言和contrib模块使用的回归测试。目前， 这些测试只能用于已经安装的服务器。要给所有编译并安装的过程语言运行测试， 我们可以进入源代码树的src/pl目录然后运行：
gmake installcheck
你还可以在src/pl的任何子目录里只针对一种过程语言进行测试。 要为所有contrib模块运行测试，必须首先编译并安装contrib模块， 然后进入contrib目录运行：
gmake installcheck
你也可以在contrib的子目录里只针对一个模块运行测试。
源代码发布还包含热备份静态行为的回归测试。测试要求一个运行的主服务器和一个运行的备用服务器， 接受使用基于文件日志传送或流复制的从主服务器改变的新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 允许测试备用服务器的行为。
额外的自动化测试可能在以后的版本中可用。
默认的，对临时安装的测试使用在当前环境中定义的区域并且由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的情况下有用；否则编码自动从区域中选择， 并且指定不匹配区域的编码将会导致错误。
编码可以为临时或现有安装测试设置。
回归测试包含的一些测试文件默认是不运行的，因为它们可能是依赖于平台的或运行需要很长的时间。 你可以通过设置变量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编码时运行。