PostgreSQL Source Code  git master
rewriteDefine.h File Reference
Include dependency graph for rewriteDefine.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros

#define RULE_FIRES_ON_ORIGIN   'O'
 
#define RULE_FIRES_ALWAYS   'A'
 
#define RULE_FIRES_ON_REPLICA   'R'
 
#define RULE_DISABLED   'D'
 

Functions

ObjectAddress DefineRule (RuleStmt *stmt, const char *queryString)
 
ObjectAddress DefineQueryRewrite (const char *rulename, Oid event_relid, Node *event_qual, CmdType event_type, bool is_instead, bool replace, List *action)
 
ObjectAddress RenameRewriteRule (RangeVar *relation, const char *oldName, const char *newName)
 
void setRuleCheckAsUser (Node *node, Oid userid)
 
void EnableDisableRule (Relation rel, const char *rulename, char fires_when)
 

Macro Definition Documentation

◆ RULE_DISABLED

#define RULE_DISABLED   'D'

Definition at line 24 of file rewriteDefine.h.

Referenced by ATExecCmd(), and matchLocks().

◆ RULE_FIRES_ALWAYS

#define RULE_FIRES_ALWAYS   'A'

Definition at line 22 of file rewriteDefine.h.

Referenced by ATExecCmd().

◆ RULE_FIRES_ON_ORIGIN

#define RULE_FIRES_ON_ORIGIN   'O'

Definition at line 21 of file rewriteDefine.h.

Referenced by ATExecCmd(), InsertRule(), and matchLocks().

◆ RULE_FIRES_ON_REPLICA

#define RULE_FIRES_ON_REPLICA   'R'

Definition at line 23 of file rewriteDefine.h.

Referenced by ATExecCmd(), and matchLocks().

Function Documentation

◆ DefineQueryRewrite()

ObjectAddress DefineQueryRewrite ( const char *  rulename,
Oid  event_relid,
Node event_qual,
CmdType  event_type,
bool  is_instead,
bool  replace,
List action 
)

Definition at line 233 of file rewriteDefine.c.

References AccessExclusiveLock, aclcheck_error(), ACLCHECK_NOT_OWNER, allowSystemTableMods, Assert, CatalogTupleUpdate(), checkRuleResultList(), ObjectAddress::classId, CMD_SELECT, CommandCounterIncrement(), Query::commandType, deleteDependencyRecordsFor(), DeleteSystemAttributeTuples(), DROP_RESTRICT, elog, ereport, errcode(), errdetail_relkind_not_supported(), errhint(), errmsg(), ERROR, RewriteRule::event, ExecDropSingleTupleTableSlot(), ForwardScanDirection, get_relkind_objtype(), getInsertSelectQuery(), GetLatestSnapshot(), GETSTRUCT, GetUserId(), has_superclass(), Query::hasModifyingCTE, heap_freetuple(), HeapTupleIsValid, i, InsertRule(), InvalidMultiXactId, InvalidOid, InvalidTransactionId, IsSystemRelation(), lfirst_node, linitial_node, list_length(), NAMEDATALEN, NIL, NoLock, RuleLock::numLocks, ObjectAddressSet, ObjectAddress::objectId, ObjectIdGetDatum, ObjectAddress::objectSubId, OidIsValid, PERFORM_DELETION_INTERNAL, performDeletion(), pg_class_ownercheck(), PRS2_NEW_VARNO, PRS2_OLD_VARNO, pstrdup(), RelationData::rd_rel, RelationData::rd_rules, RegisterSnapshot(), relation_has_policies(), RelationDropStorage(), RelationGetDescr, RelationGetRelationName, RelationGetRelid, RELOID, Query::resultRelation, Query::returningList, RowExclusiveLock, RuleLock::rules, SearchSysCacheCopy1, SetRelationRuleStatus(), HeapTupleData::t_self, table_beginscan(), table_close(), table_endscan(), table_open(), table_scan_getnextslot(), table_slot_create(), Query::targetList, UnregisterSnapshot(), and ViewSelectRuleName.

Referenced by DefineRule(), and DefineViewRules().

