30.1. 运行测试 · PostgreSQL 中文文档 9.3

# 30.1\. 运行测试回归测试可以对一套已经安装好并且在运行中的服务器进行测试，也可以对编译树里面即将安装的服务器进行测试。详细些说，有"并行" 和"串行"运行测试之分。串行模式顺序运行每个测试，而并行模式启动多个服务器进程，并发地运行一组测试。并发测试使我们对进程内部通讯和锁的正确工作有足够的信心。 ## 30.1.1\. 对临时安装运行测试编译之后和安装之前运行回归测试，你可以在顶级目录运行(或者进入 `src/test/regress`子目录然后在那里运行)： ``` gmake check ``` 这样将先编译几个辅助文件，比如一些用户定义的触发器函数，然后再运行测试驱动脚本。最后你会看到类似下面的东西： ``` <samp class="literal">======================= All 115 tests passed. =======================</samp> ``` 或者是一些关于某项测试失败的信息。先看看[Section 30.2](#calibre_link-1300) 然后再想想一个"失败"是否代表严重的错误。因为这个测试方法运行临时的服务器，所以如果你是 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](#calibre_link-1156)))运行测试，像as explained in [Chapter 17](#calibre_link-635), 描述的那样初始化一个数据区并启动服务器，然后键入： ``` 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编码时运行。