PostgreSQL Source Code  git master
pg_upgrade_support.c
Go to the documentation of this file.
1 /*
2  * pg_upgrade_support.c
3  *
4  * server-side functions to set backend global variables
5  * to control oid and relfilenumber assignment, and do other special
6  * hacks needed for pg_upgrade.
7  *
8  * Copyright (c) 2010-2022, PostgreSQL Global Development Group
9  * src/backend/utils/adt/pg_upgrade_support.c
10  */
11 
12 #include "postgres.h"
13 
14 #include "catalog/binary_upgrade.h"
15 #include "catalog/heap.h"
16 #include "catalog/namespace.h"
17 #include "catalog/pg_type.h"
18 #include "commands/extension.h"
19 #include "miscadmin.h"
20 #include "utils/array.h"
21 #include "utils/builtins.h"
22 
23 
24 #define CHECK_IS_BINARY_UPGRADE \
25 do { \
26  if (!IsBinaryUpgrade) \
27  ereport(ERROR, \
28  (errcode(ERRCODE_CANT_CHANGE_RUNTIME_PARAM), \
29  errmsg("function can only be called when server is in binary upgrade mode"))); \
30 } while (0)
31 
32 Datum
34 {
35  Oid tbspoid = PG_GETARG_OID(0);
36 
39 
41 }
42 
43 Datum
45 {
46  Oid typoid = PG_GETARG_OID(0);
47 
50 
52 }
53 
54 Datum
56 {
57  Oid typoid = PG_GETARG_OID(0);
58 
61 
63 }
64 
65 Datum
67 {
68  Oid typoid = PG_GETARG_OID(0);
69 
72 
74 }
75 
76 Datum
78 {
79  Oid typoid = PG_GETARG_OID(0);
80 
83 
85 }
86 
87 Datum
89 {
90  Oid reloid = PG_GETARG_OID(0);
91 
94 
96 }
97 
98 Datum
100 {
101  RelFileNumber relfilenumber = PG_GETARG_OID(0);
102 
105 
106  PG_RETURN_VOID();
107 }
108 
109 Datum
111 {
112  Oid reloid = PG_GETARG_OID(0);
113 
116 
117  PG_RETURN_VOID();
118 }
119 
120 Datum
122 {
123  RelFileNumber relfilenumber = PG_GETARG_OID(0);
124 
127 
128  PG_RETURN_VOID();
129 }
130 
131 Datum
133 {
134  Oid reloid = PG_GETARG_OID(0);
135 
138 
139  PG_RETURN_VOID();
140 }
141 
142 Datum
144 {
145  RelFileNumber relfilenumber = PG_GETARG_OID(0);
146 
149 
150  PG_RETURN_VOID();
151 }
152 
153 Datum
155 {
156  Oid enumoid = PG_GETARG_OID(0);
157 
160 
161  PG_RETURN_VOID();
162 }
163 
164 Datum
166 {
167  Oid authoid = PG_GETARG_OID(0);
168 
171  PG_RETURN_VOID();
172 }
173 
174 Datum
176 {
177  text *extName;
178  text *schemaName;
179  bool relocatable;
180  text *extVersion;
181  Datum extConfig;
182  Datum extCondition;
183  List *requiredExtensions;
184 
186 
187  /* We must check these things before dereferencing the arguments */
188  if (PG_ARGISNULL(0) ||
189  PG_ARGISNULL(1) ||
190  PG_ARGISNULL(2) ||
191  PG_ARGISNULL(3))
192  elog(ERROR, "null argument to binary_upgrade_create_empty_extension is not allowed");
193 
194  extName = PG_GETARG_TEXT_PP(0);
195  schemaName = PG_GETARG_TEXT_PP(1);
196  relocatable = PG_GETARG_BOOL(2);
197  extVersion = PG_GETARG_TEXT_PP(3);
198 
199  if (PG_ARGISNULL(4))
200  extConfig = PointerGetDatum(NULL);
201  else
202  extConfig = PG_GETARG_DATUM(4);
203 
204  if (PG_ARGISNULL(5))
205  extCondition = PointerGetDatum(NULL);
206  else
207  extCondition = PG_GETARG_DATUM(5);
208 
209  requiredExtensions = NIL;
210  if (!PG_ARGISNULL(6))
211  {
212  ArrayType *textArray = PG_GETARG_ARRAYTYPE_P(6);
213  Datum *textDatums;
214  int ndatums;
215  int i;
216 
217  deconstruct_array_builtin(textArray, TEXTOID, &textDatums, NULL, &ndatums);
218  for (i = 0; i < ndatums; i++)
219  {
220  char *extName = TextDatumGetCString(textDatums[i]);
221  Oid extOid = get_extension_oid(extName, false);
222 
223  requiredExtensions = lappend_oid(requiredExtensions, extOid);
224  }
225  }
226 
228  GetUserId(),
229  get_namespace_oid(text_to_cstring(schemaName), false),
230  relocatable,
231  text_to_cstring(extVersion),
232  extConfig,
233  extCondition,
234  requiredExtensions);
235 
236  PG_RETURN_VOID();
237 }
238 
239 Datum
241 {
242  bool record_init_privs = PG_GETARG_BOOL(0);
243 
245  binary_upgrade_record_init_privs = record_init_privs;
246 
247  PG_RETURN_VOID();
248 }
249 
250 Datum
252 {
253  Oid table_id = PG_GETARG_OID(0);
256  char *cattname = text_to_cstring(attname);
257  char *cvalue = text_to_cstring(value);
258 
260  SetAttrMissing(table_id, cattname, cvalue);
261 
262  PG_RETURN_VOID();
263 }
bool binary_upgrade_record_init_privs
Definition: aclchk.c:105
#define PG_GETARG_ARRAYTYPE_P(n)
Definition: array.h:256
void deconstruct_array_builtin(ArrayType *array, Oid elmtype, Datum **elemsp, bool **nullsp, int *nelemsp)
Definition: arrayfuncs.c:3668
Oid binary_upgrade_next_pg_tablespace_oid
Definition: tablespace.c:93
#define TextDatumGetCString(d)
Definition: builtins.h:89
#define ERROR
Definition: elog.h:39
ObjectAddress InsertExtensionTuple(const char *extName, Oid extOwner, Oid schemaOid, bool relocatable, const char *extVersion, Datum extConfig, Datum extCondition, List *requiredExtensions)
Definition: extension.c:1802
Oid get_extension_oid(const char *extname, bool missing_ok)
Definition: extension.c:142
#define PG_RETURN_VOID()
Definition: fmgr.h:349
#define PG_GETARG_OID(n)
Definition: fmgr.h:275
#define PG_GETARG_TEXT_PP(n)
Definition: fmgr.h:309
#define PG_ARGISNULL(n)
Definition: fmgr.h:209
#define PG_GETARG_DATUM(n)
Definition: fmgr.h:268
#define PG_GETARG_BOOL(n)
Definition: fmgr.h:274
#define PG_FUNCTION_ARGS
Definition: fmgr.h:193
#define PG_GETARG_TEXT_P(n)
Definition: fmgr.h:336
void SetAttrMissing(Oid relid, char *attname, char *value)
Definition: heap.c:2003
RelFileNumber binary_upgrade_next_heap_pg_class_relfilenumber
Definition: heap.c:81
RelFileNumber binary_upgrade_next_toast_pg_class_relfilenumber
Definition: heap.c:82
Oid binary_upgrade_next_toast_pg_class_oid
Definition: heap.c:80
Oid binary_upgrade_next_heap_pg_class_oid
Definition: heap.c:79
RelFileNumber binary_upgrade_next_index_pg_class_relfilenumber
Definition: index.c:90
Oid binary_upgrade_next_index_pg_class_oid
Definition: index.c:89
static struct @143 value
int i
Definition: isn.c:73
List * lappend_oid(List *list, Oid datum)
Definition: list.c:374
Oid GetUserId(void)
Definition: miscinit.c:497
Oid get_namespace_oid(const char *nspname, bool missing_ok)
Definition: namespace.c:3086
NameData attname
Definition: pg_attribute.h:41
Oid binary_upgrade_next_pg_enum_oid
Definition: pg_enum.c:36
#define NIL
Definition: pg_list.h:66
Oid binary_upgrade_next_pg_type_oid
Definition: pg_type.c:42
Datum binary_upgrade_set_next_heap_pg_class_oid(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_next_multirange_pg_type_oid(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_next_pg_enum_oid(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_next_index_pg_class_oid(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_next_array_pg_type_oid(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_next_toast_relfilenode(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_next_pg_authid_oid(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_record_init_privs(PG_FUNCTION_ARGS)
#define CHECK_IS_BINARY_UPGRADE
Datum binary_upgrade_set_next_multirange_array_pg_type_oid(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_next_pg_tablespace_oid(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_next_heap_relfilenode(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_next_index_relfilenode(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_missing_value(PG_FUNCTION_ARGS)
Datum binary_upgrade_create_empty_extension(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_next_pg_type_oid(PG_FUNCTION_ARGS)
Datum binary_upgrade_set_next_toast_pg_class_oid(PG_FUNCTION_ARGS)
static Datum PointerGetDatum(const void *X)
Definition: postgres.h:670
uintptr_t Datum
Definition: postgres.h:412
unsigned int Oid
Definition: postgres_ext.h:31
Oid RelFileNumber
Definition: relpath.h:25
Definition: pg_list.h:52
Definition: c.h:623
Oid binary_upgrade_next_mrng_array_pg_type_oid
Definition: typecmds.c:111
Oid binary_upgrade_next_mrng_pg_type_oid
Definition: typecmds.c:110
Oid binary_upgrade_next_array_pg_type_oid
Definition: typecmds.c:109
Oid binary_upgrade_next_pg_authid_oid
Definition: user.c:70
char * text_to_cstring(const text *t)
Definition: varlena.c:222