240 {
241  Relation event_relation;
242  ListCell *l;
243  Query *query;
244  bool RelisBecomingView = false;
245  Oid ruleId = InvalidOid;
246  ObjectAddress address;
247 
248  /*
249  * If we are installing an ON SELECT rule, we had better grab
250  * AccessExclusiveLock to ensure no SELECTs are currently running on the
251  * event relation. For other types of rules, it would be sufficient to
252  * grab ShareRowExclusiveLock to lock out insert/update/delete actions and
253  * to ensure that we lock out current CREATE RULE statements; but because
254  * of race conditions in access to catalog entries, we can't do that yet.
255  *
256  * Note that this lock level should match the one used in DefineRule.
257  */
258  event_relation = table_open(event_relid, AccessExclusiveLock);
259 
260  /*
261  * Verify relation is of a type that rules can sensibly be applied to.
262  * Internal callers can target materialized views, but transformRuleStmt()
263  * blocks them for users. Don't mention them in the error message.
264  */
265  if (event_relation->rd_rel->relkind != RELKIND_RELATION &&
266  event_relation->rd_rel->relkind != RELKIND_MATVIEW &&
267  event_relation->rd_rel->relkind != RELKIND_VIEW &&
268  event_relation->rd_rel->relkind != RELKIND_PARTITIONED_TABLE)
269  ereport(ERROR,
270  (errcode(ERRCODE_WRONG_OBJECT_TYPE),
271  errmsg("relation \"%s\" cannot have rules",
272  RelationGetRelationName(event_relation)),
273  errdetail_relkind_not_supported(event_relation->rd_rel->relkind)));
274 
275  if (!allowSystemTableMods && IsSystemRelation(event_relation))
276  ereport(ERROR,
277  (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
278  errmsg("permission denied: \"%s\" is a system catalog",
279  RelationGetRelationName(event_relation))));
280 
281  /*
282  * Check user has permission to apply rules to this relation.
283  */
284  if (!pg_class_ownercheck(event_relid, GetUserId()))
285  aclcheck_error(ACLCHECK_NOT_OWNER, get_relkind_objtype(event_relation->rd_rel->relkind),
286  RelationGetRelationName(event_relation));
287 
288  /*
289  * No rule actions that modify OLD or NEW
290  */
291  foreach(l, action)
292  {
293  query = lfirst_node(Query, l);
294  if (query->resultRelation == 0)
295  continue;
296  /* Don't be fooled by INSERT/SELECT */
297  if (query != getInsertSelectQuery(query, NULL))
298  continue;
299  if (query->resultRelation == PRS2_OLD_VARNO)
300  ereport(ERROR,
301  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
302  errmsg("rule actions on OLD are not implemented"),
303  errhint("Use views or triggers instead.")));
304  if (query->resultRelation == PRS2_NEW_VARNO)
305  ereport(ERROR,
306  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
307  errmsg("rule actions on NEW are not implemented"),
308  errhint("Use triggers instead.")));
309  }
310 
311  if (event_type == CMD_SELECT)
312  {
313  /*
314  * Rules ON SELECT are restricted to view definitions
315  *
316  * So there cannot be INSTEAD NOTHING, ...
317  */
318  if (list_length(action) == 0)
319  ereport(ERROR,
320  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
321  errmsg("INSTEAD NOTHING rules on SELECT are not implemented"),
322  errhint("Use views instead.")));
323 
324  /*
325  * ... there cannot be multiple actions, ...
326  */
327  if (list_length(action) > 1)
328  ereport(ERROR,
329  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
330  errmsg("multiple actions for rules on SELECT are not implemented")));
331 
332  /*
333  * ... the one action must be a SELECT, ...
334  */
335  query = linitial_node(Query, action);
336  if (!is_instead ||
337  query->commandType != CMD_SELECT)
338  ereport(ERROR,
339  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
340  errmsg("rules on SELECT must have action INSTEAD SELECT")));
341 
342  /*
343  * ... it cannot contain data-modifying WITH ...
344  */
345  if (query->hasModifyingCTE)
346  ereport(ERROR,
347  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
348  errmsg("rules on SELECT must not contain data-modifying statements in WITH")));
349 
350  /*
351  * ... there can be no rule qual, ...
352  */
353  if (event_qual != NULL)
354  ereport(ERROR,
355  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
356  errmsg("event qualifications are not implemented for rules on SELECT")));
357 
358  /*
359  * ... the targetlist of the SELECT action must exactly match the
360  * event relation, ...
361  */
363  RelationGetDescr(event_relation),
364  true,
365  event_relation->rd_rel->relkind !=
366  RELKIND_MATVIEW);
367 
368  /*
369  * ... there must not be another ON SELECT rule already ...
370  */
371  if (!replace && event_relation->rd_rules != NULL)
372  {
373  int i;
374 
375  for (i = 0; i < event_relation->rd_rules->numLocks; i++)
376  {
377  RewriteRule *rule;
378 
379  rule = event_relation->rd_rules->rules[i];
380  if (rule->event == CMD_SELECT)
381  ereport(ERROR,
382  (errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
383  errmsg("\"%s\" is already a view",
384  RelationGetRelationName(event_relation))));
385  }
386  }
387 
388  /*
389  * ... and finally the rule must be named _RETURN.
390  */
391  if (strcmp(rulename, ViewSelectRuleName) != 0)
392  {
393  /*
394  * In versions before 7.3, the expected name was _RETviewname. For
395  * backwards compatibility with old pg_dump output, accept that
396  * and silently change it to _RETURN. Since this is just a quick
397  * backwards-compatibility hack, limit the number of characters
398  * checked to a few less than NAMEDATALEN; this saves having to
399  * worry about where a multibyte character might have gotten
400  * truncated.
401  */
402  if (strncmp(rulename, "_RET", 4) != 0 ||
403  strncmp(rulename + 4, RelationGetRelationName(event_relation),
404  NAMEDATALEN - 4 - 4) != 0)
405  ereport(ERROR,
406  (errcode(ERRCODE_INVALID_OBJECT_DEFINITION),
407  errmsg("view rule for \"%s\" must be named \"%s\"",
408  RelationGetRelationName(event_relation),
410  rulename = pstrdup(ViewSelectRuleName);
411  }
412 
413  /*
414  * Are we converting a relation to a view?
415  *
416  * If so, check that the relation is empty because the storage for the
417  * relation is going to be deleted. Also insist that the rel not be
418  * involved in partitioning, nor have any triggers, indexes, child or
419  * parent tables, RLS policies, or RLS enabled. (Note: some of these
420  * tests are too strict, because they will reject relations that once
421  * had such but don't anymore. But we don't really care, because this
422  * whole business of converting relations to views is just an obsolete
423  * kluge to allow dump/reload of views that participate in circular
424  * dependencies.)
425  */
426  if (event_relation->rd_rel->relkind != RELKIND_VIEW &&
427  event_relation->rd_rel->relkind != RELKIND_MATVIEW)
428  {
429  TableScanDesc scanDesc;
430  Snapshot snapshot;
431  TupleTableSlot *slot;
432 
433  if (event_relation->rd_rel->relkind == RELKIND_PARTITIONED_TABLE)
434  ereport(ERROR,
435  (errcode(ERRCODE_WRONG_OBJECT_TYPE),
436  errmsg("cannot convert partitioned table \"%s\" to a view",
437  RelationGetRelationName(event_relation))));
438 
439  /* only case left: */
440  Assert(event_relation->rd_rel->relkind == RELKIND_RELATION);
441 
442  if (event_relation->rd_rel->relispartition)
443  ereport(ERROR,
444  (errcode(ERRCODE_WRONG_OBJECT_TYPE),
445  errmsg("cannot convert partition \"%s\" to a view",
446  RelationGetRelationName(event_relation))));
447 
448  snapshot = RegisterSnapshot(GetLatestSnapshot());
449  scanDesc = table_beginscan(event_relation, snapshot, 0, NULL);
450  slot = table_slot_create(event_relation, NULL);
451  if (table_scan_getnextslot(scanDesc, ForwardScanDirection, slot))
452  ereport(ERROR,
453  (errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
454  errmsg("could not convert table \"%s\" to a view because it is not empty",
455  RelationGetRelationName(event_relation))));
457  table_endscan(scanDesc);
458  UnregisterSnapshot(snapshot);
459 
460  if (event_relation->rd_rel->relhastriggers)
461  ereport(ERROR,
462  (errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
463  errmsg("could not convert table \"%s\" to a view because it has triggers",
464  RelationGetRelationName(event_relation)),
465  errhint("In particular, the table cannot be involved in any foreign key relationships.")));
466 
467  if (event_relation->rd_rel->relhasindex)
468  ereport(ERROR,
469  (errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
470  errmsg("could not convert table \"%s\" to a view because it has indexes",
471  RelationGetRelationName(event_relation))));
472 
473  if (event_relation->rd_rel->relhassubclass)
474  ereport(ERROR,
475  (errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
476  errmsg("could not convert table \"%s\" to a view because it has child tables",
477  RelationGetRelationName(event_relation))));
478 
479  if (has_superclass(RelationGetRelid(event_relation)))
480  ereport(ERROR,
481  (errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
482  errmsg("could not convert table \"%s\" to a view because it has parent tables",
483  RelationGetRelationName(event_relation))));
484 
485  if (event_relation->rd_rel->relrowsecurity)
486  ereport(ERROR,
487  (errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
488  errmsg("could not convert table \"%s\" to a view because it has row security enabled",
489  RelationGetRelationName(event_relation))));
490 
491  if (relation_has_policies(event_relation))
492  ereport(ERROR,
493  (errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
494  errmsg("could not convert table \"%s\" to a view because it has row security policies",
495  RelationGetRelationName(event_relation))));
496 
497  RelisBecomingView = true;
498  }
499  }
500  else
501  {
502  /*
503  * For non-SELECT rules, a RETURNING list can appear in at most one of
504  * the actions ... and there can't be any RETURNING list at all in a
505  * conditional or non-INSTEAD rule. (Actually, there can be at most
506  * one RETURNING list across all rules on the same event, but it seems
507  * best to enforce that at rule expansion time.) If there is a
508  * RETURNING list, it must match the event relation.
509  */
510  bool haveReturning = false;
511 
512  foreach(l, action)
513  {
514  query = lfirst_node(Query, l);
515 
516  if (!query->returningList)
517  continue;
518  if (haveReturning)
519  ereport(ERROR,
520  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
521  errmsg("cannot have multiple RETURNING lists in a rule")));
522  haveReturning = true;
523  if (event_qual != NULL)
524  ereport(ERROR,
525  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
526  errmsg("RETURNING lists are not supported in conditional rules")));
527  if (!is_instead)
528  ereport(ERROR,
529  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
530  errmsg("RETURNING lists are not supported in non-INSTEAD rules")));
532  RelationGetDescr(event_relation),
533  false, false);
534  }
535  }
536 
537  /*
538  * This rule is allowed - prepare to install it.
539  */
540 
541  /* discard rule if it's null action and not INSTEAD; it's a no-op */
542  if (action != NIL || is_instead)
543  {
544  ruleId = InsertRule(rulename,
545  event_type,
546  event_relid,
547  is_instead,
548  event_qual,
549  action,
550  replace);
551 
552  /*
553  * Set pg_class 'relhasrules' field true for event relation.
554  *
555  * Important side effect: an SI notice is broadcast to force all
556  * backends (including me!) to update relcache entries with the new
557  * rule.
558  */
559  SetRelationRuleStatus(event_relid, true);
560  }
561 
562  /* ---------------------------------------------------------------------
563  * If the relation is becoming a view:
564  * - delete the associated storage files
565  * - get rid of any system attributes in pg_attribute; a view shouldn't
566  * have any of those
567  * - remove the toast table; there is no need for it anymore, and its
568  * presence would make vacuum slightly more complicated
569  * - set relkind to RELKIND_VIEW, and adjust other pg_class fields
570  * to be appropriate for a view
571  *
572  * NB: we had better have AccessExclusiveLock to do this ...
573  * ---------------------------------------------------------------------
574  */
575  if (RelisBecomingView)
576  {
577  Relation relationRelation;
578  Oid toastrelid;
579  HeapTuple classTup;
580  Form_pg_class classForm;
581 
582  relationRelation = table_open(RelationRelationId, RowExclusiveLock);
583  toastrelid = event_relation->rd_rel->reltoastrelid;
584 
585  /* drop storage while table still looks like a table */
586  RelationDropStorage(event_relation);
587  DeleteSystemAttributeTuples(event_relid);
588 
589  /*
590  * Drop the toast table if any. (This won't take care of updating the
591  * toast fields in the relation's own pg_class entry; we handle that
592  * below.)
593  */
594  if (OidIsValid(toastrelid))
595  {
596  ObjectAddress toastobject;
597 
598  /*
599  * Delete the dependency of the toast relation on the main
600  * relation so we can drop the former without dropping the latter.
601  */
602  deleteDependencyRecordsFor(RelationRelationId, toastrelid,
603  false);
604 
605  /* Make deletion of dependency record visible */
607 
608  /* Now drop toast table, including its index */
609  toastobject.classId = RelationRelationId;
610  toastobject.objectId = toastrelid;
611  toastobject.objectSubId = 0;
612  performDeletion(&toastobject, DROP_RESTRICT,
614  }
615 
616  /*
617  * SetRelationRuleStatus may have updated the pg_class row, so we must
618  * advance the command counter before trying to update it again.
619  */
621 
622  /*
623  * Fix pg_class entry to look like a normal view's, including setting
624  * the correct relkind and removal of reltoastrelid of the toast table
625  * we potentially removed above.
626  */
627  classTup = SearchSysCacheCopy1(RELOID, ObjectIdGetDatum(event_relid));
628  if (!HeapTupleIsValid(classTup))
629  elog(ERROR, "cache lookup failed for relation %u", event_relid);
630  classForm = (Form_pg_class) GETSTRUCT(classTup);
631 
632  classForm->relam = InvalidOid;
633  classForm->reltablespace = InvalidOid;
634  classForm->relpages = 0;
635  classForm->reltuples = -1;
636  classForm->relallvisible = 0;
637  classForm->reltoastrelid = InvalidOid;
638  classForm->relhasindex = false;
639  classForm->relkind = RELKIND_VIEW;
640  classForm->relfrozenxid = InvalidTransactionId;
641  classForm->relminmxid = InvalidMultiXactId;
642  classForm->relreplident = REPLICA_IDENTITY_NOTHING;
643 
644  CatalogTupleUpdate(relationRelation, &classTup->t_self, classTup);
645 
646  heap_freetuple(classTup);
647  table_close(relationRelation, RowExclusiveLock);
648  }
649 
650  ObjectAddressSet(address, RewriteRelationId, ruleId);
651 
652  /* Close rel, but keep lock till commit... */
653  table_close(event_relation, NoLock);
654 
655  return address;
656 }
TupleTableSlot * table_slot_create(Relation relation, List **reglist)
Definition: tableam.c:91
int errdetail_relkind_not_supported(char relkind)
Definition: pg_class.c:24
#define NIL
Definition: pg_list.h:65
Query * getInsertSelectQuery(Query *parsetree, Query ***subquery_ptr)
Definition: rewriteManip.c:924
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:167
int errhint(const char *fmt,...)
Definition: elog.c:1156
#define GETSTRUCT(TUP)
Definition: htup_details.h:654
int numLocks
Definition: prs2lock.h:42
bool IsSystemRelation(Relation relation)
Definition: catalog.c:74
Snapshot RegisterSnapshot(Snapshot snapshot)
Definition: snapmgr.c:810
#define RelationGetDescr(relation)
Definition: rel.h:503
Oid GetUserId(void)
Definition: miscinit.c:495
char * pstrdup(const char *in)
Definition: mcxt.c:1299
int resultRelation
Definition: parsenodes.h:130
long deleteDependencyRecordsFor(Oid classId, Oid objectId, bool skipExtensionDeps)
Definition: pg_depend.c:243
int errcode(int sqlerrcode)
Definition: elog.c:698
static void checkRuleResultList(List *targetList, TupleDesc resultDesc, bool isSelect, bool requireColumnNameMatch)
#define ViewSelectRuleName
static bool table_scan_getnextslot(TableScanDesc sscan, ScanDirection direction, TupleTableSlot *slot)
Definition: tableam.h:1032
Form_pg_class rd_rel
Definition: rel.h:109
void heap_freetuple(HeapTuple htup)
Definition: heaptuple.c:1338
unsigned int Oid
Definition: postgres_ext.h:31
#define linitial_node(type, l)
Definition: pg_list.h:177
#define OidIsValid(objectId)
Definition: c.h:710
void SetRelationRuleStatus(Oid relationId, bool relHasRules)
Definition: localtime.c:72
List * targetList
Definition: parsenodes.h:150
#define NAMEDATALEN
void aclcheck_error(AclResult aclerr, ObjectType objtype, const char *objectname)
Definition: aclchk.c:3308
#define ObjectIdGetDatum(X)
Definition: postgres.h:551
#define ERROR
Definition: elog.h:46
static TableScanDesc table_beginscan(Relation rel, Snapshot snapshot, int nkeys, struct ScanKeyData *key)
Definition: tableam.h:883
ItemPointerData t_self
Definition: htup.h:65
bool has_superclass(Oid relationId)
Definition: pg_inherits.c:378
#define lfirst_node(type, lc)
Definition: pg_list.h:172
#define NoLock
Definition: lockdefs.h:34
void ExecDropSingleTupleTableSlot(TupleTableSlot *slot)
Definition: execTuples.c:1254
#define RowExclusiveLock
Definition: lockdefs.h:38
CmdType event
Definition: prs2lock.h:27
void performDeletion(const ObjectAddress *object, DropBehavior behavior, int flags)
Definition: dependency.c:313
#define InvalidTransactionId
Definition: transam.h:31
#define RelationGetRelationName(relation)
Definition: rel.h:511
RewriteRule ** rules
Definition: prs2lock.h:43
List * returningList
Definition: parsenodes.h:156
void UnregisterSnapshot(Snapshot snapshot)
Definition: snapmgr.c:852
#define PRS2_OLD_VARNO
Definition: primnodes.h:183
void RelationDropStorage(Relation rel)
Definition: storage.c:195
void CommandCounterIncrement(void)
Definition: xact.c:1021
#define InvalidMultiXactId
Definition: multixact.h:24
bool allowSystemTableMods
Definition: globals.c:123
#define InvalidOid
Definition: postgres_ext.h:36
#define ereport(elevel,...)
Definition: elog.h:157
CmdType commandType
Definition: parsenodes.h:120
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
#define Assert(condition)
Definition: c.h:804
bool pg_class_ownercheck(Oid class_oid, Oid roleid)
Definition: aclchk.c:4818
RuleLock * rd_rules
Definition: rel.h:113
void CatalogTupleUpdate(Relation heapRel, ItemPointer otid, HeapTuple tup)
Definition: indexing.c:301
static int list_length(const List *l)
Definition: pg_list.h:149
Snapshot GetLatestSnapshot(void)
Definition: snapmgr.c:325
#define ObjectAddressSet(addr, class_id, object_id)
Definition: objectaddress.h:40
static void table_endscan(TableScanDesc scan)
Definition: tableam.h:991
FormData_pg_class * Form_pg_class
Definition: pg_class.h:153
#define SearchSysCacheCopy1(cacheId, key1)
Definition: syscache.h:175
#define AccessExclusiveLock
Definition: lockdefs.h:45
bool relation_has_policies(Relation rel)
Definition: policy.c:1262
int errmsg(const char *fmt,...)
Definition: elog.c:909
#define elog(elevel,...)
Definition: elog.h:232
static Oid InsertRule(const char *rulname, int evtype, Oid eventrel_oid, bool evinstead, Node *event_qual, List *action, bool replace)
Definition: rewriteDefine.c:59
void DeleteSystemAttributeTuples(Oid relid)
Definition: heap.c:1620
int i
ObjectType get_relkind_objtype(char relkind)
bool hasModifyingCTE
Definition: parsenodes.h:139
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
#define RelationGetRelid(relation)
Definition: rel.h:477
#define PRS2_NEW_VARNO
Definition: primnodes.h:184
#define PERFORM_DELETION_INTERNAL
Definition: dependency.h:133

