PostgreSQL Source Code  git master
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros
tupconvert.h File Reference
#include "access/htup.h"
#include "access/tupdesc.h"
Include dependency graph for tupconvert.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  TupleConversionMap
 

Typedefs

typedef struct TupleConversionMap TupleConversionMap
 

Functions

TupleConversionMapconvert_tuples_by_position (TupleDesc indesc, TupleDesc outdesc, const char *msg)
 
TupleConversionMapconvert_tuples_by_name (TupleDesc indesc, TupleDesc outdesc, const char *msg)
 
AttrNumberconvert_tuples_by_name_map (TupleDesc indesc, TupleDesc outdesc, const char *msg)
 
HeapTuple do_convert_tuple (HeapTuple tuple, TupleConversionMap *map)
 
void free_conversion_map (TupleConversionMap *map)
 

Typedef Documentation

Function Documentation

TupleConversionMap* convert_tuples_by_name ( TupleDesc  indesc,
TupleDesc  outdesc,
const char *  msg 
)

Definition at line 205 of file tupconvert.c.

References TupleConversionMap::attrMap, tupleDesc::attrs, convert_tuples_by_name_map(), i, TupleConversionMap::indesc, TupleConversionMap::inisnull, TupleConversionMap::invalues, tupleDesc::natts, NULL, TupleConversionMap::outdesc, TupleConversionMap::outisnull, TupleConversionMap::outvalues, palloc(), pfree(), and tupleDesc::tdhasoid.

Referenced by acquire_inherited_sample_rows(), ExecConstraints(), ExecEvalConvertRowtype(), ExecSetupPartitionTupleRouting(), and RelationGetPartitionDispatchInfo().

208 {
209  TupleConversionMap *map;
210  AttrNumber *attrMap;
211  int n = outdesc->natts;
212  int i;
213  bool same;
214 
215  /* Verify compatibility and prepare attribute-number map */
216  attrMap = convert_tuples_by_name_map(indesc, outdesc, msg);
217 
218  /*
219  * Check to see if the map is one-to-one, in which case we need not do a
220  * tuple conversion. We must also insist that both tupdescs either
221  * specify or don't specify an OID column, else we need a conversion to
222  * add/remove space for that. (For some callers, presence or absence of
223  * an OID column perhaps would not really matter, but let's be safe.)
224  */
225  if (indesc->natts == outdesc->natts &&
226  indesc->tdhasoid == outdesc->tdhasoid)
227  {
228  same = true;
229  for (i = 0; i < n; i++)
230  {
231  if (attrMap[i] == (i + 1))
232  continue;
233 
234  /*
235  * If it's a dropped column and the corresponding input column is
236  * also dropped, we needn't convert. However, attlen and attalign
237  * must agree.
238  */
239  if (attrMap[i] == 0 &&
240  indesc->attrs[i]->attisdropped &&
241  indesc->attrs[i]->attlen == outdesc->attrs[i]->attlen &&
242  indesc->attrs[i]->attalign == outdesc->attrs[i]->attalign)
243  continue;
244 
245  same = false;
246  break;
247  }
248  }
249  else
250  same = false;
251 
252  if (same)
253  {
254  /* Runtime conversion is not needed */
255  pfree(attrMap);
256  return NULL;
257  }
258 
259  /* Prepare the map structure */
260  map = (TupleConversionMap *) palloc(sizeof(TupleConversionMap));
261  map->indesc = indesc;
262  map->outdesc = outdesc;
263  map->attrMap = attrMap;
264  /* preallocate workspace for Datum arrays */
265  map->outvalues = (Datum *) palloc(n * sizeof(Datum));
266  map->outisnull = (bool *) palloc(n * sizeof(bool));
267  n = indesc->natts + 1; /* +1 for NULL */
268  map->invalues = (Datum *) palloc(n * sizeof(Datum));
269  map->inisnull = (bool *) palloc(n * sizeof(bool));
270  map->invalues[0] = (Datum) 0; /* set up the NULL entry */
271  map->inisnull[0] = true;
272 
273  return map;
274 }
AttrNumber * attrMap
Definition: tupconvert.h:25
TupleDesc indesc
Definition: tupconvert.h:23
TupleDesc outdesc
Definition: tupconvert.h:24
bool tdhasoid
Definition: tupdesc.h:79
Form_pg_attribute * attrs
Definition: tupdesc.h:74
int natts
Definition: tupdesc.h:73
void pfree(void *pointer)
Definition: mcxt.c:950
AttrNumber * convert_tuples_by_name_map(TupleDesc indesc, TupleDesc outdesc, const char *msg)
Definition: tupconvert.c:283
uintptr_t Datum
Definition: postgres.h:372
#define NULL
Definition: c.h:229
void * palloc(Size size)
Definition: mcxt.c:849
int i
int16 AttrNumber
Definition: attnum.h:21
AttrNumber* convert_tuples_by_name_map ( TupleDesc  indesc,
TupleDesc  outdesc,
const char *  msg 
)

