一些正确安装的并且全功能的PostgreSQL安装可能会在这些回归测试中的某些上“失败”,其原因是平台相关的因素,例如可变浮点表示和 message wording。这些测试目前采用diff
命令来比较测试输出和在参考系统上产生的输出,这样测试的结果对小的系统差异也很敏感。当一个测试被报告为“失败”时,请总是检查实际结果和期望结果之间的差异,你可能会发现该差异其实并不明显。不管怎样,我们将努力维护在所有被支持平台上的准确的参考文件,以期待所有的测试都能通过。
回归测试的实际输出在src/test/regress/results
目录中的文件内。测试脚本会使用diff
来把每一个输出文件与存储在src/test/regress/expected
目录中的参考输出进行比较。任何差异都被保存在src/test/regress/regression.diffs
中便于你的观察(当运行一个除核心测试之外的测试套件时,这些文件当然会出现在相关子目录中,而不是src/test/regress
)。
如果你不喜欢被默认使用的diff
选项,请设置环境变量PG_REGRESS_DIFF_OPTS
,例如PG_REGRESS_DIFF_OPTS='-u'
(或者如果你愿意,你可以自己运行diff
)。
如果由于某种原因一个特定的平台对一个给定测试产生了“失败”,而对输出的检查却说明该结果是合法的,你可以增加一个新的比较文件来让失败报告在未来的测试运行中保持沉默。详见第 32.3 节。
某些回归测试涉及到故意的非法输入值。错误消息可能来自PostgreSQL代码或主机平台系统例程。在后一种情况中,消息会随着平台而变化,但是会反映相似的信息。这些消息中的差异将导致一次“失败的”回归测试,这可以通过检查来确认。
如果你在一台使用除 C 之外的排序规则顺序区域初始化的服务器上运行测试,那么可能会出现由于排序顺序和后续失败产生的差异。回归测试套件被设置为可以处理这种问题,方法是提供替代的结果文件来处理大量的区域。
要在使用临时安装方法时在一种不同的区域中运行测试,可在make
命令行上传递适当的区域相关的环境变量,例如:
make check LANG=de_DE.utf8
(回归测试驱动器会取消LC_ALL
设置,因此使用这个变量选择区域是不起作用的)。要不使用区域,要么取消所有区域相关的环境变量设置(或把它们设置为C
),要么使用下列特殊调用:
make check NO_LOCALE=1
当对一个现有安装运行测试时,区域设置由现有安装决定。要改变它,通过向initdb
传递合适的选项来使用不同的区域初始化数据库集簇。
通常,我们建议对将要在生产环境中使用的区域设置运行回归测试,因为这样可以测试即将真正被用在生产环境中的与区域和编码相关的代码。根据 操作系统环境,你可能会得到失败,但是那样你将至少知道在真实应用运行时会得到什么样的与区域相关的行为。
大部分的日期和时间结果依赖于时区环境。参考文件是用时区PST8PDT
(伯克利,加利福利亚)生成的,并且如果测试不是运行在该时区设置中显然会出现失败。回归测试驱动器会设置环境变量PGTZ
为 PST8PDT
,这通常能保证正确的结果。
某些测试涉及到从表列中计算 64 位浮点数(双精度
)。我们已经发现了涉及到双精度
列的数学函数的结果中的差异。float8
和geometry
测试容易在不同平台之间产生小的差异,甚至对不同的编译器优化设置也可能产生差异。这些差异通常位于小数点右边的 10 个位置,决定这些差异的实际意义需要人类眼球比较。
某些系统显示负零为-0
,而其他的只显示0
。
某些系统标志来自pow()
和exp()
的错误的机制不同于当前PostgreSQL代码所期望的机制。
你可能看到这样一些差异:一组相同的行在输出中的顺序与参考文件中的顺序不同。严格来说,在大部分情况下这不是缺陷。大部分回归测试脚本没有为每一个单独的SELECT
使用一个ORDER BY
,并且因此它们的结果行顺序根据 SQL 规范是非良定义的。实际上,因为我们考虑的是由相同的软件在相同的数据上执行相同的查询,我们通常会在所有平台上得到相同的结果顺序,所以缺少ORDER BY
不是一个问题。但是,某些查询确实会在不同平台上产生不同的顺序。当对一个已经安装的服务器运行测试时,顺序差异可能由非 C 区域设置或非默认参数设置导致,例如work_mem
的自定义值或规划器代价参数。
因此,如果你看到一个顺序差异,没有什么可担心的,除非结果被未被的查询确实有一个ORDER BY
。但是,不管怎样请报告它,这样我们可以为特定的查询加上一个ORDER BY
来在未来的发布中消除虚假的“失败”。
你可能好奇为什么我们不对所有回归测试查询进行显式排序来一次性解决这个问题。其原因是那可能会降低回归测试的有用性,因为它们已经倾向于测试产生有序结果的查询计划类型而排除了那些无法产生有序结果的计划类型。
如果错误
测试导致了在select infinite_recurse()
命令上的一次服务器崩溃,它意味着平台对进程栈尺寸的限制低于max_stack_depth参数所指定的值。这可以通过在一个更高的栈尺寸限制(对max_stack_depth
的默认值,我们推荐 4 MB)下运行该服务器来修复。如果你不能这样做,一种可替代的方案是减小max_stack_depth
的值。
在支持getrlimit()
的平台上,服务器应该自动选择一个max_stack_depth
的安全值。所以除非你已经手工覆盖了该设置,这类失败就是一个可报告的缺陷。
失败
测试脚本用来产生随机结果。在非常少见的情况下,这会导致回归测试失败。输入:
diff results/random.out expected/random.out
应当产生一行或少数几行差异。你不需要担心,除非随机测试重复地失败。
当对一个现有安装运行测试时,某些非默认参数设置可能导致测试失败。例如,改变enable_seqscan
或enable_indexscan
等参数可能导致计划改变,然后影响使用EXPLAIN
的测试的结果。