PostgreSQL Source Code  git master
Typedefs | Functions | Variables
pg_conversion.h File Reference
#include "catalog/genbki.h"
#include "catalog/objectaddress.h"
#include "catalog/pg_conversion_d.h"
Include dependency graph for pg_conversion.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Typedefs

typedef FormData_pg_conversion * Form_pg_conversion
 

Functions

 CATALOG (pg_conversion, 2607, ConversionRelationId)
 
 DECLARE_UNIQUE_INDEX (pg_conversion_default_index, 2668, ConversionDefaultIndexId, pg_conversion, btree(connamespace oid_ops, conforencoding int4_ops, contoencoding int4_ops, oid oid_ops))
 
 DECLARE_UNIQUE_INDEX (pg_conversion_name_nsp_index, 2669, ConversionNameNspIndexId, pg_conversion, btree(conname name_ops, connamespace oid_ops))
 
 DECLARE_UNIQUE_INDEX_PKEY (pg_conversion_oid_index, 2670, ConversionOidIndexId, pg_conversion, btree(oid oid_ops))
 
ObjectAddress ConversionCreate (const char *conname, Oid connamespace, Oid conowner, int32 conforencoding, int32 contoencoding, Oid conproc, bool def)
 
Oid FindDefaultConversion (Oid name_space, int32 for_encoding, int32 to_encoding)
 

Variables

 FormData_pg_conversion
 

Typedef Documentation

◆ Form_pg_conversion

typedef FormData_pg_conversion* Form_pg_conversion

Definition at line 61 of file pg_conversion.h.

Function Documentation

◆ CATALOG()

CATALOG ( pg_conversion  ,
2607  ,
ConversionRelationId   
)

Definition at line 29 of file pg_conversion.h.

30 {
31  /* oid */
32  Oid oid;
33 
34  /* name of the conversion */
35  NameData conname;
36 
37  /* namespace that the conversion belongs to */
38  Oid connamespace BKI_DEFAULT(pg_catalog) BKI_LOOKUP(pg_namespace);
39 
40  /* owner of the conversion */
41  Oid conowner BKI_DEFAULT(POSTGRES) BKI_LOOKUP(pg_authid);
42 
43  /* FOR encoding id */
44  int32 conforencoding BKI_LOOKUP(encoding);
45 
46  /* TO encoding id */
47  int32 contoencoding BKI_LOOKUP(encoding);
48 
49  /* OID of the conversion proc */
50  regproc conproc BKI_LOOKUP(pg_proc);
51 
52  /* true if this is a default conversion */
53  bool condefault BKI_DEFAULT(t);
54 } FormData_pg_conversion;
int32
signed int int32
Definition: c.h:483
regproc
Oid regproc
Definition: c.h:638
BKI_LOOKUP
#define BKI_LOOKUP(catalog)
Definition: genbki.h:46
BKI_DEFAULT
#define BKI_DEFAULT(value)
Definition: genbki.h:35
FormData_pg_conversion
FormData_pg_conversion
Definition: pg_conversion.h:54
encoding
int32 encoding
Definition: pg_database.h:41
Oid
unsigned int Oid
Definition: postgres_ext.h:31
nameData
Definition: c.h:730

References BKI_DEFAULT, BKI_LOOKUP, and encoding.

◆ ConversionCreate()

ObjectAddress ConversionCreate ( const char *  conname,
Oid  connamespace,
Oid  conowner,
int32  conforencoding,
int32  contoencoding,
Oid  conproc,
bool  def 
)

Definition at line 41 of file pg_conversion.c.