Definition at line 283 of file tupconvert.c.

References _, tupleDesc::attrs, ereport, errcode(), errdetail(), errmsg_internal(), ERROR, format_type_be(), i, NameStr, tupleDesc::natts, palloc0(), and tupleDesc::tdtypeid.

Referenced by ATPrepAlterColumnType(), convert_tuples_by_name(), and map_partition_varattnos().

286 {
287  AttrNumber *attrMap;
288  int n;
289  int i;
290 
291  n = outdesc->natts;
292  attrMap = (AttrNumber *) palloc0(n * sizeof(AttrNumber));
293  for (i = 0; i < n; i++)
294  {
295  Form_pg_attribute att = outdesc->attrs[i];
296  char *attname;
297  Oid atttypid;
298  int32 atttypmod;
299  int j;
300 
301  if (att->attisdropped)
302  continue; /* attrMap[i] is already 0 */
303  attname = NameStr(att->attname);
304  atttypid = att->atttypid;
305  atttypmod = att->atttypmod;
306  for (j = 0; j < indesc->natts; j++)
307  {
308  att = indesc->attrs[j];
309  if (att->attisdropped)
310  continue;
311  if (strcmp(attname, NameStr(att->attname)) == 0)
312  {
313  /* Found it, check type */
314  if (atttypid != att->atttypid || atttypmod != att->atttypmod)
315  ereport(ERROR,
316  (errcode(ERRCODE_DATATYPE_MISMATCH),
317  errmsg_internal("%s", _(msg)),
318  errdetail("Attribute \"%s\" of type %s does not match corresponding attribute of type %s.",
319  attname,
320  format_type_be(outdesc->tdtypeid),
321  format_type_be(indesc->tdtypeid))));
322  attrMap[i] = (AttrNumber) (j + 1);
323  break;
324  }
325  }
326  if (attrMap[i] == 0)
327  ereport(ERROR,
328  (errcode(ERRCODE_DATATYPE_MISMATCH),
329  errmsg_internal("%s", _(msg)),
330  errdetail("Attribute \"%s\" of type %s does not exist in type %s.",
331  attname,
332  format_type_be(outdesc->tdtypeid),
333  format_type_be(indesc->tdtypeid))));
334  }
335 
336  return attrMap;
337 }
Oid tdtypeid
Definition: tupdesc.h:77
Form_pg_attribute * attrs
Definition: tupdesc.h:74
int errcode(int sqlerrcode)
Definition: elog.c:575
char * format_type_be(Oid type_oid)
Definition: format_type.c:94
unsigned int Oid
Definition: postgres_ext.h:31
int natts
Definition: tupdesc.h:73
signed int int32
Definition: c.h:256
#define ERROR
Definition: elog.h:43
int errdetail(const char *fmt,...)
Definition: elog.c:873
FormData_pg_attribute * Form_pg_attribute
Definition: pg_attribute.h:187
#define ereport(elevel, rest)
Definition: elog.h:122
void * palloc0(Size size)
Definition: mcxt.c:878
int errmsg_internal(const char *fmt,...)
Definition: elog.c:827
int i
#define NameStr(name)
Definition: c.h:499
int16 AttrNumber
Definition: attnum.h:21
#define _(x)
Definition: elog.c:84
TupleConversionMap* convert_tuples_by_position ( TupleDesc  indesc,
TupleDesc  outdesc,
const char *  msg 
)

Definition at line 66 of file tupconvert.c.

References _, TupleConversionMap::attrMap, tupleDesc::attrs, ereport, errcode(), errdetail(), errmsg_internal(), ERROR, format_type_with_typemod(), i, TupleConversionMap::indesc, TupleConversionMap::inisnull, TupleConversionMap::invalues, tupleDesc::natts, NULL, TupleConversionMap::outdesc, TupleConversionMap::outisnull, TupleConversionMap::outvalues, palloc(), palloc0(), pfree(), and tupleDesc::tdhasoid.

Referenced by exec_stmt_return_next(), exec_stmt_return_query(), plpgsql_exec_function(), and plpgsql_exec_trigger().

