PostgreSQL Source Code  git master
index.h
Go to the documentation of this file.
1 /*-------------------------------------------------------------------------
2  *
3  * index.h
4  * prototypes for catalog/index.c.
5  *
6  *
7  * Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
8  * Portions Copyright (c) 1994, Regents of the University of California
9  *
10  * src/include/catalog/index.h
11  *
12  *-------------------------------------------------------------------------
13  */
14 #ifndef INDEX_H
15 #define INDEX_H
16 
17 #include "catalog/objectaddress.h"
18 #include "nodes/execnodes.h"
19 
20 
21 #define DEFAULT_INDEX_TYPE "btree"
22 
23 /* Action code for index_set_state_flags */
24 typedef enum
25 {
31 
32 /* options for REINDEX */
33 typedef struct ReindexParams
34 {
35  bits32 options; /* bitmask of REINDEXOPT_* */
36  Oid tablespaceOid; /* New tablespace to move indexes to.
37  * InvalidOid to do nothing. */
39 
40 /* flag bits for ReindexParams->flags */
41 #define REINDEXOPT_VERBOSE 0x01 /* print progress info */
42 #define REINDEXOPT_REPORT_PROGRESS 0x02 /* report pgstat progress */
43 #define REINDEXOPT_MISSING_OK 0x04 /* skip missing relations */
44 #define REINDEXOPT_CONCURRENTLY 0x08 /* concurrent mode */
45 
46 /* state info for validate_index bulkdelete callback */
47 typedef struct ValidateIndexState
48 {
49  Tuplesortstate *tuplesort; /* for sorting the index TIDs */
50  /* statistics (for debug purposes only): */
51  double htups,
55 
56 extern void index_check_primary_key(Relation heapRel,
57  const IndexInfo *indexInfo,
58  bool is_alter_table,
59  const IndexStmt *stmt);
60 
61 #define INDEX_CREATE_IS_PRIMARY (1 << 0)
62 #define INDEX_CREATE_ADD_CONSTRAINT (1 << 1)
63 #define INDEX_CREATE_SKIP_BUILD (1 << 2)
64 #define INDEX_CREATE_CONCURRENT (1 << 3)
65 #define INDEX_CREATE_IF_NOT_EXISTS (1 << 4)
66 #define INDEX_CREATE_PARTITIONED (1 << 5)
67 #define INDEX_CREATE_INVALID (1 << 6)
68 
69 extern Oid index_create(Relation heapRelation,
70  const char *indexRelationName,
71  Oid indexRelationId,
72  Oid parentIndexRelid,
73  Oid parentConstraintId,
74  RelFileNumber relFileNumber,
75  IndexInfo *indexInfo,
76  const List *indexColNames,
77  Oid accessMethodId,
78  Oid tableSpaceId,
79  const Oid *collationIds,
80  const Oid *opclassIds,
81  const Datum *opclassOptions,
82  const int16 *coloptions,
83  Datum reloptions,
84  bits16 flags,
85  bits16 constr_flags,
86  bool allow_system_table_mods,
87  bool is_internal,
88  Oid *constraintId);
89 
90 #define INDEX_CONSTR_CREATE_MARK_AS_PRIMARY (1 << 0)
91 #define INDEX_CONSTR_CREATE_DEFERRABLE (1 << 1)
92 #define INDEX_CONSTR_CREATE_INIT_DEFERRED (1 << 2)
93 #define INDEX_CONSTR_CREATE_UPDATE_INDEX (1 << 3)
94 #define INDEX_CONSTR_CREATE_REMOVE_OLD_DEPS (1 << 4)
95 
96 extern Oid index_concurrently_create_copy(Relation heapRelation,
97  Oid oldIndexId,
98  Oid tablespaceOid,
99  const char *newName);
100 
101 extern void index_concurrently_build(Oid heapRelationId,
102  Oid indexRelationId);
103 
104 extern void index_concurrently_swap(Oid newIndexId,
105  Oid oldIndexId,
106  const char *oldName);
107 
108 extern void index_concurrently_set_dead(Oid heapId,
109  Oid indexId);
110 
112  Oid indexRelationId,
113  Oid parentConstraintId,
114  const IndexInfo *indexInfo,
115  const char *constraintName,
116  char constraintType,
117  bits16 constr_flags,
118  bool allow_system_table_mods,
119  bool is_internal);
120 
121 extern void index_drop(Oid indexId, bool concurrent, bool concurrent_lock_mode);
122 
124 
126 
127 extern bool CompareIndexInfo(const IndexInfo *info1, const IndexInfo *info2,
128  const Oid *collations1, const Oid *collations2,
129  const Oid *opfamilies1, const Oid *opfamilies2,
130  const AttrMap *attmap);
131 
133 
134 extern void FormIndexDatum(IndexInfo *indexInfo,
135  TupleTableSlot *slot,
136  EState *estate,
137  Datum *values,
138  bool *isnull);
139 
140 extern void index_build(Relation heapRelation,
141  Relation indexRelation,
142  IndexInfo *indexInfo,
143  bool isreindex,
144  bool parallel);
145 
146 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
147 
149 
150 extern Oid IndexGetRelation(Oid indexId, bool missing_ok);
151 
152 extern void reindex_index(const ReindexStmt *stmt, Oid indexId,
153  bool skip_constraint_checks, char persistence,
154  const ReindexParams *params);
155 
156 /* Flag bits for reindex_relation(): */
157 #define REINDEX_REL_PROCESS_TOAST 0x01
158 #define REINDEX_REL_SUPPRESS_INDEX_USE 0x02
159 #define REINDEX_REL_CHECK_CONSTRAINTS 0x04
160 #define REINDEX_REL_FORCE_INDEXES_UNLOGGED 0x08
161 #define REINDEX_REL_FORCE_INDEXES_PERMANENT 0x10
162 
163 extern bool reindex_relation(const ReindexStmt *stmt, Oid relid, int flags,
164  const ReindexParams *params);
165 
166 extern bool ReindexIsProcessingHeap(Oid heapOid);
167 extern bool ReindexIsProcessingIndex(Oid indexOid);
168 
169 extern void ResetReindexState(int nestLevel);
170 extern Size EstimateReindexStateSpace(void);
171 extern void SerializeReindexState(Size maxsize, char *start_address);
172 extern void RestoreReindexState(const void *reindexstate);
173 
174 extern void IndexSetParentIndex(Relation partitionIdx, Oid parentOid);
175 
176 
177 /*
178  * itemptr_encode - Encode ItemPointer as int64/int8
179  *
180  * This representation must produce values encoded as int64 that sort in the
181  * same order as their corresponding original TID values would (using the
182  * default int8 opclass to produce a result equivalent to the default TID
183  * opclass).
184  *
185  * As noted in validate_index(), this can be significantly faster.
186  */
187 static inline int64
189 {
190  BlockNumber block = ItemPointerGetBlockNumber(itemptr);
191  OffsetNumber offset = ItemPointerGetOffsetNumber(itemptr);
192  int64 encoded;
193 
194  /*
195  * Use the 16 least significant bits for the offset. 32 adjacent bits are
196  * used for the block number. Since remaining bits are unused, there
197  * cannot be negative encoded values (We assume a two's complement
198  * representation).
199  */
200  encoded = ((uint64) block << 16) | (uint16) offset;
201 
202  return encoded;
203 }
204 
205 /*
206  * itemptr_decode - Decode int64/int8 representation back to ItemPointer
207  */
208 static inline void
209 itemptr_decode(ItemPointer itemptr, int64 encoded)
210 {
211  BlockNumber block = (BlockNumber) (encoded >> 16);
212  OffsetNumber offset = (OffsetNumber) (encoded & 0xFFFF);
213 
214  ItemPointerSet(itemptr, block, offset);
215 }
216 
217 #endif /* INDEX_H */
uint32 BlockNumber
Definition: block.h:31
static Datum values[MAXATTR]
Definition: bootstrap.c:156
unsigned short uint16
Definition: c.h:494
uint16 bits16
Definition: c.h:503
signed short int16
Definition: c.h:482
uint32 bits32
Definition: c.h:504
size_t Size
Definition: c.h:594
#define stmt
Definition: indent_codes.h:59
bool ReindexIsProcessingIndex(Oid indexOid)
Definition: index.c:4058
void validate_index(Oid heapId, Oid indexId, Snapshot snapshot)
Definition: index.c:3307
void index_drop(Oid indexId, bool concurrent, bool concurrent_lock_mode)
Definition: index.c:2135
void ResetReindexState(int nestLevel)
Definition: index.c:4131
Oid IndexGetRelation(Oid indexId, bool missing_ok)
Definition: index.c:3536
struct ValidateIndexState ValidateIndexState
void index_concurrently_set_dead(Oid heapId, Oid indexId)
Definition: index.c:1841
void index_concurrently_swap(Oid newIndexId, Oid oldIndexId, const char *oldName)
Definition: index.c:1514
Oid index_create(Relation heapRelation, const char *indexRelationName, Oid indexRelationId, Oid parentIndexRelid, Oid parentConstraintId, RelFileNumber relFileNumber, IndexInfo *indexInfo, const List *indexColNames, Oid accessMethodId, Oid tableSpaceId, const Oid *collationIds, const Oid *opclassIds, const Datum *opclassOptions, const int16 *coloptions, Datum reloptions, bits16 flags, bits16 constr_flags, bool allow_system_table_mods, bool is_internal, Oid *constraintId)
Definition: index.c:711
static void itemptr_decode(ItemPointer itemptr, int64 encoded)
Definition: index.h:209
void index_set_state_flags(Oid indexId, IndexStateFlagsAction action)
Definition: index.c:3456
bool CompareIndexInfo(const IndexInfo *info1, const IndexInfo *info2, const Oid *collations1, const Oid *collations2, const Oid *opfamilies1, const Oid *opfamilies2, const AttrMap *attmap)
Definition: index.c:2532
IndexInfo * BuildDummyIndexInfo(Relation index)
Definition: index.c:2484
bool reindex_relation(const ReindexStmt *stmt, Oid relid, int flags, const ReindexParams *params)
Definition: index.c:3883
static int64 itemptr_encode(ItemPointer itemptr)
Definition: index.h:188
void IndexSetParentIndex(Relation partitionIdx, Oid parentOid)
Definition: indexcmds.c:4266
void SerializeReindexState(Size maxsize, char *start_address)
Definition: index.c:4171
Oid index_concurrently_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid, const char *newName)
Definition: index.c:1283
void BuildSpeculativeIndexInfo(Relation index, IndexInfo *ii)
Definition: index.c:2663
void index_check_primary_key(Relation heapRel, const IndexInfo *indexInfo, bool is_alter_table, const IndexStmt *stmt)
Definition: index.c:206
bool ReindexIsProcessingHeap(Oid heapOid)
Definition: index.c:4037
struct ReindexParams ReindexParams
IndexStateFlagsAction
Definition: index.h:25
@ INDEX_CREATE_SET_VALID
Definition: index.h:27
@ INDEX_DROP_CLEAR_VALID
Definition: index.h:28
@ INDEX_DROP_SET_DEAD
Definition: index.h:29
@ INDEX_CREATE_SET_READY
Definition: index.h:26
void RestoreReindexState(const void *reindexstate)
Definition: index.c:4189
void index_build(Relation heapRelation, Relation indexRelation, IndexInfo *indexInfo, bool isreindex, bool parallel)
Definition: index.c:2959
ObjectAddress index_constraint_create(Relation heapRelation, Oid indexRelationId, Oid parentConstraintId, const IndexInfo *indexInfo, const char *constraintName, char constraintType, bits16 constr_flags, bool allow_system_table_mods, bool is_internal)
Definition: index.c:1902
void FormIndexDatum(IndexInfo *indexInfo, TupleTableSlot *slot, EState *estate, Datum *values, bool *isnull)
Definition: index.c:2723
void index_concurrently_build(Oid heapRelationId, Oid indexRelationId)
Definition: index.c:1448
Size EstimateReindexStateSpace(void)
Definition: index.c:4160
IndexInfo * BuildIndexInfo(Relation index)
Definition: index.c:2425
void reindex_index(const ReindexStmt *stmt, Oid indexId, bool skip_constraint_checks, char persistence, const ReindexParams *params)
Definition: index.c:3561
static void ItemPointerSet(ItemPointerData *pointer, BlockNumber blockNumber, OffsetNumber offNum)
Definition: itemptr.h:135
static OffsetNumber ItemPointerGetOffsetNumber(const ItemPointerData *pointer)
Definition: itemptr.h:124
static BlockNumber ItemPointerGetBlockNumber(const ItemPointerData *pointer)
Definition: itemptr.h:103
uint16 OffsetNumber
Definition: off.h:24
uintptr_t Datum
Definition: postgres.h:64
unsigned int Oid
Definition: postgres_ext.h:31
Oid RelFileNumber
Definition: relpath.h:25
Definition: attmap.h:35
Definition: pg_list.h:54
Oid tablespaceOid
Definition: index.h:36
bits32 options
Definition: index.h:35
Tuplesortstate * tuplesort
Definition: index.h:49
double tups_inserted
Definition: index.h:53
double htups
Definition: index.h:51
double itups
Definition: index.h:52
Definition: type.h:95