PostgreSQL 9.4.4 中文手册 | |||
---|---|---|---|
上一页 | 上一级 | 章 30. 回归测试 | 下一页 |
回归测试可以对一套已经安装好并且在运行中的服务器进行测试, 也可以对编译树里面即将安装的服务器进行测试。详细些说,有"并行" 和"串行"运行测试之分。串行模式顺序运行每个测试,而并行模式启动多个服务器进程, 并发地运行一组测试。并发测试增加了我们对进程内部通讯和锁的正确工作的信心。
编译之后和安装之前运行回归测试,你可以在顶级目录运行(或者进入 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 个并发进程。
安装后(参见第 15 章)运行测试, 像第 17 章 描述的那样初始化一个数据区并启动服务器,然后键入:
make installcheck
或者是运行一个并发测试:
make installcheck-parallel
该测试将与在本地主机和缺省端口号上运行的服务器进行连接,除非你用PGHOST 和PGPORT环境变量设置为其它值。该测试将在一个名为 regression的数据库中运行;任何现有的以此命名的数据库都将被删除。 该测试暂时还将创建一些群集范围的对象,比如命名为 regressuserN的用户身份。
make check和make installcheck 命令只运行"核心"回归测试,它测试PostgreSQL 服务器的内建功能。源代码分布也包含额外的测试套件, 它们中的大多数必须和附加功能比如可选的过程语言一起工作。
要在已经选择了要建立的模块上运行所有测试套件应用,包括内核测试, 在建立树的顶部输入下列命令之一:
make check-world make installcheck-world
这些命令分别使用临时服务器或者一个已经安装的服务器运行测试, 就像之前解释的make check和make installcheck。 其他注意事项和之前解释的每个方法相同。请注意,make check-world 为每个测试的模块建立一个单独的临时安装树,所以它比 make installcheck-world需要更多的时间和磁盘空间。
可选择的,你可以在建立树的适当子目录下输入make check或 make installcheck运行单独的测试套件。记住, make installcheck假设你已经安装了相关的模块, 不只是内核服务器。
可以通过这种方式调用的额外测试包括:
可选的过程语言的回归测试(除了PL/pgSQL, 它是通过内核测试测试的)。它们位于src/pl。
contrib模块的回归测试,位于contrib下面。 并不是所有的contrib模块都要测试。
ECPG接口库的回归测试,位于src/interfaces/ecpg/test。
测试并发会话的压力行为,位于src/test/isolation。
在src/bin下面测试客户端程序。又见 第 30.4 节。
当使用installcheck模式时,这些测试将毁坏任何名为 pl_regression、contrib_regression、 isolationtest、regress1或connectdb, 还有regression的现有数据库,
默认的,使用临时安装的测试使用在当前环境中定义的区域并且由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的情况下有用;否则编码自动从区域中选择, 并且指定不匹配区域的编码将会导致错误。
可以为临时或现有安装测试设置数据库编码,尽管在后一种情况下它必须和安装的环境兼容。
内核回归测试包含的一些测试文件默认是不运行的,因为它们可能是依赖于平台的或运行需要很长的时间。 你可以通过设置变量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编码时运行。
源码分布也包含对热备份的静态行为的回归测试。 这些测试需要运行中的主服务器和运行中的备用服务器, 备用服务器接受来自主服务器的新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
允许这些修改传递到备用服务器。
现在为缺省数据库连接成为测试下的备用服务器做安排(例如, 通过设置PGHOST和PGPORT环境变量)。 最后,在回归路径下运行make standbycheck:
cd src/test/regress make standbycheck
一些极端行为也会在主服务器上产生,使用脚本 src/test/regress/sql/hs_primary_extremes.sql 允许测试备用服务器的行为。