69 {
70  TupleConversionMap *map;
71  AttrNumber *attrMap;
72  int nincols;
73  int noutcols;
74  int n;
75  int i;
76  int j;
77  bool same;
78 
79  /* Verify compatibility and prepare attribute-number map */
80  n = outdesc->natts;
81  attrMap = (AttrNumber *) palloc0(n * sizeof(AttrNumber));
82  j = 0; /* j is next physical input attribute */
83  nincols = noutcols = 0; /* these count non-dropped attributes */
84  same = true;
85  for (i = 0; i < n; i++)
86  {
87  Form_pg_attribute att = outdesc->attrs[i];
88  Oid atttypid;
89  int32 atttypmod;
90 
91  if (att->attisdropped)
92  continue; /* attrMap[i] is already 0 */
93  noutcols++;
94  atttypid = att->atttypid;
95  atttypmod = att->atttypmod;
96  for (; j < indesc->natts; j++)
97  {
98  att = indesc->attrs[j];
99  if (att->attisdropped)
100  continue;
101  nincols++;
102  /* Found matching column, check type */
103  if (atttypid != att->atttypid ||
104  (atttypmod != att->atttypmod && atttypmod >= 0))
105  ereport(ERROR,
106  (errcode(ERRCODE_DATATYPE_MISMATCH),
107  errmsg_internal("%s", _(msg)),
108  errdetail("Returned type %s does not match expected type %s in column %d.",
109  format_type_with_typemod(att->atttypid,
110  att->atttypmod),
111  format_type_with_typemod(atttypid,
112  atttypmod),
113  noutcols)));
114  attrMap[i] = (AttrNumber) (j + 1);
115  j++;
116  break;
117  }
118  if (attrMap[i] == 0)
119  same = false; /* we'll complain below */
120  }
121 
122  /* Check for unused input columns */
123  for (; j < indesc->natts; j++)
124  {
125  if (indesc->attrs[j]->attisdropped)
126  continue;
127  nincols++;
128  same = false; /* we'll complain below */
129  }
130 
131  /* Report column count mismatch using the non-dropped-column counts */
132  if (!same)
133  ereport(ERROR,
134  (errcode(ERRCODE_DATATYPE_MISMATCH),
135  errmsg_internal("%s", _(msg)),
136  errdetail("Number of returned columns (%d) does not match "
137  "expected column count (%d).",
138  nincols, noutcols)));
139 
140  /*
141  * Check to see if the map is one-to-one, in which case we need not do a
142  * tuple conversion. We must also insist that both tupdescs either
143  * specify or don't specify an OID column, else we need a conversion to
144  * add/remove space for that. (For some callers, presence or absence of
145  * an OID column perhaps would not really matter, but let's be safe.)
146  */
147  if (indesc->natts == outdesc->natts &&
148  indesc->tdhasoid == outdesc->tdhasoid)
149  {
150  for (i = 0; i < n; i++)
151  {
152  if (attrMap[i] == (i + 1))
153  continue;
154 
155  /*
156  * If it's a dropped column and the corresponding input column is
157  * also dropped, we needn't convert. However, attlen and attalign
158  * must agree.
159  */
160  if (attrMap[i] == 0 &&
161  indesc->attrs[i]->attisdropped &&
162  indesc->attrs[i]->attlen == outdesc->attrs[i]->attlen &&
163  indesc->attrs[i]->attalign == outdesc->attrs[i]->attalign)
164  continue;
165 
166  same = false;
167  break;
168  }
169  }
170  else
171  same = false;
172 
173  if (same)
174  {
175  /* Runtime conversion is not needed */
176  pfree(attrMap);
177  return NULL;
178  }
179 
180  /* Prepare the map structure */
181  map = (TupleConversionMap *) palloc(sizeof(TupleConversionMap));
182  map->indesc = indesc;
183  map->outdesc = outdesc;
184  map->attrMap = attrMap;
185  /* preallocate workspace for Datum arrays */
186  map->outvalues = (Datum *) palloc(n * sizeof(Datum));
187  map->outisnull = (bool *) palloc(n * sizeof(bool));
188  n = indesc->natts + 1; /* +1 for NULL */
189  map->invalues = (Datum *) palloc(n * sizeof(Datum));
190  map->inisnull = (bool *) palloc(n * sizeof(bool));
191  map->invalues[0] = (Datum) 0; /* set up the NULL entry */
192  map->inisnull[0] = true;
193 
194  return map;
195 }
AttrNumber * attrMap
Definition: tupconvert.h:25
TupleDesc indesc
Definition: tupconvert.h:23
TupleDesc outdesc
Definition: tupconvert.h:24
bool tdhasoid
Definition: tupdesc.h:79
Form_pg_attribute * attrs
Definition: tupdesc.h:74
int errcode(int sqlerrcode)
Definition: elog.c:575
unsigned int Oid
Definition: postgres_ext.h:31
int natts
Definition: tupdesc.h:73
signed int int32
Definition: c.h:256
void pfree(void *pointer)
Definition: mcxt.c:950
#define ERROR
Definition: elog.h:43
int errdetail(const char *fmt,...)
Definition: elog.c:873
FormData_pg_attribute * Form_pg_attribute
Definition: pg_attribute.h:187
#define ereport(elevel, rest)
Definition: elog.h:122
char * format_type_with_typemod(Oid type_oid, int32 typemod)
Definition: format_type.c:113
void * palloc0(Size size)
Definition: mcxt.c:878
uintptr_t Datum
Definition: postgres.h:372
int errmsg_internal(const char *fmt,...)
Definition: elog.c:827
#define NULL
Definition: c.h:229
void * palloc(Size size)
Definition: mcxt.c:849
int i
int16 AttrNumber
Definition: attnum.h:21
#define _(x)
Definition: elog.c:84
HeapTuple do_convert_tuple ( HeapTuple  tuple,
TupleConversionMap map 
)

