本文主要介绍PostgreSQL回归测试自定义测试脚本的方法。
文件格式
先介绍需要用到的几个文件：
调度文件
· parallel_schedule
· serial_schedule
这两种文件的格式包括空格行，以“#”开头的行，以“test:”开头的行，以“ignore:”开头的行。其中，以“#”开头的行一般是注释；以“test:”开头的行定义了需要运行的测试用例；以“ignore:”开头的行，pg_regress仍然会去执行这些用例，但是如果有错误的话会被忽略。
以“ignore:”开头的行，一行只能定义一个用例；而已“test:”开头的行，一行最多定义20个用例，不同用例名之间以空格隔开。如果我们在“test:”行中指定了多个用例，那么这些测试将以并行模式(parallel_schedule)运行，如果只有一个用例，那么它将以串行模式(serial_schedule)运行。当我们用“make check”命令的时候，调度的是parallel_schedule文件，而“make installcheck”调度的是serial_schedule文件。
新增一个回归测试的时候，需要分别在parallel_schedule和serial_schedule中都加上该测试的名字。
回归测试的SQL代码和预期输出
· sql/
该目录中包含了回归测试要运行的一些sql脚本，回归测试把每一个文件都当做一个独立的测试项，所以通常我们一个sql文件只测试一种特性。
· excepted/
该目录包含了所有回归测试的期望输出文件*.out，这些文件不仅包含了查询语句的输出结果，还包含了上述提到的sql文件的所有内容（包括注释）。
· results/
该目录中起初是没有任何文件的，当我们运行完回归测试之后，才会生成一批*.out文件。
Tips：当添加新的测试用例时，也可以copy这里的文件放到excepted/目录下。
样例
下面是自定义一个回归测试的具体例子。
· sql/simple.sql
下面这个脚本是将要被运行的回归测试。
--
-- A simple brain-dead test to show how one is written
--
-- Create a table
CREATE TABLE simple_test (a integer, b text);
-- Add a couple of rows
COPY simple_test FROM stdin;
1 foo
2 bar
3 baz
4 floob
\.
-- Select it back out in reverse order
SELECT * FROM simple_test ORDER BY a DESC;
-- remove a row
DELETE FROM simple_test WHERE length(b) > 3;
-- Select again
SELECT * FROM simple_test ORDER BY a DESC;
-- Clean up
DROP TABLE simple_test;
· expected/simple.out
该文件是上面回归测试脚本的期望输出。
--
-- A simple brain-dead test to show how one is written
--
-- Create a table
CREATE TABLE simple_test (a integer, b text);
-- Add a couple of rows
COPY simple_test FROM stdin;
-- Select it back out in reverse order
SELECT * FROM simple_test ORDER BY a DESC;
a | b
---+-------
4 | floob
3 | baz
2 | bar
1 | foo
(4 rows)
-- remove a row
DELETE FROM simple_test WHERE length(b) > 3;
-- Select again
SELECT * FROM simple_test ORDER BY a DESC;
a | b
---+-----
3 | baz
2 | bar
1 | foo
(3 rows)
-- Clean up
DROP TABLE simple_test;
· parallel_schedule
这个命名为“simple”的测试需要加到调度里面才能真的被运行。理论上来说，加在任何地方都是可以的，我们可以找到跟该测试同类型的地方，或者开头字母一样的地方，然后把这个新增的测试名字加进去。
# ----------
# Another group of parallel tests
# ----------
#test: union case join random delete namespace privileges
test: union case join random delete simple namespace privileges
# ----------
# Another group of parallel tests
serial_schedule
make installcheck将会用到该调度。一般来说，为了方便维护，最好跟parallel_schedule的存放顺序一致，如下：
# src/test/regress/serial_schedule
# This should probably be in an order similar to parallel_schedule.
test: union
test: case
test: join
test: random
test: delete
test: simple
test: namespace
test: privileges