◆ DefineRule()

ObjectAddress DefineRule ( RuleStmt stmt,
const char *  queryString 
)

Definition at line 199 of file rewriteDefine.c.

References AccessExclusiveLock, DefineQueryRewrite(), RuleStmt::event, RuleStmt::instead, RangeVarGetRelid, RuleStmt::relation, RuleStmt::replace, RuleStmt::rulename, and transformRuleStmt().

Referenced by ProcessUtilitySlow().

200 {
201  List *actions;
202  Node *whereClause;
203  Oid relId;
204 
205  /* Parse analysis. */
206  transformRuleStmt(stmt, queryString, &actions, &whereClause);
207 
208  /*
209  * Find and lock the relation. Lock level should match
210  * DefineQueryRewrite.
211  */
212  relId = RangeVarGetRelid(stmt->relation, AccessExclusiveLock, false);
213 
214  /* ... and execute */
215  return DefineQueryRewrite(stmt->rulename,
216  relId,
217  whereClause,
218  stmt->event,
219  stmt->instead,
220  stmt->replace,
221  actions);
222 }
#define RangeVarGetRelid(relation, lockmode, missing_ok)
Definition: namespace.h:79
Definition: nodes.h:536
unsigned int Oid
Definition: postgres_ext.h:31
bool instead
Definition: parsenodes.h:3140
bool replace
Definition: parsenodes.h:3142
char * rulename
Definition: parsenodes.h:3137
CmdType event
Definition: parsenodes.h:3139
#define AccessExclusiveLock
Definition: lockdefs.h:45
RangeVar * relation
Definition: parsenodes.h:3136
Definition: pg_list.h:50
ObjectAddress DefineQueryRewrite(const char *rulename, Oid event_relid, Node *event_qual, CmdType event_type, bool is_instead, bool replace, List *action)
void transformRuleStmt(RuleStmt *stmt, const char *queryString, List **actions, Node **whereClause)

