运行测试

PostgreSQL 9.4.4 中文手册
上一页 | 上一级 | 章 30. 回归测试 | 下一页

# 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

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

## 30.1.3. 额外的测试套件

`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`的现有数据库，

## 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

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

现在为缺省数据库连接成为测试下的备用服务器做安排（例如， 通过设置`PGHOST`和`PGPORT`环境变量）。 最后，在回归路径下运行`make standbycheck`：

    cd src/test/regress
    make standbycheck

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

上一页 | 起始页 | 下一页
回归测试 | 上一级 | 测试评估