diff --git a/doc/src/sgml/ref/create_policy.sgml b/doc/src/sgml/ref/create_policy.sgml index cf464cb51f1..646b08d51b5 100644 --- a/doc/src/sgml/ref/create_policy.sgml +++ b/doc/src/sgml/ref/create_policy.sgml @@ -158,7 +158,8 @@ CREATE POLICY name ON SQL conditional expression (returning boolean). The conditional expression cannot contain any aggregate or window functions. This expression will be added - to queries to filter out the records which are visible to the query. + to queries that refer to the table if row level security is enabled, + and will allow access to rows matching the expression. @@ -168,11 +169,12 @@ CREATE POLICY name ON Any SQL conditional expression (returning - boolean). The condition expression cannot contain - any aggregate or window functions. This expression will be added - to queries which are attempting to add records to the table as - with-check options, and an error will be thrown if this condition - returns false for any records being added. + boolean). The conditional expression cannot contain + any aggregate or window functions. This expression will be used with + INSERT and UPDATE queries against + the table if row level security is enabled and an error will be thrown + if the expression evaluates to false for any of the records inserted + or any of the records which result from the update.