45 {
46  int i;
47  Relation rel;
48  TupleDesc tupDesc;
49  HeapTuple tup;
50  Oid oid;
51  bool nulls[Natts_pg_conversion];
52  Datum values[Natts_pg_conversion];
53  NameData cname;
54  ObjectAddress myself,
55  referenced;
56 
57  /* sanity checks */
58  if (!conname)
59  elog(ERROR, "no conversion name supplied");
60 
61  /* make sure there is no existing conversion of same name */
62  if (SearchSysCacheExists2(CONNAMENSP,
63  PointerGetDatum(conname),
64  ObjectIdGetDatum(connamespace)))
65  ereport(ERROR,
66  (errcode(ERRCODE_DUPLICATE_OBJECT),
67  errmsg("conversion \"%s\" already exists", conname)));
68 
69  if (def)
70  {
71  /*
72  * make sure there is no existing default <for encoding><to encoding>
73  * pair in this name space
74  */
75  if (FindDefaultConversion(connamespace,
76  conforencoding,
77  contoencoding))
78  ereport(ERROR,
79  (errcode(ERRCODE_DUPLICATE_OBJECT),
80  errmsg("default conversion for %s to %s already exists",
81  pg_encoding_to_char(conforencoding),
82  pg_encoding_to_char(contoencoding))));
83  }
84 
85  /* open pg_conversion */
86  rel = table_open(ConversionRelationId, RowExclusiveLock);
87  tupDesc = rel->rd_att;
88 
89  /* initialize nulls and values */
90  for (i = 0; i < Natts_pg_conversion; i++)
91  {
92  nulls[i] = false;
93  values[i] = (Datum) NULL;
94  }
95 
96  /* form a tuple */
97  namestrcpy(&cname, conname);
98  oid = GetNewOidWithIndex(rel, ConversionOidIndexId,
99  Anum_pg_conversion_oid);
100  values[Anum_pg_conversion_oid - 1] = ObjectIdGetDatum(oid);
101  values[Anum_pg_conversion_conname - 1] = NameGetDatum(&cname);
102  values[Anum_pg_conversion_connamespace - 1] = ObjectIdGetDatum(connamespace);
103  values[Anum_pg_conversion_conowner - 1] = ObjectIdGetDatum(conowner);
104  values[Anum_pg_conversion_conforencoding - 1] = Int32GetDatum(conforencoding);
105  values[Anum_pg_conversion_contoencoding - 1] = Int32GetDatum(contoencoding);
106  values[Anum_pg_conversion_conproc - 1] = ObjectIdGetDatum(conproc);
107  values[Anum_pg_conversion_condefault - 1] = BoolGetDatum(def);
108 
109  tup = heap_form_tuple(tupDesc, values, nulls);
110 
111  /* insert a new tuple */
112  CatalogTupleInsert(rel, tup);
113 
114  myself.classId = ConversionRelationId;
115  myself.objectId = oid;
116  myself.objectSubId = 0;
117 
118  /* create dependency on conversion procedure */
119  referenced.classId = ProcedureRelationId;
120  referenced.objectId = conproc;
121  referenced.objectSubId = 0;
122  recordDependencyOn(&myself, &referenced, DEPENDENCY_NORMAL);
123 
124  /* create dependency on namespace */
125  referenced.classId = NamespaceRelationId;
126  referenced.objectId = connamespace;
127  referenced.objectSubId = 0;
128  recordDependencyOn(&myself, &referenced, DEPENDENCY_NORMAL);
129 
130  /* create dependency on owner */
131  recordDependencyOnOwner(ConversionRelationId, oid, conowner);
132 
133  /* dependency on extension */
134  recordDependencyOnCurrentExtension(&myself, false);
135 
136  /* Post creation hook for new conversion */
137  InvokeObjectPostCreateHook(ConversionRelationId, oid, 0);
138 
139  heap_freetuple(tup);
140  table_close(rel, RowExclusiveLock);
141 
142  return myself;
143 }
values
static Datum values[MAXATTR]
Definition: bootstrap.c:156
GetNewOidWithIndex
Oid GetNewOidWithIndex(Relation relation, Oid indexId, AttrNumber oidcolumn)
Definition: catalog.c:393
DEPENDENCY_NORMAL
@ DEPENDENCY_NORMAL
Definition: dependency.h:33
errcode
int errcode(int sqlerrcode)
Definition: elog.c:858
errmsg
int errmsg(const char *fmt,...)
Definition: elog.c:1069
ERROR
#define ERROR
Definition: elog.h:39
ereport
#define ereport(elevel,...)
Definition: elog.h:149
heap_form_tuple
HeapTuple heap_form_tuple(TupleDesc tupleDescriptor, const Datum *values, const bool *isnull)
Definition: heaptuple.c:1117
heap_freetuple
void heap_freetuple(HeapTuple htup)
Definition: heaptuple.c:1435
CatalogTupleInsert
void CatalogTupleInsert(Relation heapRel, HeapTuple tup)
Definition: indexing.c:233
i
int i
Definition: isn.c:73
RowExclusiveLock
#define RowExclusiveLock
Definition: lockdefs.h:38
namestrcpy
void namestrcpy(Name name, const char *str)
Definition: name.c:233
InvokeObjectPostCreateHook
#define InvokeObjectPostCreateHook(classId, objectId, subId)
Definition: objectaccess.h:173
FindDefaultConversion
Oid FindDefaultConversion(Oid name_space, int32 for_encoding, int32 to_encoding)
Definition: pg_conversion.c:155
recordDependencyOn
void recordDependencyOn(const ObjectAddress *depender, const ObjectAddress *referenced, DependencyType behavior)
Definition: pg_depend.c:44
recordDependencyOnCurrentExtension
void recordDependencyOnCurrentExtension(const ObjectAddress *object, bool isReplace)
Definition: pg_depend.c:192
recordDependencyOnOwner
void recordDependencyOnOwner(Oid classId, Oid objectId, Oid owner)
Definition: pg_shdepend.c:165
pg_encoding_to_char
#define pg_encoding_to_char
Definition: pg_wchar.h:563
PointerGetDatum
static Datum PointerGetDatum(const void *X)
Definition: postgres.h:322
Datum
uintptr_t Datum
Definition: postgres.h:64
BoolGetDatum
static Datum BoolGetDatum(bool X)
Definition: postgres.h:102
ObjectIdGetDatum
static Datum ObjectIdGetDatum(Oid X)
Definition: postgres.h:252
NameGetDatum
static Datum NameGetDatum(const NameData *X)
Definition: postgres.h:373
Int32GetDatum
static Datum Int32GetDatum(int32 X)
Definition: postgres.h:212
ERRCODE_DUPLICATE_OBJECT
#define ERRCODE_DUPLICATE_OBJECT
Definition: streamutil.c:32
RelationData::rd_att
TupleDesc rd_att
Definition: rel.h:112
CONNAMENSP
@ CONNAMENSP
Definition: syscache.h:52
SearchSysCacheExists2
#define SearchSysCacheExists2(cacheId, key1, key2)
Definition: syscache.h:193
table_close
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:126
table_open
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:40