◆ EnableDisableRule()

void EnableDisableRule ( Relation  rel,
const char *  rulename,
char  fires_when 
)

Definition at line 857 of file rewriteDefine.c.

References aclcheck_error(), ACLCHECK_NOT_OWNER, Assert, CacheInvalidateRelcache(), CatalogTupleUpdate(), CharGetDatum, DatumGetChar, ereport, errcode(), errmsg(), ERROR, get_rel_name(), get_rel_relkind(), get_relkind_objtype(), GETSTRUCT, GetUserId(), heap_freetuple(), HeapTupleIsValid, InvokeObjectPostAlterHook, ObjectIdGetDatum, pg_class_ownercheck(), PointerGetDatum, RelationGetRelid, RowExclusiveLock, RULERELNAME, SearchSysCacheCopy2, HeapTupleData::t_self, table_close(), and table_open().

Referenced by ATExecEnableDisableRule().

859 {
860  Relation pg_rewrite_desc;
861  Oid owningRel = RelationGetRelid(rel);
862  Oid eventRelationOid;
863  HeapTuple ruletup;
864  Form_pg_rewrite ruleform;
865  bool changed = false;
866 
867  /*
868  * Find the rule tuple to change.
869  */
870  pg_rewrite_desc = table_open(RewriteRelationId, RowExclusiveLock);
872  ObjectIdGetDatum(owningRel),
873  PointerGetDatum(rulename));
874  if (!HeapTupleIsValid(ruletup))
875  ereport(ERROR,
876  (errcode(ERRCODE_UNDEFINED_OBJECT),
877  errmsg("rule \"%s\" for relation \"%s\" does not exist",
878  rulename, get_rel_name(owningRel))));
879 
880  ruleform = (Form_pg_rewrite) GETSTRUCT(ruletup);
881 
882  /*
883  * Verify that the user has appropriate permissions.
884  */
885  eventRelationOid = ruleform->ev_class;
886  Assert(eventRelationOid == owningRel);
887  if (!pg_class_ownercheck(eventRelationOid, GetUserId()))
889  get_rel_name(eventRelationOid));
890 
891  /*
892  * Change ev_enabled if it is different from the desired new state.
893  */
894  if (DatumGetChar(ruleform->ev_enabled) !=
895  fires_when)
896  {
897  ruleform->ev_enabled = CharGetDatum(fires_when);
898  CatalogTupleUpdate(pg_rewrite_desc, &ruletup->t_self, ruletup);
899 
900  changed = true;
901  }
902 
903  InvokeObjectPostAlterHook(RewriteRelationId, ruleform->oid, 0);
904 
905  heap_freetuple(ruletup);
906  table_close(pg_rewrite_desc, RowExclusiveLock);
907 
908  /*
909  * If we changed anything, broadcast a SI inval message to force each
910  * backend (including our own!) to rebuild relation's relcache entry.
911  * Otherwise they will fail to apply the change promptly.
912  */
913  if (changed)
915 }
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:167
#define GETSTRUCT(TUP)
Definition: htup_details.h:654
Oid GetUserId(void)
Definition: miscinit.c:495
#define PointerGetDatum(X)
Definition: postgres.h:600
char get_rel_relkind(Oid relid)
Definition: lsyscache.c:1974
int errcode(int sqlerrcode)
Definition: elog.c:698
void heap_freetuple(HeapTuple htup)
Definition: heaptuple.c:1338
unsigned int Oid
Definition: postgres_ext.h:31
void aclcheck_error(AclResult aclerr, ObjectType objtype, const char *objectname)
Definition: aclchk.c:3308
#define ObjectIdGetDatum(X)
Definition: postgres.h:551
#define ERROR
Definition: elog.h:46
ItemPointerData t_self
Definition: htup.h:65
#define RowExclusiveLock
Definition: lockdefs.h:38
#define InvokeObjectPostAlterHook(classId, objectId, subId)
Definition: objectaccess.h:175
#define DatumGetChar(X)
Definition: postgres.h:453
#define ereport(elevel,...)
Definition: elog.h:157
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
#define Assert(condition)
Definition: c.h:804
bool pg_class_ownercheck(Oid class_oid, Oid roleid)
Definition: aclchk.c:4818
void CatalogTupleUpdate(Relation heapRel, ItemPointer otid, HeapTuple tup)
Definition: indexing.c:301
#define CharGetDatum(X)
Definition: postgres.h:460
FormData_pg_rewrite * Form_pg_rewrite
Definition: pg_rewrite.h:52
void CacheInvalidateRelcache(Relation relation)
Definition: inval.c:1342
int errmsg(const char *fmt,...)
Definition: elog.c:909
ObjectType get_relkind_objtype(char relkind)
#define SearchSysCacheCopy2(cacheId, key1, key2)
Definition: syscache.h:177
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
char * get_rel_name(Oid relid)
Definition: lsyscache.c:1899
#define RelationGetRelid(relation)
Definition: rel.h:477

