PostgreSQL回归测试--自定义测试脚本

本文主要介绍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