30.1. 运行测试

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

30.1.1. 对临时安装运行测试

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

make check

最后你会看到类似下面的东西:

=======================
 All 115 tests passed.
=======================

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

因为这个测试方法运行临时的服务器,所以如果你作为 root 用户编译, 那这个方法不能运行,因为服务器不是以 root 身份启动的。 建议的过程是不要作为root编译,或者在完成安装之后执行测试。

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

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

make MAX_CONNECTIONS=10 check

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

30.1.2. 对现有安装运行测试

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

make installcheck

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

make installcheck-parallel

该测试将与在本地主机和缺省端口号上运行的服务器进行连接,除非你用PGHOSTPGPORT环境变量设置为其它值。该测试将在一个名为 regression的数据库中运行;任何现有的以此命名的数据库都将被删除。 该测试暂时还将创建一些群集范围的对象,比如命名为 regressuserN的用户身份。

30.1.3. 额外的测试套件

make checkmake installcheck 命令只运行"核心"回归测试,它测试PostgreSQL 服务器的内建功能。源代码分布也包含额外的测试套件, 它们中的大多数必须和附加功能比如可选的过程语言一起工作。

要在已经选择了要建立的模块上运行所有测试套件应用,包括内核测试, 在建立树的顶部输入下列命令之一:

make check-world
make installcheck-world

这些命令分别使用临时服务器或者一个已经安装的服务器运行测试, 就像之前解释的make checkmake installcheck。 其他注意事项和之前解释的每个方法相同。请注意,make check-world 为每个测试的模块建立一个单独的临时安装树,所以它比 make installcheck-world需要更多的时间和磁盘空间。

可选择的,你可以在建立树的适当子目录下输入make checkmake installcheck运行单独的测试套件。记住, make installcheck假设你已经安装了相关的模块, 不只是内核服务器。

可以通过这种方式调用的额外测试包括:

当使用installcheck模式时,这些测试将毁坏任何名为 pl_regressioncontrib_regressionisolationtestregress1connectdb, 还有regression的现有数据库,

30.1.4. 区域和编码

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

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

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

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

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

make check LANG=C ENCODING=EUC_JP

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

可以为临时或现有安装测试设置数据库编码,尽管在后一种情况下它必须和安装的环境兼容。

30.1.5. 额外的测试

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

make check EXTRA_TESTS=numeric_big

运行排序测试:

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

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

30.1.6. 测试热备份

源码分布也包含对热备份的静态行为的回归测试。 这些测试需要运行中的主服务器和运行中的备用服务器, 备用服务器接受来自主服务器的新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

允许这些修改传递到备用服务器。

现在为缺省数据库连接成为测试下的备用服务器做安排(例如, 通过设置PGHOSTPGPORT环境变量)。 最后,在回归路径下运行make standbycheck

cd src/test/regress
make standbycheck

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