Definition at line 343 of file tupconvert.c.

References TupleConversionMap::attrMap, heap_deform_tuple(), heap_form_tuple(), i, TupleConversionMap::indesc, TupleConversionMap::inisnull, TupleConversionMap::invalues, tupleDesc::natts, TupleConversionMap::outdesc, TupleConversionMap::outisnull, and TupleConversionMap::outvalues.

Referenced by acquire_inherited_sample_rows(), CopyFrom(), exec_stmt_return_next(), exec_stmt_return_query(), ExecConstraints(), ExecEvalConvertRowtype(), ExecInsert(), get_partition_for_tuple(), plpgsql_exec_function(), and plpgsql_exec_trigger().

344 {
345  AttrNumber *attrMap = map->attrMap;
346  Datum *invalues = map->invalues;
347  bool *inisnull = map->inisnull;
348  Datum *outvalues = map->outvalues;
349  bool *outisnull = map->outisnull;
350  int outnatts = map->outdesc->natts;
351  int i;
352 
353  /*
354  * Extract all the values of the old tuple, offsetting the arrays so that
355  * invalues[0] is left NULL and invalues[1] is the first source attribute;
356  * this exactly matches the numbering convention in attrMap.
357  */
358  heap_deform_tuple(tuple, map->indesc, invalues + 1, inisnull + 1);
359 
360  /*
361  * Transpose into proper fields of the new tuple.
362  */
363  for (i = 0; i < outnatts; i++)
364  {
365  int j = attrMap[i];
366 
367  outvalues[i] = invalues[j];
368  outisnull[i] = inisnull[j];
369  }
370 
371  /*
372  * Now form the new tuple.
373  */
374  return heap_form_tuple(map->outdesc, outvalues, outisnull);
375 }
AttrNumber * attrMap
Definition: tupconvert.h:25
TupleDesc indesc
Definition: tupconvert.h:23
TupleDesc outdesc
Definition: tupconvert.h:24
HeapTuple heap_form_tuple(TupleDesc tupleDescriptor, Datum *values, bool *isnull)
Definition: heaptuple.c:692
int natts
Definition: tupdesc.h:73
uintptr_t Datum
Definition: postgres.h:372
void heap_deform_tuple(HeapTuple tuple, TupleDesc tupleDesc, Datum *values, bool *isnull)
Definition: heaptuple.c:935
int i
int16 AttrNumber
Definition: attnum.h:21
void free_conversion_map ( TupleConversionMap map)

Definition at line 381 of file tupconvert.c.

References TupleConversionMap::attrMap, TupleConversionMap::inisnull, TupleConversionMap::invalues, TupleConversionMap::outisnull, TupleConversionMap::outvalues, and pfree().

Referenced by acquire_inherited_sample_rows().

382 {
383  /* indesc and outdesc are not ours to free */
384  pfree(map->attrMap);
385  pfree(map->invalues);
386  pfree(map->inisnull);
387  pfree(map->outvalues);
388  pfree(map->outisnull);
389  pfree(map);
390 }
AttrNumber * attrMap
Definition: tupconvert.h:25
void pfree(void *pointer)
Definition: mcxt.c:950