PostgreSQL Source Code  git master
pg_range.c
Go to the documentation of this file.
1 /*-------------------------------------------------------------------------
2  *
3  * pg_range.c
4  * routines to support manipulation of the pg_range relation
5  *
6  * Portions Copyright (c) 1996-2021, PostgreSQL Global Development Group
7  * Portions Copyright (c) 1994, Regents of the University of California
8  *
9  *
10  * IDENTIFICATION
11  * src/backend/catalog/pg_range.c
12  *
13  *-------------------------------------------------------------------------
14  */
15 #include "postgres.h"
16 
17 #include "access/genam.h"
18 #include "access/htup_details.h"
19 #include "access/table.h"
20 #include "catalog/dependency.h"
21 #include "catalog/indexing.h"
22 #include "catalog/pg_collation.h"
23 #include "catalog/pg_opclass.h"
24 #include "catalog/pg_proc.h"
25 #include "catalog/pg_range.h"
26 #include "catalog/pg_type.h"
27 #include "utils/fmgroids.h"
28 #include "utils/rel.h"
29 
30 
31 /*
32  * RangeCreate
33  * Create an entry in pg_range.
34  */
35 void
36 RangeCreate(Oid rangeTypeOid, Oid rangeSubType, Oid rangeCollation,
37  Oid rangeSubOpclass, RegProcedure rangeCanonical,
38  RegProcedure rangeSubDiff, Oid multirangeTypeOid)
39 {
40  Relation pg_range;
41  Datum values[Natts_pg_range];
42  bool nulls[Natts_pg_range];
43  HeapTuple tup;
44  ObjectAddress myself;
45  ObjectAddress referenced;
46  ObjectAddress referencing;
47  ObjectAddresses *addrs;
48 
49  pg_range = table_open(RangeRelationId, RowExclusiveLock);
50 
51  memset(nulls, 0, sizeof(nulls));
52 
53  values[Anum_pg_range_rngtypid - 1] = ObjectIdGetDatum(rangeTypeOid);
54  values[Anum_pg_range_rngsubtype - 1] = ObjectIdGetDatum(rangeSubType);
55  values[Anum_pg_range_rngcollation - 1] = ObjectIdGetDatum(rangeCollation);
56  values[Anum_pg_range_rngsubopc - 1] = ObjectIdGetDatum(rangeSubOpclass);
57  values[Anum_pg_range_rngcanonical - 1] = ObjectIdGetDatum(rangeCanonical);
58  values[Anum_pg_range_rngsubdiff - 1] = ObjectIdGetDatum(rangeSubDiff);
59  values[Anum_pg_range_rngmultitypid - 1] = ObjectIdGetDatum(multirangeTypeOid);
60 
61  tup = heap_form_tuple(RelationGetDescr(pg_range), values, nulls);
62 
63  CatalogTupleInsert(pg_range, tup);
64  heap_freetuple(tup);
65 
66  /* record type's dependencies on range-related items */
67  addrs = new_object_addresses();
68 
69  ObjectAddressSet(myself, TypeRelationId, rangeTypeOid);
70 
71  ObjectAddressSet(referenced, TypeRelationId, rangeSubType);
72  add_exact_object_address(&referenced, addrs);
73 
74  ObjectAddressSet(referenced, OperatorClassRelationId, rangeSubOpclass);
75  add_exact_object_address(&referenced, addrs);
76 
77  if (OidIsValid(rangeCollation))
78  {
79  ObjectAddressSet(referenced, CollationRelationId, rangeCollation);
80  add_exact_object_address(&referenced, addrs);
81  }
82 
83  if (OidIsValid(rangeCanonical))
84  {
85  ObjectAddressSet(referenced, ProcedureRelationId, rangeCanonical);
86  add_exact_object_address(&referenced, addrs);
87  }
88 
89  if (OidIsValid(rangeSubDiff))
90  {
91  ObjectAddressSet(referenced, ProcedureRelationId, rangeSubDiff);
92  add_exact_object_address(&referenced, addrs);
93  }
94 
96  free_object_addresses(addrs);
97 
98  /* record multirange type's dependency on the range type */
99  referencing.classId = TypeRelationId;
100  referencing.objectId = multirangeTypeOid;
101  referencing.objectSubId = 0;
102  recordDependencyOn(&referencing, &myself, DEPENDENCY_INTERNAL);
103 
104  table_close(pg_range, RowExclusiveLock);
105 }
106 
107 
108 /*
109  * RangeDelete
110  * Remove the pg_range entry for the specified type.
111  */
112 void
113 RangeDelete(Oid rangeTypeOid)
114 {
115  Relation pg_range;
116  ScanKeyData key[1];
117  SysScanDesc scan;
118  HeapTuple tup;
119 
120  pg_range = table_open(RangeRelationId, RowExclusiveLock);
121 
122  ScanKeyInit(&key[0],
123  Anum_pg_range_rngtypid,
124  BTEqualStrategyNumber, F_OIDEQ,
125  ObjectIdGetDatum(rangeTypeOid));
126 
127  scan = systable_beginscan(pg_range, RangeTypidIndexId, true,
128  NULL, 1, key);
129 
130  while (HeapTupleIsValid(tup = systable_getnext(scan)))
131  {
132  CatalogTupleDelete(pg_range, &tup->t_self);
133  }
134 
135  systable_endscan(scan);
136 
137  table_close(pg_range, RowExclusiveLock);
138 }
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:167
void systable_endscan(SysScanDesc sysscan)
Definition: genam.c:595
#define RelationGetDescr(relation)
Definition: rel.h:503
void RangeCreate(Oid rangeTypeOid, Oid rangeSubType, Oid rangeCollation, Oid rangeSubOpclass, RegProcedure rangeCanonical, RegProcedure rangeSubDiff, Oid multirangeTypeOid)
Definition: pg_range.c:36
void record_object_address_dependencies(const ObjectAddress *depender, ObjectAddresses *referenced, DependencyType behavior)
Definition: dependency.c:2691
regproc RegProcedure
Definition: c.h:585
void CatalogTupleDelete(Relation heapRel, ItemPointer tid)
Definition: indexing.c:350
void recordDependencyOn(const ObjectAddress *depender, const ObjectAddress *referenced, DependencyType behavior)
Definition: pg_depend.c:44
void add_exact_object_address(const ObjectAddress *object, ObjectAddresses *addrs)
Definition: dependency.c:2482
HeapTuple heap_form_tuple(TupleDesc tupleDescriptor, Datum *values, bool *isnull)
Definition: heaptuple.c:1020
ObjectAddresses * new_object_addresses(void)
Definition: dependency.c:2427
void free_object_addresses(ObjectAddresses *addrs)
Definition: dependency.c:2722
void heap_freetuple(HeapTuple htup)
Definition: heaptuple.c:1338
unsigned int Oid
Definition: postgres_ext.h:31
#define OidIsValid(objectId)
Definition: c.h:710
SysScanDesc systable_beginscan(Relation heapRelation, Oid indexId, bool indexOK, Snapshot snapshot, int nkeys, ScanKey key)
Definition: genam.c:383
HeapTuple systable_getnext(SysScanDesc sysscan)
Definition: genam.c:502
#define ObjectIdGetDatum(X)
Definition: postgres.h:551
ItemPointerData t_self
Definition: htup.h:65
#define RowExclusiveLock
Definition: lockdefs.h:38
uintptr_t Datum
Definition: postgres.h:411
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
#define ObjectAddressSet(addr, class_id, object_id)
Definition: objectaddress.h:40
static Datum values[MAXATTR]
Definition: bootstrap.c:166
void ScanKeyInit(ScanKey entry, AttrNumber attributeNumber, StrategyNumber strategy, RegProcedure procedure, Datum argument)
Definition: scankey.c:76
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
void RangeDelete(Oid rangeTypeOid)
Definition: pg_range.c:113
void CatalogTupleInsert(Relation heapRel, HeapTuple tup)
Definition: indexing.c:221
#define BTEqualStrategyNumber
Definition: stratnum.h:31