◆ RenameRewriteRule()

ObjectAddress RenameRewriteRule ( RangeVar relation,
const char *  oldName,
const char *  newName 
)

Definition at line 959 of file rewriteDefine.c.

References AccessExclusiveLock, CacheInvalidateRelcache(), CatalogTupleUpdate(), CMD_SELECT, ereport, errcode(), ERRCODE_DUPLICATE_OBJECT, errmsg(), ERROR, GETSTRUCT, heap_freetuple(), HeapTupleIsValid, InvokeObjectPostAlterHook, IsDefinedRewriteRule(), namestrcpy(), NoLock, ObjectAddressSet, ObjectIdGetDatum, PointerGetDatum, RangeVarCallbackForRenameRule(), RangeVarGetRelidExtended(), relation_close(), relation_open(), RelationGetRelationName, RowExclusiveLock, RULERELNAME, SearchSysCacheCopy2, HeapTupleData::t_self, table_close(), and table_open().

Referenced by ExecRenameStmt().

961 {
962  Oid relid;
963  Relation targetrel;
964  Relation pg_rewrite_desc;
965  HeapTuple ruletup;
966  Form_pg_rewrite ruleform;
967  Oid ruleOid;
968  ObjectAddress address;
969 
970  /*
971  * Look up name, check permissions, and acquire lock (which we will NOT
972  * release until end of transaction).
973  */
975  0,
977  NULL);
978 
979  /* Have lock already, so just need to build relcache entry. */
980  targetrel = relation_open(relid, NoLock);
981 
982  /* Prepare to modify pg_rewrite */
983  pg_rewrite_desc = table_open(RewriteRelationId, RowExclusiveLock);
984 
985  /* Fetch the rule's entry (it had better exist) */
987  ObjectIdGetDatum(relid),
988  PointerGetDatum(oldName));
989  if (!HeapTupleIsValid(ruletup))
990  ereport(ERROR,
991  (errcode(ERRCODE_UNDEFINED_OBJECT),
992  errmsg("rule \"%s\" for relation \"%s\" does not exist",
993  oldName, RelationGetRelationName(targetrel))));
994  ruleform = (Form_pg_rewrite) GETSTRUCT(ruletup);
995  ruleOid = ruleform->oid;
996 
997  /* rule with the new name should not already exist */
998  if (IsDefinedRewriteRule(relid, newName))
999  ereport(ERROR,
1001  errmsg("rule \"%s\" for relation \"%s\" already exists",
1002  newName, RelationGetRelationName(targetrel))));
1003 
1004  /*
1005  * We disallow renaming ON SELECT rules, because they should always be
1006  * named "_RETURN".
1007  */
1008  if (ruleform->ev_type == CMD_SELECT + '0')
1009  ereport(ERROR,
1010  (errcode(ERRCODE_INVALID_OBJECT_DEFINITION),
1011  errmsg("renaming an ON SELECT rule is not allowed")));
1012 
1013  /* OK, do the update */
1014  namestrcpy(&(ruleform->rulename), newName);
1015 
1016  CatalogTupleUpdate(pg_rewrite_desc, &ruletup->t_self, ruletup);
1017 
1018  InvokeObjectPostAlterHook(RewriteRelationId, ruleOid, 0);
1019 
1020  heap_freetuple(ruletup);
1021  table_close(pg_rewrite_desc, RowExclusiveLock);
1022 
1023  /*
1024  * Invalidate relation's relcache entry so that other backends (and this
1025  * one too!) are sent SI message to make them rebuild relcache entries.
1026  * (Ideally this should happen automatically...)
1027  */
1028  CacheInvalidateRelcache(targetrel);
1029 
1030  ObjectAddressSet(address, RewriteRelationId, ruleOid);
1031 
1032  /*
1033  * Close rel, but keep exclusive lock!
1034  */
1035  relation_close(targetrel, NoLock);
1036 
1037  return address;
1038 }
bool IsDefinedRewriteRule(Oid owningRel, const char *ruleName)
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:167
#define GETSTRUCT(TUP)
Definition: htup_details.h:654
void namestrcpy(Name name, const char *str)
Definition: name.c:233
#define PointerGetDatum(X)
Definition: postgres.h:600
int errcode(int sqlerrcode)
Definition: elog.c:698
void heap_freetuple(HeapTuple htup)
Definition: heaptuple.c:1338
unsigned int Oid
Definition: postgres_ext.h:31
#define ObjectIdGetDatum(X)
Definition: postgres.h:551
#define ERROR
Definition: elog.h:46
Relation relation_open(Oid relationId, LOCKMODE lockmode)
Definition: relation.c:48
ItemPointerData t_self
Definition: htup.h:65
#define NoLock
Definition: lockdefs.h:34
#define RowExclusiveLock
Definition: lockdefs.h:38
#define RelationGetRelationName(relation)
Definition: rel.h:511
Oid RangeVarGetRelidExtended(const RangeVar *relation, LOCKMODE lockmode, uint32 flags, RangeVarGetRelidCallback callback, void *callback_arg)
Definition: namespace.c:237
#define InvokeObjectPostAlterHook(classId, objectId, subId)
Definition: objectaccess.h:175
#define ereport(elevel,...)
Definition: elog.h:157
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
void relation_close(Relation relation, LOCKMODE lockmode)
Definition: relation.c:206
void CatalogTupleUpdate(Relation heapRel, ItemPointer otid, HeapTuple tup)
Definition: indexing.c:301
#define ObjectAddressSet(addr, class_id, object_id)
Definition: objectaddress.h:40
FormData_pg_rewrite * Form_pg_rewrite
Definition: pg_rewrite.h:52
void CacheInvalidateRelcache(Relation relation)
Definition: inval.c:1342
#define AccessExclusiveLock
Definition: lockdefs.h:45
int errmsg(const char *fmt,...)
Definition: elog.c:909
static void RangeVarCallbackForRenameRule(const RangeVar *rv, Oid relid, Oid oldrelid, void *arg)
#define SearchSysCacheCopy2(cacheId, key1, key2)
Definition: syscache.h:177
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
#define ERRCODE_DUPLICATE_OBJECT
Definition: streamutil.c:32

◆ setRuleCheckAsUser()

void setRuleCheckAsUser ( Node node,
Oid  userid 
)

Definition at line 800 of file rewriteDefine.c.

References setRuleCheckAsUser_walker().

Referenced by get_row_security_policies(), and RelationBuildRuleLock().

801 {
802  (void) setRuleCheckAsUser_walker(node, &userid);
803 }
static bool setRuleCheckAsUser_walker(Node *node, Oid *context)