postgresql/src/test/modules/test_rls_hooks
Tom Lane 18555b1323 Establish conventions about global object names used in regression tests.
To ensure that "make installcheck" can be used safely against an existing
installation, we need to be careful about what global object names
(database, role, and tablespace names) we use; otherwise we might
accidentally clobber important objects.  There's been a weak consensus that
test databases should have names including "regression", and that test role
names should start with "regress_", but we didn't have any particular rule
about tablespace names; and neither of the other rules was followed with
any consistency either.

This commit moves us a long way towards having a hard-and-fast rule that
regression test databases must have names including "regression", and that
test role and tablespace names must start with "regress_".  It's not
completely there because I did not touch some test cases in rolenames.sql
that test creation of special role names like "session_user".  That will
require some rethinking of exactly what we want to test, whereas the intent
of this patch is just to hit all the cases in which the needed renamings
are cosmetic.

There is no enforcement mechanism in this patch either, but if we don't
add one we can expect that the tests will soon be violating the convention
again.  Again, that's not such a cosmetic change and it will require
discussion.  (But I did use a quick-hack enforcement patch to find these
cases.)

Discussion: <16638.1468620817@sss.pgh.pa.us>
2016-07-17 18:42:43 -04:00
..
expected Establish conventions about global object names used in regression tests. 2016-07-17 18:42:43 -04:00
sql Establish conventions about global object names used in regression tests. 2016-07-17 18:42:43 -04:00
.gitignore RLS fixes, new hooks, and new test module 2015-04-22 12:01:06 -04:00
Makefile RLS fixes, new hooks, and new test module 2015-04-22 12:01:06 -04:00
README RLS fixes, new hooks, and new test module 2015-04-22 12:01:06 -04:00
rls_hooks.conf RLS fixes, new hooks, and new test module 2015-04-22 12:01:06 -04:00
test_rls_hooks.c Update copyright for 2016 2016-01-02 14:19:48 -05:00
test_rls_hooks.control RLS fixes, new hooks, and new test module 2015-04-22 12:01:06 -04:00
test_rls_hooks.h Update copyright for 2016 2016-01-02 14:19:48 -05:00

test_rls_hooks is an example of how to use the hooks provided for RLS to
define additional policies to be used.

Functions
=========
test_rls_hook_permissive(CmdType cmdtype, Relation relation)
    RETURNS List*

Returns a list of policies which should be added to any existing
policies on the relation, combined with OR.

test_rls_hook_restrictive(CmdType cmdtype, Relation relation)
    RETURNS List*

Returns a list of policies which should be added to any existing
policies on the relation, combined with AND.