References BoolGetDatum(), CatalogTupleInsert(), ObjectAddress::classId, CONNAMENSP, DEPENDENCY_NORMAL, elog(), ereport, errcode(), ERRCODE_DUPLICATE_OBJECT, errmsg(), ERROR, FindDefaultConversion(), GetNewOidWithIndex(), heap_form_tuple(), heap_freetuple(), i, Int32GetDatum(), InvokeObjectPostCreateHook, NameGetDatum(), namestrcpy(), ObjectAddress::objectId, ObjectIdGetDatum(), ObjectAddress::objectSubId, pg_encoding_to_char, PointerGetDatum(), RelationData::rd_att, recordDependencyOn(), recordDependencyOnCurrentExtension(), recordDependencyOnOwner(), RowExclusiveLock, SearchSysCacheExists2, table_close(), table_open(), and values.

Referenced by CreateConversionCommand().

◆ DECLARE_UNIQUE_INDEX() [1/2]

DECLARE_UNIQUE_INDEX ( pg_conversion_default_index  ,
2668  ,
ConversionDefaultIndexId  ,
pg_conversion  ,
btree(connamespace oid_ops, conforencoding int4_ops, contoencoding int4_ops, oid oid_ops)   
)

◆ DECLARE_UNIQUE_INDEX() [2/2]

DECLARE_UNIQUE_INDEX ( pg_conversion_name_nsp_index  ,
2669  ,
ConversionNameNspIndexId  ,
pg_conversion  ,
btree(conname name_ops, connamespace oid_ops)   
)

◆ DECLARE_UNIQUE_INDEX_PKEY()

DECLARE_UNIQUE_INDEX_PKEY ( pg_conversion_oid_index  ,
2670  ,
ConversionOidIndexId  ,
pg_conversion  ,
btree(oid oid_ops)   
)

◆ FindDefaultConversion()

Oid FindDefaultConversion ( Oid  name_space,
int32  for_encoding,
int32  to_encoding 
)

Definition at line 155 of file pg_conversion.c.

156 {
157  CatCList *catlist;
158  HeapTuple tuple;
159  Form_pg_conversion body;
160  Oid proc = InvalidOid;
161  int i;
162 
163  catlist = SearchSysCacheList3(CONDEFAULT,
164  ObjectIdGetDatum(name_space),
165  Int32GetDatum(for_encoding),
166  Int32GetDatum(to_encoding));
167 
168  for (i = 0; i < catlist->n_members; i++)
169  {
170  tuple = &catlist->members[i]->tuple;
171  body = (Form_pg_conversion) GETSTRUCT(tuple);
172  if (body->condefault)
173  {
174  proc = body->conproc;
175  break;
176  }
177  }
178  ReleaseSysCacheList(catlist);
179  return proc;
180 }
GETSTRUCT
#define GETSTRUCT(TUP)
Definition: htup_details.h:653
Form_pg_conversion
FormData_pg_conversion * Form_pg_conversion
Definition: pg_conversion.h:61
InvalidOid
#define InvalidOid
Definition: postgres_ext.h:36
catclist::members
CatCTup * members[FLEXIBLE_ARRAY_MEMBER]
Definition: catcache.h:178
catclist::n_members
int n_members
Definition: catcache.h:176
catctup::tuple
HeapTupleData tuple
Definition: catcache.h:121
SearchSysCacheList3
#define SearchSysCacheList3(cacheId, key1, key2, key3)
Definition: syscache.h:222
CONDEFAULT
@ CONDEFAULT
Definition: syscache.h:51
ReleaseSysCacheList
#define ReleaseSysCacheList(x)
Definition: syscache.h:225

References CONDEFAULT, GETSTRUCT, i, Int32GetDatum(), InvalidOid, catclist::members, catclist::n_members, ObjectIdGetDatum(), ReleaseSysCacheList, SearchSysCacheList3, and catctup::tuple.

Referenced by ConversionCreate(), and FindDefaultConversionProc().

Variable Documentation

◆ FormData_pg_conversion

FormData_pg_conversion

Definition at line 54 of file pg_conversion.h.