Line data Source code
1 : /*-------------------------------------------------------------------------
2 : *
3 : * ruleutils.c
4 : * Functions to convert stored expressions/querytrees back to
5 : * source text
6 : *
7 : * Portions Copyright (c) 1996-2025, PostgreSQL Global Development Group
8 : * Portions Copyright (c) 1994, Regents of the University of California
9 : *
10 : *
11 : * IDENTIFICATION
12 : * src/backend/utils/adt/ruleutils.c
13 : *
14 : *-------------------------------------------------------------------------
15 : */
16 : #include "postgres.h"
17 :
18 : #include <ctype.h>
19 : #include <unistd.h>
20 : #include <fcntl.h>
21 :
22 : #include "access/amapi.h"
23 : #include "access/htup_details.h"
24 : #include "access/relation.h"
25 : #include "access/table.h"
26 : #include "catalog/pg_aggregate.h"
27 : #include "catalog/pg_am.h"
28 : #include "catalog/pg_authid.h"
29 : #include "catalog/pg_collation.h"
30 : #include "catalog/pg_constraint.h"
31 : #include "catalog/pg_depend.h"
32 : #include "catalog/pg_language.h"
33 : #include "catalog/pg_opclass.h"
34 : #include "catalog/pg_operator.h"
35 : #include "catalog/pg_partitioned_table.h"
36 : #include "catalog/pg_proc.h"
37 : #include "catalog/pg_statistic_ext.h"
38 : #include "catalog/pg_trigger.h"
39 : #include "catalog/pg_type.h"
40 : #include "commands/defrem.h"
41 : #include "commands/tablespace.h"
42 : #include "common/keywords.h"
43 : #include "executor/spi.h"
44 : #include "funcapi.h"
45 : #include "mb/pg_wchar.h"
46 : #include "miscadmin.h"
47 : #include "nodes/makefuncs.h"
48 : #include "nodes/nodeFuncs.h"
49 : #include "nodes/pathnodes.h"
50 : #include "optimizer/optimizer.h"
51 : #include "parser/parse_agg.h"
52 : #include "parser/parse_func.h"
53 : #include "parser/parse_oper.h"
54 : #include "parser/parse_relation.h"
55 : #include "parser/parser.h"
56 : #include "parser/parsetree.h"
57 : #include "rewrite/rewriteHandler.h"
58 : #include "rewrite/rewriteManip.h"
59 : #include "rewrite/rewriteSupport.h"
60 : #include "utils/array.h"
61 : #include "utils/builtins.h"
62 : #include "utils/fmgroids.h"
63 : #include "utils/guc.h"
64 : #include "utils/hsearch.h"
65 : #include "utils/lsyscache.h"
66 : #include "utils/partcache.h"
67 : #include "utils/rel.h"
68 : #include "utils/ruleutils.h"
69 : #include "utils/snapmgr.h"
70 : #include "utils/syscache.h"
71 : #include "utils/typcache.h"
72 : #include "utils/varlena.h"
73 : #include "utils/xml.h"
74 :
75 : /* ----------
76 : * Pretty formatting constants
77 : * ----------
78 : */
79 :
80 : /* Indent counts */
81 : #define PRETTYINDENT_STD 8
82 : #define PRETTYINDENT_JOIN 4
83 : #define PRETTYINDENT_VAR 4
84 :
85 : #define PRETTYINDENT_LIMIT 40 /* wrap limit */
86 :
87 : /* Pretty flags */
88 : #define PRETTYFLAG_PAREN 0x0001
89 : #define PRETTYFLAG_INDENT 0x0002
90 : #define PRETTYFLAG_SCHEMA 0x0004
91 :
92 : /* Standard conversion of a "bool pretty" option to detailed flags */
93 : #define GET_PRETTY_FLAGS(pretty) \
94 : ((pretty) ? (PRETTYFLAG_PAREN | PRETTYFLAG_INDENT | PRETTYFLAG_SCHEMA) \
95 : : PRETTYFLAG_INDENT)
96 :
97 : /* Default line length for pretty-print wrapping: 0 means wrap always */
98 : #define WRAP_COLUMN_DEFAULT 0
99 :
100 : /* macros to test if pretty action needed */
101 : #define PRETTY_PAREN(context) ((context)->prettyFlags & PRETTYFLAG_PAREN)
102 : #define PRETTY_INDENT(context) ((context)->prettyFlags & PRETTYFLAG_INDENT)
103 : #define PRETTY_SCHEMA(context) ((context)->prettyFlags & PRETTYFLAG_SCHEMA)
104 :
105 :
106 : /* ----------
107 : * Local data types
108 : * ----------
109 : */
110 :
111 : /* Context info needed for invoking a recursive querytree display routine */
112 : typedef struct
113 : {
114 : StringInfo buf; /* output buffer to append to */
115 : List *namespaces; /* List of deparse_namespace nodes */
116 : TupleDesc resultDesc; /* if top level of a view, the view's tupdesc */
117 : List *targetList; /* Current query level's SELECT targetlist */
118 : List *windowClause; /* Current query level's WINDOW clause */
119 : int prettyFlags; /* enabling of pretty-print functions */
120 : int wrapColumn; /* max line length, or -1 for no limit */
121 : int indentLevel; /* current indent level for pretty-print */
122 : bool varprefix; /* true to print prefixes on Vars */
123 : bool colNamesVisible; /* do we care about output column names? */
124 : bool inGroupBy; /* deparsing GROUP BY clause? */
125 : bool varInOrderBy; /* deparsing simple Var in ORDER BY? */
126 : Bitmapset *appendparents; /* if not null, map child Vars of these relids
127 : * back to the parent rel */
128 : } deparse_context;
129 :
130 : /*
131 : * Each level of query context around a subtree needs a level of Var namespace.
132 : * A Var having varlevelsup=N refers to the N'th item (counting from 0) in
133 : * the current context's namespaces list.
134 : *
135 : * rtable is the list of actual RTEs from the Query or PlannedStmt.
136 : * rtable_names holds the alias name to be used for each RTE (either a C
137 : * string, or NULL for nameless RTEs such as unnamed joins).
138 : * rtable_columns holds the column alias names to be used for each RTE.
139 : *
140 : * subplans is a list of Plan trees for SubPlans and CTEs (it's only used
141 : * in the PlannedStmt case).
142 : * ctes is a list of CommonTableExpr nodes (only used in the Query case).
143 : * appendrels, if not null (it's only used in the PlannedStmt case), is an
144 : * array of AppendRelInfo nodes, indexed by child relid. We use that to map
145 : * child-table Vars to their inheritance parents.
146 : *
147 : * In some cases we need to make names of merged JOIN USING columns unique
148 : * across the whole query, not only per-RTE. If so, unique_using is true
149 : * and using_names is a list of C strings representing names already assigned
150 : * to USING columns.
151 : *
152 : * When deparsing plan trees, there is always just a single item in the
153 : * deparse_namespace list (since a plan tree never contains Vars with
154 : * varlevelsup > 0). We store the Plan node that is the immediate
155 : * parent of the expression to be deparsed, as well as a list of that
156 : * Plan's ancestors. In addition, we store its outer and inner subplan nodes,
157 : * as well as their targetlists, and the index tlist if the current plan node
158 : * might contain INDEX_VAR Vars. (These fields could be derived on-the-fly
159 : * from the current Plan node, but it seems notationally clearer to set them
160 : * up as separate fields.)
161 : */
162 : typedef struct
163 : {
164 : List *rtable; /* List of RangeTblEntry nodes */
165 : List *rtable_names; /* Parallel list of names for RTEs */
166 : List *rtable_columns; /* Parallel list of deparse_columns structs */
167 : List *subplans; /* List of Plan trees for SubPlans */
168 : List *ctes; /* List of CommonTableExpr nodes */
169 : AppendRelInfo **appendrels; /* Array of AppendRelInfo nodes, or NULL */
170 : char *ret_old_alias; /* alias for OLD in RETURNING list */
171 : char *ret_new_alias; /* alias for NEW in RETURNING list */
172 : /* Workspace for column alias assignment: */
173 : bool unique_using; /* Are we making USING names globally unique */
174 : List *using_names; /* List of assigned names for USING columns */
175 : /* Remaining fields are used only when deparsing a Plan tree: */
176 : Plan *plan; /* immediate parent of current expression */
177 : List *ancestors; /* ancestors of plan */
178 : Plan *outer_plan; /* outer subnode, or NULL if none */
179 : Plan *inner_plan; /* inner subnode, or NULL if none */
180 : List *outer_tlist; /* referent for OUTER_VAR Vars */
181 : List *inner_tlist; /* referent for INNER_VAR Vars */
182 : List *index_tlist; /* referent for INDEX_VAR Vars */
183 : /* Special namespace representing a function signature: */
184 : char *funcname;
185 : int numargs;
186 : char **argnames;
187 : } deparse_namespace;
188 :
189 : /*
190 : * Per-relation data about column alias names.
191 : *
192 : * Selecting aliases is unreasonably complicated because of the need to dump
193 : * rules/views whose underlying tables may have had columns added, deleted, or
194 : * renamed since the query was parsed. We must nonetheless print the rule/view
195 : * in a form that can be reloaded and will produce the same results as before.
196 : *
197 : * For each RTE used in the query, we must assign column aliases that are
198 : * unique within that RTE. SQL does not require this of the original query,
199 : * but due to factors such as *-expansion we need to be able to uniquely
200 : * reference every column in a decompiled query. As long as we qualify all
201 : * column references, per-RTE uniqueness is sufficient for that.
202 : *
203 : * However, we can't ensure per-column name uniqueness for unnamed join RTEs,
204 : * since they just inherit column names from their input RTEs, and we can't
205 : * rename the columns at the join level. Most of the time this isn't an issue
206 : * because we don't need to reference the join's output columns as such; we
207 : * can reference the input columns instead. That approach can fail for merged
208 : * JOIN USING columns, however, so when we have one of those in an unnamed
209 : * join, we have to make that column's alias globally unique across the whole
210 : * query to ensure it can be referenced unambiguously.
211 : *
212 : * Another problem is that a JOIN USING clause requires the columns to be
213 : * merged to have the same aliases in both input RTEs, and that no other
214 : * columns in those RTEs or their children conflict with the USING names.
215 : * To handle that, we do USING-column alias assignment in a recursive
216 : * traversal of the query's jointree. When descending through a JOIN with
217 : * USING, we preassign the USING column names to the child columns, overriding
218 : * other rules for column alias assignment. We also mark each RTE with a list
219 : * of all USING column names selected for joins containing that RTE, so that
220 : * when we assign other columns' aliases later, we can avoid conflicts.
221 : *
222 : * Another problem is that if a JOIN's input tables have had columns added or
223 : * deleted since the query was parsed, we must generate a column alias list
224 : * for the join that matches the current set of input columns --- otherwise, a
225 : * change in the number of columns in the left input would throw off matching
226 : * of aliases to columns of the right input. Thus, positions in the printable
227 : * column alias list are not necessarily one-for-one with varattnos of the
228 : * JOIN, so we need a separate new_colnames[] array for printing purposes.
229 : *
230 : * Finally, when dealing with wide tables we risk O(N^2) costs in assigning
231 : * non-duplicate column names. We ameliorate that by using a hash table that
232 : * holds all the strings appearing in colnames, new_colnames, and parentUsing.
233 : */
234 : typedef struct
235 : {
236 : /*
237 : * colnames is an array containing column aliases to use for columns that
238 : * existed when the query was parsed. Dropped columns have NULL entries.
239 : * This array can be directly indexed by varattno to get a Var's name.
240 : *
241 : * Non-NULL entries are guaranteed unique within the RTE, *except* when
242 : * this is for an unnamed JOIN RTE. In that case we merely copy up names
243 : * from the two input RTEs.
244 : *
245 : * During the recursive descent in set_using_names(), forcible assignment
246 : * of a child RTE's column name is represented by pre-setting that element
247 : * of the child's colnames array. So at that stage, NULL entries in this
248 : * array just mean that no name has been preassigned, not necessarily that
249 : * the column is dropped.
250 : */
251 : int num_cols; /* length of colnames[] array */
252 : char **colnames; /* array of C strings and NULLs */
253 :
254 : /*
255 : * new_colnames is an array containing column aliases to use for columns
256 : * that would exist if the query was re-parsed against the current
257 : * definitions of its base tables. This is what to print as the column
258 : * alias list for the RTE. This array does not include dropped columns,
259 : * but it will include columns added since original parsing. Indexes in
260 : * it therefore have little to do with current varattno values. As above,
261 : * entries are unique unless this is for an unnamed JOIN RTE. (In such an
262 : * RTE, we never actually print this array, but we must compute it anyway
263 : * for possible use in computing column names of upper joins.) The
264 : * parallel array is_new_col marks which of these columns are new since
265 : * original parsing. Entries with is_new_col false must match the
266 : * non-NULL colnames entries one-for-one.
267 : */
268 : int num_new_cols; /* length of new_colnames[] array */
269 : char **new_colnames; /* array of C strings */
270 : bool *is_new_col; /* array of bool flags */
271 :
272 : /* This flag tells whether we should actually print a column alias list */
273 : bool printaliases;
274 :
275 : /* This list has all names used as USING names in joins above this RTE */
276 : List *parentUsing; /* names assigned to parent merged columns */
277 :
278 : /*
279 : * If this struct is for a JOIN RTE, we fill these fields during the
280 : * set_using_names() pass to describe its relationship to its child RTEs.
281 : *
282 : * leftattnos and rightattnos are arrays with one entry per existing
283 : * output column of the join (hence, indexable by join varattno). For a
284 : * simple reference to a column of the left child, leftattnos[i] is the
285 : * child RTE's attno and rightattnos[i] is zero; and conversely for a
286 : * column of the right child. But for merged columns produced by JOIN
287 : * USING/NATURAL JOIN, both leftattnos[i] and rightattnos[i] are nonzero.
288 : * Note that a simple reference might be to a child RTE column that's been
289 : * dropped; but that's OK since the column could not be used in the query.
290 : *
291 : * If it's a JOIN USING, usingNames holds the alias names selected for the
292 : * merged columns (these might be different from the original USING list,
293 : * if we had to modify names to achieve uniqueness).
294 : */
295 : int leftrti; /* rangetable index of left child */
296 : int rightrti; /* rangetable index of right child */
297 : int *leftattnos; /* left-child varattnos of join cols, or 0 */
298 : int *rightattnos; /* right-child varattnos of join cols, or 0 */
299 : List *usingNames; /* names assigned to merged columns */
300 :
301 : /*
302 : * Hash table holding copies of all the strings appearing in this struct's
303 : * colnames, new_colnames, and parentUsing. We use a hash table only for
304 : * sufficiently wide relations, and only during the colname-assignment
305 : * functions set_relation_column_names and set_join_column_names;
306 : * otherwise, names_hash is NULL.
307 : */
308 : HTAB *names_hash; /* entries are just strings */
309 : } deparse_columns;
310 :
311 : /* This macro is analogous to rt_fetch(), but for deparse_columns structs */
312 : #define deparse_columns_fetch(rangetable_index, dpns) \
313 : ((deparse_columns *) list_nth((dpns)->rtable_columns, (rangetable_index)-1))
314 :
315 : /*
316 : * Entry in set_rtable_names' hash table
317 : */
318 : typedef struct
319 : {
320 : char name[NAMEDATALEN]; /* Hash key --- must be first */
321 : int counter; /* Largest addition used so far for name */
322 : } NameHashEntry;
323 :
324 : /* Callback signature for resolve_special_varno() */
325 : typedef void (*rsv_callback) (Node *node, deparse_context *context,
326 : void *callback_arg);
327 :
328 :
329 : /* ----------
330 : * Global data
331 : * ----------
332 : */
333 : static SPIPlanPtr plan_getrulebyoid = NULL;
334 : static const char *const query_getrulebyoid = "SELECT * FROM pg_catalog.pg_rewrite WHERE oid = $1";
335 : static SPIPlanPtr plan_getviewrule = NULL;
336 : static const char *const query_getviewrule = "SELECT * FROM pg_catalog.pg_rewrite WHERE ev_class = $1 AND rulename = $2";
337 :
338 : /* GUC parameters */
339 : bool quote_all_identifiers = false;
340 :
341 :
342 : /* ----------
343 : * Local functions
344 : *
345 : * Most of these functions used to use fixed-size buffers to build their
346 : * results. Now, they take an (already initialized) StringInfo object
347 : * as a parameter, and append their text output to its contents.
348 : * ----------
349 : */
350 : static char *deparse_expression_pretty(Node *expr, List *dpcontext,
351 : bool forceprefix, bool showimplicit,
352 : int prettyFlags, int startIndent);
353 : static char *pg_get_viewdef_worker(Oid viewoid,
354 : int prettyFlags, int wrapColumn);
355 : static char *pg_get_triggerdef_worker(Oid trigid, bool pretty);
356 : static int decompile_column_index_array(Datum column_index_array, Oid relId,
357 : bool withPeriod, StringInfo buf);
358 : static char *pg_get_ruledef_worker(Oid ruleoid, int prettyFlags);
359 : static char *pg_get_indexdef_worker(Oid indexrelid, int colno,
360 : const Oid *excludeOps,
361 : bool attrsOnly, bool keysOnly,
362 : bool showTblSpc, bool inherits,
363 : int prettyFlags, bool missing_ok);
364 : static char *pg_get_statisticsobj_worker(Oid statextid, bool columns_only,
365 : bool missing_ok);
366 : static char *pg_get_partkeydef_worker(Oid relid, int prettyFlags,
367 : bool attrsOnly, bool missing_ok);
368 : static char *pg_get_constraintdef_worker(Oid constraintId, bool fullCommand,
369 : int prettyFlags, bool missing_ok);
370 : static text *pg_get_expr_worker(text *expr, Oid relid, int prettyFlags);
371 : static int print_function_arguments(StringInfo buf, HeapTuple proctup,
372 : bool print_table_args, bool print_defaults);
373 : static void print_function_rettype(StringInfo buf, HeapTuple proctup);
374 : static void print_function_trftypes(StringInfo buf, HeapTuple proctup);
375 : static void print_function_sqlbody(StringInfo buf, HeapTuple proctup);
376 : static void set_rtable_names(deparse_namespace *dpns, List *parent_namespaces,
377 : Bitmapset *rels_used);
378 : static void set_deparse_for_query(deparse_namespace *dpns, Query *query,
379 : List *parent_namespaces);
380 : static void set_simple_column_names(deparse_namespace *dpns);
381 : static bool has_dangerous_join_using(deparse_namespace *dpns, Node *jtnode);
382 : static void set_using_names(deparse_namespace *dpns, Node *jtnode,
383 : List *parentUsing);
384 : static void set_relation_column_names(deparse_namespace *dpns,
385 : RangeTblEntry *rte,
386 : deparse_columns *colinfo);
387 : static void set_join_column_names(deparse_namespace *dpns, RangeTblEntry *rte,
388 : deparse_columns *colinfo);
389 : static bool colname_is_unique(const char *colname, deparse_namespace *dpns,
390 : deparse_columns *colinfo);
391 : static char *make_colname_unique(char *colname, deparse_namespace *dpns,
392 : deparse_columns *colinfo);
393 : static void expand_colnames_array_to(deparse_columns *colinfo, int n);
394 : static void build_colinfo_names_hash(deparse_columns *colinfo);
395 : static void add_to_names_hash(deparse_columns *colinfo, const char *name);
396 : static void destroy_colinfo_names_hash(deparse_columns *colinfo);
397 : static void identify_join_columns(JoinExpr *j, RangeTblEntry *jrte,
398 : deparse_columns *colinfo);
399 : static char *get_rtable_name(int rtindex, deparse_context *context);
400 : static void set_deparse_plan(deparse_namespace *dpns, Plan *plan);
401 : static Plan *find_recursive_union(deparse_namespace *dpns,
402 : WorkTableScan *wtscan);
403 : static void push_child_plan(deparse_namespace *dpns, Plan *plan,
404 : deparse_namespace *save_dpns);
405 : static void pop_child_plan(deparse_namespace *dpns,
406 : deparse_namespace *save_dpns);
407 : static void push_ancestor_plan(deparse_namespace *dpns, ListCell *ancestor_cell,
408 : deparse_namespace *save_dpns);
409 : static void pop_ancestor_plan(deparse_namespace *dpns,
410 : deparse_namespace *save_dpns);
411 : static void make_ruledef(StringInfo buf, HeapTuple ruletup, TupleDesc rulettc,
412 : int prettyFlags);
413 : static void make_viewdef(StringInfo buf, HeapTuple ruletup, TupleDesc rulettc,
414 : int prettyFlags, int wrapColumn);
415 : static void get_query_def(Query *query, StringInfo buf, List *parentnamespace,
416 : TupleDesc resultDesc, bool colNamesVisible,
417 : int prettyFlags, int wrapColumn, int startIndent);
418 : static void get_values_def(List *values_lists, deparse_context *context);
419 : static void get_with_clause(Query *query, deparse_context *context);
420 : static void get_select_query_def(Query *query, deparse_context *context);
421 : static void get_insert_query_def(Query *query, deparse_context *context);
422 : static void get_update_query_def(Query *query, deparse_context *context);
423 : static void get_update_query_targetlist_def(Query *query, List *targetList,
424 : deparse_context *context,
425 : RangeTblEntry *rte);
426 : static void get_delete_query_def(Query *query, deparse_context *context);
427 : static void get_merge_query_def(Query *query, deparse_context *context);
428 : static void get_utility_query_def(Query *query, deparse_context *context);
429 : static void get_basic_select_query(Query *query, deparse_context *context);
430 : static void get_target_list(List *targetList, deparse_context *context);
431 : static void get_returning_clause(Query *query, deparse_context *context);
432 : static void get_setop_query(Node *setOp, Query *query,
433 : deparse_context *context);
434 : static Node *get_rule_sortgroupclause(Index ref, List *tlist,
435 : bool force_colno,
436 : deparse_context *context);
437 : static void get_rule_groupingset(GroupingSet *gset, List *targetlist,
438 : bool omit_parens, deparse_context *context);
439 : static void get_rule_orderby(List *orderList, List *targetList,
440 : bool force_colno, deparse_context *context);
441 : static void get_rule_windowclause(Query *query, deparse_context *context);
442 : static void get_rule_windowspec(WindowClause *wc, List *targetList,
443 : deparse_context *context);
444 : static void get_window_frame_options(int frameOptions,
445 : Node *startOffset, Node *endOffset,
446 : deparse_context *context);
447 : static char *get_variable(Var *var, int levelsup, bool istoplevel,
448 : deparse_context *context);
449 : static void get_special_variable(Node *node, deparse_context *context,
450 : void *callback_arg);
451 : static void resolve_special_varno(Node *node, deparse_context *context,
452 : rsv_callback callback, void *callback_arg);
453 : static Node *find_param_referent(Param *param, deparse_context *context,
454 : deparse_namespace **dpns_p, ListCell **ancestor_cell_p);
455 : static SubPlan *find_param_generator(Param *param, deparse_context *context,
456 : int *column_p);
457 : static SubPlan *find_param_generator_initplan(Param *param, Plan *plan,
458 : int *column_p);
459 : static void get_parameter(Param *param, deparse_context *context);
460 : static const char *get_simple_binary_op_name(OpExpr *expr);
461 : static bool isSimpleNode(Node *node, Node *parentNode, int prettyFlags);
462 : static void appendContextKeyword(deparse_context *context, const char *str,
463 : int indentBefore, int indentAfter, int indentPlus);
464 : static void removeStringInfoSpaces(StringInfo str);
465 : static void get_rule_expr(Node *node, deparse_context *context,
466 : bool showimplicit);
467 : static void get_rule_expr_toplevel(Node *node, deparse_context *context,
468 : bool showimplicit);
469 : static void get_rule_list_toplevel(List *lst, deparse_context *context,
470 : bool showimplicit);
471 : static void get_rule_expr_funccall(Node *node, deparse_context *context,
472 : bool showimplicit);
473 : static bool looks_like_function(Node *node);
474 : static void get_oper_expr(OpExpr *expr, deparse_context *context);
475 : static void get_func_expr(FuncExpr *expr, deparse_context *context,
476 : bool showimplicit);
477 : static void get_agg_expr(Aggref *aggref, deparse_context *context,
478 : Aggref *original_aggref);
479 : static void get_agg_expr_helper(Aggref *aggref, deparse_context *context,
480 : Aggref *original_aggref, const char *funcname,
481 : const char *options, bool is_json_objectagg);
482 : static void get_agg_combine_expr(Node *node, deparse_context *context,
483 : void *callback_arg);
484 : static void get_windowfunc_expr(WindowFunc *wfunc, deparse_context *context);
485 : static void get_windowfunc_expr_helper(WindowFunc *wfunc, deparse_context *context,
486 : const char *funcname, const char *options,
487 : bool is_json_objectagg);
488 : static bool get_func_sql_syntax(FuncExpr *expr, deparse_context *context);
489 : static void get_coercion_expr(Node *arg, deparse_context *context,
490 : Oid resulttype, int32 resulttypmod,
491 : Node *parentNode);
492 : static void get_const_expr(Const *constval, deparse_context *context,
493 : int showtype);
494 : static void get_const_collation(Const *constval, deparse_context *context);
495 : static void get_json_format(JsonFormat *format, StringInfo buf);
496 : static void get_json_returning(JsonReturning *returning, StringInfo buf,
497 : bool json_format_by_default);
498 : static void get_json_constructor(JsonConstructorExpr *ctor,
499 : deparse_context *context, bool showimplicit);
500 : static void get_json_constructor_options(JsonConstructorExpr *ctor,
501 : StringInfo buf);
502 : static void get_json_agg_constructor(JsonConstructorExpr *ctor,
503 : deparse_context *context,
504 : const char *funcname,
505 : bool is_json_objectagg);
506 : static void simple_quote_literal(StringInfo buf, const char *val);
507 : static void get_sublink_expr(SubLink *sublink, deparse_context *context);
508 : static void get_tablefunc(TableFunc *tf, deparse_context *context,
509 : bool showimplicit);
510 : static void get_from_clause(Query *query, const char *prefix,
511 : deparse_context *context);
512 : static void get_from_clause_item(Node *jtnode, Query *query,
513 : deparse_context *context);
514 : static void get_rte_alias(RangeTblEntry *rte, int varno, bool use_as,
515 : deparse_context *context);
516 : static void get_column_alias_list(deparse_columns *colinfo,
517 : deparse_context *context);
518 : static void get_from_clause_coldeflist(RangeTblFunction *rtfunc,
519 : deparse_columns *colinfo,
520 : deparse_context *context);
521 : static void get_tablesample_def(TableSampleClause *tablesample,
522 : deparse_context *context);
523 : static void get_opclass_name(Oid opclass, Oid actual_datatype,
524 : StringInfo buf);
525 : static Node *processIndirection(Node *node, deparse_context *context);
526 : static void printSubscripts(SubscriptingRef *sbsref, deparse_context *context);
527 : static char *get_relation_name(Oid relid);
528 : static char *generate_relation_name(Oid relid, List *namespaces);
529 : static char *generate_qualified_relation_name(Oid relid);
530 : static char *generate_function_name(Oid funcid, int nargs,
531 : List *argnames, Oid *argtypes,
532 : bool has_variadic, bool *use_variadic_p,
533 : bool inGroupBy);
534 : static char *generate_operator_name(Oid operid, Oid arg1, Oid arg2);
535 : static void add_cast_to(StringInfo buf, Oid typid);
536 : static char *generate_qualified_type_name(Oid typid);
537 : static text *string_to_text(char *str);
538 : static char *flatten_reloptions(Oid relid);
539 : static void get_reloptions(StringInfo buf, Datum reloptions);
540 : static void get_json_path_spec(Node *path_spec, deparse_context *context,
541 : bool showimplicit);
542 : static void get_json_table_columns(TableFunc *tf, JsonTablePathScan *scan,
543 : deparse_context *context,
544 : bool showimplicit);
545 : static void get_json_table_nested_columns(TableFunc *tf, JsonTablePlan *plan,
546 : deparse_context *context,
547 : bool showimplicit,
548 : bool needcomma);
549 :
550 : #define only_marker(rte) ((rte)->inh ? "" : "ONLY ")
551 :
552 :
553 : /* ----------
554 : * pg_get_ruledef - Do it all and return a text
555 : * that could be used as a statement
556 : * to recreate the rule
557 : * ----------
558 : */
559 : Datum
560 450 : pg_get_ruledef(PG_FUNCTION_ARGS)
561 : {
562 450 : Oid ruleoid = PG_GETARG_OID(0);
563 : int prettyFlags;
564 : char *res;
565 :
566 450 : prettyFlags = PRETTYFLAG_INDENT;
567 :
568 450 : res = pg_get_ruledef_worker(ruleoid, prettyFlags);
569 :
570 450 : if (res == NULL)
571 6 : PG_RETURN_NULL();
572 :
573 444 : PG_RETURN_TEXT_P(string_to_text(res));
574 : }
575 :
576 :
577 : Datum
578 114 : pg_get_ruledef_ext(PG_FUNCTION_ARGS)
579 : {
580 114 : Oid ruleoid = PG_GETARG_OID(0);
581 114 : bool pretty = PG_GETARG_BOOL(1);
582 : int prettyFlags;
583 : char *res;
584 :
585 114 : prettyFlags = GET_PRETTY_FLAGS(pretty);
586 :
587 114 : res = pg_get_ruledef_worker(ruleoid, prettyFlags);
588 :
589 114 : if (res == NULL)
590 0 : PG_RETURN_NULL();
591 :
592 114 : PG_RETURN_TEXT_P(string_to_text(res));
593 : }
594 :
595 :
596 : static char *
597 564 : pg_get_ruledef_worker(Oid ruleoid, int prettyFlags)
598 : {
599 : Datum args[1];
600 : char nulls[1];
601 : int spirc;
602 : HeapTuple ruletup;
603 : TupleDesc rulettc;
604 : StringInfoData buf;
605 :
606 : /*
607 : * Do this first so that string is alloc'd in outer context not SPI's.
608 : */
609 564 : initStringInfo(&buf);
610 :
611 : /*
612 : * Connect to SPI manager
613 : */
614 564 : SPI_connect();
615 :
616 : /*
617 : * On the first call prepare the plan to lookup pg_rewrite. We read
618 : * pg_rewrite over the SPI manager instead of using the syscache to be
619 : * checked for read access on pg_rewrite.
620 : */
621 564 : if (plan_getrulebyoid == NULL)
622 : {
623 : Oid argtypes[1];
624 : SPIPlanPtr plan;
625 :
626 40 : argtypes[0] = OIDOID;
627 40 : plan = SPI_prepare(query_getrulebyoid, 1, argtypes);
628 40 : if (plan == NULL)
629 0 : elog(ERROR, "SPI_prepare failed for \"%s\"", query_getrulebyoid);
630 40 : SPI_keepplan(plan);
631 40 : plan_getrulebyoid = plan;
632 : }
633 :
634 : /*
635 : * Get the pg_rewrite tuple for this rule
636 : */
637 564 : args[0] = ObjectIdGetDatum(ruleoid);
638 564 : nulls[0] = ' ';
639 564 : spirc = SPI_execute_plan(plan_getrulebyoid, args, nulls, true, 0);
640 564 : if (spirc != SPI_OK_SELECT)
641 0 : elog(ERROR, "failed to get pg_rewrite tuple for rule %u", ruleoid);
642 564 : if (SPI_processed != 1)
643 : {
644 : /*
645 : * There is no tuple data available here, just keep the output buffer
646 : * empty.
647 : */
648 : }
649 : else
650 : {
651 : /*
652 : * Get the rule's definition and put it into executor's memory
653 : */
654 558 : ruletup = SPI_tuptable->vals[0];
655 558 : rulettc = SPI_tuptable->tupdesc;
656 558 : make_ruledef(&buf, ruletup, rulettc, prettyFlags);
657 : }
658 :
659 : /*
660 : * Disconnect from SPI manager
661 : */
662 564 : if (SPI_finish() != SPI_OK_FINISH)
663 0 : elog(ERROR, "SPI_finish failed");
664 :
665 564 : if (buf.len == 0)
666 6 : return NULL;
667 :
668 558 : return buf.data;
669 : }
670 :
671 :
672 : /* ----------
673 : * pg_get_viewdef - Mainly the same thing, but we
674 : * only return the SELECT part of a view
675 : * ----------
676 : */
677 : Datum
678 2468 : pg_get_viewdef(PG_FUNCTION_ARGS)
679 : {
680 : /* By OID */
681 2468 : Oid viewoid = PG_GETARG_OID(0);
682 : int prettyFlags;
683 : char *res;
684 :
685 2468 : prettyFlags = PRETTYFLAG_INDENT;
686 :
687 2468 : res = pg_get_viewdef_worker(viewoid, prettyFlags, WRAP_COLUMN_DEFAULT);
688 :
689 2468 : if (res == NULL)
690 6 : PG_RETURN_NULL();
691 :
692 2462 : PG_RETURN_TEXT_P(string_to_text(res));
693 : }
694 :
695 :
696 : Datum
697 564 : pg_get_viewdef_ext(PG_FUNCTION_ARGS)
698 : {
699 : /* By OID */
700 564 : Oid viewoid = PG_GETARG_OID(0);
701 564 : bool pretty = PG_GETARG_BOOL(1);
702 : int prettyFlags;
703 : char *res;
704 :
705 564 : prettyFlags = GET_PRETTY_FLAGS(pretty);
706 :
707 564 : res = pg_get_viewdef_worker(viewoid, prettyFlags, WRAP_COLUMN_DEFAULT);
708 :
709 564 : if (res == NULL)
710 0 : PG_RETURN_NULL();
711 :
712 564 : PG_RETURN_TEXT_P(string_to_text(res));
713 : }
714 :
715 : Datum
716 6 : pg_get_viewdef_wrap(PG_FUNCTION_ARGS)
717 : {
718 : /* By OID */
719 6 : Oid viewoid = PG_GETARG_OID(0);
720 6 : int wrap = PG_GETARG_INT32(1);
721 : int prettyFlags;
722 : char *res;
723 :
724 : /* calling this implies we want pretty printing */
725 6 : prettyFlags = GET_PRETTY_FLAGS(true);
726 :
727 6 : res = pg_get_viewdef_worker(viewoid, prettyFlags, wrap);
728 :
729 6 : if (res == NULL)
730 0 : PG_RETURN_NULL();
731 :
732 6 : PG_RETURN_TEXT_P(string_to_text(res));
733 : }
734 :
735 : Datum
736 78 : pg_get_viewdef_name(PG_FUNCTION_ARGS)
737 : {
738 : /* By qualified name */
739 78 : text *viewname = PG_GETARG_TEXT_PP(0);
740 : int prettyFlags;
741 : RangeVar *viewrel;
742 : Oid viewoid;
743 : char *res;
744 :
745 78 : prettyFlags = PRETTYFLAG_INDENT;
746 :
747 : /* Look up view name. Can't lock it - we might not have privileges. */
748 78 : viewrel = makeRangeVarFromNameList(textToQualifiedNameList(viewname));
749 78 : viewoid = RangeVarGetRelid(viewrel, NoLock, false);
750 :
751 78 : res = pg_get_viewdef_worker(viewoid, prettyFlags, WRAP_COLUMN_DEFAULT);
752 :
753 78 : if (res == NULL)
754 0 : PG_RETURN_NULL();
755 :
756 78 : PG_RETURN_TEXT_P(string_to_text(res));
757 : }
758 :
759 :
760 : Datum
761 402 : pg_get_viewdef_name_ext(PG_FUNCTION_ARGS)
762 : {
763 : /* By qualified name */
764 402 : text *viewname = PG_GETARG_TEXT_PP(0);
765 402 : bool pretty = PG_GETARG_BOOL(1);
766 : int prettyFlags;
767 : RangeVar *viewrel;
768 : Oid viewoid;
769 : char *res;
770 :
771 402 : prettyFlags = GET_PRETTY_FLAGS(pretty);
772 :
773 : /* Look up view name. Can't lock it - we might not have privileges. */
774 402 : viewrel = makeRangeVarFromNameList(textToQualifiedNameList(viewname));
775 402 : viewoid = RangeVarGetRelid(viewrel, NoLock, false);
776 :
777 402 : res = pg_get_viewdef_worker(viewoid, prettyFlags, WRAP_COLUMN_DEFAULT);
778 :
779 402 : if (res == NULL)
780 0 : PG_RETURN_NULL();
781 :
782 402 : PG_RETURN_TEXT_P(string_to_text(res));
783 : }
784 :
785 : /*
786 : * Common code for by-OID and by-name variants of pg_get_viewdef
787 : */
788 : static char *
789 3518 : pg_get_viewdef_worker(Oid viewoid, int prettyFlags, int wrapColumn)
790 : {
791 : Datum args[2];
792 : char nulls[2];
793 : int spirc;
794 : HeapTuple ruletup;
795 : TupleDesc rulettc;
796 : StringInfoData buf;
797 :
798 : /*
799 : * Do this first so that string is alloc'd in outer context not SPI's.
800 : */
801 3518 : initStringInfo(&buf);
802 :
803 : /*
804 : * Connect to SPI manager
805 : */
806 3518 : SPI_connect();
807 :
808 : /*
809 : * On the first call prepare the plan to lookup pg_rewrite. We read
810 : * pg_rewrite over the SPI manager instead of using the syscache to be
811 : * checked for read access on pg_rewrite.
812 : */
813 3518 : if (plan_getviewrule == NULL)
814 : {
815 : Oid argtypes[2];
816 : SPIPlanPtr plan;
817 :
818 248 : argtypes[0] = OIDOID;
819 248 : argtypes[1] = NAMEOID;
820 248 : plan = SPI_prepare(query_getviewrule, 2, argtypes);
821 248 : if (plan == NULL)
822 0 : elog(ERROR, "SPI_prepare failed for \"%s\"", query_getviewrule);
823 248 : SPI_keepplan(plan);
824 248 : plan_getviewrule = plan;
825 : }
826 :
827 : /*
828 : * Get the pg_rewrite tuple for the view's SELECT rule
829 : */
830 3518 : args[0] = ObjectIdGetDatum(viewoid);
831 3518 : args[1] = DirectFunctionCall1(namein, CStringGetDatum(ViewSelectRuleName));
832 3518 : nulls[0] = ' ';
833 3518 : nulls[1] = ' ';
834 3518 : spirc = SPI_execute_plan(plan_getviewrule, args, nulls, true, 0);
835 3518 : if (spirc != SPI_OK_SELECT)
836 0 : elog(ERROR, "failed to get pg_rewrite tuple for view %u", viewoid);
837 3518 : if (SPI_processed != 1)
838 : {
839 : /*
840 : * There is no tuple data available here, just keep the output buffer
841 : * empty.
842 : */
843 : }
844 : else
845 : {
846 : /*
847 : * Get the rule's definition and put it into executor's memory
848 : */
849 3512 : ruletup = SPI_tuptable->vals[0];
850 3512 : rulettc = SPI_tuptable->tupdesc;
851 3512 : make_viewdef(&buf, ruletup, rulettc, prettyFlags, wrapColumn);
852 : }
853 :
854 : /*
855 : * Disconnect from SPI manager
856 : */
857 3518 : if (SPI_finish() != SPI_OK_FINISH)
858 0 : elog(ERROR, "SPI_finish failed");
859 :
860 3518 : if (buf.len == 0)
861 6 : return NULL;
862 :
863 3512 : return buf.data;
864 : }
865 :
866 : /* ----------
867 : * pg_get_triggerdef - Get the definition of a trigger
868 : * ----------
869 : */
870 : Datum
871 164 : pg_get_triggerdef(PG_FUNCTION_ARGS)
872 : {
873 164 : Oid trigid = PG_GETARG_OID(0);
874 : char *res;
875 :
876 164 : res = pg_get_triggerdef_worker(trigid, false);
877 :
878 164 : if (res == NULL)
879 6 : PG_RETURN_NULL();
880 :
881 158 : PG_RETURN_TEXT_P(string_to_text(res));
882 : }
883 :
884 : Datum
885 1190 : pg_get_triggerdef_ext(PG_FUNCTION_ARGS)
886 : {
887 1190 : Oid trigid = PG_GETARG_OID(0);
888 1190 : bool pretty = PG_GETARG_BOOL(1);
889 : char *res;
890 :
891 1190 : res = pg_get_triggerdef_worker(trigid, pretty);
892 :
893 1190 : if (res == NULL)
894 0 : PG_RETURN_NULL();
895 :
896 1190 : PG_RETURN_TEXT_P(string_to_text(res));
897 : }
898 :
899 : static char *
900 1354 : pg_get_triggerdef_worker(Oid trigid, bool pretty)
901 : {
902 : HeapTuple ht_trig;
903 : Form_pg_trigger trigrec;
904 : StringInfoData buf;
905 : Relation tgrel;
906 : ScanKeyData skey[1];
907 : SysScanDesc tgscan;
908 1354 : int findx = 0;
909 : char *tgname;
910 : char *tgoldtable;
911 : char *tgnewtable;
912 : Datum value;
913 : bool isnull;
914 :
915 : /*
916 : * Fetch the pg_trigger tuple by the Oid of the trigger
917 : */
918 1354 : tgrel = table_open(TriggerRelationId, AccessShareLock);
919 :
920 1354 : ScanKeyInit(&skey[0],
921 : Anum_pg_trigger_oid,
922 : BTEqualStrategyNumber, F_OIDEQ,
923 : ObjectIdGetDatum(trigid));
924 :
925 1354 : tgscan = systable_beginscan(tgrel, TriggerOidIndexId, true,
926 : NULL, 1, skey);
927 :
928 1354 : ht_trig = systable_getnext(tgscan);
929 :
930 1354 : if (!HeapTupleIsValid(ht_trig))
931 : {
932 6 : systable_endscan(tgscan);
933 6 : table_close(tgrel, AccessShareLock);
934 6 : return NULL;
935 : }
936 :
937 1348 : trigrec = (Form_pg_trigger) GETSTRUCT(ht_trig);
938 :
939 : /*
940 : * Start the trigger definition. Note that the trigger's name should never
941 : * be schema-qualified, but the trigger rel's name may be.
942 : */
943 1348 : initStringInfo(&buf);
944 :
945 1348 : tgname = NameStr(trigrec->tgname);
946 2696 : appendStringInfo(&buf, "CREATE %sTRIGGER %s ",
947 1348 : OidIsValid(trigrec->tgconstraint) ? "CONSTRAINT " : "",
948 : quote_identifier(tgname));
949 :
950 1348 : if (TRIGGER_FOR_BEFORE(trigrec->tgtype))
951 494 : appendStringInfoString(&buf, "BEFORE");
952 854 : else if (TRIGGER_FOR_AFTER(trigrec->tgtype))
953 830 : appendStringInfoString(&buf, "AFTER");
954 24 : else if (TRIGGER_FOR_INSTEAD(trigrec->tgtype))
955 24 : appendStringInfoString(&buf, "INSTEAD OF");
956 : else
957 0 : elog(ERROR, "unexpected tgtype value: %d", trigrec->tgtype);
958 :
959 1348 : if (TRIGGER_FOR_INSERT(trigrec->tgtype))
960 : {
961 930 : appendStringInfoString(&buf, " INSERT");
962 930 : findx++;
963 : }
964 1348 : if (TRIGGER_FOR_DELETE(trigrec->tgtype))
965 : {
966 210 : if (findx > 0)
967 90 : appendStringInfoString(&buf, " OR DELETE");
968 : else
969 120 : appendStringInfoString(&buf, " DELETE");
970 210 : findx++;
971 : }
972 1348 : if (TRIGGER_FOR_UPDATE(trigrec->tgtype))
973 : {
974 648 : if (findx > 0)
975 350 : appendStringInfoString(&buf, " OR UPDATE");
976 : else
977 298 : appendStringInfoString(&buf, " UPDATE");
978 648 : findx++;
979 : /* tgattr is first var-width field, so OK to access directly */
980 648 : if (trigrec->tgattr.dim1 > 0)
981 : {
982 : int i;
983 :
984 76 : appendStringInfoString(&buf, " OF ");
985 168 : for (i = 0; i < trigrec->tgattr.dim1; i++)
986 : {
987 : char *attname;
988 :
989 92 : if (i > 0)
990 16 : appendStringInfoString(&buf, ", ");
991 92 : attname = get_attname(trigrec->tgrelid,
992 92 : trigrec->tgattr.values[i], false);
993 92 : appendStringInfoString(&buf, quote_identifier(attname));
994 : }
995 : }
996 : }
997 1348 : if (TRIGGER_FOR_TRUNCATE(trigrec->tgtype))
998 : {
999 0 : if (findx > 0)
1000 0 : appendStringInfoString(&buf, " OR TRUNCATE");
1001 : else
1002 0 : appendStringInfoString(&buf, " TRUNCATE");
1003 0 : findx++;
1004 : }
1005 :
1006 : /*
1007 : * In non-pretty mode, always schema-qualify the target table name for
1008 : * safety. In pretty mode, schema-qualify only if not visible.
1009 : */
1010 2696 : appendStringInfo(&buf, " ON %s ",
1011 : pretty ?
1012 138 : generate_relation_name(trigrec->tgrelid, NIL) :
1013 1210 : generate_qualified_relation_name(trigrec->tgrelid));
1014 :
1015 1348 : if (OidIsValid(trigrec->tgconstraint))
1016 : {
1017 0 : if (OidIsValid(trigrec->tgconstrrelid))
1018 0 : appendStringInfo(&buf, "FROM %s ",
1019 : generate_relation_name(trigrec->tgconstrrelid, NIL));
1020 0 : if (!trigrec->tgdeferrable)
1021 0 : appendStringInfoString(&buf, "NOT ");
1022 0 : appendStringInfoString(&buf, "DEFERRABLE INITIALLY ");
1023 0 : if (trigrec->tginitdeferred)
1024 0 : appendStringInfoString(&buf, "DEFERRED ");
1025 : else
1026 0 : appendStringInfoString(&buf, "IMMEDIATE ");
1027 : }
1028 :
1029 1348 : value = fastgetattr(ht_trig, Anum_pg_trigger_tgoldtable,
1030 : tgrel->rd_att, &isnull);
1031 1348 : if (!isnull)
1032 98 : tgoldtable = NameStr(*DatumGetName(value));
1033 : else
1034 1250 : tgoldtable = NULL;
1035 1348 : value = fastgetattr(ht_trig, Anum_pg_trigger_tgnewtable,
1036 : tgrel->rd_att, &isnull);
1037 1348 : if (!isnull)
1038 108 : tgnewtable = NameStr(*DatumGetName(value));
1039 : else
1040 1240 : tgnewtable = NULL;
1041 1348 : if (tgoldtable != NULL || tgnewtable != NULL)
1042 : {
1043 152 : appendStringInfoString(&buf, "REFERENCING ");
1044 152 : if (tgoldtable != NULL)
1045 98 : appendStringInfo(&buf, "OLD TABLE AS %s ",
1046 : quote_identifier(tgoldtable));
1047 152 : if (tgnewtable != NULL)
1048 108 : appendStringInfo(&buf, "NEW TABLE AS %s ",
1049 : quote_identifier(tgnewtable));
1050 : }
1051 :
1052 1348 : if (TRIGGER_FOR_ROW(trigrec->tgtype))
1053 1030 : appendStringInfoString(&buf, "FOR EACH ROW ");
1054 : else
1055 318 : appendStringInfoString(&buf, "FOR EACH STATEMENT ");
1056 :
1057 : /* If the trigger has a WHEN qualification, add that */
1058 1348 : value = fastgetattr(ht_trig, Anum_pg_trigger_tgqual,
1059 : tgrel->rd_att, &isnull);
1060 1348 : if (!isnull)
1061 : {
1062 : Node *qual;
1063 : char relkind;
1064 : deparse_context context;
1065 : deparse_namespace dpns;
1066 : RangeTblEntry *oldrte;
1067 : RangeTblEntry *newrte;
1068 :
1069 152 : appendStringInfoString(&buf, "WHEN (");
1070 :
1071 152 : qual = stringToNode(TextDatumGetCString(value));
1072 :
1073 152 : relkind = get_rel_relkind(trigrec->tgrelid);
1074 :
1075 : /* Build minimal OLD and NEW RTEs for the rel */
1076 152 : oldrte = makeNode(RangeTblEntry);
1077 152 : oldrte->rtekind = RTE_RELATION;
1078 152 : oldrte->relid = trigrec->tgrelid;
1079 152 : oldrte->relkind = relkind;
1080 152 : oldrte->rellockmode = AccessShareLock;
1081 152 : oldrte->alias = makeAlias("old", NIL);
1082 152 : oldrte->eref = oldrte->alias;
1083 152 : oldrte->lateral = false;
1084 152 : oldrte->inh = false;
1085 152 : oldrte->inFromCl = true;
1086 :
1087 152 : newrte = makeNode(RangeTblEntry);
1088 152 : newrte->rtekind = RTE_RELATION;
1089 152 : newrte->relid = trigrec->tgrelid;
1090 152 : newrte->relkind = relkind;
1091 152 : newrte->rellockmode = AccessShareLock;
1092 152 : newrte->alias = makeAlias("new", NIL);
1093 152 : newrte->eref = newrte->alias;
1094 152 : newrte->lateral = false;
1095 152 : newrte->inh = false;
1096 152 : newrte->inFromCl = true;
1097 :
1098 : /* Build two-element rtable */
1099 152 : memset(&dpns, 0, sizeof(dpns));
1100 152 : dpns.rtable = list_make2(oldrte, newrte);
1101 152 : dpns.subplans = NIL;
1102 152 : dpns.ctes = NIL;
1103 152 : dpns.appendrels = NULL;
1104 152 : set_rtable_names(&dpns, NIL, NULL);
1105 152 : set_simple_column_names(&dpns);
1106 :
1107 : /* Set up context with one-deep namespace stack */
1108 152 : context.buf = &buf;
1109 152 : context.namespaces = list_make1(&dpns);
1110 152 : context.resultDesc = NULL;
1111 152 : context.targetList = NIL;
1112 152 : context.windowClause = NIL;
1113 152 : context.varprefix = true;
1114 152 : context.prettyFlags = GET_PRETTY_FLAGS(pretty);
1115 152 : context.wrapColumn = WRAP_COLUMN_DEFAULT;
1116 152 : context.indentLevel = PRETTYINDENT_STD;
1117 152 : context.colNamesVisible = true;
1118 152 : context.inGroupBy = false;
1119 152 : context.varInOrderBy = false;
1120 152 : context.appendparents = NULL;
1121 :
1122 152 : get_rule_expr(qual, &context, false);
1123 :
1124 152 : appendStringInfoString(&buf, ") ");
1125 : }
1126 :
1127 1348 : appendStringInfo(&buf, "EXECUTE FUNCTION %s(",
1128 : generate_function_name(trigrec->tgfoid, 0,
1129 : NIL, NULL,
1130 : false, NULL, false));
1131 :
1132 1348 : if (trigrec->tgnargs > 0)
1133 : {
1134 : char *p;
1135 : int i;
1136 :
1137 410 : value = fastgetattr(ht_trig, Anum_pg_trigger_tgargs,
1138 : tgrel->rd_att, &isnull);
1139 410 : if (isnull)
1140 0 : elog(ERROR, "tgargs is null for trigger %u", trigid);
1141 410 : p = (char *) VARDATA_ANY(DatumGetByteaPP(value));
1142 932 : for (i = 0; i < trigrec->tgnargs; i++)
1143 : {
1144 522 : if (i > 0)
1145 112 : appendStringInfoString(&buf, ", ");
1146 522 : simple_quote_literal(&buf, p);
1147 : /* advance p to next string embedded in tgargs */
1148 5372 : while (*p)
1149 4850 : p++;
1150 522 : p++;
1151 : }
1152 : }
1153 :
1154 : /* We deliberately do not put semi-colon at end */
1155 1348 : appendStringInfoChar(&buf, ')');
1156 :
1157 : /* Clean up */
1158 1348 : systable_endscan(tgscan);
1159 :
1160 1348 : table_close(tgrel, AccessShareLock);
1161 :
1162 1348 : return buf.data;
1163 : }
1164 :
1165 : /* ----------
1166 : * pg_get_indexdef - Get the definition of an index
1167 : *
1168 : * In the extended version, there is a colno argument as well as pretty bool.
1169 : * if colno == 0, we want a complete index definition.
1170 : * if colno > 0, we only want the Nth index key's variable or expression.
1171 : *
1172 : * Note that the SQL-function versions of this omit any info about the
1173 : * index tablespace; this is intentional because pg_dump wants it that way.
1174 : * However pg_get_indexdef_string() includes the index tablespace.
1175 : * ----------
1176 : */
1177 : Datum
1178 5622 : pg_get_indexdef(PG_FUNCTION_ARGS)
1179 : {
1180 5622 : Oid indexrelid = PG_GETARG_OID(0);
1181 : int prettyFlags;
1182 : char *res;
1183 :
1184 5622 : prettyFlags = PRETTYFLAG_INDENT;
1185 :
1186 5622 : res = pg_get_indexdef_worker(indexrelid, 0, NULL,
1187 : false, false,
1188 : false, false,
1189 : prettyFlags, true);
1190 :
1191 5622 : if (res == NULL)
1192 6 : PG_RETURN_NULL();
1193 :
1194 5616 : PG_RETURN_TEXT_P(string_to_text(res));
1195 : }
1196 :
1197 : Datum
1198 1994 : pg_get_indexdef_ext(PG_FUNCTION_ARGS)
1199 : {
1200 1994 : Oid indexrelid = PG_GETARG_OID(0);
1201 1994 : int32 colno = PG_GETARG_INT32(1);
1202 1994 : bool pretty = PG_GETARG_BOOL(2);
1203 : int prettyFlags;
1204 : char *res;
1205 :
1206 1994 : prettyFlags = GET_PRETTY_FLAGS(pretty);
1207 :
1208 1994 : res = pg_get_indexdef_worker(indexrelid, colno, NULL,
1209 : colno != 0, false,
1210 : false, false,
1211 : prettyFlags, true);
1212 :
1213 1994 : if (res == NULL)
1214 0 : PG_RETURN_NULL();
1215 :
1216 1994 : PG_RETURN_TEXT_P(string_to_text(res));
1217 : }
1218 :
1219 : /*
1220 : * Internal version for use by ALTER TABLE.
1221 : * Includes a tablespace clause in the result.
1222 : * Returns a palloc'd C string; no pretty-printing.
1223 : */
1224 : char *
1225 228 : pg_get_indexdef_string(Oid indexrelid)
1226 : {
1227 228 : return pg_get_indexdef_worker(indexrelid, 0, NULL,
1228 : false, false,
1229 : true, true,
1230 : 0, false);
1231 : }
1232 :
1233 : /* Internal version that just reports the key-column definitions */
1234 : char *
1235 1024 : pg_get_indexdef_columns(Oid indexrelid, bool pretty)
1236 : {
1237 : int prettyFlags;
1238 :
1239 1024 : prettyFlags = GET_PRETTY_FLAGS(pretty);
1240 :
1241 1024 : return pg_get_indexdef_worker(indexrelid, 0, NULL,
1242 : true, true,
1243 : false, false,
1244 : prettyFlags, false);
1245 : }
1246 :
1247 : /* Internal version, extensible with flags to control its behavior */
1248 : char *
1249 8 : pg_get_indexdef_columns_extended(Oid indexrelid, bits16 flags)
1250 : {
1251 8 : bool pretty = ((flags & RULE_INDEXDEF_PRETTY) != 0);
1252 8 : bool keys_only = ((flags & RULE_INDEXDEF_KEYS_ONLY) != 0);
1253 : int prettyFlags;
1254 :
1255 8 : prettyFlags = GET_PRETTY_FLAGS(pretty);
1256 :
1257 8 : return pg_get_indexdef_worker(indexrelid, 0, NULL,
1258 : true, keys_only,
1259 : false, false,
1260 : prettyFlags, false);
1261 : }
1262 :
1263 : /*
1264 : * Internal workhorse to decompile an index definition.
1265 : *
1266 : * This is now used for exclusion constraints as well: if excludeOps is not
1267 : * NULL then it points to an array of exclusion operator OIDs.
1268 : */
1269 : static char *
1270 8980 : pg_get_indexdef_worker(Oid indexrelid, int colno,
1271 : const Oid *excludeOps,
1272 : bool attrsOnly, bool keysOnly,
1273 : bool showTblSpc, bool inherits,
1274 : int prettyFlags, bool missing_ok)
1275 : {
1276 : /* might want a separate isConstraint parameter later */
1277 8980 : bool isConstraint = (excludeOps != NULL);
1278 : HeapTuple ht_idx;
1279 : HeapTuple ht_idxrel;
1280 : HeapTuple ht_am;
1281 : Form_pg_index idxrec;
1282 : Form_pg_class idxrelrec;
1283 : Form_pg_am amrec;
1284 : IndexAmRoutine *amroutine;
1285 : List *indexprs;
1286 : ListCell *indexpr_item;
1287 : List *context;
1288 : Oid indrelid;
1289 : int keyno;
1290 : Datum indcollDatum;
1291 : Datum indclassDatum;
1292 : Datum indoptionDatum;
1293 : oidvector *indcollation;
1294 : oidvector *indclass;
1295 : int2vector *indoption;
1296 : StringInfoData buf;
1297 : char *str;
1298 : char *sep;
1299 :
1300 : /*
1301 : * Fetch the pg_index tuple by the Oid of the index
1302 : */
1303 8980 : ht_idx = SearchSysCache1(INDEXRELID, ObjectIdGetDatum(indexrelid));
1304 8980 : if (!HeapTupleIsValid(ht_idx))
1305 : {
1306 6 : if (missing_ok)
1307 6 : return NULL;
1308 0 : elog(ERROR, "cache lookup failed for index %u", indexrelid);
1309 : }
1310 8974 : idxrec = (Form_pg_index) GETSTRUCT(ht_idx);
1311 :
1312 8974 : indrelid = idxrec->indrelid;
1313 : Assert(indexrelid == idxrec->indexrelid);
1314 :
1315 : /* Must get indcollation, indclass, and indoption the hard way */
1316 8974 : indcollDatum = SysCacheGetAttrNotNull(INDEXRELID, ht_idx,
1317 : Anum_pg_index_indcollation);
1318 8974 : indcollation = (oidvector *) DatumGetPointer(indcollDatum);
1319 :
1320 8974 : indclassDatum = SysCacheGetAttrNotNull(INDEXRELID, ht_idx,
1321 : Anum_pg_index_indclass);
1322 8974 : indclass = (oidvector *) DatumGetPointer(indclassDatum);
1323 :
1324 8974 : indoptionDatum = SysCacheGetAttrNotNull(INDEXRELID, ht_idx,
1325 : Anum_pg_index_indoption);
1326 8974 : indoption = (int2vector *) DatumGetPointer(indoptionDatum);
1327 :
1328 : /*
1329 : * Fetch the pg_class tuple of the index relation
1330 : */
1331 8974 : ht_idxrel = SearchSysCache1(RELOID, ObjectIdGetDatum(indexrelid));
1332 8974 : if (!HeapTupleIsValid(ht_idxrel))
1333 0 : elog(ERROR, "cache lookup failed for relation %u", indexrelid);
1334 8974 : idxrelrec = (Form_pg_class) GETSTRUCT(ht_idxrel);
1335 :
1336 : /*
1337 : * Fetch the pg_am tuple of the index' access method
1338 : */
1339 8974 : ht_am = SearchSysCache1(AMOID, ObjectIdGetDatum(idxrelrec->relam));
1340 8974 : if (!HeapTupleIsValid(ht_am))
1341 0 : elog(ERROR, "cache lookup failed for access method %u",
1342 : idxrelrec->relam);
1343 8974 : amrec = (Form_pg_am) GETSTRUCT(ht_am);
1344 :
1345 : /* Fetch the index AM's API struct */
1346 8974 : amroutine = GetIndexAmRoutine(amrec->amhandler);
1347 :
1348 : /*
1349 : * Get the index expressions, if any. (NOTE: we do not use the relcache
1350 : * versions of the expressions and predicate, because we want to display
1351 : * non-const-folded expressions.)
1352 : */
1353 8974 : if (!heap_attisnull(ht_idx, Anum_pg_index_indexprs, NULL))
1354 : {
1355 : Datum exprsDatum;
1356 : char *exprsString;
1357 :
1358 652 : exprsDatum = SysCacheGetAttrNotNull(INDEXRELID, ht_idx,
1359 : Anum_pg_index_indexprs);
1360 652 : exprsString = TextDatumGetCString(exprsDatum);
1361 652 : indexprs = (List *) stringToNode(exprsString);
1362 652 : pfree(exprsString);
1363 : }
1364 : else
1365 8322 : indexprs = NIL;
1366 :
1367 8974 : indexpr_item = list_head(indexprs);
1368 :
1369 8974 : context = deparse_context_for(get_relation_name(indrelid), indrelid);
1370 :
1371 : /*
1372 : * Start the index definition. Note that the index's name should never be
1373 : * schema-qualified, but the indexed rel's name may be.
1374 : */
1375 8974 : initStringInfo(&buf);
1376 :
1377 8974 : if (!attrsOnly)
1378 : {
1379 7480 : if (!isConstraint)
1380 14752 : appendStringInfo(&buf, "CREATE %sINDEX %s ON %s%s USING %s (",
1381 7376 : idxrec->indisunique ? "UNIQUE " : "",
1382 7376 : quote_identifier(NameStr(idxrelrec->relname)),
1383 7376 : idxrelrec->relkind == RELKIND_PARTITIONED_INDEX
1384 670 : && !inherits ? "ONLY " : "",
1385 7376 : (prettyFlags & PRETTYFLAG_SCHEMA) ?
1386 1532 : generate_relation_name(indrelid, NIL) :
1387 5844 : generate_qualified_relation_name(indrelid),
1388 7376 : quote_identifier(NameStr(amrec->amname)));
1389 : else /* currently, must be EXCLUDE constraint */
1390 104 : appendStringInfo(&buf, "EXCLUDE USING %s (",
1391 104 : quote_identifier(NameStr(amrec->amname)));
1392 : }
1393 :
1394 : /*
1395 : * Report the indexed attributes
1396 : */
1397 8974 : sep = "";
1398 22546 : for (keyno = 0; keyno < idxrec->indnatts; keyno++)
1399 : {
1400 13670 : AttrNumber attnum = idxrec->indkey.values[keyno];
1401 : Oid keycoltype;
1402 : Oid keycolcollation;
1403 :
1404 : /*
1405 : * Ignore non-key attributes if told to.
1406 : */
1407 13670 : if (keysOnly && keyno >= idxrec->indnkeyatts)
1408 98 : break;
1409 :
1410 : /* Otherwise, print INCLUDE to divide key and non-key attrs. */
1411 13572 : if (!colno && keyno == idxrec->indnkeyatts)
1412 : {
1413 250 : appendStringInfoString(&buf, ") INCLUDE (");
1414 250 : sep = "";
1415 : }
1416 :
1417 13572 : if (!colno)
1418 12930 : appendStringInfoString(&buf, sep);
1419 13572 : sep = ", ";
1420 :
1421 13572 : if (attnum != 0)
1422 : {
1423 : /* Simple index column */
1424 : char *attname;
1425 : int32 keycoltypmod;
1426 :
1427 12766 : attname = get_attname(indrelid, attnum, false);
1428 12766 : if (!colno || colno == keyno + 1)
1429 12598 : appendStringInfoString(&buf, quote_identifier(attname));
1430 12766 : get_atttypetypmodcoll(indrelid, attnum,
1431 : &keycoltype, &keycoltypmod,
1432 : &keycolcollation);
1433 : }
1434 : else
1435 : {
1436 : /* expressional index */
1437 : Node *indexkey;
1438 :
1439 806 : if (indexpr_item == NULL)
1440 0 : elog(ERROR, "too few entries in indexprs list");
1441 806 : indexkey = (Node *) lfirst(indexpr_item);
1442 806 : indexpr_item = lnext(indexprs, indexpr_item);
1443 : /* Deparse */
1444 806 : str = deparse_expression_pretty(indexkey, context, false, false,
1445 : prettyFlags, 0);
1446 806 : if (!colno || colno == keyno + 1)
1447 : {
1448 : /* Need parens if it's not a bare function call */
1449 794 : if (looks_like_function(indexkey))
1450 52 : appendStringInfoString(&buf, str);
1451 : else
1452 742 : appendStringInfo(&buf, "(%s)", str);
1453 : }
1454 806 : keycoltype = exprType(indexkey);
1455 806 : keycolcollation = exprCollation(indexkey);
1456 : }
1457 :
1458 : /* Print additional decoration for (selected) key columns */
1459 13572 : if (!attrsOnly && keyno < idxrec->indnkeyatts &&
1460 0 : (!colno || colno == keyno + 1))
1461 : {
1462 11080 : int16 opt = indoption->values[keyno];
1463 11080 : Oid indcoll = indcollation->values[keyno];
1464 11080 : Datum attoptions = get_attoptions(indexrelid, keyno + 1);
1465 11080 : bool has_options = attoptions != (Datum) 0;
1466 :
1467 : /* Add collation, if not default for column */
1468 11080 : if (OidIsValid(indcoll) && indcoll != keycolcollation)
1469 94 : appendStringInfo(&buf, " COLLATE %s",
1470 : generate_collation_name((indcoll)));
1471 :
1472 : /* Add the operator class name, if not default */
1473 11080 : get_opclass_name(indclass->values[keyno],
1474 : has_options ? InvalidOid : keycoltype, &buf);
1475 :
1476 11080 : if (has_options)
1477 : {
1478 34 : appendStringInfoString(&buf, " (");
1479 34 : get_reloptions(&buf, attoptions);
1480 34 : appendStringInfoChar(&buf, ')');
1481 : }
1482 :
1483 : /* Add options if relevant */
1484 11080 : if (amroutine->amcanorder)
1485 : {
1486 : /* if it supports sort ordering, report DESC and NULLS opts */
1487 8984 : if (opt & INDOPTION_DESC)
1488 : {
1489 0 : appendStringInfoString(&buf, " DESC");
1490 : /* NULLS FIRST is the default in this case */
1491 0 : if (!(opt & INDOPTION_NULLS_FIRST))
1492 0 : appendStringInfoString(&buf, " NULLS LAST");
1493 : }
1494 : else
1495 : {
1496 8984 : if (opt & INDOPTION_NULLS_FIRST)
1497 0 : appendStringInfoString(&buf, " NULLS FIRST");
1498 : }
1499 : }
1500 :
1501 : /* Add the exclusion operator if relevant */
1502 11080 : if (excludeOps != NULL)
1503 124 : appendStringInfo(&buf, " WITH %s",
1504 124 : generate_operator_name(excludeOps[keyno],
1505 : keycoltype,
1506 : keycoltype));
1507 : }
1508 : }
1509 :
1510 8974 : if (!attrsOnly)
1511 : {
1512 7480 : appendStringInfoChar(&buf, ')');
1513 :
1514 7480 : if (idxrec->indnullsnotdistinct)
1515 12 : appendStringInfoString(&buf, " NULLS NOT DISTINCT");
1516 :
1517 : /*
1518 : * If it has options, append "WITH (options)"
1519 : */
1520 7480 : str = flatten_reloptions(indexrelid);
1521 7480 : if (str)
1522 : {
1523 210 : appendStringInfo(&buf, " WITH (%s)", str);
1524 210 : pfree(str);
1525 : }
1526 :
1527 : /*
1528 : * Print tablespace, but only if requested
1529 : */
1530 7480 : if (showTblSpc)
1531 : {
1532 : Oid tblspc;
1533 :
1534 228 : tblspc = get_rel_tablespace(indexrelid);
1535 228 : if (OidIsValid(tblspc))
1536 : {
1537 54 : if (isConstraint)
1538 0 : appendStringInfoString(&buf, " USING INDEX");
1539 54 : appendStringInfo(&buf, " TABLESPACE %s",
1540 54 : quote_identifier(get_tablespace_name(tblspc)));
1541 : }
1542 : }
1543 :
1544 : /*
1545 : * If it's a partial index, decompile and append the predicate
1546 : */
1547 7480 : if (!heap_attisnull(ht_idx, Anum_pg_index_indpred, NULL))
1548 : {
1549 : Node *node;
1550 : Datum predDatum;
1551 : char *predString;
1552 :
1553 : /* Convert text string to node tree */
1554 314 : predDatum = SysCacheGetAttrNotNull(INDEXRELID, ht_idx,
1555 : Anum_pg_index_indpred);
1556 314 : predString = TextDatumGetCString(predDatum);
1557 314 : node = (Node *) stringToNode(predString);
1558 314 : pfree(predString);
1559 :
1560 : /* Deparse */
1561 314 : str = deparse_expression_pretty(node, context, false, false,
1562 : prettyFlags, 0);
1563 314 : if (isConstraint)
1564 42 : appendStringInfo(&buf, " WHERE (%s)", str);
1565 : else
1566 272 : appendStringInfo(&buf, " WHERE %s", str);
1567 : }
1568 : }
1569 :
1570 : /* Clean up */
1571 8974 : ReleaseSysCache(ht_idx);
1572 8974 : ReleaseSysCache(ht_idxrel);
1573 8974 : ReleaseSysCache(ht_am);
1574 :
1575 8974 : return buf.data;
1576 : }
1577 :
1578 : /* ----------
1579 : * pg_get_querydef
1580 : *
1581 : * Public entry point to deparse one query parsetree.
1582 : * The pretty flags are determined by GET_PRETTY_FLAGS(pretty).
1583 : *
1584 : * The result is a palloc'd C string.
1585 : * ----------
1586 : */
1587 : char *
1588 0 : pg_get_querydef(Query *query, bool pretty)
1589 : {
1590 : StringInfoData buf;
1591 : int prettyFlags;
1592 :
1593 0 : prettyFlags = GET_PRETTY_FLAGS(pretty);
1594 :
1595 0 : initStringInfo(&buf);
1596 :
1597 0 : get_query_def(query, &buf, NIL, NULL, true,
1598 : prettyFlags, WRAP_COLUMN_DEFAULT, 0);
1599 :
1600 0 : return buf.data;
1601 : }
1602 :
1603 : /*
1604 : * pg_get_statisticsobjdef
1605 : * Get the definition of an extended statistics object
1606 : */
1607 : Datum
1608 242 : pg_get_statisticsobjdef(PG_FUNCTION_ARGS)
1609 : {
1610 242 : Oid statextid = PG_GETARG_OID(0);
1611 : char *res;
1612 :
1613 242 : res = pg_get_statisticsobj_worker(statextid, false, true);
1614 :
1615 242 : if (res == NULL)
1616 6 : PG_RETURN_NULL();
1617 :
1618 236 : PG_RETURN_TEXT_P(string_to_text(res));
1619 : }
1620 :
1621 : /*
1622 : * Internal version for use by ALTER TABLE.
1623 : * Returns a palloc'd C string; no pretty-printing.
1624 : */
1625 : char *
1626 26 : pg_get_statisticsobjdef_string(Oid statextid)
1627 : {
1628 26 : return pg_get_statisticsobj_worker(statextid, false, false);
1629 : }
1630 :
1631 : /*
1632 : * pg_get_statisticsobjdef_columns
1633 : * Get columns and expressions for an extended statistics object
1634 : */
1635 : Datum
1636 414 : pg_get_statisticsobjdef_columns(PG_FUNCTION_ARGS)
1637 : {
1638 414 : Oid statextid = PG_GETARG_OID(0);
1639 : char *res;
1640 :
1641 414 : res = pg_get_statisticsobj_worker(statextid, true, true);
1642 :
1643 414 : if (res == NULL)
1644 0 : PG_RETURN_NULL();
1645 :
1646 414 : PG_RETURN_TEXT_P(string_to_text(res));
1647 : }
1648 :
1649 : /*
1650 : * Internal workhorse to decompile an extended statistics object.
1651 : */
1652 : static char *
1653 682 : pg_get_statisticsobj_worker(Oid statextid, bool columns_only, bool missing_ok)
1654 : {
1655 : Form_pg_statistic_ext statextrec;
1656 : HeapTuple statexttup;
1657 : StringInfoData buf;
1658 : int colno;
1659 : char *nsp;
1660 : ArrayType *arr;
1661 : char *enabled;
1662 : Datum datum;
1663 : bool ndistinct_enabled;
1664 : bool dependencies_enabled;
1665 : bool mcv_enabled;
1666 : int i;
1667 : List *context;
1668 : ListCell *lc;
1669 682 : List *exprs = NIL;
1670 : bool has_exprs;
1671 : int ncolumns;
1672 :
1673 682 : statexttup = SearchSysCache1(STATEXTOID, ObjectIdGetDatum(statextid));
1674 :
1675 682 : if (!HeapTupleIsValid(statexttup))
1676 : {
1677 6 : if (missing_ok)
1678 6 : return NULL;
1679 0 : elog(ERROR, "cache lookup failed for statistics object %u", statextid);
1680 : }
1681 :
1682 : /* has the statistics expressions? */
1683 676 : has_exprs = !heap_attisnull(statexttup, Anum_pg_statistic_ext_stxexprs, NULL);
1684 :
1685 676 : statextrec = (Form_pg_statistic_ext) GETSTRUCT(statexttup);
1686 :
1687 : /*
1688 : * Get the statistics expressions, if any. (NOTE: we do not use the
1689 : * relcache versions of the expressions, because we want to display
1690 : * non-const-folded expressions.)
1691 : */
1692 676 : if (has_exprs)
1693 : {
1694 : Datum exprsDatum;
1695 : char *exprsString;
1696 :
1697 152 : exprsDatum = SysCacheGetAttrNotNull(STATEXTOID, statexttup,
1698 : Anum_pg_statistic_ext_stxexprs);
1699 152 : exprsString = TextDatumGetCString(exprsDatum);
1700 152 : exprs = (List *) stringToNode(exprsString);
1701 152 : pfree(exprsString);
1702 : }
1703 : else
1704 524 : exprs = NIL;
1705 :
1706 : /* count the number of columns (attributes and expressions) */
1707 676 : ncolumns = statextrec->stxkeys.dim1 + list_length(exprs);
1708 :
1709 676 : initStringInfo(&buf);
1710 :
1711 676 : if (!columns_only)
1712 : {
1713 262 : nsp = get_namespace_name_or_temp(statextrec->stxnamespace);
1714 262 : appendStringInfo(&buf, "CREATE STATISTICS %s",
1715 : quote_qualified_identifier(nsp,
1716 262 : NameStr(statextrec->stxname)));
1717 :
1718 : /*
1719 : * Decode the stxkind column so that we know which stats types to
1720 : * print.
1721 : */
1722 262 : datum = SysCacheGetAttrNotNull(STATEXTOID, statexttup,
1723 : Anum_pg_statistic_ext_stxkind);
1724 262 : arr = DatumGetArrayTypeP(datum);
1725 262 : if (ARR_NDIM(arr) != 1 ||
1726 262 : ARR_HASNULL(arr) ||
1727 262 : ARR_ELEMTYPE(arr) != CHAROID)
1728 0 : elog(ERROR, "stxkind is not a 1-D char array");
1729 262 : enabled = (char *) ARR_DATA_PTR(arr);
1730 :
1731 262 : ndistinct_enabled = false;
1732 262 : dependencies_enabled = false;
1733 262 : mcv_enabled = false;
1734 :
1735 670 : for (i = 0; i < ARR_DIMS(arr)[0]; i++)
1736 : {
1737 408 : if (enabled[i] == STATS_EXT_NDISTINCT)
1738 132 : ndistinct_enabled = true;
1739 276 : else if (enabled[i] == STATS_EXT_DEPENDENCIES)
1740 86 : dependencies_enabled = true;
1741 190 : else if (enabled[i] == STATS_EXT_MCV)
1742 104 : mcv_enabled = true;
1743 :
1744 : /* ignore STATS_EXT_EXPRESSIONS (it's built automatically) */
1745 : }
1746 :
1747 : /*
1748 : * If any option is disabled, then we'll need to append the types
1749 : * clause to show which options are enabled. We omit the types clause
1750 : * on purpose when all options are enabled, so a pg_dump/pg_restore
1751 : * will create all statistics types on a newer postgres version, if
1752 : * the statistics had all options enabled on the original version.
1753 : *
1754 : * But if the statistics is defined on just a single column, it has to
1755 : * be an expression statistics. In that case we don't need to specify
1756 : * kinds.
1757 : */
1758 262 : if ((!ndistinct_enabled || !dependencies_enabled || !mcv_enabled) &&
1759 : (ncolumns > 1))
1760 : {
1761 118 : bool gotone = false;
1762 :
1763 118 : appendStringInfoString(&buf, " (");
1764 :
1765 118 : if (ndistinct_enabled)
1766 : {
1767 64 : appendStringInfoString(&buf, "ndistinct");
1768 64 : gotone = true;
1769 : }
1770 :
1771 118 : if (dependencies_enabled)
1772 : {
1773 18 : appendStringInfo(&buf, "%sdependencies", gotone ? ", " : "");
1774 18 : gotone = true;
1775 : }
1776 :
1777 118 : if (mcv_enabled)
1778 36 : appendStringInfo(&buf, "%smcv", gotone ? ", " : "");
1779 :
1780 118 : appendStringInfoChar(&buf, ')');
1781 : }
1782 :
1783 262 : appendStringInfoString(&buf, " ON ");
1784 : }
1785 :
1786 : /* decode simple column references */
1787 1904 : for (colno = 0; colno < statextrec->stxkeys.dim1; colno++)
1788 : {
1789 1228 : AttrNumber attnum = statextrec->stxkeys.values[colno];
1790 : char *attname;
1791 :
1792 1228 : if (colno > 0)
1793 692 : appendStringInfoString(&buf, ", ");
1794 :
1795 1228 : attname = get_attname(statextrec->stxrelid, attnum, false);
1796 :
1797 1228 : appendStringInfoString(&buf, quote_identifier(attname));
1798 : }
1799 :
1800 676 : context = deparse_context_for(get_relation_name(statextrec->stxrelid),
1801 : statextrec->stxrelid);
1802 :
1803 914 : foreach(lc, exprs)
1804 : {
1805 238 : Node *expr = (Node *) lfirst(lc);
1806 : char *str;
1807 238 : int prettyFlags = PRETTYFLAG_PAREN;
1808 :
1809 238 : str = deparse_expression_pretty(expr, context, false, false,
1810 : prettyFlags, 0);
1811 :
1812 238 : if (colno > 0)
1813 98 : appendStringInfoString(&buf, ", ");
1814 :
1815 : /* Need parens if it's not a bare function call */
1816 238 : if (looks_like_function(expr))
1817 34 : appendStringInfoString(&buf, str);
1818 : else
1819 204 : appendStringInfo(&buf, "(%s)", str);
1820 :
1821 238 : colno++;
1822 : }
1823 :
1824 676 : if (!columns_only)
1825 262 : appendStringInfo(&buf, " FROM %s",
1826 : generate_relation_name(statextrec->stxrelid, NIL));
1827 :
1828 676 : ReleaseSysCache(statexttup);
1829 :
1830 676 : return buf.data;
1831 : }
1832 :
1833 : /*
1834 : * Generate text array of expressions for statistics object.
1835 : */
1836 : Datum
1837 24 : pg_get_statisticsobjdef_expressions(PG_FUNCTION_ARGS)
1838 : {
1839 24 : Oid statextid = PG_GETARG_OID(0);
1840 : Form_pg_statistic_ext statextrec;
1841 : HeapTuple statexttup;
1842 : Datum datum;
1843 : List *context;
1844 : ListCell *lc;
1845 24 : List *exprs = NIL;
1846 : bool has_exprs;
1847 : char *tmp;
1848 24 : ArrayBuildState *astate = NULL;
1849 :
1850 24 : statexttup = SearchSysCache1(STATEXTOID, ObjectIdGetDatum(statextid));
1851 :
1852 24 : if (!HeapTupleIsValid(statexttup))
1853 0 : PG_RETURN_NULL();
1854 :
1855 : /* Does the stats object have expressions? */
1856 24 : has_exprs = !heap_attisnull(statexttup, Anum_pg_statistic_ext_stxexprs, NULL);
1857 :
1858 : /* no expressions? we're done */
1859 24 : if (!has_exprs)
1860 : {
1861 12 : ReleaseSysCache(statexttup);
1862 12 : PG_RETURN_NULL();
1863 : }
1864 :
1865 12 : statextrec = (Form_pg_statistic_ext) GETSTRUCT(statexttup);
1866 :
1867 : /*
1868 : * Get the statistics expressions, and deparse them into text values.
1869 : */
1870 12 : datum = SysCacheGetAttrNotNull(STATEXTOID, statexttup,
1871 : Anum_pg_statistic_ext_stxexprs);
1872 12 : tmp = TextDatumGetCString(datum);
1873 12 : exprs = (List *) stringToNode(tmp);
1874 12 : pfree(tmp);
1875 :
1876 12 : context = deparse_context_for(get_relation_name(statextrec->stxrelid),
1877 : statextrec->stxrelid);
1878 :
1879 36 : foreach(lc, exprs)
1880 : {
1881 24 : Node *expr = (Node *) lfirst(lc);
1882 : char *str;
1883 24 : int prettyFlags = PRETTYFLAG_INDENT;
1884 :
1885 24 : str = deparse_expression_pretty(expr, context, false, false,
1886 : prettyFlags, 0);
1887 :
1888 24 : astate = accumArrayResult(astate,
1889 24 : PointerGetDatum(cstring_to_text(str)),
1890 : false,
1891 : TEXTOID,
1892 : CurrentMemoryContext);
1893 : }
1894 :
1895 12 : ReleaseSysCache(statexttup);
1896 :
1897 12 : PG_RETURN_DATUM(makeArrayResult(astate, CurrentMemoryContext));
1898 : }
1899 :
1900 : /*
1901 : * pg_get_partkeydef
1902 : *
1903 : * Returns the partition key specification, ie, the following:
1904 : *
1905 : * { RANGE | LIST | HASH } (column opt_collation opt_opclass [, ...])
1906 : */
1907 : Datum
1908 1428 : pg_get_partkeydef(PG_FUNCTION_ARGS)
1909 : {
1910 1428 : Oid relid = PG_GETARG_OID(0);
1911 : char *res;
1912 :
1913 1428 : res = pg_get_partkeydef_worker(relid, PRETTYFLAG_INDENT, false, true);
1914 :
1915 1428 : if (res == NULL)
1916 6 : PG_RETURN_NULL();
1917 :
1918 1422 : PG_RETURN_TEXT_P(string_to_text(res));
1919 : }
1920 :
1921 : /* Internal version that just reports the column definitions */
1922 : char *
1923 142 : pg_get_partkeydef_columns(Oid relid, bool pretty)
1924 : {
1925 : int prettyFlags;
1926 :
1927 142 : prettyFlags = GET_PRETTY_FLAGS(pretty);
1928 :
1929 142 : return pg_get_partkeydef_worker(relid, prettyFlags, true, false);
1930 : }
1931 :
1932 : /*
1933 : * Internal workhorse to decompile a partition key definition.
1934 : */
1935 : static char *
1936 1570 : pg_get_partkeydef_worker(Oid relid, int prettyFlags,
1937 : bool attrsOnly, bool missing_ok)
1938 : {
1939 : Form_pg_partitioned_table form;
1940 : HeapTuple tuple;
1941 : oidvector *partclass;
1942 : oidvector *partcollation;
1943 : List *partexprs;
1944 : ListCell *partexpr_item;
1945 : List *context;
1946 : Datum datum;
1947 : StringInfoData buf;
1948 : int keyno;
1949 : char *str;
1950 : char *sep;
1951 :
1952 1570 : tuple = SearchSysCache1(PARTRELID, ObjectIdGetDatum(relid));
1953 1570 : if (!HeapTupleIsValid(tuple))
1954 : {
1955 6 : if (missing_ok)
1956 6 : return NULL;
1957 0 : elog(ERROR, "cache lookup failed for partition key of %u", relid);
1958 : }
1959 :
1960 1564 : form = (Form_pg_partitioned_table) GETSTRUCT(tuple);
1961 :
1962 : Assert(form->partrelid == relid);
1963 :
1964 : /* Must get partclass and partcollation the hard way */
1965 1564 : datum = SysCacheGetAttrNotNull(PARTRELID, tuple,
1966 : Anum_pg_partitioned_table_partclass);
1967 1564 : partclass = (oidvector *) DatumGetPointer(datum);
1968 :
1969 1564 : datum = SysCacheGetAttrNotNull(PARTRELID, tuple,
1970 : Anum_pg_partitioned_table_partcollation);
1971 1564 : partcollation = (oidvector *) DatumGetPointer(datum);
1972 :
1973 :
1974 : /*
1975 : * Get the expressions, if any. (NOTE: we do not use the relcache
1976 : * versions of the expressions, because we want to display
1977 : * non-const-folded expressions.)
1978 : */
1979 1564 : if (!heap_attisnull(tuple, Anum_pg_partitioned_table_partexprs, NULL))
1980 : {
1981 : Datum exprsDatum;
1982 : char *exprsString;
1983 :
1984 146 : exprsDatum = SysCacheGetAttrNotNull(PARTRELID, tuple,
1985 : Anum_pg_partitioned_table_partexprs);
1986 146 : exprsString = TextDatumGetCString(exprsDatum);
1987 146 : partexprs = (List *) stringToNode(exprsString);
1988 :
1989 146 : if (!IsA(partexprs, List))
1990 0 : elog(ERROR, "unexpected node type found in partexprs: %d",
1991 : (int) nodeTag(partexprs));
1992 :
1993 146 : pfree(exprsString);
1994 : }
1995 : else
1996 1418 : partexprs = NIL;
1997 :
1998 1564 : partexpr_item = list_head(partexprs);
1999 1564 : context = deparse_context_for(get_relation_name(relid), relid);
2000 :
2001 1564 : initStringInfo(&buf);
2002 :
2003 1564 : switch (form->partstrat)
2004 : {
2005 116 : case PARTITION_STRATEGY_HASH:
2006 116 : if (!attrsOnly)
2007 116 : appendStringInfoString(&buf, "HASH");
2008 116 : break;
2009 586 : case PARTITION_STRATEGY_LIST:
2010 586 : if (!attrsOnly)
2011 546 : appendStringInfoString(&buf, "LIST");
2012 586 : break;
2013 862 : case PARTITION_STRATEGY_RANGE:
2014 862 : if (!attrsOnly)
2015 760 : appendStringInfoString(&buf, "RANGE");
2016 862 : break;
2017 0 : default:
2018 0 : elog(ERROR, "unexpected partition strategy: %d",
2019 : (int) form->partstrat);
2020 : }
2021 :
2022 1564 : if (!attrsOnly)
2023 1422 : appendStringInfoString(&buf, " (");
2024 1564 : sep = "";
2025 3280 : for (keyno = 0; keyno < form->partnatts; keyno++)
2026 : {
2027 1716 : AttrNumber attnum = form->partattrs.values[keyno];
2028 : Oid keycoltype;
2029 : Oid keycolcollation;
2030 : Oid partcoll;
2031 :
2032 1716 : appendStringInfoString(&buf, sep);
2033 1716 : sep = ", ";
2034 1716 : if (attnum != 0)
2035 : {
2036 : /* Simple attribute reference */
2037 : char *attname;
2038 : int32 keycoltypmod;
2039 :
2040 1558 : attname = get_attname(relid, attnum, false);
2041 1558 : appendStringInfoString(&buf, quote_identifier(attname));
2042 1558 : get_atttypetypmodcoll(relid, attnum,
2043 : &keycoltype, &keycoltypmod,
2044 : &keycolcollation);
2045 : }
2046 : else
2047 : {
2048 : /* Expression */
2049 : Node *partkey;
2050 :
2051 158 : if (partexpr_item == NULL)
2052 0 : elog(ERROR, "too few entries in partexprs list");
2053 158 : partkey = (Node *) lfirst(partexpr_item);
2054 158 : partexpr_item = lnext(partexprs, partexpr_item);
2055 :
2056 : /* Deparse */
2057 158 : str = deparse_expression_pretty(partkey, context, false, false,
2058 : prettyFlags, 0);
2059 : /* Need parens if it's not a bare function call */
2060 158 : if (looks_like_function(partkey))
2061 56 : appendStringInfoString(&buf, str);
2062 : else
2063 102 : appendStringInfo(&buf, "(%s)", str);
2064 :
2065 158 : keycoltype = exprType(partkey);
2066 158 : keycolcollation = exprCollation(partkey);
2067 : }
2068 :
2069 : /* Add collation, if not default for column */
2070 1716 : partcoll = partcollation->values[keyno];
2071 1716 : if (!attrsOnly && OidIsValid(partcoll) && partcoll != keycolcollation)
2072 6 : appendStringInfo(&buf, " COLLATE %s",
2073 : generate_collation_name((partcoll)));
2074 :
2075 : /* Add the operator class name, if not default */
2076 1716 : if (!attrsOnly)
2077 1520 : get_opclass_name(partclass->values[keyno], keycoltype, &buf);
2078 : }
2079 :
2080 1564 : if (!attrsOnly)
2081 1422 : appendStringInfoChar(&buf, ')');
2082 :
2083 : /* Clean up */
2084 1564 : ReleaseSysCache(tuple);
2085 :
2086 1564 : return buf.data;
2087 : }
2088 :
2089 : /*
2090 : * pg_get_partition_constraintdef
2091 : *
2092 : * Returns partition constraint expression as a string for the input relation
2093 : */
2094 : Datum
2095 182 : pg_get_partition_constraintdef(PG_FUNCTION_ARGS)
2096 : {
2097 182 : Oid relationId = PG_GETARG_OID(0);
2098 : Expr *constr_expr;
2099 : int prettyFlags;
2100 : List *context;
2101 : char *consrc;
2102 :
2103 182 : constr_expr = get_partition_qual_relid(relationId);
2104 :
2105 : /* Quick exit if no partition constraint */
2106 182 : if (constr_expr == NULL)
2107 18 : PG_RETURN_NULL();
2108 :
2109 : /*
2110 : * Deparse and return the constraint expression.
2111 : */
2112 164 : prettyFlags = PRETTYFLAG_INDENT;
2113 164 : context = deparse_context_for(get_relation_name(relationId), relationId);
2114 164 : consrc = deparse_expression_pretty((Node *) constr_expr, context, false,
2115 : false, prettyFlags, 0);
2116 :
2117 164 : PG_RETURN_TEXT_P(string_to_text(consrc));
2118 : }
2119 :
2120 : /*
2121 : * pg_get_partconstrdef_string
2122 : *
2123 : * Returns the partition constraint as a C-string for the input relation, with
2124 : * the given alias. No pretty-printing.
2125 : */
2126 : char *
2127 110 : pg_get_partconstrdef_string(Oid partitionId, char *aliasname)
2128 : {
2129 : Expr *constr_expr;
2130 : List *context;
2131 :
2132 110 : constr_expr = get_partition_qual_relid(partitionId);
2133 110 : context = deparse_context_for(aliasname, partitionId);
2134 :
2135 110 : return deparse_expression((Node *) constr_expr, context, true, false);
2136 : }
2137 :
2138 : /*
2139 : * pg_get_constraintdef
2140 : *
2141 : * Returns the definition for the constraint, ie, everything that needs to
2142 : * appear after "ALTER TABLE ... ADD CONSTRAINT <constraintname>".
2143 : */
2144 : Datum
2145 2138 : pg_get_constraintdef(PG_FUNCTION_ARGS)
2146 : {
2147 2138 : Oid constraintId = PG_GETARG_OID(0);
2148 : int prettyFlags;
2149 : char *res;
2150 :
2151 2138 : prettyFlags = PRETTYFLAG_INDENT;
2152 :
2153 2138 : res = pg_get_constraintdef_worker(constraintId, false, prettyFlags, true);
2154 :
2155 2138 : if (res == NULL)
2156 6 : PG_RETURN_NULL();
2157 :
2158 2132 : PG_RETURN_TEXT_P(string_to_text(res));
2159 : }
2160 :
2161 : Datum
2162 4702 : pg_get_constraintdef_ext(PG_FUNCTION_ARGS)
2163 : {
2164 4702 : Oid constraintId = PG_GETARG_OID(0);
2165 4702 : bool pretty = PG_GETARG_BOOL(1);
2166 : int prettyFlags;
2167 : char *res;
2168 :
2169 4702 : prettyFlags = GET_PRETTY_FLAGS(pretty);
2170 :
2171 4702 : res = pg_get_constraintdef_worker(constraintId, false, prettyFlags, true);
2172 :
2173 4702 : if (res == NULL)
2174 0 : PG_RETURN_NULL();
2175 :
2176 4702 : PG_RETURN_TEXT_P(string_to_text(res));
2177 : }
2178 :
2179 : /*
2180 : * Internal version that returns a full ALTER TABLE ... ADD CONSTRAINT command
2181 : */
2182 : char *
2183 608 : pg_get_constraintdef_command(Oid constraintId)
2184 : {
2185 608 : return pg_get_constraintdef_worker(constraintId, true, 0, false);
2186 : }
2187 :
2188 : /*
2189 : * As of 9.4, we now use an MVCC snapshot for this.
2190 : */
2191 : static char *
2192 7448 : pg_get_constraintdef_worker(Oid constraintId, bool fullCommand,
2193 : int prettyFlags, bool missing_ok)
2194 : {
2195 : HeapTuple tup;
2196 : Form_pg_constraint conForm;
2197 : StringInfoData buf;
2198 : SysScanDesc scandesc;
2199 : ScanKeyData scankey[1];
2200 7448 : Snapshot snapshot = RegisterSnapshot(GetTransactionSnapshot());
2201 7448 : Relation relation = table_open(ConstraintRelationId, AccessShareLock);
2202 :
2203 7448 : ScanKeyInit(&scankey[0],
2204 : Anum_pg_constraint_oid,
2205 : BTEqualStrategyNumber, F_OIDEQ,
2206 : ObjectIdGetDatum(constraintId));
2207 :
2208 7448 : scandesc = systable_beginscan(relation,
2209 : ConstraintOidIndexId,
2210 : true,
2211 : snapshot,
2212 : 1,
2213 : scankey);
2214 :
2215 : /*
2216 : * We later use the tuple with SysCacheGetAttr() as if we had obtained it
2217 : * via SearchSysCache, which works fine.
2218 : */
2219 7448 : tup = systable_getnext(scandesc);
2220 :
2221 7448 : UnregisterSnapshot(snapshot);
2222 :
2223 7448 : if (!HeapTupleIsValid(tup))
2224 : {
2225 6 : if (missing_ok)
2226 : {
2227 6 : systable_endscan(scandesc);
2228 6 : table_close(relation, AccessShareLock);
2229 6 : return NULL;
2230 : }
2231 0 : elog(ERROR, "could not find tuple for constraint %u", constraintId);
2232 : }
2233 :
2234 7442 : conForm = (Form_pg_constraint) GETSTRUCT(tup);
2235 :
2236 7442 : initStringInfo(&buf);
2237 :
2238 7442 : if (fullCommand)
2239 : {
2240 608 : if (OidIsValid(conForm->conrelid))
2241 : {
2242 : /*
2243 : * Currently, callers want ALTER TABLE (without ONLY) for CHECK
2244 : * constraints, and other types of constraints don't inherit
2245 : * anyway so it doesn't matter whether we say ONLY or not. Someday
2246 : * we might need to let callers specify whether to put ONLY in the
2247 : * command.
2248 : */
2249 594 : appendStringInfo(&buf, "ALTER TABLE %s ADD CONSTRAINT %s ",
2250 : generate_qualified_relation_name(conForm->conrelid),
2251 594 : quote_identifier(NameStr(conForm->conname)));
2252 : }
2253 : else
2254 : {
2255 : /* Must be a domain constraint */
2256 : Assert(OidIsValid(conForm->contypid));
2257 14 : appendStringInfo(&buf, "ALTER DOMAIN %s ADD CONSTRAINT %s ",
2258 : generate_qualified_type_name(conForm->contypid),
2259 14 : quote_identifier(NameStr(conForm->conname)));
2260 : }
2261 : }
2262 :
2263 7442 : switch (conForm->contype)
2264 : {
2265 736 : case CONSTRAINT_FOREIGN:
2266 : {
2267 : Datum val;
2268 : bool isnull;
2269 : const char *string;
2270 :
2271 : /* Start off the constraint definition */
2272 736 : appendStringInfoString(&buf, "FOREIGN KEY (");
2273 :
2274 : /* Fetch and build referencing-column list */
2275 736 : val = SysCacheGetAttrNotNull(CONSTROID, tup,
2276 : Anum_pg_constraint_conkey);
2277 :
2278 : /* If it is a temporal foreign key then it uses PERIOD. */
2279 736 : decompile_column_index_array(val, conForm->conrelid, conForm->conperiod, &buf);
2280 :
2281 : /* add foreign relation name */
2282 736 : appendStringInfo(&buf, ") REFERENCES %s(",
2283 : generate_relation_name(conForm->confrelid,
2284 : NIL));
2285 :
2286 : /* Fetch and build referenced-column list */
2287 736 : val = SysCacheGetAttrNotNull(CONSTROID, tup,
2288 : Anum_pg_constraint_confkey);
2289 :
2290 736 : decompile_column_index_array(val, conForm->confrelid, conForm->conperiod, &buf);
2291 :
2292 736 : appendStringInfoChar(&buf, ')');
2293 :
2294 : /* Add match type */
2295 736 : switch (conForm->confmatchtype)
2296 : {
2297 34 : case FKCONSTR_MATCH_FULL:
2298 34 : string = " MATCH FULL";
2299 34 : break;
2300 0 : case FKCONSTR_MATCH_PARTIAL:
2301 0 : string = " MATCH PARTIAL";
2302 0 : break;
2303 702 : case FKCONSTR_MATCH_SIMPLE:
2304 702 : string = "";
2305 702 : break;
2306 0 : default:
2307 0 : elog(ERROR, "unrecognized confmatchtype: %d",
2308 : conForm->confmatchtype);
2309 : string = ""; /* keep compiler quiet */
2310 : break;
2311 : }
2312 736 : appendStringInfoString(&buf, string);
2313 :
2314 : /* Add ON UPDATE and ON DELETE clauses, if needed */
2315 736 : switch (conForm->confupdtype)
2316 : {
2317 600 : case FKCONSTR_ACTION_NOACTION:
2318 600 : string = NULL; /* suppress default */
2319 600 : break;
2320 0 : case FKCONSTR_ACTION_RESTRICT:
2321 0 : string = "RESTRICT";
2322 0 : break;
2323 108 : case FKCONSTR_ACTION_CASCADE:
2324 108 : string = "CASCADE";
2325 108 : break;
2326 28 : case FKCONSTR_ACTION_SETNULL:
2327 28 : string = "SET NULL";
2328 28 : break;
2329 0 : case FKCONSTR_ACTION_SETDEFAULT:
2330 0 : string = "SET DEFAULT";
2331 0 : break;
2332 0 : default:
2333 0 : elog(ERROR, "unrecognized confupdtype: %d",
2334 : conForm->confupdtype);
2335 : string = NULL; /* keep compiler quiet */
2336 : break;
2337 : }
2338 736 : if (string)
2339 136 : appendStringInfo(&buf, " ON UPDATE %s", string);
2340 :
2341 736 : switch (conForm->confdeltype)
2342 : {
2343 604 : case FKCONSTR_ACTION_NOACTION:
2344 604 : string = NULL; /* suppress default */
2345 604 : break;
2346 0 : case FKCONSTR_ACTION_RESTRICT:
2347 0 : string = "RESTRICT";
2348 0 : break;
2349 108 : case FKCONSTR_ACTION_CASCADE:
2350 108 : string = "CASCADE";
2351 108 : break;
2352 18 : case FKCONSTR_ACTION_SETNULL:
2353 18 : string = "SET NULL";
2354 18 : break;
2355 6 : case FKCONSTR_ACTION_SETDEFAULT:
2356 6 : string = "SET DEFAULT";
2357 6 : break;
2358 0 : default:
2359 0 : elog(ERROR, "unrecognized confdeltype: %d",
2360 : conForm->confdeltype);
2361 : string = NULL; /* keep compiler quiet */
2362 : break;
2363 : }
2364 736 : if (string)
2365 132 : appendStringInfo(&buf, " ON DELETE %s", string);
2366 :
2367 : /*
2368 : * Add columns specified to SET NULL or SET DEFAULT if
2369 : * provided.
2370 : */
2371 736 : val = SysCacheGetAttr(CONSTROID, tup,
2372 : Anum_pg_constraint_confdelsetcols, &isnull);
2373 736 : if (!isnull)
2374 : {
2375 12 : appendStringInfoString(&buf, " (");
2376 12 : decompile_column_index_array(val, conForm->conrelid, false, &buf);
2377 12 : appendStringInfoChar(&buf, ')');
2378 : }
2379 :
2380 736 : break;
2381 : }
2382 3920 : case CONSTRAINT_PRIMARY:
2383 : case CONSTRAINT_UNIQUE:
2384 : {
2385 : Datum val;
2386 : Oid indexId;
2387 : int keyatts;
2388 : HeapTuple indtup;
2389 :
2390 : /* Start off the constraint definition */
2391 3920 : if (conForm->contype == CONSTRAINT_PRIMARY)
2392 3186 : appendStringInfoString(&buf, "PRIMARY KEY ");
2393 : else
2394 734 : appendStringInfoString(&buf, "UNIQUE ");
2395 :
2396 3920 : indexId = conForm->conindid;
2397 :
2398 3920 : indtup = SearchSysCache1(INDEXRELID, ObjectIdGetDatum(indexId));
2399 3920 : if (!HeapTupleIsValid(indtup))
2400 0 : elog(ERROR, "cache lookup failed for index %u", indexId);
2401 3920 : if (conForm->contype == CONSTRAINT_UNIQUE &&
2402 734 : ((Form_pg_index) GETSTRUCT(indtup))->indnullsnotdistinct)
2403 0 : appendStringInfoString(&buf, "NULLS NOT DISTINCT ");
2404 :
2405 3920 : appendStringInfoChar(&buf, '(');
2406 :
2407 : /* Fetch and build target column list */
2408 3920 : val = SysCacheGetAttrNotNull(CONSTROID, tup,
2409 : Anum_pg_constraint_conkey);
2410 :
2411 3920 : keyatts = decompile_column_index_array(val, conForm->conrelid, false, &buf);
2412 3920 : if (conForm->conperiod)
2413 382 : appendStringInfoString(&buf, " WITHOUT OVERLAPS");
2414 :
2415 3920 : appendStringInfoChar(&buf, ')');
2416 :
2417 : /* Build including column list (from pg_index.indkeys) */
2418 3920 : val = SysCacheGetAttrNotNull(INDEXRELID, indtup,
2419 : Anum_pg_index_indnatts);
2420 3920 : if (DatumGetInt32(val) > keyatts)
2421 : {
2422 : Datum cols;
2423 : Datum *keys;
2424 : int nKeys;
2425 : int j;
2426 :
2427 82 : appendStringInfoString(&buf, " INCLUDE (");
2428 :
2429 82 : cols = SysCacheGetAttrNotNull(INDEXRELID, indtup,
2430 : Anum_pg_index_indkey);
2431 :
2432 82 : deconstruct_array_builtin(DatumGetArrayTypeP(cols), INT2OID,
2433 : &keys, NULL, &nKeys);
2434 :
2435 246 : for (j = keyatts; j < nKeys; j++)
2436 : {
2437 : char *colName;
2438 :
2439 164 : colName = get_attname(conForm->conrelid,
2440 164 : DatumGetInt16(keys[j]), false);
2441 164 : if (j > keyatts)
2442 82 : appendStringInfoString(&buf, ", ");
2443 164 : appendStringInfoString(&buf, quote_identifier(colName));
2444 : }
2445 :
2446 82 : appendStringInfoChar(&buf, ')');
2447 : }
2448 3920 : ReleaseSysCache(indtup);
2449 :
2450 : /* XXX why do we only print these bits if fullCommand? */
2451 3920 : if (fullCommand && OidIsValid(indexId))
2452 : {
2453 204 : char *options = flatten_reloptions(indexId);
2454 : Oid tblspc;
2455 :
2456 204 : if (options)
2457 : {
2458 0 : appendStringInfo(&buf, " WITH (%s)", options);
2459 0 : pfree(options);
2460 : }
2461 :
2462 : /*
2463 : * Print the tablespace, unless it's the database default.
2464 : * This is to help ALTER TABLE usage of this facility,
2465 : * which needs this behavior to recreate exact catalog
2466 : * state.
2467 : */
2468 204 : tblspc = get_rel_tablespace(indexId);
2469 204 : if (OidIsValid(tblspc))
2470 24 : appendStringInfo(&buf, " USING INDEX TABLESPACE %s",
2471 24 : quote_identifier(get_tablespace_name(tblspc)));
2472 : }
2473 :
2474 3920 : break;
2475 : }
2476 2238 : case CONSTRAINT_CHECK:
2477 : {
2478 : Datum val;
2479 : char *conbin;
2480 : char *consrc;
2481 : Node *expr;
2482 : List *context;
2483 :
2484 : /* Fetch constraint expression in parsetree form */
2485 2238 : val = SysCacheGetAttrNotNull(CONSTROID, tup,
2486 : Anum_pg_constraint_conbin);
2487 :
2488 2238 : conbin = TextDatumGetCString(val);
2489 2238 : expr = stringToNode(conbin);
2490 :
2491 : /* Set up deparsing context for Var nodes in constraint */
2492 2238 : if (conForm->conrelid != InvalidOid)
2493 : {
2494 : /* relation constraint */
2495 1986 : context = deparse_context_for(get_relation_name(conForm->conrelid),
2496 : conForm->conrelid);
2497 : }
2498 : else
2499 : {
2500 : /* domain constraint --- can't have Vars */
2501 252 : context = NIL;
2502 : }
2503 :
2504 2238 : consrc = deparse_expression_pretty(expr, context, false, false,
2505 : prettyFlags, 0);
2506 :
2507 : /*
2508 : * Now emit the constraint definition, adding NO INHERIT if
2509 : * necessary.
2510 : *
2511 : * There are cases where the constraint expression will be
2512 : * fully parenthesized and we don't need the outer parens ...
2513 : * but there are other cases where we do need 'em. Be
2514 : * conservative for now.
2515 : *
2516 : * Note that simply checking for leading '(' and trailing ')'
2517 : * would NOT be good enough, consider "(x > 0) AND (y > 0)".
2518 : */
2519 2238 : appendStringInfo(&buf, "CHECK (%s)%s",
2520 : consrc,
2521 2238 : conForm->connoinherit ? " NO INHERIT" : "");
2522 2238 : break;
2523 : }
2524 444 : case CONSTRAINT_NOTNULL:
2525 : {
2526 444 : if (conForm->conrelid)
2527 : {
2528 : AttrNumber attnum;
2529 :
2530 332 : attnum = extractNotNullColumn(tup);
2531 :
2532 332 : appendStringInfo(&buf, "NOT NULL %s",
2533 332 : quote_identifier(get_attname(conForm->conrelid,
2534 : attnum, false)));
2535 332 : if (((Form_pg_constraint) GETSTRUCT(tup))->connoinherit)
2536 0 : appendStringInfoString(&buf, " NO INHERIT");
2537 : }
2538 112 : else if (conForm->contypid)
2539 : {
2540 : /* conkey is null for domain not-null constraints */
2541 112 : appendStringInfoString(&buf, "NOT NULL");
2542 : }
2543 444 : break;
2544 : }
2545 :
2546 0 : case CONSTRAINT_TRIGGER:
2547 :
2548 : /*
2549 : * There isn't an ALTER TABLE syntax for creating a user-defined
2550 : * constraint trigger, but it seems better to print something than
2551 : * throw an error; if we throw error then this function couldn't
2552 : * safely be applied to all rows of pg_constraint.
2553 : */
2554 0 : appendStringInfoString(&buf, "TRIGGER");
2555 0 : break;
2556 104 : case CONSTRAINT_EXCLUSION:
2557 : {
2558 104 : Oid indexOid = conForm->conindid;
2559 : Datum val;
2560 : Datum *elems;
2561 : int nElems;
2562 : int i;
2563 : Oid *operators;
2564 :
2565 : /* Extract operator OIDs from the pg_constraint tuple */
2566 104 : val = SysCacheGetAttrNotNull(CONSTROID, tup,
2567 : Anum_pg_constraint_conexclop);
2568 :
2569 104 : deconstruct_array_builtin(DatumGetArrayTypeP(val), OIDOID,
2570 : &elems, NULL, &nElems);
2571 :
2572 104 : operators = (Oid *) palloc(nElems * sizeof(Oid));
2573 228 : for (i = 0; i < nElems; i++)
2574 124 : operators[i] = DatumGetObjectId(elems[i]);
2575 :
2576 : /* pg_get_indexdef_worker does the rest */
2577 : /* suppress tablespace because pg_dump wants it that way */
2578 104 : appendStringInfoString(&buf,
2579 104 : pg_get_indexdef_worker(indexOid,
2580 : 0,
2581 : operators,
2582 : false,
2583 : false,
2584 : false,
2585 : false,
2586 : prettyFlags,
2587 : false));
2588 104 : break;
2589 : }
2590 0 : default:
2591 0 : elog(ERROR, "invalid constraint type \"%c\"", conForm->contype);
2592 : break;
2593 : }
2594 :
2595 7442 : if (conForm->condeferrable)
2596 120 : appendStringInfoString(&buf, " DEFERRABLE");
2597 7442 : if (conForm->condeferred)
2598 48 : appendStringInfoString(&buf, " INITIALLY DEFERRED");
2599 :
2600 : /* Validated status is irrelevant when the constraint is NOT ENFORCED. */
2601 7442 : if (!conForm->conenforced)
2602 92 : appendStringInfoString(&buf, " NOT ENFORCED");
2603 7350 : else if (!conForm->convalidated)
2604 248 : appendStringInfoString(&buf, " NOT VALID");
2605 :
2606 : /* Cleanup */
2607 7442 : systable_endscan(scandesc);
2608 7442 : table_close(relation, AccessShareLock);
2609 :
2610 7442 : return buf.data;
2611 : }
2612 :
2613 :
2614 : /*
2615 : * Convert an int16[] Datum into a comma-separated list of column names
2616 : * for the indicated relation; append the list to buf. Returns the number
2617 : * of keys.
2618 : */
2619 : static int
2620 5404 : decompile_column_index_array(Datum column_index_array, Oid relId,
2621 : bool withPeriod, StringInfo buf)
2622 : {
2623 : Datum *keys;
2624 : int nKeys;
2625 : int j;
2626 :
2627 : /* Extract data from array of int16 */
2628 5404 : deconstruct_array_builtin(DatumGetArrayTypeP(column_index_array), INT2OID,
2629 : &keys, NULL, &nKeys);
2630 :
2631 13084 : for (j = 0; j < nKeys; j++)
2632 : {
2633 : char *colName;
2634 :
2635 7680 : colName = get_attname(relId, DatumGetInt16(keys[j]), false);
2636 :
2637 7680 : if (j == 0)
2638 5404 : appendStringInfoString(buf, quote_identifier(colName));
2639 : else
2640 2504 : appendStringInfo(buf, ", %s%s",
2641 228 : (withPeriod && j == nKeys - 1) ? "PERIOD " : "",
2642 : quote_identifier(colName));
2643 : }
2644 :
2645 5404 : return nKeys;
2646 : }
2647 :
2648 :
2649 : /* ----------
2650 : * pg_get_expr - Decompile an expression tree
2651 : *
2652 : * Input: an expression tree in nodeToString form, and a relation OID
2653 : *
2654 : * Output: reverse-listed expression
2655 : *
2656 : * Currently, the expression can only refer to a single relation, namely
2657 : * the one specified by the second parameter. This is sufficient for
2658 : * partial indexes, column default expressions, etc. We also support
2659 : * Var-free expressions, for which the OID can be InvalidOid.
2660 : *
2661 : * If the OID is nonzero but not actually valid, don't throw an error,
2662 : * just return NULL. This is a bit questionable, but it's what we've
2663 : * done historically, and it can help avoid unwanted failures when
2664 : * examining catalog entries for just-deleted relations.
2665 : *
2666 : * We expect this function to work, or throw a reasonably clean error,
2667 : * for any node tree that can appear in a catalog pg_node_tree column.
2668 : * Query trees, such as those appearing in pg_rewrite.ev_action, are
2669 : * not supported. Nor are expressions in more than one relation, which
2670 : * can appear in places like pg_rewrite.ev_qual.
2671 : * ----------
2672 : */
2673 : Datum
2674 8464 : pg_get_expr(PG_FUNCTION_ARGS)
2675 : {
2676 8464 : text *expr = PG_GETARG_TEXT_PP(0);
2677 8464 : Oid relid = PG_GETARG_OID(1);
2678 : text *result;
2679 : int prettyFlags;
2680 :
2681 8464 : prettyFlags = PRETTYFLAG_INDENT;
2682 :
2683 8464 : result = pg_get_expr_worker(expr, relid, prettyFlags);
2684 8464 : if (result)
2685 8464 : PG_RETURN_TEXT_P(result);
2686 : else
2687 0 : PG_RETURN_NULL();
2688 : }
2689 :
2690 : Datum
2691 724 : pg_get_expr_ext(PG_FUNCTION_ARGS)
2692 : {
2693 724 : text *expr = PG_GETARG_TEXT_PP(0);
2694 724 : Oid relid = PG_GETARG_OID(1);
2695 724 : bool pretty = PG_GETARG_BOOL(2);
2696 : text *result;
2697 : int prettyFlags;
2698 :
2699 724 : prettyFlags = GET_PRETTY_FLAGS(pretty);
2700 :
2701 724 : result = pg_get_expr_worker(expr, relid, prettyFlags);
2702 724 : if (result)
2703 724 : PG_RETURN_TEXT_P(result);
2704 : else
2705 0 : PG_RETURN_NULL();
2706 : }
2707 :
2708 : static text *
2709 9188 : pg_get_expr_worker(text *expr, Oid relid, int prettyFlags)
2710 : {
2711 : Node *node;
2712 : Node *tst;
2713 : Relids relids;
2714 : List *context;
2715 : char *exprstr;
2716 9188 : Relation rel = NULL;
2717 : char *str;
2718 :
2719 : /* Convert input pg_node_tree (really TEXT) object to C string */
2720 9188 : exprstr = text_to_cstring(expr);
2721 :
2722 : /* Convert expression to node tree */
2723 9188 : node = (Node *) stringToNode(exprstr);
2724 :
2725 9188 : pfree(exprstr);
2726 :
2727 : /*
2728 : * Throw error if the input is a querytree rather than an expression tree.
2729 : * While we could support queries here, there seems no very good reason
2730 : * to. In most such catalog columns, we'll see a List of Query nodes, or
2731 : * even nested Lists, so drill down to a non-List node before checking.
2732 : */
2733 9188 : tst = node;
2734 9188 : while (tst && IsA(tst, List))
2735 0 : tst = linitial((List *) tst);
2736 9188 : if (tst && IsA(tst, Query))
2737 0 : ereport(ERROR,
2738 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
2739 : errmsg("input is a query, not an expression")));
2740 :
2741 : /*
2742 : * Throw error if the expression contains Vars we won't be able to
2743 : * deparse.
2744 : */
2745 9188 : relids = pull_varnos(NULL, node);
2746 9188 : if (OidIsValid(relid))
2747 : {
2748 9104 : if (!bms_is_subset(relids, bms_make_singleton(1)))
2749 0 : ereport(ERROR,
2750 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
2751 : errmsg("expression contains variables of more than one relation")));
2752 : }
2753 : else
2754 : {
2755 84 : if (!bms_is_empty(relids))
2756 0 : ereport(ERROR,
2757 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
2758 : errmsg("expression contains variables")));
2759 : }
2760 :
2761 : /*
2762 : * Prepare deparse context if needed. If we are deparsing with a relid,
2763 : * we need to transiently open and lock the rel, to make sure it won't go
2764 : * away underneath us. (set_relation_column_names would lock it anyway,
2765 : * so this isn't really introducing any new behavior.)
2766 : */
2767 9188 : if (OidIsValid(relid))
2768 : {
2769 9104 : rel = try_relation_open(relid, AccessShareLock);
2770 9104 : if (rel == NULL)
2771 0 : return NULL;
2772 9104 : context = deparse_context_for(RelationGetRelationName(rel), relid);
2773 : }
2774 : else
2775 84 : context = NIL;
2776 :
2777 : /* Deparse */
2778 9188 : str = deparse_expression_pretty(node, context, false, false,
2779 : prettyFlags, 0);
2780 :
2781 9188 : if (rel != NULL)
2782 9104 : relation_close(rel, AccessShareLock);
2783 :
2784 9188 : return string_to_text(str);
2785 : }
2786 :
2787 :
2788 : /* ----------
2789 : * pg_get_userbyid - Get a user name by roleid and
2790 : * fallback to 'unknown (OID=n)'
2791 : * ----------
2792 : */
2793 : Datum
2794 1746 : pg_get_userbyid(PG_FUNCTION_ARGS)
2795 : {
2796 1746 : Oid roleid = PG_GETARG_OID(0);
2797 : Name result;
2798 : HeapTuple roletup;
2799 : Form_pg_authid role_rec;
2800 :
2801 : /*
2802 : * Allocate space for the result
2803 : */
2804 1746 : result = (Name) palloc(NAMEDATALEN);
2805 1746 : memset(NameStr(*result), 0, NAMEDATALEN);
2806 :
2807 : /*
2808 : * Get the pg_authid entry and print the result
2809 : */
2810 1746 : roletup = SearchSysCache1(AUTHOID, ObjectIdGetDatum(roleid));
2811 1746 : if (HeapTupleIsValid(roletup))
2812 : {
2813 1746 : role_rec = (Form_pg_authid) GETSTRUCT(roletup);
2814 1746 : *result = role_rec->rolname;
2815 1746 : ReleaseSysCache(roletup);
2816 : }
2817 : else
2818 0 : sprintf(NameStr(*result), "unknown (OID=%u)", roleid);
2819 :
2820 1746 : PG_RETURN_NAME(result);
2821 : }
2822 :
2823 :
2824 : /*
2825 : * pg_get_serial_sequence
2826 : * Get the name of the sequence used by an identity or serial column,
2827 : * formatted suitably for passing to setval, nextval or currval.
2828 : * First parameter is not treated as double-quoted, second parameter
2829 : * is --- see documentation for reason.
2830 : */
2831 : Datum
2832 12 : pg_get_serial_sequence(PG_FUNCTION_ARGS)
2833 : {
2834 12 : text *tablename = PG_GETARG_TEXT_PP(0);
2835 12 : text *columnname = PG_GETARG_TEXT_PP(1);
2836 : RangeVar *tablerv;
2837 : Oid tableOid;
2838 : char *column;
2839 : AttrNumber attnum;
2840 12 : Oid sequenceId = InvalidOid;
2841 : Relation depRel;
2842 : ScanKeyData key[3];
2843 : SysScanDesc scan;
2844 : HeapTuple tup;
2845 :
2846 : /* Look up table name. Can't lock it - we might not have privileges. */
2847 12 : tablerv = makeRangeVarFromNameList(textToQualifiedNameList(tablename));
2848 12 : tableOid = RangeVarGetRelid(tablerv, NoLock, false);
2849 :
2850 : /* Get the number of the column */
2851 12 : column = text_to_cstring(columnname);
2852 :
2853 12 : attnum = get_attnum(tableOid, column);
2854 12 : if (attnum == InvalidAttrNumber)
2855 0 : ereport(ERROR,
2856 : (errcode(ERRCODE_UNDEFINED_COLUMN),
2857 : errmsg("column \"%s\" of relation \"%s\" does not exist",
2858 : column, tablerv->relname)));
2859 :
2860 : /* Search the dependency table for the dependent sequence */
2861 12 : depRel = table_open(DependRelationId, AccessShareLock);
2862 :
2863 12 : ScanKeyInit(&key[0],
2864 : Anum_pg_depend_refclassid,
2865 : BTEqualStrategyNumber, F_OIDEQ,
2866 : ObjectIdGetDatum(RelationRelationId));
2867 12 : ScanKeyInit(&key[1],
2868 : Anum_pg_depend_refobjid,
2869 : BTEqualStrategyNumber, F_OIDEQ,
2870 : ObjectIdGetDatum(tableOid));
2871 12 : ScanKeyInit(&key[2],
2872 : Anum_pg_depend_refobjsubid,
2873 : BTEqualStrategyNumber, F_INT4EQ,
2874 : Int32GetDatum(attnum));
2875 :
2876 12 : scan = systable_beginscan(depRel, DependReferenceIndexId, true,
2877 : NULL, 3, key);
2878 :
2879 30 : while (HeapTupleIsValid(tup = systable_getnext(scan)))
2880 : {
2881 30 : Form_pg_depend deprec = (Form_pg_depend) GETSTRUCT(tup);
2882 :
2883 : /*
2884 : * Look for an auto dependency (serial column) or internal dependency
2885 : * (identity column) of a sequence on a column. (We need the relkind
2886 : * test because indexes can also have auto dependencies on columns.)
2887 : */
2888 30 : if (deprec->classid == RelationRelationId &&
2889 12 : deprec->objsubid == 0 &&
2890 12 : (deprec->deptype == DEPENDENCY_AUTO ||
2891 18 : deprec->deptype == DEPENDENCY_INTERNAL) &&
2892 12 : get_rel_relkind(deprec->objid) == RELKIND_SEQUENCE)
2893 : {
2894 12 : sequenceId = deprec->objid;
2895 12 : break;
2896 : }
2897 : }
2898 :
2899 12 : systable_endscan(scan);
2900 12 : table_close(depRel, AccessShareLock);
2901 :
2902 12 : if (OidIsValid(sequenceId))
2903 : {
2904 : char *result;
2905 :
2906 12 : result = generate_qualified_relation_name(sequenceId);
2907 :
2908 12 : PG_RETURN_TEXT_P(string_to_text(result));
2909 : }
2910 :
2911 0 : PG_RETURN_NULL();
2912 : }
2913 :
2914 :
2915 : /*
2916 : * pg_get_functiondef
2917 : * Returns the complete "CREATE OR REPLACE FUNCTION ..." statement for
2918 : * the specified function.
2919 : *
2920 : * Note: if you change the output format of this function, be careful not
2921 : * to break psql's rules (in \ef and \sf) for identifying the start of the
2922 : * function body. To wit: the function body starts on a line that begins with
2923 : * "AS ", "BEGIN ", or "RETURN ", and no preceding line will look like that.
2924 : */
2925 : Datum
2926 172 : pg_get_functiondef(PG_FUNCTION_ARGS)
2927 : {
2928 172 : Oid funcid = PG_GETARG_OID(0);
2929 : StringInfoData buf;
2930 : StringInfoData dq;
2931 : HeapTuple proctup;
2932 : Form_pg_proc proc;
2933 : bool isfunction;
2934 : Datum tmp;
2935 : bool isnull;
2936 : const char *prosrc;
2937 : const char *name;
2938 : const char *nsp;
2939 : float4 procost;
2940 : int oldlen;
2941 :
2942 172 : initStringInfo(&buf);
2943 :
2944 : /* Look up the function */
2945 172 : proctup = SearchSysCache1(PROCOID, ObjectIdGetDatum(funcid));
2946 172 : if (!HeapTupleIsValid(proctup))
2947 6 : PG_RETURN_NULL();
2948 :
2949 166 : proc = (Form_pg_proc) GETSTRUCT(proctup);
2950 166 : name = NameStr(proc->proname);
2951 :
2952 166 : if (proc->prokind == PROKIND_AGGREGATE)
2953 0 : ereport(ERROR,
2954 : (errcode(ERRCODE_WRONG_OBJECT_TYPE),
2955 : errmsg("\"%s\" is an aggregate function", name)));
2956 :
2957 166 : isfunction = (proc->prokind != PROKIND_PROCEDURE);
2958 :
2959 : /*
2960 : * We always qualify the function name, to ensure the right function gets
2961 : * replaced.
2962 : */
2963 166 : nsp = get_namespace_name_or_temp(proc->pronamespace);
2964 166 : appendStringInfo(&buf, "CREATE OR REPLACE %s %s(",
2965 : isfunction ? "FUNCTION" : "PROCEDURE",
2966 : quote_qualified_identifier(nsp, name));
2967 166 : (void) print_function_arguments(&buf, proctup, false, true);
2968 166 : appendStringInfoString(&buf, ")\n");
2969 166 : if (isfunction)
2970 : {
2971 146 : appendStringInfoString(&buf, " RETURNS ");
2972 146 : print_function_rettype(&buf, proctup);
2973 146 : appendStringInfoChar(&buf, '\n');
2974 : }
2975 :
2976 166 : print_function_trftypes(&buf, proctup);
2977 :
2978 166 : appendStringInfo(&buf, " LANGUAGE %s\n",
2979 166 : quote_identifier(get_language_name(proc->prolang, false)));
2980 :
2981 : /* Emit some miscellaneous options on one line */
2982 166 : oldlen = buf.len;
2983 :
2984 166 : if (proc->prokind == PROKIND_WINDOW)
2985 0 : appendStringInfoString(&buf, " WINDOW");
2986 166 : switch (proc->provolatile)
2987 : {
2988 12 : case PROVOLATILE_IMMUTABLE:
2989 12 : appendStringInfoString(&buf, " IMMUTABLE");
2990 12 : break;
2991 30 : case PROVOLATILE_STABLE:
2992 30 : appendStringInfoString(&buf, " STABLE");
2993 30 : break;
2994 124 : case PROVOLATILE_VOLATILE:
2995 124 : break;
2996 : }
2997 :
2998 166 : switch (proc->proparallel)
2999 : {
3000 28 : case PROPARALLEL_SAFE:
3001 28 : appendStringInfoString(&buf, " PARALLEL SAFE");
3002 28 : break;
3003 0 : case PROPARALLEL_RESTRICTED:
3004 0 : appendStringInfoString(&buf, " PARALLEL RESTRICTED");
3005 0 : break;
3006 138 : case PROPARALLEL_UNSAFE:
3007 138 : break;
3008 : }
3009 :
3010 166 : if (proc->proisstrict)
3011 50 : appendStringInfoString(&buf, " STRICT");
3012 166 : if (proc->prosecdef)
3013 6 : appendStringInfoString(&buf, " SECURITY DEFINER");
3014 166 : if (proc->proleakproof)
3015 0 : appendStringInfoString(&buf, " LEAKPROOF");
3016 :
3017 : /* This code for the default cost and rows should match functioncmds.c */
3018 166 : if (proc->prolang == INTERNALlanguageId ||
3019 166 : proc->prolang == ClanguageId)
3020 10 : procost = 1;
3021 : else
3022 156 : procost = 100;
3023 166 : if (proc->procost != procost)
3024 6 : appendStringInfo(&buf, " COST %g", proc->procost);
3025 :
3026 166 : if (proc->prorows > 0 && proc->prorows != 1000)
3027 0 : appendStringInfo(&buf, " ROWS %g", proc->prorows);
3028 :
3029 166 : if (proc->prosupport)
3030 : {
3031 : Oid argtypes[1];
3032 :
3033 : /*
3034 : * We should qualify the support function's name if it wouldn't be
3035 : * resolved by lookup in the current search path.
3036 : */
3037 0 : argtypes[0] = INTERNALOID;
3038 0 : appendStringInfo(&buf, " SUPPORT %s",
3039 : generate_function_name(proc->prosupport, 1,
3040 : NIL, argtypes,
3041 : false, NULL, false));
3042 : }
3043 :
3044 166 : if (oldlen != buf.len)
3045 64 : appendStringInfoChar(&buf, '\n');
3046 :
3047 : /* Emit any proconfig options, one per line */
3048 166 : tmp = SysCacheGetAttr(PROCOID, proctup, Anum_pg_proc_proconfig, &isnull);
3049 166 : if (!isnull)
3050 : {
3051 6 : ArrayType *a = DatumGetArrayTypeP(tmp);
3052 : int i;
3053 :
3054 : Assert(ARR_ELEMTYPE(a) == TEXTOID);
3055 : Assert(ARR_NDIM(a) == 1);
3056 : Assert(ARR_LBOUND(a)[0] == 1);
3057 :
3058 36 : for (i = 1; i <= ARR_DIMS(a)[0]; i++)
3059 : {
3060 : Datum d;
3061 :
3062 30 : d = array_ref(a, 1, &i,
3063 : -1 /* varlenarray */ ,
3064 : -1 /* TEXT's typlen */ ,
3065 : false /* TEXT's typbyval */ ,
3066 : TYPALIGN_INT /* TEXT's typalign */ ,
3067 : &isnull);
3068 30 : if (!isnull)
3069 : {
3070 30 : char *configitem = TextDatumGetCString(d);
3071 : char *pos;
3072 :
3073 30 : pos = strchr(configitem, '=');
3074 30 : if (pos == NULL)
3075 0 : continue;
3076 30 : *pos++ = '\0';
3077 :
3078 30 : appendStringInfo(&buf, " SET %s TO ",
3079 : quote_identifier(configitem));
3080 :
3081 : /*
3082 : * Variables that are marked GUC_LIST_QUOTE were already fully
3083 : * quoted by flatten_set_variable_args() before they were put
3084 : * into the proconfig array. However, because the quoting
3085 : * rules used there aren't exactly like SQL's, we have to
3086 : * break the list value apart and then quote the elements as
3087 : * string literals. (The elements may be double-quoted as-is,
3088 : * but we can't just feed them to the SQL parser; it would do
3089 : * the wrong thing with elements that are zero-length or
3090 : * longer than NAMEDATALEN.)
3091 : *
3092 : * Variables that are not so marked should just be emitted as
3093 : * simple string literals. If the variable is not known to
3094 : * guc.c, we'll do that; this makes it unsafe to use
3095 : * GUC_LIST_QUOTE for extension variables.
3096 : */
3097 30 : if (GetConfigOptionFlags(configitem, true) & GUC_LIST_QUOTE)
3098 : {
3099 : List *namelist;
3100 : ListCell *lc;
3101 :
3102 : /* Parse string into list of identifiers */
3103 12 : if (!SplitGUCList(pos, ',', &namelist))
3104 : {
3105 : /* this shouldn't fail really */
3106 0 : elog(ERROR, "invalid list syntax in proconfig item");
3107 : }
3108 42 : foreach(lc, namelist)
3109 : {
3110 30 : char *curname = (char *) lfirst(lc);
3111 :
3112 30 : simple_quote_literal(&buf, curname);
3113 30 : if (lnext(namelist, lc))
3114 18 : appendStringInfoString(&buf, ", ");
3115 : }
3116 : }
3117 : else
3118 18 : simple_quote_literal(&buf, pos);
3119 30 : appendStringInfoChar(&buf, '\n');
3120 : }
3121 : }
3122 : }
3123 :
3124 : /* And finally the function definition ... */
3125 166 : (void) SysCacheGetAttr(PROCOID, proctup, Anum_pg_proc_prosqlbody, &isnull);
3126 166 : if (proc->prolang == SQLlanguageId && !isnull)
3127 : {
3128 114 : print_function_sqlbody(&buf, proctup);
3129 : }
3130 : else
3131 : {
3132 52 : appendStringInfoString(&buf, "AS ");
3133 :
3134 52 : tmp = SysCacheGetAttr(PROCOID, proctup, Anum_pg_proc_probin, &isnull);
3135 52 : if (!isnull)
3136 : {
3137 10 : simple_quote_literal(&buf, TextDatumGetCString(tmp));
3138 10 : appendStringInfoString(&buf, ", "); /* assume prosrc isn't null */
3139 : }
3140 :
3141 52 : tmp = SysCacheGetAttrNotNull(PROCOID, proctup, Anum_pg_proc_prosrc);
3142 52 : prosrc = TextDatumGetCString(tmp);
3143 :
3144 : /*
3145 : * We always use dollar quoting. Figure out a suitable delimiter.
3146 : *
3147 : * Since the user is likely to be editing the function body string, we
3148 : * shouldn't use a short delimiter that he might easily create a
3149 : * conflict with. Hence prefer "$function$"/"$procedure$", but extend
3150 : * if needed.
3151 : */
3152 52 : initStringInfo(&dq);
3153 52 : appendStringInfoChar(&dq, '$');
3154 52 : appendStringInfoString(&dq, (isfunction ? "function" : "procedure"));
3155 52 : while (strstr(prosrc, dq.data) != NULL)
3156 0 : appendStringInfoChar(&dq, 'x');
3157 52 : appendStringInfoChar(&dq, '$');
3158 :
3159 52 : appendBinaryStringInfo(&buf, dq.data, dq.len);
3160 52 : appendStringInfoString(&buf, prosrc);
3161 52 : appendBinaryStringInfo(&buf, dq.data, dq.len);
3162 : }
3163 :
3164 166 : appendStringInfoChar(&buf, '\n');
3165 :
3166 166 : ReleaseSysCache(proctup);
3167 :
3168 166 : PG_RETURN_TEXT_P(string_to_text(buf.data));
3169 : }
3170 :
3171 : /*
3172 : * pg_get_function_arguments
3173 : * Get a nicely-formatted list of arguments for a function.
3174 : * This is everything that would go between the parentheses in
3175 : * CREATE FUNCTION.
3176 : */
3177 : Datum
3178 4620 : pg_get_function_arguments(PG_FUNCTION_ARGS)
3179 : {
3180 4620 : Oid funcid = PG_GETARG_OID(0);
3181 : StringInfoData buf;
3182 : HeapTuple proctup;
3183 :
3184 4620 : proctup = SearchSysCache1(PROCOID, ObjectIdGetDatum(funcid));
3185 4620 : if (!HeapTupleIsValid(proctup))
3186 6 : PG_RETURN_NULL();
3187 :
3188 4614 : initStringInfo(&buf);
3189 :
3190 4614 : (void) print_function_arguments(&buf, proctup, false, true);
3191 :
3192 4614 : ReleaseSysCache(proctup);
3193 :
3194 4614 : PG_RETURN_TEXT_P(string_to_text(buf.data));
3195 : }
3196 :
3197 : /*
3198 : * pg_get_function_identity_arguments
3199 : * Get a formatted list of arguments for a function.
3200 : * This is everything that would go between the parentheses in
3201 : * ALTER FUNCTION, etc. In particular, don't print defaults.
3202 : */
3203 : Datum
3204 4088 : pg_get_function_identity_arguments(PG_FUNCTION_ARGS)
3205 : {
3206 4088 : Oid funcid = PG_GETARG_OID(0);
3207 : StringInfoData buf;
3208 : HeapTuple proctup;
3209 :
3210 4088 : proctup = SearchSysCache1(PROCOID, ObjectIdGetDatum(funcid));
3211 4088 : if (!HeapTupleIsValid(proctup))
3212 6 : PG_RETURN_NULL();
3213 :
3214 4082 : initStringInfo(&buf);
3215 :
3216 4082 : (void) print_function_arguments(&buf, proctup, false, false);
3217 :
3218 4082 : ReleaseSysCache(proctup);
3219 :
3220 4082 : PG_RETURN_TEXT_P(string_to_text(buf.data));
3221 : }
3222 :
3223 : /*
3224 : * pg_get_function_result
3225 : * Get a nicely-formatted version of the result type of a function.
3226 : * This is what would appear after RETURNS in CREATE FUNCTION.
3227 : */
3228 : Datum
3229 4036 : pg_get_function_result(PG_FUNCTION_ARGS)
3230 : {
3231 4036 : Oid funcid = PG_GETARG_OID(0);
3232 : StringInfoData buf;
3233 : HeapTuple proctup;
3234 :
3235 4036 : proctup = SearchSysCache1(PROCOID, ObjectIdGetDatum(funcid));
3236 4036 : if (!HeapTupleIsValid(proctup))
3237 6 : PG_RETURN_NULL();
3238 :
3239 4030 : if (((Form_pg_proc) GETSTRUCT(proctup))->prokind == PROKIND_PROCEDURE)
3240 : {
3241 238 : ReleaseSysCache(proctup);
3242 238 : PG_RETURN_NULL();
3243 : }
3244 :
3245 3792 : initStringInfo(&buf);
3246 :
3247 3792 : print_function_rettype(&buf, proctup);
3248 :
3249 3792 : ReleaseSysCache(proctup);
3250 :
3251 3792 : PG_RETURN_TEXT_P(string_to_text(buf.data));
3252 : }
3253 :
3254 : /*
3255 : * Guts of pg_get_function_result: append the function's return type
3256 : * to the specified buffer.
3257 : */
3258 : static void
3259 3938 : print_function_rettype(StringInfo buf, HeapTuple proctup)
3260 : {
3261 3938 : Form_pg_proc proc = (Form_pg_proc) GETSTRUCT(proctup);
3262 3938 : int ntabargs = 0;
3263 : StringInfoData rbuf;
3264 :
3265 3938 : initStringInfo(&rbuf);
3266 :
3267 3938 : if (proc->proretset)
3268 : {
3269 : /* It might be a table function; try to print the arguments */
3270 404 : appendStringInfoString(&rbuf, "TABLE(");
3271 404 : ntabargs = print_function_arguments(&rbuf, proctup, true, false);
3272 404 : if (ntabargs > 0)
3273 76 : appendStringInfoChar(&rbuf, ')');
3274 : else
3275 328 : resetStringInfo(&rbuf);
3276 : }
3277 :
3278 3938 : if (ntabargs == 0)
3279 : {
3280 : /* Not a table function, so do the normal thing */
3281 3862 : if (proc->proretset)
3282 328 : appendStringInfoString(&rbuf, "SETOF ");
3283 3862 : appendStringInfoString(&rbuf, format_type_be(proc->prorettype));
3284 : }
3285 :
3286 3938 : appendBinaryStringInfo(buf, rbuf.data, rbuf.len);
3287 3938 : }
3288 :
3289 : /*
3290 : * Common code for pg_get_function_arguments and pg_get_function_result:
3291 : * append the desired subset of arguments to buf. We print only TABLE
3292 : * arguments when print_table_args is true, and all the others when it's false.
3293 : * We print argument defaults only if print_defaults is true.
3294 : * Function return value is the number of arguments printed.
3295 : */
3296 : static int
3297 9266 : print_function_arguments(StringInfo buf, HeapTuple proctup,
3298 : bool print_table_args, bool print_defaults)
3299 : {
3300 9266 : Form_pg_proc proc = (Form_pg_proc) GETSTRUCT(proctup);
3301 : int numargs;
3302 : Oid *argtypes;
3303 : char **argnames;
3304 : char *argmodes;
3305 9266 : int insertorderbyat = -1;
3306 : int argsprinted;
3307 : int inputargno;
3308 : int nlackdefaults;
3309 9266 : List *argdefaults = NIL;
3310 9266 : ListCell *nextargdefault = NULL;
3311 : int i;
3312 :
3313 9266 : numargs = get_func_arg_info(proctup,
3314 : &argtypes, &argnames, &argmodes);
3315 :
3316 9266 : nlackdefaults = numargs;
3317 9266 : if (print_defaults && proc->pronargdefaults > 0)
3318 : {
3319 : Datum proargdefaults;
3320 : bool isnull;
3321 :
3322 38 : proargdefaults = SysCacheGetAttr(PROCOID, proctup,
3323 : Anum_pg_proc_proargdefaults,
3324 : &isnull);
3325 38 : if (!isnull)
3326 : {
3327 : char *str;
3328 :
3329 38 : str = TextDatumGetCString(proargdefaults);
3330 38 : argdefaults = castNode(List, stringToNode(str));
3331 38 : pfree(str);
3332 38 : nextargdefault = list_head(argdefaults);
3333 : /* nlackdefaults counts only *input* arguments lacking defaults */
3334 38 : nlackdefaults = proc->pronargs - list_length(argdefaults);
3335 : }
3336 : }
3337 :
3338 : /* Check for special treatment of ordered-set aggregates */
3339 9266 : if (proc->prokind == PROKIND_AGGREGATE)
3340 : {
3341 : HeapTuple aggtup;
3342 : Form_pg_aggregate agg;
3343 :
3344 1170 : aggtup = SearchSysCache1(AGGFNOID, ObjectIdGetDatum(proc->oid));
3345 1170 : if (!HeapTupleIsValid(aggtup))
3346 0 : elog(ERROR, "cache lookup failed for aggregate %u",
3347 : proc->oid);
3348 1170 : agg = (Form_pg_aggregate) GETSTRUCT(aggtup);
3349 1170 : if (AGGKIND_IS_ORDERED_SET(agg->aggkind))
3350 52 : insertorderbyat = agg->aggnumdirectargs;
3351 1170 : ReleaseSysCache(aggtup);
3352 : }
3353 :
3354 9266 : argsprinted = 0;
3355 9266 : inputargno = 0;
3356 18676 : for (i = 0; i < numargs; i++)
3357 : {
3358 9410 : Oid argtype = argtypes[i];
3359 9410 : char *argname = argnames ? argnames[i] : NULL;
3360 9410 : char argmode = argmodes ? argmodes[i] : PROARGMODE_IN;
3361 : const char *modename;
3362 : bool isinput;
3363 :
3364 9410 : switch (argmode)
3365 : {
3366 7732 : case PROARGMODE_IN:
3367 :
3368 : /*
3369 : * For procedures, explicitly mark all argument modes, so as
3370 : * to avoid ambiguity with the SQL syntax for DROP PROCEDURE.
3371 : */
3372 7732 : if (proc->prokind == PROKIND_PROCEDURE)
3373 532 : modename = "IN ";
3374 : else
3375 7200 : modename = "";
3376 7732 : isinput = true;
3377 7732 : break;
3378 100 : case PROARGMODE_INOUT:
3379 100 : modename = "INOUT ";
3380 100 : isinput = true;
3381 100 : break;
3382 956 : case PROARGMODE_OUT:
3383 956 : modename = "OUT ";
3384 956 : isinput = false;
3385 956 : break;
3386 178 : case PROARGMODE_VARIADIC:
3387 178 : modename = "VARIADIC ";
3388 178 : isinput = true;
3389 178 : break;
3390 444 : case PROARGMODE_TABLE:
3391 444 : modename = "";
3392 444 : isinput = false;
3393 444 : break;
3394 0 : default:
3395 0 : elog(ERROR, "invalid parameter mode '%c'", argmode);
3396 : modename = NULL; /* keep compiler quiet */
3397 : isinput = false;
3398 : break;
3399 : }
3400 9410 : if (isinput)
3401 8010 : inputargno++; /* this is a 1-based counter */
3402 :
3403 9410 : if (print_table_args != (argmode == PROARGMODE_TABLE))
3404 764 : continue;
3405 :
3406 8646 : if (argsprinted == insertorderbyat)
3407 : {
3408 52 : if (argsprinted)
3409 52 : appendStringInfoChar(buf, ' ');
3410 52 : appendStringInfoString(buf, "ORDER BY ");
3411 : }
3412 8594 : else if (argsprinted)
3413 2776 : appendStringInfoString(buf, ", ");
3414 :
3415 8646 : appendStringInfoString(buf, modename);
3416 8646 : if (argname && argname[0])
3417 3106 : appendStringInfo(buf, "%s ", quote_identifier(argname));
3418 8646 : appendStringInfoString(buf, format_type_be(argtype));
3419 8646 : if (print_defaults && isinput && inputargno > nlackdefaults)
3420 : {
3421 : Node *expr;
3422 :
3423 : Assert(nextargdefault != NULL);
3424 58 : expr = (Node *) lfirst(nextargdefault);
3425 58 : nextargdefault = lnext(argdefaults, nextargdefault);
3426 :
3427 58 : appendStringInfo(buf, " DEFAULT %s",
3428 : deparse_expression(expr, NIL, false, false));
3429 : }
3430 8646 : argsprinted++;
3431 :
3432 : /* nasty hack: print the last arg twice for variadic ordered-set agg */
3433 8646 : if (argsprinted == insertorderbyat && i == numargs - 1)
3434 : {
3435 26 : i--;
3436 : /* aggs shouldn't have defaults anyway, but just to be sure ... */
3437 26 : print_defaults = false;
3438 : }
3439 : }
3440 :
3441 9266 : return argsprinted;
3442 : }
3443 :
3444 : static bool
3445 96 : is_input_argument(int nth, const char *argmodes)
3446 : {
3447 : return (!argmodes
3448 42 : || argmodes[nth] == PROARGMODE_IN
3449 18 : || argmodes[nth] == PROARGMODE_INOUT
3450 138 : || argmodes[nth] == PROARGMODE_VARIADIC);
3451 : }
3452 :
3453 : /*
3454 : * Append used transformed types to specified buffer
3455 : */
3456 : static void
3457 166 : print_function_trftypes(StringInfo buf, HeapTuple proctup)
3458 : {
3459 : Oid *trftypes;
3460 : int ntypes;
3461 :
3462 166 : ntypes = get_func_trftypes(proctup, &trftypes);
3463 166 : if (ntypes > 0)
3464 : {
3465 : int i;
3466 :
3467 6 : appendStringInfoString(buf, " TRANSFORM ");
3468 16 : for (i = 0; i < ntypes; i++)
3469 : {
3470 10 : if (i != 0)
3471 4 : appendStringInfoString(buf, ", ");
3472 10 : appendStringInfo(buf, "FOR TYPE %s", format_type_be(trftypes[i]));
3473 : }
3474 6 : appendStringInfoChar(buf, '\n');
3475 : }
3476 166 : }
3477 :
3478 : /*
3479 : * Get textual representation of a function argument's default value. The
3480 : * second argument of this function is the argument number among all arguments
3481 : * (i.e. proallargtypes, *not* proargtypes), starting with 1, because that's
3482 : * how information_schema.sql uses it.
3483 : */
3484 : Datum
3485 54 : pg_get_function_arg_default(PG_FUNCTION_ARGS)
3486 : {
3487 54 : Oid funcid = PG_GETARG_OID(0);
3488 54 : int32 nth_arg = PG_GETARG_INT32(1);
3489 : HeapTuple proctup;
3490 : Form_pg_proc proc;
3491 : int numargs;
3492 : Oid *argtypes;
3493 : char **argnames;
3494 : char *argmodes;
3495 : int i;
3496 : List *argdefaults;
3497 : Node *node;
3498 : char *str;
3499 : int nth_inputarg;
3500 : Datum proargdefaults;
3501 : bool isnull;
3502 : int nth_default;
3503 :
3504 54 : proctup = SearchSysCache1(PROCOID, ObjectIdGetDatum(funcid));
3505 54 : if (!HeapTupleIsValid(proctup))
3506 12 : PG_RETURN_NULL();
3507 :
3508 42 : numargs = get_func_arg_info(proctup, &argtypes, &argnames, &argmodes);
3509 42 : if (nth_arg < 1 || nth_arg > numargs || !is_input_argument(nth_arg - 1, argmodes))
3510 : {
3511 12 : ReleaseSysCache(proctup);
3512 12 : PG_RETURN_NULL();
3513 : }
3514 :
3515 30 : nth_inputarg = 0;
3516 84 : for (i = 0; i < nth_arg; i++)
3517 54 : if (is_input_argument(i, argmodes))
3518 48 : nth_inputarg++;
3519 :
3520 30 : proargdefaults = SysCacheGetAttr(PROCOID, proctup,
3521 : Anum_pg_proc_proargdefaults,
3522 : &isnull);
3523 30 : if (isnull)
3524 : {
3525 0 : ReleaseSysCache(proctup);
3526 0 : PG_RETURN_NULL();
3527 : }
3528 :
3529 30 : str = TextDatumGetCString(proargdefaults);
3530 30 : argdefaults = castNode(List, stringToNode(str));
3531 30 : pfree(str);
3532 :
3533 30 : proc = (Form_pg_proc) GETSTRUCT(proctup);
3534 :
3535 : /*
3536 : * Calculate index into proargdefaults: proargdefaults corresponds to the
3537 : * last N input arguments, where N = pronargdefaults.
3538 : */
3539 30 : nth_default = nth_inputarg - 1 - (proc->pronargs - proc->pronargdefaults);
3540 :
3541 30 : if (nth_default < 0 || nth_default >= list_length(argdefaults))
3542 : {
3543 6 : ReleaseSysCache(proctup);
3544 6 : PG_RETURN_NULL();
3545 : }
3546 24 : node = list_nth(argdefaults, nth_default);
3547 24 : str = deparse_expression(node, NIL, false, false);
3548 :
3549 24 : ReleaseSysCache(proctup);
3550 :
3551 24 : PG_RETURN_TEXT_P(string_to_text(str));
3552 : }
3553 :
3554 : static void
3555 210 : print_function_sqlbody(StringInfo buf, HeapTuple proctup)
3556 : {
3557 : int numargs;
3558 : Oid *argtypes;
3559 : char **argnames;
3560 : char *argmodes;
3561 210 : deparse_namespace dpns = {0};
3562 : Datum tmp;
3563 : Node *n;
3564 :
3565 210 : dpns.funcname = pstrdup(NameStr(((Form_pg_proc) GETSTRUCT(proctup))->proname));
3566 210 : numargs = get_func_arg_info(proctup,
3567 : &argtypes, &argnames, &argmodes);
3568 210 : dpns.numargs = numargs;
3569 210 : dpns.argnames = argnames;
3570 :
3571 210 : tmp = SysCacheGetAttrNotNull(PROCOID, proctup, Anum_pg_proc_prosqlbody);
3572 210 : n = stringToNode(TextDatumGetCString(tmp));
3573 :
3574 210 : if (IsA(n, List))
3575 : {
3576 : List *stmts;
3577 : ListCell *lc;
3578 :
3579 164 : stmts = linitial(castNode(List, n));
3580 :
3581 164 : appendStringInfoString(buf, "BEGIN ATOMIC\n");
3582 :
3583 318 : foreach(lc, stmts)
3584 : {
3585 154 : Query *query = lfirst_node(Query, lc);
3586 :
3587 : /* It seems advisable to get at least AccessShareLock on rels */
3588 154 : AcquireRewriteLocks(query, false, false);
3589 154 : get_query_def(query, buf, list_make1(&dpns), NULL, false,
3590 : PRETTYFLAG_INDENT, WRAP_COLUMN_DEFAULT, 1);
3591 154 : appendStringInfoChar(buf, ';');
3592 154 : appendStringInfoChar(buf, '\n');
3593 : }
3594 :
3595 164 : appendStringInfoString(buf, "END");
3596 : }
3597 : else
3598 : {
3599 46 : Query *query = castNode(Query, n);
3600 :
3601 : /* It seems advisable to get at least AccessShareLock on rels */
3602 46 : AcquireRewriteLocks(query, false, false);
3603 46 : get_query_def(query, buf, list_make1(&dpns), NULL, false,
3604 : 0, WRAP_COLUMN_DEFAULT, 0);
3605 : }
3606 210 : }
3607 :
3608 : Datum
3609 3512 : pg_get_function_sqlbody(PG_FUNCTION_ARGS)
3610 : {
3611 3512 : Oid funcid = PG_GETARG_OID(0);
3612 : StringInfoData buf;
3613 : HeapTuple proctup;
3614 : bool isnull;
3615 :
3616 3512 : initStringInfo(&buf);
3617 :
3618 : /* Look up the function */
3619 3512 : proctup = SearchSysCache1(PROCOID, ObjectIdGetDatum(funcid));
3620 3512 : if (!HeapTupleIsValid(proctup))
3621 0 : PG_RETURN_NULL();
3622 :
3623 3512 : (void) SysCacheGetAttr(PROCOID, proctup, Anum_pg_proc_prosqlbody, &isnull);
3624 3512 : if (isnull)
3625 : {
3626 3416 : ReleaseSysCache(proctup);
3627 3416 : PG_RETURN_NULL();
3628 : }
3629 :
3630 96 : print_function_sqlbody(&buf, proctup);
3631 :
3632 96 : ReleaseSysCache(proctup);
3633 :
3634 96 : PG_RETURN_TEXT_P(cstring_to_text_with_len(buf.data, buf.len));
3635 : }
3636 :
3637 :
3638 : /*
3639 : * deparse_expression - General utility for deparsing expressions
3640 : *
3641 : * calls deparse_expression_pretty with all prettyPrinting disabled
3642 : */
3643 : char *
3644 80910 : deparse_expression(Node *expr, List *dpcontext,
3645 : bool forceprefix, bool showimplicit)
3646 : {
3647 80910 : return deparse_expression_pretty(expr, dpcontext, forceprefix,
3648 : showimplicit, 0, 0);
3649 : }
3650 :
3651 : /* ----------
3652 : * deparse_expression_pretty - General utility for deparsing expressions
3653 : *
3654 : * expr is the node tree to be deparsed. It must be a transformed expression
3655 : * tree (ie, not the raw output of gram.y).
3656 : *
3657 : * dpcontext is a list of deparse_namespace nodes representing the context
3658 : * for interpreting Vars in the node tree. It can be NIL if no Vars are
3659 : * expected.
3660 : *
3661 : * forceprefix is true to force all Vars to be prefixed with their table names.
3662 : *
3663 : * showimplicit is true to force all implicit casts to be shown explicitly.
3664 : *
3665 : * Tries to pretty up the output according to prettyFlags and startIndent.
3666 : *
3667 : * The result is a palloc'd string.
3668 : * ----------
3669 : */
3670 : static char *
3671 94040 : deparse_expression_pretty(Node *expr, List *dpcontext,
3672 : bool forceprefix, bool showimplicit,
3673 : int prettyFlags, int startIndent)
3674 : {
3675 : StringInfoData buf;
3676 : deparse_context context;
3677 :
3678 94040 : initStringInfo(&buf);
3679 94040 : context.buf = &buf;
3680 94040 : context.namespaces = dpcontext;
3681 94040 : context.resultDesc = NULL;
3682 94040 : context.targetList = NIL;
3683 94040 : context.windowClause = NIL;
3684 94040 : context.varprefix = forceprefix;
3685 94040 : context.prettyFlags = prettyFlags;
3686 94040 : context.wrapColumn = WRAP_COLUMN_DEFAULT;
3687 94040 : context.indentLevel = startIndent;
3688 94040 : context.colNamesVisible = true;
3689 94040 : context.inGroupBy = false;
3690 94040 : context.varInOrderBy = false;
3691 94040 : context.appendparents = NULL;
3692 :
3693 94040 : get_rule_expr(expr, &context, showimplicit);
3694 :
3695 94040 : return buf.data;
3696 : }
3697 :
3698 : /* ----------
3699 : * deparse_context_for - Build deparse context for a single relation
3700 : *
3701 : * Given the reference name (alias) and OID of a relation, build deparsing
3702 : * context for an expression referencing only that relation (as varno 1,
3703 : * varlevelsup 0). This is sufficient for many uses of deparse_expression.
3704 : * ----------
3705 : */
3706 : List *
3707 23540 : deparse_context_for(const char *aliasname, Oid relid)
3708 : {
3709 : deparse_namespace *dpns;
3710 : RangeTblEntry *rte;
3711 :
3712 23540 : dpns = (deparse_namespace *) palloc0(sizeof(deparse_namespace));
3713 :
3714 : /* Build a minimal RTE for the rel */
3715 23540 : rte = makeNode(RangeTblEntry);
3716 23540 : rte->rtekind = RTE_RELATION;
3717 23540 : rte->relid = relid;
3718 23540 : rte->relkind = RELKIND_RELATION; /* no need for exactness here */
3719 23540 : rte->rellockmode = AccessShareLock;
3720 23540 : rte->alias = makeAlias(aliasname, NIL);
3721 23540 : rte->eref = rte->alias;
3722 23540 : rte->lateral = false;
3723 23540 : rte->inh = false;
3724 23540 : rte->inFromCl = true;
3725 :
3726 : /* Build one-element rtable */
3727 23540 : dpns->rtable = list_make1(rte);
3728 23540 : dpns->subplans = NIL;
3729 23540 : dpns->ctes = NIL;
3730 23540 : dpns->appendrels = NULL;
3731 23540 : set_rtable_names(dpns, NIL, NULL);
3732 23540 : set_simple_column_names(dpns);
3733 :
3734 : /* Return a one-deep namespace stack */
3735 23540 : return list_make1(dpns);
3736 : }
3737 :
3738 : /*
3739 : * deparse_context_for_plan_tree - Build deparse context for a Plan tree
3740 : *
3741 : * When deparsing an expression in a Plan tree, we use the plan's rangetable
3742 : * to resolve names of simple Vars. The initialization of column names for
3743 : * this is rather expensive if the rangetable is large, and it'll be the same
3744 : * for every expression in the Plan tree; so we do it just once and re-use
3745 : * the result of this function for each expression. (Note that the result
3746 : * is not usable until set_deparse_context_plan() is applied to it.)
3747 : *
3748 : * In addition to the PlannedStmt, pass the per-RTE alias names
3749 : * assigned by a previous call to select_rtable_names_for_explain.
3750 : */
3751 : List *
3752 24228 : deparse_context_for_plan_tree(PlannedStmt *pstmt, List *rtable_names)
3753 : {
3754 : deparse_namespace *dpns;
3755 :
3756 24228 : dpns = (deparse_namespace *) palloc0(sizeof(deparse_namespace));
3757 :
3758 : /* Initialize fields that stay the same across the whole plan tree */
3759 24228 : dpns->rtable = pstmt->rtable;
3760 24228 : dpns->rtable_names = rtable_names;
3761 24228 : dpns->subplans = pstmt->subplans;
3762 24228 : dpns->ctes = NIL;
3763 24228 : if (pstmt->appendRelations)
3764 : {
3765 : /* Set up the array, indexed by child relid */
3766 3906 : int ntables = list_length(dpns->rtable);
3767 : ListCell *lc;
3768 :
3769 3906 : dpns->appendrels = (AppendRelInfo **)
3770 3906 : palloc0((ntables + 1) * sizeof(AppendRelInfo *));
3771 21668 : foreach(lc, pstmt->appendRelations)
3772 : {
3773 17762 : AppendRelInfo *appinfo = lfirst_node(AppendRelInfo, lc);
3774 17762 : Index crelid = appinfo->child_relid;
3775 :
3776 : Assert(crelid > 0 && crelid <= ntables);
3777 : Assert(dpns->appendrels[crelid] == NULL);
3778 17762 : dpns->appendrels[crelid] = appinfo;
3779 : }
3780 : }
3781 : else
3782 20322 : dpns->appendrels = NULL; /* don't need it */
3783 :
3784 : /*
3785 : * Set up column name aliases, ignoring any join RTEs; they don't matter
3786 : * because plan trees don't contain any join alias Vars.
3787 : */
3788 24228 : set_simple_column_names(dpns);
3789 :
3790 : /* Return a one-deep namespace stack */
3791 24228 : return list_make1(dpns);
3792 : }
3793 :
3794 : /*
3795 : * set_deparse_context_plan - Specify Plan node containing expression
3796 : *
3797 : * When deparsing an expression in a Plan tree, we might have to resolve
3798 : * OUTER_VAR, INNER_VAR, or INDEX_VAR references. To do this, the caller must
3799 : * provide the parent Plan node. Then OUTER_VAR and INNER_VAR references
3800 : * can be resolved by drilling down into the left and right child plans.
3801 : * Similarly, INDEX_VAR references can be resolved by reference to the
3802 : * indextlist given in a parent IndexOnlyScan node, or to the scan tlist in
3803 : * ForeignScan and CustomScan nodes. (Note that we don't currently support
3804 : * deparsing of indexquals in regular IndexScan or BitmapIndexScan nodes;
3805 : * for those, we can only deparse the indexqualorig fields, which won't
3806 : * contain INDEX_VAR Vars.)
3807 : *
3808 : * The ancestors list is a list of the Plan's parent Plan and SubPlan nodes,
3809 : * the most-closely-nested first. This is needed to resolve PARAM_EXEC
3810 : * Params. Note we assume that all the Plan nodes share the same rtable.
3811 : *
3812 : * For a ModifyTable plan, we might also need to resolve references to OLD/NEW
3813 : * variables in the RETURNING list, so we copy the alias names of the OLD and
3814 : * NEW rows from the ModifyTable plan node.
3815 : *
3816 : * Once this function has been called, deparse_expression() can be called on
3817 : * subsidiary expression(s) of the specified Plan node. To deparse
3818 : * expressions of a different Plan node in the same Plan tree, re-call this
3819 : * function to identify the new parent Plan node.
3820 : *
3821 : * The result is the same List passed in; this is a notational convenience.
3822 : */
3823 : List *
3824 57646 : set_deparse_context_plan(List *dpcontext, Plan *plan, List *ancestors)
3825 : {
3826 : deparse_namespace *dpns;
3827 :
3828 : /* Should always have one-entry namespace list for Plan deparsing */
3829 : Assert(list_length(dpcontext) == 1);
3830 57646 : dpns = (deparse_namespace *) linitial(dpcontext);
3831 :
3832 : /* Set our attention on the specific plan node passed in */
3833 57646 : dpns->ancestors = ancestors;
3834 57646 : set_deparse_plan(dpns, plan);
3835 :
3836 : /* For ModifyTable, set aliases for OLD and NEW in RETURNING */
3837 57646 : if (IsA(plan, ModifyTable))
3838 : {
3839 210 : dpns->ret_old_alias = ((ModifyTable *) plan)->returningOldAlias;
3840 210 : dpns->ret_new_alias = ((ModifyTable *) plan)->returningNewAlias;
3841 : }
3842 :
3843 57646 : return dpcontext;
3844 : }
3845 :
3846 : /*
3847 : * select_rtable_names_for_explain - Select RTE aliases for EXPLAIN
3848 : *
3849 : * Determine the relation aliases we'll use during an EXPLAIN operation.
3850 : * This is just a frontend to set_rtable_names. We have to expose the aliases
3851 : * to EXPLAIN because EXPLAIN needs to know the right alias names to print.
3852 : */
3853 : List *
3854 24228 : select_rtable_names_for_explain(List *rtable, Bitmapset *rels_used)
3855 : {
3856 : deparse_namespace dpns;
3857 :
3858 24228 : memset(&dpns, 0, sizeof(dpns));
3859 24228 : dpns.rtable = rtable;
3860 24228 : dpns.subplans = NIL;
3861 24228 : dpns.ctes = NIL;
3862 24228 : dpns.appendrels = NULL;
3863 24228 : set_rtable_names(&dpns, NIL, rels_used);
3864 : /* We needn't bother computing column aliases yet */
3865 :
3866 24228 : return dpns.rtable_names;
3867 : }
3868 :
3869 : /*
3870 : * set_rtable_names: select RTE aliases to be used in printing a query
3871 : *
3872 : * We fill in dpns->rtable_names with a list of names that is one-for-one with
3873 : * the already-filled dpns->rtable list. Each RTE name is unique among those
3874 : * in the new namespace plus any ancestor namespaces listed in
3875 : * parent_namespaces.
3876 : *
3877 : * If rels_used isn't NULL, only RTE indexes listed in it are given aliases.
3878 : *
3879 : * Note that this function is only concerned with relation names, not column
3880 : * names.
3881 : */
3882 : static void
3883 53776 : set_rtable_names(deparse_namespace *dpns, List *parent_namespaces,
3884 : Bitmapset *rels_used)
3885 : {
3886 : HASHCTL hash_ctl;
3887 : HTAB *names_hash;
3888 : NameHashEntry *hentry;
3889 : bool found;
3890 : int rtindex;
3891 : ListCell *lc;
3892 :
3893 53776 : dpns->rtable_names = NIL;
3894 : /* nothing more to do if empty rtable */
3895 53776 : if (dpns->rtable == NIL)
3896 566 : return;
3897 :
3898 : /*
3899 : * We use a hash table to hold known names, so that this process is O(N)
3900 : * not O(N^2) for N names.
3901 : */
3902 53210 : hash_ctl.keysize = NAMEDATALEN;
3903 53210 : hash_ctl.entrysize = sizeof(NameHashEntry);
3904 53210 : hash_ctl.hcxt = CurrentMemoryContext;
3905 53210 : names_hash = hash_create("set_rtable_names names",
3906 53210 : list_length(dpns->rtable),
3907 : &hash_ctl,
3908 : HASH_ELEM | HASH_STRINGS | HASH_CONTEXT);
3909 :
3910 : /* Preload the hash table with names appearing in parent_namespaces */
3911 54946 : foreach(lc, parent_namespaces)
3912 : {
3913 1736 : deparse_namespace *olddpns = (deparse_namespace *) lfirst(lc);
3914 : ListCell *lc2;
3915 :
3916 6298 : foreach(lc2, olddpns->rtable_names)
3917 : {
3918 4562 : char *oldname = (char *) lfirst(lc2);
3919 :
3920 4562 : if (oldname == NULL)
3921 336 : continue;
3922 4226 : hentry = (NameHashEntry *) hash_search(names_hash,
3923 : oldname,
3924 : HASH_ENTER,
3925 : &found);
3926 : /* we do not complain about duplicate names in parent namespaces */
3927 4226 : hentry->counter = 0;
3928 : }
3929 : }
3930 :
3931 : /* Now we can scan the rtable */
3932 53210 : rtindex = 1;
3933 154554 : foreach(lc, dpns->rtable)
3934 : {
3935 101344 : RangeTblEntry *rte = (RangeTblEntry *) lfirst(lc);
3936 : char *refname;
3937 :
3938 : /* Just in case this takes an unreasonable amount of time ... */
3939 101344 : CHECK_FOR_INTERRUPTS();
3940 :
3941 101344 : if (rels_used && !bms_is_member(rtindex, rels_used))
3942 : {
3943 : /* Ignore unreferenced RTE */
3944 17692 : refname = NULL;
3945 : }
3946 83652 : else if (rte->alias)
3947 : {
3948 : /* If RTE has a user-defined alias, prefer that */
3949 54464 : refname = rte->alias->aliasname;
3950 : }
3951 29188 : else if (rte->rtekind == RTE_RELATION)
3952 : {
3953 : /* Use the current actual name of the relation */
3954 22162 : refname = get_rel_name(rte->relid);
3955 : }
3956 7026 : else if (rte->rtekind == RTE_JOIN)
3957 : {
3958 : /* Unnamed join has no refname */
3959 1806 : refname = NULL;
3960 : }
3961 : else
3962 : {
3963 : /* Otherwise use whatever the parser assigned */
3964 5220 : refname = rte->eref->aliasname;
3965 : }
3966 :
3967 : /*
3968 : * If the selected name isn't unique, append digits to make it so, and
3969 : * make a new hash entry for it once we've got a unique name. For a
3970 : * very long input name, we might have to truncate to stay within
3971 : * NAMEDATALEN.
3972 : */
3973 101344 : if (refname)
3974 : {
3975 81846 : hentry = (NameHashEntry *) hash_search(names_hash,
3976 : refname,
3977 : HASH_ENTER,
3978 : &found);
3979 81846 : if (found)
3980 : {
3981 : /* Name already in use, must choose a new one */
3982 15204 : int refnamelen = strlen(refname);
3983 15204 : char *modname = (char *) palloc(refnamelen + 16);
3984 : NameHashEntry *hentry2;
3985 :
3986 : do
3987 : {
3988 15210 : hentry->counter++;
3989 : for (;;)
3990 : {
3991 15222 : memcpy(modname, refname, refnamelen);
3992 15222 : sprintf(modname + refnamelen, "_%d", hentry->counter);
3993 15222 : if (strlen(modname) < NAMEDATALEN)
3994 15210 : break;
3995 : /* drop chars from refname to keep all the digits */
3996 12 : refnamelen = pg_mbcliplen(refname, refnamelen,
3997 : refnamelen - 1);
3998 : }
3999 15210 : hentry2 = (NameHashEntry *) hash_search(names_hash,
4000 : modname,
4001 : HASH_ENTER,
4002 : &found);
4003 15210 : } while (found);
4004 15204 : hentry2->counter = 0; /* init new hash entry */
4005 15204 : refname = modname;
4006 : }
4007 : else
4008 : {
4009 : /* Name not previously used, need only initialize hentry */
4010 66642 : hentry->counter = 0;
4011 : }
4012 : }
4013 :
4014 101344 : dpns->rtable_names = lappend(dpns->rtable_names, refname);
4015 101344 : rtindex++;
4016 : }
4017 :
4018 53210 : hash_destroy(names_hash);
4019 : }
4020 :
4021 : /*
4022 : * set_deparse_for_query: set up deparse_namespace for deparsing a Query tree
4023 : *
4024 : * For convenience, this is defined to initialize the deparse_namespace struct
4025 : * from scratch.
4026 : */
4027 : static void
4028 5856 : set_deparse_for_query(deparse_namespace *dpns, Query *query,
4029 : List *parent_namespaces)
4030 : {
4031 : ListCell *lc;
4032 : ListCell *lc2;
4033 :
4034 : /* Initialize *dpns and fill rtable/ctes links */
4035 5856 : memset(dpns, 0, sizeof(deparse_namespace));
4036 5856 : dpns->rtable = query->rtable;
4037 5856 : dpns->subplans = NIL;
4038 5856 : dpns->ctes = query->cteList;
4039 5856 : dpns->appendrels = NULL;
4040 5856 : dpns->ret_old_alias = query->returningOldAlias;
4041 5856 : dpns->ret_new_alias = query->returningNewAlias;
4042 :
4043 : /* Assign a unique relation alias to each RTE */
4044 5856 : set_rtable_names(dpns, parent_namespaces, NULL);
4045 :
4046 : /* Initialize dpns->rtable_columns to contain zeroed structs */
4047 5856 : dpns->rtable_columns = NIL;
4048 16436 : while (list_length(dpns->rtable_columns) < list_length(dpns->rtable))
4049 10580 : dpns->rtable_columns = lappend(dpns->rtable_columns,
4050 : palloc0(sizeof(deparse_columns)));
4051 :
4052 : /* If it's a utility query, it won't have a jointree */
4053 5856 : if (query->jointree)
4054 : {
4055 : /* Detect whether global uniqueness of USING names is needed */
4056 5840 : dpns->unique_using =
4057 5840 : has_dangerous_join_using(dpns, (Node *) query->jointree);
4058 :
4059 : /*
4060 : * Select names for columns merged by USING, via a recursive pass over
4061 : * the query jointree.
4062 : */
4063 5840 : set_using_names(dpns, (Node *) query->jointree, NIL);
4064 : }
4065 :
4066 : /*
4067 : * Now assign remaining column aliases for each RTE. We do this in a
4068 : * linear scan of the rtable, so as to process RTEs whether or not they
4069 : * are in the jointree (we mustn't miss NEW.*, INSERT target relations,
4070 : * etc). JOIN RTEs must be processed after their children, but this is
4071 : * okay because they appear later in the rtable list than their children
4072 : * (cf Asserts in identify_join_columns()).
4073 : */
4074 16436 : forboth(lc, dpns->rtable, lc2, dpns->rtable_columns)
4075 : {
4076 10580 : RangeTblEntry *rte = (RangeTblEntry *) lfirst(lc);
4077 10580 : deparse_columns *colinfo = (deparse_columns *) lfirst(lc2);
4078 :
4079 10580 : if (rte->rtekind == RTE_JOIN)
4080 1522 : set_join_column_names(dpns, rte, colinfo);
4081 : else
4082 9058 : set_relation_column_names(dpns, rte, colinfo);
4083 : }
4084 5856 : }
4085 :
4086 : /*
4087 : * set_simple_column_names: fill in column aliases for non-query situations
4088 : *
4089 : * This handles EXPLAIN and cases where we only have relation RTEs. Without
4090 : * a join tree, we can't do anything smart about join RTEs, but we don't
4091 : * need to, because EXPLAIN should never see join alias Vars anyway.
4092 : * If we find a join RTE we'll just skip it, leaving its deparse_columns
4093 : * struct all-zero. If somehow we try to deparse a join alias Var, we'll
4094 : * error out cleanly because the struct's num_cols will be zero.
4095 : */
4096 : static void
4097 47920 : set_simple_column_names(deparse_namespace *dpns)
4098 : {
4099 : ListCell *lc;
4100 : ListCell *lc2;
4101 :
4102 : /* Initialize dpns->rtable_columns to contain zeroed structs */
4103 47920 : dpns->rtable_columns = NIL;
4104 138684 : while (list_length(dpns->rtable_columns) < list_length(dpns->rtable))
4105 90764 : dpns->rtable_columns = lappend(dpns->rtable_columns,
4106 : palloc0(sizeof(deparse_columns)));
4107 :
4108 : /* Assign unique column aliases within each non-join RTE */
4109 138684 : forboth(lc, dpns->rtable, lc2, dpns->rtable_columns)
4110 : {
4111 90764 : RangeTblEntry *rte = (RangeTblEntry *) lfirst(lc);
4112 90764 : deparse_columns *colinfo = (deparse_columns *) lfirst(lc2);
4113 :
4114 90764 : if (rte->rtekind != RTE_JOIN)
4115 84828 : set_relation_column_names(dpns, rte, colinfo);
4116 : }
4117 47920 : }
4118 :
4119 : /*
4120 : * has_dangerous_join_using: search jointree for unnamed JOIN USING
4121 : *
4122 : * Merged columns of a JOIN USING may act differently from either of the input
4123 : * columns, either because they are merged with COALESCE (in a FULL JOIN) or
4124 : * because an implicit coercion of the underlying input column is required.
4125 : * In such a case the column must be referenced as a column of the JOIN not as
4126 : * a column of either input. And this is problematic if the join is unnamed
4127 : * (alias-less): we cannot qualify the column's name with an RTE name, since
4128 : * there is none. (Forcibly assigning an alias to the join is not a solution,
4129 : * since that will prevent legal references to tables below the join.)
4130 : * To ensure that every column in the query is unambiguously referenceable,
4131 : * we must assign such merged columns names that are globally unique across
4132 : * the whole query, aliasing other columns out of the way as necessary.
4133 : *
4134 : * Because the ensuing re-aliasing is fairly damaging to the readability of
4135 : * the query, we don't do this unless we have to. So, we must pre-scan
4136 : * the join tree to see if we have to, before starting set_using_names().
4137 : */
4138 : static bool
4139 13892 : has_dangerous_join_using(deparse_namespace *dpns, Node *jtnode)
4140 : {
4141 13892 : if (IsA(jtnode, RangeTblRef))
4142 : {
4143 : /* nothing to do here */
4144 : }
4145 7296 : else if (IsA(jtnode, FromExpr))
4146 : {
4147 5840 : FromExpr *f = (FromExpr *) jtnode;
4148 : ListCell *lc;
4149 :
4150 11052 : foreach(lc, f->fromlist)
4151 : {
4152 5284 : if (has_dangerous_join_using(dpns, (Node *) lfirst(lc)))
4153 72 : return true;
4154 : }
4155 : }
4156 1456 : else if (IsA(jtnode, JoinExpr))
4157 : {
4158 1456 : JoinExpr *j = (JoinExpr *) jtnode;
4159 :
4160 : /* Is it an unnamed JOIN with USING? */
4161 1456 : if (j->alias == NULL && j->usingClause)
4162 : {
4163 : /*
4164 : * Yes, so check each join alias var to see if any of them are not
4165 : * simple references to underlying columns. If so, we have a
4166 : * dangerous situation and must pick unique aliases.
4167 : */
4168 286 : RangeTblEntry *jrte = rt_fetch(j->rtindex, dpns->rtable);
4169 :
4170 : /* We need only examine the merged columns */
4171 596 : for (int i = 0; i < jrte->joinmergedcols; i++)
4172 : {
4173 382 : Node *aliasvar = list_nth(jrte->joinaliasvars, i);
4174 :
4175 382 : if (!IsA(aliasvar, Var))
4176 72 : return true;
4177 : }
4178 : }
4179 :
4180 : /* Nope, but inspect children */
4181 1384 : if (has_dangerous_join_using(dpns, j->larg))
4182 0 : return true;
4183 1384 : if (has_dangerous_join_using(dpns, j->rarg))
4184 0 : return true;
4185 : }
4186 : else
4187 0 : elog(ERROR, "unrecognized node type: %d",
4188 : (int) nodeTag(jtnode));
4189 13748 : return false;
4190 : }
4191 :
4192 : /*
4193 : * set_using_names: select column aliases to be used for merged USING columns
4194 : *
4195 : * We do this during a recursive descent of the query jointree.
4196 : * dpns->unique_using must already be set to determine the global strategy.
4197 : *
4198 : * Column alias info is saved in the dpns->rtable_columns list, which is
4199 : * assumed to be filled with pre-zeroed deparse_columns structs.
4200 : *
4201 : * parentUsing is a list of all USING aliases assigned in parent joins of
4202 : * the current jointree node. (The passed-in list must not be modified.)
4203 : *
4204 : * Note that we do not use per-deparse_columns hash tables in this function.
4205 : * The number of names that need to be assigned should be small enough that
4206 : * we don't need to trouble with that.
4207 : */
4208 : static void
4209 14210 : set_using_names(deparse_namespace *dpns, Node *jtnode, List *parentUsing)
4210 : {
4211 14210 : if (IsA(jtnode, RangeTblRef))
4212 : {
4213 : /* nothing to do now */
4214 : }
4215 7362 : else if (IsA(jtnode, FromExpr))
4216 : {
4217 5840 : FromExpr *f = (FromExpr *) jtnode;
4218 : ListCell *lc;
4219 :
4220 11166 : foreach(lc, f->fromlist)
4221 5326 : set_using_names(dpns, (Node *) lfirst(lc), parentUsing);
4222 : }
4223 1522 : else if (IsA(jtnode, JoinExpr))
4224 : {
4225 1522 : JoinExpr *j = (JoinExpr *) jtnode;
4226 1522 : RangeTblEntry *rte = rt_fetch(j->rtindex, dpns->rtable);
4227 1522 : deparse_columns *colinfo = deparse_columns_fetch(j->rtindex, dpns);
4228 : int *leftattnos;
4229 : int *rightattnos;
4230 : deparse_columns *leftcolinfo;
4231 : deparse_columns *rightcolinfo;
4232 : int i;
4233 : ListCell *lc;
4234 :
4235 : /* Get info about the shape of the join */
4236 1522 : identify_join_columns(j, rte, colinfo);
4237 1522 : leftattnos = colinfo->leftattnos;
4238 1522 : rightattnos = colinfo->rightattnos;
4239 :
4240 : /* Look up the not-yet-filled-in child deparse_columns structs */
4241 1522 : leftcolinfo = deparse_columns_fetch(colinfo->leftrti, dpns);
4242 1522 : rightcolinfo = deparse_columns_fetch(colinfo->rightrti, dpns);
4243 :
4244 : /*
4245 : * If this join is unnamed, then we cannot substitute new aliases at
4246 : * this level, so any name requirements pushed down to here must be
4247 : * pushed down again to the children.
4248 : */
4249 1522 : if (rte->alias == NULL)
4250 : {
4251 1552 : for (i = 0; i < colinfo->num_cols; i++)
4252 : {
4253 138 : char *colname = colinfo->colnames[i];
4254 :
4255 138 : if (colname == NULL)
4256 24 : continue;
4257 :
4258 : /* Push down to left column, unless it's a system column */
4259 114 : if (leftattnos[i] > 0)
4260 : {
4261 102 : expand_colnames_array_to(leftcolinfo, leftattnos[i]);
4262 102 : leftcolinfo->colnames[leftattnos[i] - 1] = colname;
4263 : }
4264 :
4265 : /* Same on the righthand side */
4266 114 : if (rightattnos[i] > 0)
4267 : {
4268 114 : expand_colnames_array_to(rightcolinfo, rightattnos[i]);
4269 114 : rightcolinfo->colnames[rightattnos[i] - 1] = colname;
4270 : }
4271 : }
4272 : }
4273 :
4274 : /*
4275 : * If there's a USING clause, select the USING column names and push
4276 : * those names down to the children. We have two strategies:
4277 : *
4278 : * If dpns->unique_using is true, we force all USING names to be
4279 : * unique across the whole query level. In principle we'd only need
4280 : * the names of dangerous USING columns to be globally unique, but to
4281 : * safely assign all USING names in a single pass, we have to enforce
4282 : * the same uniqueness rule for all of them. However, if a USING
4283 : * column's name has been pushed down from the parent, we should use
4284 : * it as-is rather than making a uniqueness adjustment. This is
4285 : * necessary when we're at an unnamed join, and it creates no risk of
4286 : * ambiguity. Also, if there's a user-written output alias for a
4287 : * merged column, we prefer to use that rather than the input name;
4288 : * this simplifies the logic and seems likely to lead to less aliasing
4289 : * overall.
4290 : *
4291 : * If dpns->unique_using is false, we only need USING names to be
4292 : * unique within their own join RTE. We still need to honor
4293 : * pushed-down names, though.
4294 : *
4295 : * Though significantly different in results, these two strategies are
4296 : * implemented by the same code, with only the difference of whether
4297 : * to put assigned names into dpns->using_names.
4298 : */
4299 1522 : if (j->usingClause)
4300 : {
4301 : /* Copy the input parentUsing list so we don't modify it */
4302 424 : parentUsing = list_copy(parentUsing);
4303 :
4304 : /* USING names must correspond to the first join output columns */
4305 424 : expand_colnames_array_to(colinfo, list_length(j->usingClause));
4306 424 : i = 0;
4307 1004 : foreach(lc, j->usingClause)
4308 : {
4309 580 : char *colname = strVal(lfirst(lc));
4310 :
4311 : /* Assert it's a merged column */
4312 : Assert(leftattnos[i] != 0 && rightattnos[i] != 0);
4313 :
4314 : /* Adopt passed-down name if any, else select unique name */
4315 580 : if (colinfo->colnames[i] != NULL)
4316 102 : colname = colinfo->colnames[i];
4317 : else
4318 : {
4319 : /* Prefer user-written output alias if any */
4320 478 : if (rte->alias && i < list_length(rte->alias->colnames))
4321 0 : colname = strVal(list_nth(rte->alias->colnames, i));
4322 : /* Make it appropriately unique */
4323 478 : colname = make_colname_unique(colname, dpns, colinfo);
4324 478 : if (dpns->unique_using)
4325 126 : dpns->using_names = lappend(dpns->using_names,
4326 : colname);
4327 : /* Save it as output column name, too */
4328 478 : colinfo->colnames[i] = colname;
4329 : }
4330 :
4331 : /* Remember selected names for use later */
4332 580 : colinfo->usingNames = lappend(colinfo->usingNames, colname);
4333 580 : parentUsing = lappend(parentUsing, colname);
4334 :
4335 : /* Push down to left column, unless it's a system column */
4336 580 : if (leftattnos[i] > 0)
4337 : {
4338 580 : expand_colnames_array_to(leftcolinfo, leftattnos[i]);
4339 580 : leftcolinfo->colnames[leftattnos[i] - 1] = colname;
4340 : }
4341 :
4342 : /* Same on the righthand side */
4343 580 : if (rightattnos[i] > 0)
4344 : {
4345 580 : expand_colnames_array_to(rightcolinfo, rightattnos[i]);
4346 580 : rightcolinfo->colnames[rightattnos[i] - 1] = colname;
4347 : }
4348 :
4349 580 : i++;
4350 : }
4351 : }
4352 :
4353 : /* Mark child deparse_columns structs with correct parentUsing info */
4354 1522 : leftcolinfo->parentUsing = parentUsing;
4355 1522 : rightcolinfo->parentUsing = parentUsing;
4356 :
4357 : /* Now recursively assign USING column names in children */
4358 1522 : set_using_names(dpns, j->larg, parentUsing);
4359 1522 : set_using_names(dpns, j->rarg, parentUsing);
4360 : }
4361 : else
4362 0 : elog(ERROR, "unrecognized node type: %d",
4363 : (int) nodeTag(jtnode));
4364 14210 : }
4365 :
4366 : /*
4367 : * set_relation_column_names: select column aliases for a non-join RTE
4368 : *
4369 : * Column alias info is saved in *colinfo, which is assumed to be pre-zeroed.
4370 : * If any colnames entries are already filled in, those override local
4371 : * choices.
4372 : */
4373 : static void
4374 93886 : set_relation_column_names(deparse_namespace *dpns, RangeTblEntry *rte,
4375 : deparse_columns *colinfo)
4376 : {
4377 : int ncolumns;
4378 : char **real_colnames;
4379 : bool changed_any;
4380 : int noldcolumns;
4381 : int i;
4382 : int j;
4383 :
4384 : /*
4385 : * Construct an array of the current "real" column names of the RTE.
4386 : * real_colnames[] will be indexed by physical column number, with NULL
4387 : * entries for dropped columns.
4388 : */
4389 93886 : if (rte->rtekind == RTE_RELATION)
4390 : {
4391 : /* Relation --- look to the system catalogs for up-to-date info */
4392 : Relation rel;
4393 : TupleDesc tupdesc;
4394 :
4395 79738 : rel = relation_open(rte->relid, AccessShareLock);
4396 79738 : tupdesc = RelationGetDescr(rel);
4397 :
4398 79738 : ncolumns = tupdesc->natts;
4399 79738 : real_colnames = (char **) palloc(ncolumns * sizeof(char *));
4400 :
4401 507888 : for (i = 0; i < ncolumns; i++)
4402 : {
4403 428150 : Form_pg_attribute attr = TupleDescAttr(tupdesc, i);
4404 :
4405 428150 : if (attr->attisdropped)
4406 3184 : real_colnames[i] = NULL;
4407 : else
4408 424966 : real_colnames[i] = pstrdup(NameStr(attr->attname));
4409 : }
4410 79738 : relation_close(rel, AccessShareLock);
4411 : }
4412 : else
4413 : {
4414 : /* Otherwise get the column names from eref or expandRTE() */
4415 : List *colnames;
4416 : ListCell *lc;
4417 :
4418 : /*
4419 : * Functions returning composites have the annoying property that some
4420 : * of the composite type's columns might have been dropped since the
4421 : * query was parsed. If possible, use expandRTE() to handle that
4422 : * case, since it has the tedious logic needed to find out about
4423 : * dropped columns. However, if we're explaining a plan, then we
4424 : * don't have rte->functions because the planner thinks that won't be
4425 : * needed later, and that breaks expandRTE(). So in that case we have
4426 : * to rely on rte->eref, which may lead us to report a dropped
4427 : * column's old name; that seems close enough for EXPLAIN's purposes.
4428 : *
4429 : * For non-RELATION, non-FUNCTION RTEs, we can just look at rte->eref,
4430 : * which should be sufficiently up-to-date: no other RTE types can
4431 : * have columns get dropped from under them after parsing.
4432 : */
4433 14148 : if (rte->rtekind == RTE_FUNCTION && rte->functions != NIL)
4434 : {
4435 : /* Since we're not creating Vars, rtindex etc. don't matter */
4436 858 : expandRTE(rte, 1, 0, VAR_RETURNING_DEFAULT, -1,
4437 : true /* include dropped */ , &colnames, NULL);
4438 : }
4439 : else
4440 13290 : colnames = rte->eref->colnames;
4441 :
4442 14148 : ncolumns = list_length(colnames);
4443 14148 : real_colnames = (char **) palloc(ncolumns * sizeof(char *));
4444 :
4445 14148 : i = 0;
4446 46426 : foreach(lc, colnames)
4447 : {
4448 : /*
4449 : * If the column name we find here is an empty string, then it's a
4450 : * dropped column, so change to NULL.
4451 : */
4452 32278 : char *cname = strVal(lfirst(lc));
4453 :
4454 32278 : if (cname[0] == '\0')
4455 54 : cname = NULL;
4456 32278 : real_colnames[i] = cname;
4457 32278 : i++;
4458 : }
4459 : }
4460 :
4461 : /*
4462 : * Ensure colinfo->colnames has a slot for each column. (It could be long
4463 : * enough already, if we pushed down a name for the last column.) Note:
4464 : * it's possible that there are now more columns than there were when the
4465 : * query was parsed, ie colnames could be longer than rte->eref->colnames.
4466 : * We must assign unique aliases to the new columns too, else there could
4467 : * be unresolved conflicts when the view/rule is reloaded.
4468 : */
4469 93886 : expand_colnames_array_to(colinfo, ncolumns);
4470 : Assert(colinfo->num_cols == ncolumns);
4471 :
4472 : /*
4473 : * Make sufficiently large new_colnames and is_new_col arrays, too.
4474 : *
4475 : * Note: because we leave colinfo->num_new_cols zero until after the loop,
4476 : * colname_is_unique will not consult that array, which is fine because it
4477 : * would only be duplicate effort.
4478 : */
4479 93886 : colinfo->new_colnames = (char **) palloc(ncolumns * sizeof(char *));
4480 93886 : colinfo->is_new_col = (bool *) palloc(ncolumns * sizeof(bool));
4481 :
4482 : /* If the RTE is wide enough, use a hash table to avoid O(N^2) costs */
4483 93886 : build_colinfo_names_hash(colinfo);
4484 :
4485 : /*
4486 : * Scan the columns, select a unique alias for each one, and store it in
4487 : * colinfo->colnames and colinfo->new_colnames. The former array has NULL
4488 : * entries for dropped columns, the latter omits them. Also mark
4489 : * new_colnames entries as to whether they are new since parse time; this
4490 : * is the case for entries beyond the length of rte->eref->colnames.
4491 : */
4492 93886 : noldcolumns = list_length(rte->eref->colnames);
4493 93886 : changed_any = false;
4494 93886 : j = 0;
4495 554314 : for (i = 0; i < ncolumns; i++)
4496 : {
4497 460428 : char *real_colname = real_colnames[i];
4498 460428 : char *colname = colinfo->colnames[i];
4499 :
4500 : /* Skip dropped columns */
4501 460428 : if (real_colname == NULL)
4502 : {
4503 : Assert(colname == NULL); /* colnames[i] is already NULL */
4504 3238 : continue;
4505 : }
4506 :
4507 : /* If alias already assigned, that's what to use */
4508 457190 : if (colname == NULL)
4509 : {
4510 : /* If user wrote an alias, prefer that over real column name */
4511 456132 : if (rte->alias && i < list_length(rte->alias->colnames))
4512 44422 : colname = strVal(list_nth(rte->alias->colnames, i));
4513 : else
4514 411710 : colname = real_colname;
4515 :
4516 : /* Unique-ify and insert into colinfo */
4517 456132 : colname = make_colname_unique(colname, dpns, colinfo);
4518 :
4519 456132 : colinfo->colnames[i] = colname;
4520 456132 : add_to_names_hash(colinfo, colname);
4521 : }
4522 :
4523 : /* Put names of non-dropped columns in new_colnames[] too */
4524 457190 : colinfo->new_colnames[j] = colname;
4525 : /* And mark them as new or not */
4526 457190 : colinfo->is_new_col[j] = (i >= noldcolumns);
4527 457190 : j++;
4528 :
4529 : /* Remember if any assigned aliases differ from "real" name */
4530 457190 : if (!changed_any && strcmp(colname, real_colname) != 0)
4531 1198 : changed_any = true;
4532 : }
4533 :
4534 : /* We're now done needing the colinfo's names_hash */
4535 93886 : destroy_colinfo_names_hash(colinfo);
4536 :
4537 : /*
4538 : * Set correct length for new_colnames[] array. (Note: if columns have
4539 : * been added, colinfo->num_cols includes them, which is not really quite
4540 : * right but is harmless, since any new columns must be at the end where
4541 : * they won't affect varattnos of pre-existing columns.)
4542 : */
4543 93886 : colinfo->num_new_cols = j;
4544 :
4545 : /*
4546 : * For a relation RTE, we need only print the alias column names if any
4547 : * are different from the underlying "real" names. For a function RTE,
4548 : * always emit a complete column alias list; this is to protect against
4549 : * possible instability of the default column names (eg, from altering
4550 : * parameter names). For tablefunc RTEs, we never print aliases, because
4551 : * the column names are part of the clause itself. For other RTE types,
4552 : * print if we changed anything OR if there were user-written column
4553 : * aliases (since the latter would be part of the underlying "reality").
4554 : */
4555 93886 : if (rte->rtekind == RTE_RELATION)
4556 79738 : colinfo->printaliases = changed_any;
4557 14148 : else if (rte->rtekind == RTE_FUNCTION)
4558 1434 : colinfo->printaliases = true;
4559 12714 : else if (rte->rtekind == RTE_TABLEFUNC)
4560 176 : colinfo->printaliases = false;
4561 12538 : else if (rte->alias && rte->alias->colnames != NIL)
4562 732 : colinfo->printaliases = true;
4563 : else
4564 11806 : colinfo->printaliases = changed_any;
4565 93886 : }
4566 :
4567 : /*
4568 : * set_join_column_names: select column aliases for a join RTE
4569 : *
4570 : * Column alias info is saved in *colinfo, which is assumed to be pre-zeroed.
4571 : * If any colnames entries are already filled in, those override local
4572 : * choices. Also, names for USING columns were already chosen by
4573 : * set_using_names(). We further expect that column alias selection has been
4574 : * completed for both input RTEs.
4575 : */
4576 : static void
4577 1522 : set_join_column_names(deparse_namespace *dpns, RangeTblEntry *rte,
4578 : deparse_columns *colinfo)
4579 : {
4580 : deparse_columns *leftcolinfo;
4581 : deparse_columns *rightcolinfo;
4582 : bool changed_any;
4583 : int noldcolumns;
4584 : int nnewcolumns;
4585 1522 : Bitmapset *leftmerged = NULL;
4586 1522 : Bitmapset *rightmerged = NULL;
4587 : int i;
4588 : int j;
4589 : int ic;
4590 : int jc;
4591 :
4592 : /* Look up the previously-filled-in child deparse_columns structs */
4593 1522 : leftcolinfo = deparse_columns_fetch(colinfo->leftrti, dpns);
4594 1522 : rightcolinfo = deparse_columns_fetch(colinfo->rightrti, dpns);
4595 :
4596 : /*
4597 : * Ensure colinfo->colnames has a slot for each column. (It could be long
4598 : * enough already, if we pushed down a name for the last column.) Note:
4599 : * it's possible that one or both inputs now have more columns than there
4600 : * were when the query was parsed, but we'll deal with that below. We
4601 : * only need entries in colnames for pre-existing columns.
4602 : */
4603 1522 : noldcolumns = list_length(rte->eref->colnames);
4604 1522 : expand_colnames_array_to(colinfo, noldcolumns);
4605 : Assert(colinfo->num_cols == noldcolumns);
4606 :
4607 : /* If the RTE is wide enough, use a hash table to avoid O(N^2) costs */
4608 1522 : build_colinfo_names_hash(colinfo);
4609 :
4610 : /*
4611 : * Scan the join output columns, select an alias for each one, and store
4612 : * it in colinfo->colnames. If there are USING columns, set_using_names()
4613 : * already selected their names, so we can start the loop at the first
4614 : * non-merged column.
4615 : */
4616 1522 : changed_any = false;
4617 51274 : for (i = list_length(colinfo->usingNames); i < noldcolumns; i++)
4618 : {
4619 49752 : char *colname = colinfo->colnames[i];
4620 : char *real_colname;
4621 :
4622 : /* Join column must refer to at least one input column */
4623 : Assert(colinfo->leftattnos[i] != 0 || colinfo->rightattnos[i] != 0);
4624 :
4625 : /* Get the child column name */
4626 49752 : if (colinfo->leftattnos[i] > 0)
4627 35176 : real_colname = leftcolinfo->colnames[colinfo->leftattnos[i] - 1];
4628 14576 : else if (colinfo->rightattnos[i] > 0)
4629 14576 : real_colname = rightcolinfo->colnames[colinfo->rightattnos[i] - 1];
4630 : else
4631 : {
4632 : /* We're joining system columns --- use eref name */
4633 0 : real_colname = strVal(list_nth(rte->eref->colnames, i));
4634 : }
4635 :
4636 : /* If child col has been dropped, no need to assign a join colname */
4637 49752 : if (real_colname == NULL)
4638 : {
4639 6 : colinfo->colnames[i] = NULL;
4640 6 : continue;
4641 : }
4642 :
4643 : /* In an unnamed join, just report child column names as-is */
4644 49746 : if (rte->alias == NULL)
4645 : {
4646 49368 : colinfo->colnames[i] = real_colname;
4647 49368 : add_to_names_hash(colinfo, real_colname);
4648 49368 : continue;
4649 : }
4650 :
4651 : /* If alias already assigned, that's what to use */
4652 378 : if (colname == NULL)
4653 : {
4654 : /* If user wrote an alias, prefer that over real column name */
4655 378 : if (rte->alias && i < list_length(rte->alias->colnames))
4656 96 : colname = strVal(list_nth(rte->alias->colnames, i));
4657 : else
4658 282 : colname = real_colname;
4659 :
4660 : /* Unique-ify and insert into colinfo */
4661 378 : colname = make_colname_unique(colname, dpns, colinfo);
4662 :
4663 378 : colinfo->colnames[i] = colname;
4664 378 : add_to_names_hash(colinfo, colname);
4665 : }
4666 :
4667 : /* Remember if any assigned aliases differ from "real" name */
4668 378 : if (!changed_any && strcmp(colname, real_colname) != 0)
4669 24 : changed_any = true;
4670 : }
4671 :
4672 : /*
4673 : * Calculate number of columns the join would have if it were re-parsed
4674 : * now, and create storage for the new_colnames and is_new_col arrays.
4675 : *
4676 : * Note: colname_is_unique will be consulting new_colnames[] during the
4677 : * loops below, so its not-yet-filled entries must be zeroes.
4678 : */
4679 3044 : nnewcolumns = leftcolinfo->num_new_cols + rightcolinfo->num_new_cols -
4680 1522 : list_length(colinfo->usingNames);
4681 1522 : colinfo->num_new_cols = nnewcolumns;
4682 1522 : colinfo->new_colnames = (char **) palloc0(nnewcolumns * sizeof(char *));
4683 1522 : colinfo->is_new_col = (bool *) palloc0(nnewcolumns * sizeof(bool));
4684 :
4685 : /*
4686 : * Generating the new_colnames array is a bit tricky since any new columns
4687 : * added since parse time must be inserted in the right places. This code
4688 : * must match the parser, which will order a join's columns as merged
4689 : * columns first (in USING-clause order), then non-merged columns from the
4690 : * left input (in attnum order), then non-merged columns from the right
4691 : * input (ditto). If one of the inputs is itself a join, its columns will
4692 : * be ordered according to the same rule, which means newly-added columns
4693 : * might not be at the end. We can figure out what's what by consulting
4694 : * the leftattnos and rightattnos arrays plus the input is_new_col arrays.
4695 : *
4696 : * In these loops, i indexes leftattnos/rightattnos (so it's join varattno
4697 : * less one), j indexes new_colnames/is_new_col, and ic/jc have similar
4698 : * meanings for the current child RTE.
4699 : */
4700 :
4701 : /* Handle merged columns; they are first and can't be new */
4702 1522 : i = j = 0;
4703 1522 : while (i < noldcolumns &&
4704 2102 : colinfo->leftattnos[i] != 0 &&
4705 2102 : colinfo->rightattnos[i] != 0)
4706 : {
4707 : /* column name is already determined and known unique */
4708 580 : colinfo->new_colnames[j] = colinfo->colnames[i];
4709 580 : colinfo->is_new_col[j] = false;
4710 :
4711 : /* build bitmapsets of child attnums of merged columns */
4712 580 : if (colinfo->leftattnos[i] > 0)
4713 580 : leftmerged = bms_add_member(leftmerged, colinfo->leftattnos[i]);
4714 580 : if (colinfo->rightattnos[i] > 0)
4715 580 : rightmerged = bms_add_member(rightmerged, colinfo->rightattnos[i]);
4716 :
4717 580 : i++, j++;
4718 : }
4719 :
4720 : /* Handle non-merged left-child columns */
4721 1522 : ic = 0;
4722 37764 : for (jc = 0; jc < leftcolinfo->num_new_cols; jc++)
4723 : {
4724 36242 : char *child_colname = leftcolinfo->new_colnames[jc];
4725 :
4726 36242 : if (!leftcolinfo->is_new_col[jc])
4727 : {
4728 : /* Advance ic to next non-dropped old column of left child */
4729 35834 : while (ic < leftcolinfo->num_cols &&
4730 35834 : leftcolinfo->colnames[ic] == NULL)
4731 84 : ic++;
4732 : Assert(ic < leftcolinfo->num_cols);
4733 35750 : ic++;
4734 : /* If it is a merged column, we already processed it */
4735 35750 : if (bms_is_member(ic, leftmerged))
4736 580 : continue;
4737 : /* Else, advance i to the corresponding existing join column */
4738 35176 : while (i < colinfo->num_cols &&
4739 35176 : colinfo->colnames[i] == NULL)
4740 6 : i++;
4741 : Assert(i < colinfo->num_cols);
4742 : Assert(ic == colinfo->leftattnos[i]);
4743 : /* Use the already-assigned name of this column */
4744 35170 : colinfo->new_colnames[j] = colinfo->colnames[i];
4745 35170 : i++;
4746 : }
4747 : else
4748 : {
4749 : /*
4750 : * Unique-ify the new child column name and assign, unless we're
4751 : * in an unnamed join, in which case just copy
4752 : */
4753 492 : if (rte->alias != NULL)
4754 : {
4755 264 : colinfo->new_colnames[j] =
4756 132 : make_colname_unique(child_colname, dpns, colinfo);
4757 132 : if (!changed_any &&
4758 108 : strcmp(colinfo->new_colnames[j], child_colname) != 0)
4759 12 : changed_any = true;
4760 : }
4761 : else
4762 360 : colinfo->new_colnames[j] = child_colname;
4763 492 : add_to_names_hash(colinfo, colinfo->new_colnames[j]);
4764 : }
4765 :
4766 35662 : colinfo->is_new_col[j] = leftcolinfo->is_new_col[jc];
4767 35662 : j++;
4768 : }
4769 :
4770 : /* Handle non-merged right-child columns in exactly the same way */
4771 1522 : ic = 0;
4772 16846 : for (jc = 0; jc < rightcolinfo->num_new_cols; jc++)
4773 : {
4774 15324 : char *child_colname = rightcolinfo->new_colnames[jc];
4775 :
4776 15324 : if (!rightcolinfo->is_new_col[jc])
4777 : {
4778 : /* Advance ic to next non-dropped old column of right child */
4779 15156 : while (ic < rightcolinfo->num_cols &&
4780 15156 : rightcolinfo->colnames[ic] == NULL)
4781 0 : ic++;
4782 : Assert(ic < rightcolinfo->num_cols);
4783 15156 : ic++;
4784 : /* If it is a merged column, we already processed it */
4785 15156 : if (bms_is_member(ic, rightmerged))
4786 580 : continue;
4787 : /* Else, advance i to the corresponding existing join column */
4788 14576 : while (i < colinfo->num_cols &&
4789 14576 : colinfo->colnames[i] == NULL)
4790 0 : i++;
4791 : Assert(i < colinfo->num_cols);
4792 : Assert(ic == colinfo->rightattnos[i]);
4793 : /* Use the already-assigned name of this column */
4794 14576 : colinfo->new_colnames[j] = colinfo->colnames[i];
4795 14576 : i++;
4796 : }
4797 : else
4798 : {
4799 : /*
4800 : * Unique-ify the new child column name and assign, unless we're
4801 : * in an unnamed join, in which case just copy
4802 : */
4803 168 : if (rte->alias != NULL)
4804 : {
4805 48 : colinfo->new_colnames[j] =
4806 24 : make_colname_unique(child_colname, dpns, colinfo);
4807 24 : if (!changed_any &&
4808 24 : strcmp(colinfo->new_colnames[j], child_colname) != 0)
4809 12 : changed_any = true;
4810 : }
4811 : else
4812 144 : colinfo->new_colnames[j] = child_colname;
4813 168 : add_to_names_hash(colinfo, colinfo->new_colnames[j]);
4814 : }
4815 :
4816 14744 : colinfo->is_new_col[j] = rightcolinfo->is_new_col[jc];
4817 14744 : j++;
4818 : }
4819 :
4820 : /* Assert we processed the right number of columns */
4821 : #ifdef USE_ASSERT_CHECKING
4822 : while (i < colinfo->num_cols && colinfo->colnames[i] == NULL)
4823 : i++;
4824 : Assert(i == colinfo->num_cols);
4825 : Assert(j == nnewcolumns);
4826 : #endif
4827 :
4828 : /* We're now done needing the colinfo's names_hash */
4829 1522 : destroy_colinfo_names_hash(colinfo);
4830 :
4831 : /*
4832 : * For a named join, print column aliases if we changed any from the child
4833 : * names. Unnamed joins cannot print aliases.
4834 : */
4835 1522 : if (rte->alias != NULL)
4836 108 : colinfo->printaliases = changed_any;
4837 : else
4838 1414 : colinfo->printaliases = false;
4839 1522 : }
4840 :
4841 : /*
4842 : * colname_is_unique: is colname distinct from already-chosen column names?
4843 : *
4844 : * dpns is query-wide info, colinfo is for the column's RTE
4845 : */
4846 : static bool
4847 459512 : colname_is_unique(const char *colname, deparse_namespace *dpns,
4848 : deparse_columns *colinfo)
4849 : {
4850 : int i;
4851 : ListCell *lc;
4852 :
4853 : /*
4854 : * If we have a hash table, consult that instead of linearly scanning the
4855 : * colinfo's strings.
4856 : */
4857 459512 : if (colinfo->names_hash)
4858 : {
4859 18070 : if (hash_search(colinfo->names_hash,
4860 : colname,
4861 : HASH_FIND,
4862 : NULL) != NULL)
4863 0 : return false;
4864 : }
4865 : else
4866 : {
4867 : /* Check against already-assigned column aliases within RTE */
4868 6101768 : for (i = 0; i < colinfo->num_cols; i++)
4869 : {
4870 5662622 : char *oldname = colinfo->colnames[i];
4871 :
4872 5662622 : if (oldname && strcmp(oldname, colname) == 0)
4873 2296 : return false;
4874 : }
4875 :
4876 : /*
4877 : * If we're building a new_colnames array, check that too (this will
4878 : * be partially but not completely redundant with the previous checks)
4879 : */
4880 440418 : for (i = 0; i < colinfo->num_new_cols; i++)
4881 : {
4882 1296 : char *oldname = colinfo->new_colnames[i];
4883 :
4884 1296 : if (oldname && strcmp(oldname, colname) == 0)
4885 24 : return false;
4886 : }
4887 :
4888 : /*
4889 : * Also check against names already assigned for parent-join USING
4890 : * cols
4891 : */
4892 441714 : foreach(lc, colinfo->parentUsing)
4893 : {
4894 2598 : char *oldname = (char *) lfirst(lc);
4895 :
4896 2598 : if (strcmp(oldname, colname) == 0)
4897 6 : return false;
4898 : }
4899 : }
4900 :
4901 : /*
4902 : * Also check against USING-column names that must be globally unique.
4903 : * These are not hashed, but there should be few of them.
4904 : */
4905 458026 : foreach(lc, dpns->using_names)
4906 : {
4907 882 : char *oldname = (char *) lfirst(lc);
4908 :
4909 882 : if (strcmp(oldname, colname) == 0)
4910 42 : return false;
4911 : }
4912 :
4913 457144 : return true;
4914 : }
4915 :
4916 : /*
4917 : * make_colname_unique: modify colname if necessary to make it unique
4918 : *
4919 : * dpns is query-wide info, colinfo is for the column's RTE
4920 : */
4921 : static char *
4922 457144 : make_colname_unique(char *colname, deparse_namespace *dpns,
4923 : deparse_columns *colinfo)
4924 : {
4925 : /*
4926 : * If the selected name isn't unique, append digits to make it so. For a
4927 : * very long input name, we might have to truncate to stay within
4928 : * NAMEDATALEN.
4929 : */
4930 457144 : if (!colname_is_unique(colname, dpns, colinfo))
4931 : {
4932 1644 : int colnamelen = strlen(colname);
4933 1644 : char *modname = (char *) palloc(colnamelen + 16);
4934 1644 : int i = 0;
4935 :
4936 : do
4937 : {
4938 2368 : i++;
4939 : for (;;)
4940 : {
4941 2368 : memcpy(modname, colname, colnamelen);
4942 2368 : sprintf(modname + colnamelen, "_%d", i);
4943 2368 : if (strlen(modname) < NAMEDATALEN)
4944 2368 : break;
4945 : /* drop chars from colname to keep all the digits */
4946 0 : colnamelen = pg_mbcliplen(colname, colnamelen,
4947 : colnamelen - 1);
4948 : }
4949 2368 : } while (!colname_is_unique(modname, dpns, colinfo));
4950 1644 : colname = modname;
4951 : }
4952 457144 : return colname;
4953 : }
4954 :
4955 : /*
4956 : * expand_colnames_array_to: make colinfo->colnames at least n items long
4957 : *
4958 : * Any added array entries are initialized to zero.
4959 : */
4960 : static void
4961 97208 : expand_colnames_array_to(deparse_columns *colinfo, int n)
4962 : {
4963 97208 : if (n > colinfo->num_cols)
4964 : {
4965 94556 : if (colinfo->colnames == NULL)
4966 93140 : colinfo->colnames = palloc0_array(char *, n);
4967 : else
4968 1416 : colinfo->colnames = repalloc0_array(colinfo->colnames, char *, colinfo->num_cols, n);
4969 94556 : colinfo->num_cols = n;
4970 : }
4971 97208 : }
4972 :
4973 : /*
4974 : * build_colinfo_names_hash: optionally construct a hash table for colinfo
4975 : */
4976 : static void
4977 95408 : build_colinfo_names_hash(deparse_columns *colinfo)
4978 : {
4979 : HASHCTL hash_ctl;
4980 : int i;
4981 : ListCell *lc;
4982 :
4983 : /*
4984 : * Use a hash table only for RTEs with at least 32 columns. (The cutoff
4985 : * is somewhat arbitrary, but let's choose it so that this code does get
4986 : * exercised in the regression tests.)
4987 : */
4988 95408 : if (colinfo->num_cols < 32)
4989 94054 : return;
4990 :
4991 : /*
4992 : * Set up the hash table. The entries are just strings with no other
4993 : * payload.
4994 : */
4995 1354 : hash_ctl.keysize = NAMEDATALEN;
4996 1354 : hash_ctl.entrysize = NAMEDATALEN;
4997 1354 : hash_ctl.hcxt = CurrentMemoryContext;
4998 2708 : colinfo->names_hash = hash_create("deparse_columns names",
4999 1354 : colinfo->num_cols + colinfo->num_new_cols,
5000 : &hash_ctl,
5001 : HASH_ELEM | HASH_STRINGS | HASH_CONTEXT);
5002 :
5003 : /*
5004 : * Preload the hash table with any names already present (these would have
5005 : * come from set_using_names).
5006 : */
5007 64010 : for (i = 0; i < colinfo->num_cols; i++)
5008 : {
5009 62656 : char *oldname = colinfo->colnames[i];
5010 :
5011 62656 : if (oldname)
5012 0 : add_to_names_hash(colinfo, oldname);
5013 : }
5014 :
5015 1354 : for (i = 0; i < colinfo->num_new_cols; i++)
5016 : {
5017 0 : char *oldname = colinfo->new_colnames[i];
5018 :
5019 0 : if (oldname)
5020 0 : add_to_names_hash(colinfo, oldname);
5021 : }
5022 :
5023 1354 : foreach(lc, colinfo->parentUsing)
5024 : {
5025 0 : char *oldname = (char *) lfirst(lc);
5026 :
5027 0 : add_to_names_hash(colinfo, oldname);
5028 : }
5029 : }
5030 :
5031 : /*
5032 : * add_to_names_hash: add a string to the names_hash, if we're using one
5033 : */
5034 : static void
5035 506538 : add_to_names_hash(deparse_columns *colinfo, const char *name)
5036 : {
5037 506538 : if (colinfo->names_hash)
5038 62656 : (void) hash_search(colinfo->names_hash,
5039 : name,
5040 : HASH_ENTER,
5041 : NULL);
5042 506538 : }
5043 :
5044 : /*
5045 : * destroy_colinfo_names_hash: destroy hash table when done with it
5046 : */
5047 : static void
5048 95408 : destroy_colinfo_names_hash(deparse_columns *colinfo)
5049 : {
5050 95408 : if (colinfo->names_hash)
5051 : {
5052 1354 : hash_destroy(colinfo->names_hash);
5053 1354 : colinfo->names_hash = NULL;
5054 : }
5055 95408 : }
5056 :
5057 : /*
5058 : * identify_join_columns: figure out where columns of a join come from
5059 : *
5060 : * Fills the join-specific fields of the colinfo struct, except for
5061 : * usingNames which is filled later.
5062 : */
5063 : static void
5064 1522 : identify_join_columns(JoinExpr *j, RangeTblEntry *jrte,
5065 : deparse_columns *colinfo)
5066 : {
5067 : int numjoincols;
5068 : int jcolno;
5069 : int rcolno;
5070 : ListCell *lc;
5071 :
5072 : /* Extract left/right child RT indexes */
5073 1522 : if (IsA(j->larg, RangeTblRef))
5074 966 : colinfo->leftrti = ((RangeTblRef *) j->larg)->rtindex;
5075 556 : else if (IsA(j->larg, JoinExpr))
5076 556 : colinfo->leftrti = ((JoinExpr *) j->larg)->rtindex;
5077 : else
5078 0 : elog(ERROR, "unrecognized node type in jointree: %d",
5079 : (int) nodeTag(j->larg));
5080 1522 : if (IsA(j->rarg, RangeTblRef))
5081 1522 : colinfo->rightrti = ((RangeTblRef *) j->rarg)->rtindex;
5082 0 : else if (IsA(j->rarg, JoinExpr))
5083 0 : colinfo->rightrti = ((JoinExpr *) j->rarg)->rtindex;
5084 : else
5085 0 : elog(ERROR, "unrecognized node type in jointree: %d",
5086 : (int) nodeTag(j->rarg));
5087 :
5088 : /* Assert children will be processed earlier than join in second pass */
5089 : Assert(colinfo->leftrti < j->rtindex);
5090 : Assert(colinfo->rightrti < j->rtindex);
5091 :
5092 : /* Initialize result arrays with zeroes */
5093 1522 : numjoincols = list_length(jrte->joinaliasvars);
5094 : Assert(numjoincols == list_length(jrte->eref->colnames));
5095 1522 : colinfo->leftattnos = (int *) palloc0(numjoincols * sizeof(int));
5096 1522 : colinfo->rightattnos = (int *) palloc0(numjoincols * sizeof(int));
5097 :
5098 : /*
5099 : * Deconstruct RTE's joinleftcols/joinrightcols into desired format.
5100 : * Recall that the column(s) merged due to USING are the first column(s)
5101 : * of the join output. We need not do anything special while scanning
5102 : * joinleftcols, but while scanning joinrightcols we must distinguish
5103 : * merged from unmerged columns.
5104 : */
5105 1522 : jcolno = 0;
5106 37278 : foreach(lc, jrte->joinleftcols)
5107 : {
5108 35756 : int leftattno = lfirst_int(lc);
5109 :
5110 35756 : colinfo->leftattnos[jcolno++] = leftattno;
5111 : }
5112 1522 : rcolno = 0;
5113 16678 : foreach(lc, jrte->joinrightcols)
5114 : {
5115 15156 : int rightattno = lfirst_int(lc);
5116 :
5117 15156 : if (rcolno < jrte->joinmergedcols) /* merged column? */
5118 580 : colinfo->rightattnos[rcolno] = rightattno;
5119 : else
5120 14576 : colinfo->rightattnos[jcolno++] = rightattno;
5121 15156 : rcolno++;
5122 : }
5123 : Assert(jcolno == numjoincols);
5124 1522 : }
5125 :
5126 : /*
5127 : * get_rtable_name: convenience function to get a previously assigned RTE alias
5128 : *
5129 : * The RTE must belong to the topmost namespace level in "context".
5130 : */
5131 : static char *
5132 6694 : get_rtable_name(int rtindex, deparse_context *context)
5133 : {
5134 6694 : deparse_namespace *dpns = (deparse_namespace *) linitial(context->namespaces);
5135 :
5136 : Assert(rtindex > 0 && rtindex <= list_length(dpns->rtable_names));
5137 6694 : return (char *) list_nth(dpns->rtable_names, rtindex - 1);
5138 : }
5139 :
5140 : /*
5141 : * set_deparse_plan: set up deparse_namespace to parse subexpressions
5142 : * of a given Plan node
5143 : *
5144 : * This sets the plan, outer_plan, inner_plan, outer_tlist, inner_tlist,
5145 : * and index_tlist fields. Caller must already have adjusted the ancestors
5146 : * list if necessary. Note that the rtable, subplans, and ctes fields do
5147 : * not need to change when shifting attention to different plan nodes in a
5148 : * single plan tree.
5149 : */
5150 : static void
5151 148774 : set_deparse_plan(deparse_namespace *dpns, Plan *plan)
5152 : {
5153 148774 : dpns->plan = plan;
5154 :
5155 : /*
5156 : * We special-case Append and MergeAppend to pretend that the first child
5157 : * plan is the OUTER referent; we have to interpret OUTER Vars in their
5158 : * tlists according to one of the children, and the first one is the most
5159 : * natural choice.
5160 : */
5161 148774 : if (IsA(plan, Append))
5162 4450 : dpns->outer_plan = linitial(((Append *) plan)->appendplans);
5163 144324 : else if (IsA(plan, MergeAppend))
5164 528 : dpns->outer_plan = linitial(((MergeAppend *) plan)->mergeplans);
5165 : else
5166 143796 : dpns->outer_plan = outerPlan(plan);
5167 :
5168 148774 : if (dpns->outer_plan)
5169 71848 : dpns->outer_tlist = dpns->outer_plan->targetlist;
5170 : else
5171 76926 : dpns->outer_tlist = NIL;
5172 :
5173 : /*
5174 : * For a SubqueryScan, pretend the subplan is INNER referent. (We don't
5175 : * use OUTER because that could someday conflict with the normal meaning.)
5176 : * Likewise, for a CteScan, pretend the subquery's plan is INNER referent.
5177 : * For a WorkTableScan, locate the parent RecursiveUnion plan node and use
5178 : * that as INNER referent.
5179 : *
5180 : * For MERGE, pretend the ModifyTable's source plan (its outer plan) is
5181 : * INNER referent. This is the join from the target relation to the data
5182 : * source, and all INNER_VAR Vars in other parts of the query refer to its
5183 : * targetlist.
5184 : *
5185 : * For ON CONFLICT .. UPDATE we just need the inner tlist to point to the
5186 : * excluded expression's tlist. (Similar to the SubqueryScan we don't want
5187 : * to reuse OUTER, it's used for RETURNING in some modify table cases,
5188 : * although not INSERT .. CONFLICT).
5189 : */
5190 148774 : if (IsA(plan, SubqueryScan))
5191 662 : dpns->inner_plan = ((SubqueryScan *) plan)->subplan;
5192 148112 : else if (IsA(plan, CteScan))
5193 552 : dpns->inner_plan = list_nth(dpns->subplans,
5194 552 : ((CteScan *) plan)->ctePlanId - 1);
5195 147560 : else if (IsA(plan, WorkTableScan))
5196 174 : dpns->inner_plan = find_recursive_union(dpns,
5197 : (WorkTableScan *) plan);
5198 147386 : else if (IsA(plan, ModifyTable))
5199 : {
5200 402 : if (((ModifyTable *) plan)->operation == CMD_MERGE)
5201 60 : dpns->inner_plan = outerPlan(plan);
5202 : else
5203 342 : dpns->inner_plan = plan;
5204 : }
5205 : else
5206 146984 : dpns->inner_plan = innerPlan(plan);
5207 :
5208 148774 : if (IsA(plan, ModifyTable) && ((ModifyTable *) plan)->operation == CMD_INSERT)
5209 170 : dpns->inner_tlist = ((ModifyTable *) plan)->exclRelTlist;
5210 148604 : else if (dpns->inner_plan)
5211 26000 : dpns->inner_tlist = dpns->inner_plan->targetlist;
5212 : else
5213 122604 : dpns->inner_tlist = NIL;
5214 :
5215 : /* Set up referent for INDEX_VAR Vars, if needed */
5216 148774 : if (IsA(plan, IndexOnlyScan))
5217 3484 : dpns->index_tlist = ((IndexOnlyScan *) plan)->indextlist;
5218 145290 : else if (IsA(plan, ForeignScan))
5219 3096 : dpns->index_tlist = ((ForeignScan *) plan)->fdw_scan_tlist;
5220 142194 : else if (IsA(plan, CustomScan))
5221 0 : dpns->index_tlist = ((CustomScan *) plan)->custom_scan_tlist;
5222 : else
5223 142194 : dpns->index_tlist = NIL;
5224 148774 : }
5225 :
5226 : /*
5227 : * Locate the ancestor plan node that is the RecursiveUnion generating
5228 : * the WorkTableScan's work table. We can match on wtParam, since that
5229 : * should be unique within the plan tree.
5230 : */
5231 : static Plan *
5232 174 : find_recursive_union(deparse_namespace *dpns, WorkTableScan *wtscan)
5233 : {
5234 : ListCell *lc;
5235 :
5236 438 : foreach(lc, dpns->ancestors)
5237 : {
5238 438 : Plan *ancestor = (Plan *) lfirst(lc);
5239 :
5240 438 : if (IsA(ancestor, RecursiveUnion) &&
5241 174 : ((RecursiveUnion *) ancestor)->wtParam == wtscan->wtParam)
5242 174 : return ancestor;
5243 : }
5244 0 : elog(ERROR, "could not find RecursiveUnion for WorkTableScan with wtParam %d",
5245 : wtscan->wtParam);
5246 : return NULL;
5247 : }
5248 :
5249 : /*
5250 : * push_child_plan: temporarily transfer deparsing attention to a child plan
5251 : *
5252 : * When expanding an OUTER_VAR or INNER_VAR reference, we must adjust the
5253 : * deparse context in case the referenced expression itself uses
5254 : * OUTER_VAR/INNER_VAR. We modify the top stack entry in-place to avoid
5255 : * affecting levelsup issues (although in a Plan tree there really shouldn't
5256 : * be any).
5257 : *
5258 : * Caller must provide a local deparse_namespace variable to save the
5259 : * previous state for pop_child_plan.
5260 : */
5261 : static void
5262 86488 : push_child_plan(deparse_namespace *dpns, Plan *plan,
5263 : deparse_namespace *save_dpns)
5264 : {
5265 : /* Save state for restoration later */
5266 86488 : *save_dpns = *dpns;
5267 :
5268 : /* Link current plan node into ancestors list */
5269 86488 : dpns->ancestors = lcons(dpns->plan, dpns->ancestors);
5270 :
5271 : /* Set attention on selected child */
5272 86488 : set_deparse_plan(dpns, plan);
5273 86488 : }
5274 :
5275 : /*
5276 : * pop_child_plan: undo the effects of push_child_plan
5277 : */
5278 : static void
5279 86488 : pop_child_plan(deparse_namespace *dpns, deparse_namespace *save_dpns)
5280 : {
5281 : List *ancestors;
5282 :
5283 : /* Get rid of ancestors list cell added by push_child_plan */
5284 86488 : ancestors = list_delete_first(dpns->ancestors);
5285 :
5286 : /* Restore fields changed by push_child_plan */
5287 86488 : *dpns = *save_dpns;
5288 :
5289 : /* Make sure dpns->ancestors is right (may be unnecessary) */
5290 86488 : dpns->ancestors = ancestors;
5291 86488 : }
5292 :
5293 : /*
5294 : * push_ancestor_plan: temporarily transfer deparsing attention to an
5295 : * ancestor plan
5296 : *
5297 : * When expanding a Param reference, we must adjust the deparse context
5298 : * to match the plan node that contains the expression being printed;
5299 : * otherwise we'd fail if that expression itself contains a Param or
5300 : * OUTER_VAR/INNER_VAR/INDEX_VAR variable.
5301 : *
5302 : * The target ancestor is conveniently identified by the ListCell holding it
5303 : * in dpns->ancestors.
5304 : *
5305 : * Caller must provide a local deparse_namespace variable to save the
5306 : * previous state for pop_ancestor_plan.
5307 : */
5308 : static void
5309 4640 : push_ancestor_plan(deparse_namespace *dpns, ListCell *ancestor_cell,
5310 : deparse_namespace *save_dpns)
5311 : {
5312 4640 : Plan *plan = (Plan *) lfirst(ancestor_cell);
5313 :
5314 : /* Save state for restoration later */
5315 4640 : *save_dpns = *dpns;
5316 :
5317 : /* Build a new ancestor list with just this node's ancestors */
5318 4640 : dpns->ancestors =
5319 4640 : list_copy_tail(dpns->ancestors,
5320 4640 : list_cell_number(dpns->ancestors, ancestor_cell) + 1);
5321 :
5322 : /* Set attention on selected ancestor */
5323 4640 : set_deparse_plan(dpns, plan);
5324 4640 : }
5325 :
5326 : /*
5327 : * pop_ancestor_plan: undo the effects of push_ancestor_plan
5328 : */
5329 : static void
5330 4640 : pop_ancestor_plan(deparse_namespace *dpns, deparse_namespace *save_dpns)
5331 : {
5332 : /* Free the ancestor list made in push_ancestor_plan */
5333 4640 : list_free(dpns->ancestors);
5334 :
5335 : /* Restore fields changed by push_ancestor_plan */
5336 4640 : *dpns = *save_dpns;
5337 4640 : }
5338 :
5339 :
5340 : /* ----------
5341 : * make_ruledef - reconstruct the CREATE RULE command
5342 : * for a given pg_rewrite tuple
5343 : * ----------
5344 : */
5345 : static void
5346 558 : make_ruledef(StringInfo buf, HeapTuple ruletup, TupleDesc rulettc,
5347 : int prettyFlags)
5348 : {
5349 : char *rulename;
5350 : char ev_type;
5351 : Oid ev_class;
5352 : bool is_instead;
5353 : char *ev_qual;
5354 : char *ev_action;
5355 : List *actions;
5356 : Relation ev_relation;
5357 558 : TupleDesc viewResultDesc = NULL;
5358 : int fno;
5359 : Datum dat;
5360 : bool isnull;
5361 :
5362 : /*
5363 : * Get the attribute values from the rules tuple
5364 : */
5365 558 : fno = SPI_fnumber(rulettc, "rulename");
5366 558 : dat = SPI_getbinval(ruletup, rulettc, fno, &isnull);
5367 : Assert(!isnull);
5368 558 : rulename = NameStr(*(DatumGetName(dat)));
5369 :
5370 558 : fno = SPI_fnumber(rulettc, "ev_type");
5371 558 : dat = SPI_getbinval(ruletup, rulettc, fno, &isnull);
5372 : Assert(!isnull);
5373 558 : ev_type = DatumGetChar(dat);
5374 :
5375 558 : fno = SPI_fnumber(rulettc, "ev_class");
5376 558 : dat = SPI_getbinval(ruletup, rulettc, fno, &isnull);
5377 : Assert(!isnull);
5378 558 : ev_class = DatumGetObjectId(dat);
5379 :
5380 558 : fno = SPI_fnumber(rulettc, "is_instead");
5381 558 : dat = SPI_getbinval(ruletup, rulettc, fno, &isnull);
5382 : Assert(!isnull);
5383 558 : is_instead = DatumGetBool(dat);
5384 :
5385 558 : fno = SPI_fnumber(rulettc, "ev_qual");
5386 558 : ev_qual = SPI_getvalue(ruletup, rulettc, fno);
5387 : Assert(ev_qual != NULL);
5388 :
5389 558 : fno = SPI_fnumber(rulettc, "ev_action");
5390 558 : ev_action = SPI_getvalue(ruletup, rulettc, fno);
5391 : Assert(ev_action != NULL);
5392 558 : actions = (List *) stringToNode(ev_action);
5393 558 : if (actions == NIL)
5394 0 : elog(ERROR, "invalid empty ev_action list");
5395 :
5396 558 : ev_relation = table_open(ev_class, AccessShareLock);
5397 :
5398 : /*
5399 : * Build the rules definition text
5400 : */
5401 558 : appendStringInfo(buf, "CREATE RULE %s AS",
5402 : quote_identifier(rulename));
5403 :
5404 558 : if (prettyFlags & PRETTYFLAG_INDENT)
5405 558 : appendStringInfoString(buf, "\n ON ");
5406 : else
5407 0 : appendStringInfoString(buf, " ON ");
5408 :
5409 : /* The event the rule is fired for */
5410 558 : switch (ev_type)
5411 : {
5412 6 : case '1':
5413 6 : appendStringInfoString(buf, "SELECT");
5414 6 : viewResultDesc = RelationGetDescr(ev_relation);
5415 6 : break;
5416 :
5417 154 : case '2':
5418 154 : appendStringInfoString(buf, "UPDATE");
5419 154 : break;
5420 :
5421 294 : case '3':
5422 294 : appendStringInfoString(buf, "INSERT");
5423 294 : break;
5424 :
5425 104 : case '4':
5426 104 : appendStringInfoString(buf, "DELETE");
5427 104 : break;
5428 :
5429 0 : default:
5430 0 : ereport(ERROR,
5431 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
5432 : errmsg("rule \"%s\" has unsupported event type %d",
5433 : rulename, ev_type)));
5434 : break;
5435 : }
5436 :
5437 : /* The relation the rule is fired on */
5438 558 : appendStringInfo(buf, " TO %s",
5439 558 : (prettyFlags & PRETTYFLAG_SCHEMA) ?
5440 114 : generate_relation_name(ev_class, NIL) :
5441 444 : generate_qualified_relation_name(ev_class));
5442 :
5443 : /* If the rule has an event qualification, add it */
5444 558 : if (strcmp(ev_qual, "<>") != 0)
5445 : {
5446 : Node *qual;
5447 : Query *query;
5448 : deparse_context context;
5449 : deparse_namespace dpns;
5450 :
5451 122 : if (prettyFlags & PRETTYFLAG_INDENT)
5452 122 : appendStringInfoString(buf, "\n ");
5453 122 : appendStringInfoString(buf, " WHERE ");
5454 :
5455 122 : qual = stringToNode(ev_qual);
5456 :
5457 : /*
5458 : * We need to make a context for recognizing any Vars in the qual
5459 : * (which can only be references to OLD and NEW). Use the rtable of
5460 : * the first query in the action list for this purpose.
5461 : */
5462 122 : query = (Query *) linitial(actions);
5463 :
5464 : /*
5465 : * If the action is INSERT...SELECT, OLD/NEW have been pushed down
5466 : * into the SELECT, and that's what we need to look at. (Ugly kluge
5467 : * ... try to fix this when we redesign querytrees.)
5468 : */
5469 122 : query = getInsertSelectQuery(query, NULL);
5470 :
5471 : /* Must acquire locks right away; see notes in get_query_def() */
5472 122 : AcquireRewriteLocks(query, false, false);
5473 :
5474 122 : context.buf = buf;
5475 122 : context.namespaces = list_make1(&dpns);
5476 122 : context.resultDesc = NULL;
5477 122 : context.targetList = NIL;
5478 122 : context.windowClause = NIL;
5479 122 : context.varprefix = (list_length(query->rtable) != 1);
5480 122 : context.prettyFlags = prettyFlags;
5481 122 : context.wrapColumn = WRAP_COLUMN_DEFAULT;
5482 122 : context.indentLevel = PRETTYINDENT_STD;
5483 122 : context.colNamesVisible = true;
5484 122 : context.inGroupBy = false;
5485 122 : context.varInOrderBy = false;
5486 122 : context.appendparents = NULL;
5487 :
5488 122 : set_deparse_for_query(&dpns, query, NIL);
5489 :
5490 122 : get_rule_expr(qual, &context, false);
5491 : }
5492 :
5493 558 : appendStringInfoString(buf, " DO ");
5494 :
5495 : /* The INSTEAD keyword (if so) */
5496 558 : if (is_instead)
5497 330 : appendStringInfoString(buf, "INSTEAD ");
5498 :
5499 : /* Finally the rules actions */
5500 558 : if (list_length(actions) > 1)
5501 : {
5502 : ListCell *action;
5503 : Query *query;
5504 :
5505 20 : appendStringInfoChar(buf, '(');
5506 60 : foreach(action, actions)
5507 : {
5508 40 : query = (Query *) lfirst(action);
5509 40 : get_query_def(query, buf, NIL, viewResultDesc, true,
5510 : prettyFlags, WRAP_COLUMN_DEFAULT, 0);
5511 40 : if (prettyFlags)
5512 40 : appendStringInfoString(buf, ";\n");
5513 : else
5514 0 : appendStringInfoString(buf, "; ");
5515 : }
5516 20 : appendStringInfoString(buf, ");");
5517 : }
5518 : else
5519 : {
5520 : Query *query;
5521 :
5522 538 : query = (Query *) linitial(actions);
5523 538 : get_query_def(query, buf, NIL, viewResultDesc, true,
5524 : prettyFlags, WRAP_COLUMN_DEFAULT, 0);
5525 538 : appendStringInfoChar(buf, ';');
5526 : }
5527 :
5528 558 : table_close(ev_relation, AccessShareLock);
5529 558 : }
5530 :
5531 :
5532 : /* ----------
5533 : * make_viewdef - reconstruct the SELECT part of a
5534 : * view rewrite rule
5535 : * ----------
5536 : */
5537 : static void
5538 3512 : make_viewdef(StringInfo buf, HeapTuple ruletup, TupleDesc rulettc,
5539 : int prettyFlags, int wrapColumn)
5540 : {
5541 : Query *query;
5542 : char ev_type;
5543 : Oid ev_class;
5544 : bool is_instead;
5545 : char *ev_qual;
5546 : char *ev_action;
5547 : List *actions;
5548 : Relation ev_relation;
5549 : int fno;
5550 : Datum dat;
5551 : bool isnull;
5552 :
5553 : /*
5554 : * Get the attribute values from the rules tuple
5555 : */
5556 3512 : fno = SPI_fnumber(rulettc, "ev_type");
5557 3512 : dat = SPI_getbinval(ruletup, rulettc, fno, &isnull);
5558 : Assert(!isnull);
5559 3512 : ev_type = DatumGetChar(dat);
5560 :
5561 3512 : fno = SPI_fnumber(rulettc, "ev_class");
5562 3512 : dat = SPI_getbinval(ruletup, rulettc, fno, &isnull);
5563 : Assert(!isnull);
5564 3512 : ev_class = DatumGetObjectId(dat);
5565 :
5566 3512 : fno = SPI_fnumber(rulettc, "is_instead");
5567 3512 : dat = SPI_getbinval(ruletup, rulettc, fno, &isnull);
5568 : Assert(!isnull);
5569 3512 : is_instead = DatumGetBool(dat);
5570 :
5571 3512 : fno = SPI_fnumber(rulettc, "ev_qual");
5572 3512 : ev_qual = SPI_getvalue(ruletup, rulettc, fno);
5573 : Assert(ev_qual != NULL);
5574 :
5575 3512 : fno = SPI_fnumber(rulettc, "ev_action");
5576 3512 : ev_action = SPI_getvalue(ruletup, rulettc, fno);
5577 : Assert(ev_action != NULL);
5578 3512 : actions = (List *) stringToNode(ev_action);
5579 :
5580 3512 : if (list_length(actions) != 1)
5581 : {
5582 : /* keep output buffer empty and leave */
5583 0 : return;
5584 : }
5585 :
5586 3512 : query = (Query *) linitial(actions);
5587 :
5588 3512 : if (ev_type != '1' || !is_instead ||
5589 3512 : strcmp(ev_qual, "<>") != 0 || query->commandType != CMD_SELECT)
5590 : {
5591 : /* keep output buffer empty and leave */
5592 0 : return;
5593 : }
5594 :
5595 3512 : ev_relation = table_open(ev_class, AccessShareLock);
5596 :
5597 3512 : get_query_def(query, buf, NIL, RelationGetDescr(ev_relation), true,
5598 : prettyFlags, wrapColumn, 0);
5599 3512 : appendStringInfoChar(buf, ';');
5600 :
5601 3512 : table_close(ev_relation, AccessShareLock);
5602 : }
5603 :
5604 :
5605 : /* ----------
5606 : * get_query_def - Parse back one query parsetree
5607 : *
5608 : * query: parsetree to be displayed
5609 : * buf: output text is appended to buf
5610 : * parentnamespace: list (initially empty) of outer-level deparse_namespace's
5611 : * resultDesc: if not NULL, the output tuple descriptor for the view
5612 : * represented by a SELECT query. We use the column names from it
5613 : * to label SELECT output columns, in preference to names in the query
5614 : * colNamesVisible: true if the surrounding context cares about the output
5615 : * column names at all (as, for example, an EXISTS() context does not);
5616 : * when false, we can suppress dummy column labels such as "?column?"
5617 : * prettyFlags: bitmask of PRETTYFLAG_XXX options
5618 : * wrapColumn: maximum line length, or -1 to disable wrapping
5619 : * startIndent: initial indentation amount
5620 : * ----------
5621 : */
5622 : static void
5623 5698 : get_query_def(Query *query, StringInfo buf, List *parentnamespace,
5624 : TupleDesc resultDesc, bool colNamesVisible,
5625 : int prettyFlags, int wrapColumn, int startIndent)
5626 : {
5627 : deparse_context context;
5628 : deparse_namespace dpns;
5629 : int rtable_size;
5630 :
5631 : /* Guard against excessively long or deeply-nested queries */
5632 5698 : CHECK_FOR_INTERRUPTS();
5633 5698 : check_stack_depth();
5634 :
5635 11396 : rtable_size = query->hasGroupRTE ?
5636 5698 : list_length(query->rtable) - 1 :
5637 5478 : list_length(query->rtable);
5638 :
5639 : /*
5640 : * Replace any Vars in the query's targetlist and havingQual that
5641 : * reference GROUP outputs with the underlying grouping expressions.
5642 : */
5643 5698 : if (query->hasGroupRTE)
5644 : {
5645 220 : query->targetList = (List *)
5646 220 : flatten_group_exprs(NULL, query, (Node *) query->targetList);
5647 220 : query->havingQual =
5648 220 : flatten_group_exprs(NULL, query, query->havingQual);
5649 : }
5650 :
5651 : /*
5652 : * Before we begin to examine the query, acquire locks on referenced
5653 : * relations, and fix up deleted columns in JOIN RTEs. This ensures
5654 : * consistent results. Note we assume it's OK to scribble on the passed
5655 : * querytree!
5656 : *
5657 : * We are only deparsing the query (we are not about to execute it), so we
5658 : * only need AccessShareLock on the relations it mentions.
5659 : */
5660 5698 : AcquireRewriteLocks(query, false, false);
5661 :
5662 5698 : context.buf = buf;
5663 5698 : context.namespaces = lcons(&dpns, list_copy(parentnamespace));
5664 5698 : context.resultDesc = NULL;
5665 5698 : context.targetList = NIL;
5666 5698 : context.windowClause = NIL;
5667 5698 : context.varprefix = (parentnamespace != NIL ||
5668 : rtable_size != 1);
5669 5698 : context.prettyFlags = prettyFlags;
5670 5698 : context.wrapColumn = wrapColumn;
5671 5698 : context.indentLevel = startIndent;
5672 5698 : context.colNamesVisible = colNamesVisible;
5673 5698 : context.inGroupBy = false;
5674 5698 : context.varInOrderBy = false;
5675 5698 : context.appendparents = NULL;
5676 :
5677 5698 : set_deparse_for_query(&dpns, query, parentnamespace);
5678 :
5679 5698 : switch (query->commandType)
5680 : {
5681 5058 : case CMD_SELECT:
5682 : /* We set context.resultDesc only if it's a SELECT */
5683 5058 : context.resultDesc = resultDesc;
5684 5058 : get_select_query_def(query, &context);
5685 5058 : break;
5686 :
5687 154 : case CMD_UPDATE:
5688 154 : get_update_query_def(query, &context);
5689 154 : break;
5690 :
5691 340 : case CMD_INSERT:
5692 340 : get_insert_query_def(query, &context);
5693 340 : break;
5694 :
5695 76 : case CMD_DELETE:
5696 76 : get_delete_query_def(query, &context);
5697 76 : break;
5698 :
5699 12 : case CMD_MERGE:
5700 12 : get_merge_query_def(query, &context);
5701 12 : break;
5702 :
5703 42 : case CMD_NOTHING:
5704 42 : appendStringInfoString(buf, "NOTHING");
5705 42 : break;
5706 :
5707 16 : case CMD_UTILITY:
5708 16 : get_utility_query_def(query, &context);
5709 16 : break;
5710 :
5711 0 : default:
5712 0 : elog(ERROR, "unrecognized query command type: %d",
5713 : query->commandType);
5714 : break;
5715 : }
5716 5698 : }
5717 :
5718 : /* ----------
5719 : * get_values_def - Parse back a VALUES list
5720 : * ----------
5721 : */
5722 : static void
5723 272 : get_values_def(List *values_lists, deparse_context *context)
5724 : {
5725 272 : StringInfo buf = context->buf;
5726 272 : bool first_list = true;
5727 : ListCell *vtl;
5728 :
5729 272 : appendStringInfoString(buf, "VALUES ");
5730 :
5731 778 : foreach(vtl, values_lists)
5732 : {
5733 506 : List *sublist = (List *) lfirst(vtl);
5734 506 : bool first_col = true;
5735 : ListCell *lc;
5736 :
5737 506 : if (first_list)
5738 272 : first_list = false;
5739 : else
5740 234 : appendStringInfoString(buf, ", ");
5741 :
5742 506 : appendStringInfoChar(buf, '(');
5743 1958 : foreach(lc, sublist)
5744 : {
5745 1452 : Node *col = (Node *) lfirst(lc);
5746 :
5747 1452 : if (first_col)
5748 506 : first_col = false;
5749 : else
5750 946 : appendStringInfoChar(buf, ',');
5751 :
5752 : /*
5753 : * Print the value. Whole-row Vars need special treatment.
5754 : */
5755 1452 : get_rule_expr_toplevel(col, context, false);
5756 : }
5757 506 : appendStringInfoChar(buf, ')');
5758 : }
5759 272 : }
5760 :
5761 : /* ----------
5762 : * get_with_clause - Parse back a WITH clause
5763 : * ----------
5764 : */
5765 : static void
5766 5640 : get_with_clause(Query *query, deparse_context *context)
5767 : {
5768 5640 : StringInfo buf = context->buf;
5769 : const char *sep;
5770 : ListCell *l;
5771 :
5772 5640 : if (query->cteList == NIL)
5773 5544 : return;
5774 :
5775 96 : if (PRETTY_INDENT(context))
5776 : {
5777 96 : context->indentLevel += PRETTYINDENT_STD;
5778 96 : appendStringInfoChar(buf, ' ');
5779 : }
5780 :
5781 96 : if (query->hasRecursive)
5782 56 : sep = "WITH RECURSIVE ";
5783 : else
5784 40 : sep = "WITH ";
5785 242 : foreach(l, query->cteList)
5786 : {
5787 146 : CommonTableExpr *cte = (CommonTableExpr *) lfirst(l);
5788 :
5789 146 : appendStringInfoString(buf, sep);
5790 146 : appendStringInfoString(buf, quote_identifier(cte->ctename));
5791 146 : if (cte->aliascolnames)
5792 : {
5793 56 : bool first = true;
5794 : ListCell *col;
5795 :
5796 56 : appendStringInfoChar(buf, '(');
5797 148 : foreach(col, cte->aliascolnames)
5798 : {
5799 92 : if (first)
5800 56 : first = false;
5801 : else
5802 36 : appendStringInfoString(buf, ", ");
5803 92 : appendStringInfoString(buf,
5804 92 : quote_identifier(strVal(lfirst(col))));
5805 : }
5806 56 : appendStringInfoChar(buf, ')');
5807 : }
5808 146 : appendStringInfoString(buf, " AS ");
5809 146 : switch (cte->ctematerialized)
5810 : {
5811 128 : case CTEMaterializeDefault:
5812 128 : break;
5813 18 : case CTEMaterializeAlways:
5814 18 : appendStringInfoString(buf, "MATERIALIZED ");
5815 18 : break;
5816 0 : case CTEMaterializeNever:
5817 0 : appendStringInfoString(buf, "NOT MATERIALIZED ");
5818 0 : break;
5819 : }
5820 146 : appendStringInfoChar(buf, '(');
5821 146 : if (PRETTY_INDENT(context))
5822 146 : appendContextKeyword(context, "", 0, 0, 0);
5823 146 : get_query_def((Query *) cte->ctequery, buf, context->namespaces, NULL,
5824 : true,
5825 : context->prettyFlags, context->wrapColumn,
5826 : context->indentLevel);
5827 146 : if (PRETTY_INDENT(context))
5828 146 : appendContextKeyword(context, "", 0, 0, 0);
5829 146 : appendStringInfoChar(buf, ')');
5830 :
5831 146 : if (cte->search_clause)
5832 : {
5833 6 : bool first = true;
5834 : ListCell *lc;
5835 :
5836 6 : appendStringInfo(buf, " SEARCH %s FIRST BY ",
5837 6 : cte->search_clause->search_breadth_first ? "BREADTH" : "DEPTH");
5838 :
5839 18 : foreach(lc, cte->search_clause->search_col_list)
5840 : {
5841 12 : if (first)
5842 6 : first = false;
5843 : else
5844 6 : appendStringInfoString(buf, ", ");
5845 12 : appendStringInfoString(buf,
5846 12 : quote_identifier(strVal(lfirst(lc))));
5847 : }
5848 :
5849 6 : appendStringInfo(buf, " SET %s", quote_identifier(cte->search_clause->search_seq_column));
5850 : }
5851 :
5852 146 : if (cte->cycle_clause)
5853 : {
5854 12 : bool first = true;
5855 : ListCell *lc;
5856 :
5857 12 : appendStringInfoString(buf, " CYCLE ");
5858 :
5859 36 : foreach(lc, cte->cycle_clause->cycle_col_list)
5860 : {
5861 24 : if (first)
5862 12 : first = false;
5863 : else
5864 12 : appendStringInfoString(buf, ", ");
5865 24 : appendStringInfoString(buf,
5866 24 : quote_identifier(strVal(lfirst(lc))));
5867 : }
5868 :
5869 12 : appendStringInfo(buf, " SET %s", quote_identifier(cte->cycle_clause->cycle_mark_column));
5870 :
5871 : {
5872 12 : Const *cmv = castNode(Const, cte->cycle_clause->cycle_mark_value);
5873 12 : Const *cmd = castNode(Const, cte->cycle_clause->cycle_mark_default);
5874 :
5875 18 : if (!(cmv->consttype == BOOLOID && !cmv->constisnull && DatumGetBool(cmv->constvalue) == true &&
5876 6 : cmd->consttype == BOOLOID && !cmd->constisnull && DatumGetBool(cmd->constvalue) == false))
5877 : {
5878 6 : appendStringInfoString(buf, " TO ");
5879 6 : get_rule_expr(cte->cycle_clause->cycle_mark_value, context, false);
5880 6 : appendStringInfoString(buf, " DEFAULT ");
5881 6 : get_rule_expr(cte->cycle_clause->cycle_mark_default, context, false);
5882 : }
5883 : }
5884 :
5885 12 : appendStringInfo(buf, " USING %s", quote_identifier(cte->cycle_clause->cycle_path_column));
5886 : }
5887 :
5888 146 : sep = ", ";
5889 : }
5890 :
5891 96 : if (PRETTY_INDENT(context))
5892 : {
5893 96 : context->indentLevel -= PRETTYINDENT_STD;
5894 96 : appendContextKeyword(context, "", 0, 0, 0);
5895 : }
5896 : else
5897 0 : appendStringInfoChar(buf, ' ');
5898 : }
5899 :
5900 : /* ----------
5901 : * get_select_query_def - Parse back a SELECT parsetree
5902 : * ----------
5903 : */
5904 : static void
5905 5058 : get_select_query_def(Query *query, deparse_context *context)
5906 : {
5907 5058 : StringInfo buf = context->buf;
5908 : bool force_colno;
5909 : ListCell *l;
5910 :
5911 : /* Insert the WITH clause if given */
5912 5058 : get_with_clause(query, context);
5913 :
5914 : /* Subroutines may need to consult the SELECT targetlist and windowClause */
5915 5058 : context->targetList = query->targetList;
5916 5058 : context->windowClause = query->windowClause;
5917 :
5918 : /*
5919 : * If the Query node has a setOperations tree, then it's the top level of
5920 : * a UNION/INTERSECT/EXCEPT query; only the WITH, ORDER BY and LIMIT
5921 : * fields are interesting in the top query itself.
5922 : */
5923 5058 : if (query->setOperations)
5924 : {
5925 164 : get_setop_query(query->setOperations, query, context);
5926 : /* ORDER BY clauses must be simple in this case */
5927 164 : force_colno = true;
5928 : }
5929 : else
5930 : {
5931 4894 : get_basic_select_query(query, context);
5932 4894 : force_colno = false;
5933 : }
5934 :
5935 : /* Add the ORDER BY clause if given */
5936 5058 : if (query->sortClause != NIL)
5937 : {
5938 180 : appendContextKeyword(context, " ORDER BY ",
5939 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 1);
5940 180 : get_rule_orderby(query->sortClause, query->targetList,
5941 : force_colno, context);
5942 : }
5943 :
5944 : /*
5945 : * Add the LIMIT/OFFSET clauses if given. If non-default options, use the
5946 : * standard spelling of LIMIT.
5947 : */
5948 5058 : if (query->limitOffset != NULL)
5949 : {
5950 32 : appendContextKeyword(context, " OFFSET ",
5951 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 0);
5952 32 : get_rule_expr(query->limitOffset, context, false);
5953 : }
5954 5058 : if (query->limitCount != NULL)
5955 : {
5956 86 : if (query->limitOption == LIMIT_OPTION_WITH_TIES)
5957 : {
5958 : /*
5959 : * The limitCount arg is a c_expr, so it needs parens. Simple
5960 : * literals and function expressions would not need parens, but
5961 : * unfortunately it's hard to tell if the expression will be
5962 : * printed as a simple literal like 123 or as a typecast
5963 : * expression, like '-123'::int4. The grammar accepts the former
5964 : * without quoting, but not the latter.
5965 : */
5966 48 : appendContextKeyword(context, " FETCH FIRST ",
5967 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 0);
5968 48 : appendStringInfoChar(buf, '(');
5969 48 : get_rule_expr(query->limitCount, context, false);
5970 48 : appendStringInfoChar(buf, ')');
5971 48 : appendStringInfoString(buf, " ROWS WITH TIES");
5972 : }
5973 : else
5974 : {
5975 38 : appendContextKeyword(context, " LIMIT ",
5976 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 0);
5977 38 : if (IsA(query->limitCount, Const) &&
5978 16 : ((Const *) query->limitCount)->constisnull)
5979 16 : appendStringInfoString(buf, "ALL");
5980 : else
5981 22 : get_rule_expr(query->limitCount, context, false);
5982 : }
5983 : }
5984 :
5985 : /* Add FOR [KEY] UPDATE/SHARE clauses if present */
5986 5058 : if (query->hasForUpdate)
5987 : {
5988 12 : foreach(l, query->rowMarks)
5989 : {
5990 6 : RowMarkClause *rc = (RowMarkClause *) lfirst(l);
5991 :
5992 : /* don't print implicit clauses */
5993 6 : if (rc->pushedDown)
5994 0 : continue;
5995 :
5996 6 : switch (rc->strength)
5997 : {
5998 0 : case LCS_NONE:
5999 : /* we intentionally throw an error for LCS_NONE */
6000 0 : elog(ERROR, "unrecognized LockClauseStrength %d",
6001 : (int) rc->strength);
6002 : break;
6003 0 : case LCS_FORKEYSHARE:
6004 0 : appendContextKeyword(context, " FOR KEY SHARE",
6005 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 0);
6006 0 : break;
6007 0 : case LCS_FORSHARE:
6008 0 : appendContextKeyword(context, " FOR SHARE",
6009 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 0);
6010 0 : break;
6011 0 : case LCS_FORNOKEYUPDATE:
6012 0 : appendContextKeyword(context, " FOR NO KEY UPDATE",
6013 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 0);
6014 0 : break;
6015 6 : case LCS_FORUPDATE:
6016 6 : appendContextKeyword(context, " FOR UPDATE",
6017 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 0);
6018 6 : break;
6019 : }
6020 :
6021 6 : appendStringInfo(buf, " OF %s",
6022 6 : quote_identifier(get_rtable_name(rc->rti,
6023 : context)));
6024 6 : if (rc->waitPolicy == LockWaitError)
6025 0 : appendStringInfoString(buf, " NOWAIT");
6026 6 : else if (rc->waitPolicy == LockWaitSkip)
6027 0 : appendStringInfoString(buf, " SKIP LOCKED");
6028 : }
6029 : }
6030 5058 : }
6031 :
6032 : /*
6033 : * Detect whether query looks like SELECT ... FROM VALUES(),
6034 : * with no need to rename the output columns of the VALUES RTE.
6035 : * If so, return the VALUES RTE. Otherwise return NULL.
6036 : */
6037 : static RangeTblEntry *
6038 4894 : get_simple_values_rte(Query *query, TupleDesc resultDesc)
6039 : {
6040 4894 : RangeTblEntry *result = NULL;
6041 : ListCell *lc;
6042 :
6043 : /*
6044 : * We want to detect a match even if the Query also contains OLD or NEW
6045 : * rule RTEs. So the idea is to scan the rtable and see if there is only
6046 : * one inFromCl RTE that is a VALUES RTE.
6047 : */
6048 5266 : foreach(lc, query->rtable)
6049 : {
6050 4454 : RangeTblEntry *rte = (RangeTblEntry *) lfirst(lc);
6051 :
6052 4454 : if (rte->rtekind == RTE_VALUES && rte->inFromCl)
6053 : {
6054 228 : if (result)
6055 4082 : return NULL; /* multiple VALUES (probably not possible) */
6056 228 : result = rte;
6057 : }
6058 4226 : else if (rte->rtekind == RTE_RELATION && !rte->inFromCl)
6059 144 : continue; /* ignore rule entries */
6060 : else
6061 4082 : return NULL; /* something else -> not simple VALUES */
6062 : }
6063 :
6064 : /*
6065 : * We don't need to check the targetlist in any great detail, because
6066 : * parser/analyze.c will never generate a "bare" VALUES RTE --- they only
6067 : * appear inside auto-generated sub-queries with very restricted
6068 : * structure. However, DefineView might have modified the tlist by
6069 : * injecting new column aliases, or we might have some other column
6070 : * aliases forced by a resultDesc. We can only simplify if the RTE's
6071 : * column names match the names that get_target_list() would select.
6072 : */
6073 812 : if (result)
6074 : {
6075 : ListCell *lcn;
6076 : int colno;
6077 :
6078 228 : if (list_length(query->targetList) != list_length(result->eref->colnames))
6079 0 : return NULL; /* this probably cannot happen */
6080 228 : colno = 0;
6081 842 : forboth(lc, query->targetList, lcn, result->eref->colnames)
6082 : {
6083 626 : TargetEntry *tle = (TargetEntry *) lfirst(lc);
6084 626 : char *cname = strVal(lfirst(lcn));
6085 : char *colname;
6086 :
6087 626 : if (tle->resjunk)
6088 12 : return NULL; /* this probably cannot happen */
6089 :
6090 : /* compute name that get_target_list would use for column */
6091 626 : colno++;
6092 626 : if (resultDesc && colno <= resultDesc->natts)
6093 30 : colname = NameStr(TupleDescAttr(resultDesc, colno - 1)->attname);
6094 : else
6095 596 : colname = tle->resname;
6096 :
6097 : /* does it match the VALUES RTE? */
6098 626 : if (colname == NULL || strcmp(colname, cname) != 0)
6099 12 : return NULL; /* column name has been changed */
6100 : }
6101 : }
6102 :
6103 800 : return result;
6104 : }
6105 :
6106 : static void
6107 4894 : get_basic_select_query(Query *query, deparse_context *context)
6108 : {
6109 4894 : StringInfo buf = context->buf;
6110 : RangeTblEntry *values_rte;
6111 : char *sep;
6112 : ListCell *l;
6113 :
6114 4894 : if (PRETTY_INDENT(context))
6115 : {
6116 4848 : context->indentLevel += PRETTYINDENT_STD;
6117 4848 : appendStringInfoChar(buf, ' ');
6118 : }
6119 :
6120 : /*
6121 : * If the query looks like SELECT * FROM (VALUES ...), then print just the
6122 : * VALUES part. This reverses what transformValuesClause() did at parse
6123 : * time.
6124 : */
6125 4894 : values_rte = get_simple_values_rte(query, context->resultDesc);
6126 4894 : if (values_rte)
6127 : {
6128 216 : get_values_def(values_rte->values_lists, context);
6129 216 : return;
6130 : }
6131 :
6132 : /*
6133 : * Build up the query string - first we say SELECT
6134 : */
6135 4678 : if (query->isReturn)
6136 52 : appendStringInfoString(buf, "RETURN");
6137 : else
6138 4626 : appendStringInfoString(buf, "SELECT");
6139 :
6140 : /* Add the DISTINCT clause if given */
6141 4678 : if (query->distinctClause != NIL)
6142 : {
6143 0 : if (query->hasDistinctOn)
6144 : {
6145 0 : appendStringInfoString(buf, " DISTINCT ON (");
6146 0 : sep = "";
6147 0 : foreach(l, query->distinctClause)
6148 : {
6149 0 : SortGroupClause *srt = (SortGroupClause *) lfirst(l);
6150 :
6151 0 : appendStringInfoString(buf, sep);
6152 0 : get_rule_sortgroupclause(srt->tleSortGroupRef, query->targetList,
6153 : false, context);
6154 0 : sep = ", ";
6155 : }
6156 0 : appendStringInfoChar(buf, ')');
6157 : }
6158 : else
6159 0 : appendStringInfoString(buf, " DISTINCT");
6160 : }
6161 :
6162 : /* Then we tell what to select (the targetlist) */
6163 4678 : get_target_list(query->targetList, context);
6164 :
6165 : /* Add the FROM clause if needed */
6166 4678 : get_from_clause(query, " FROM ", context);
6167 :
6168 : /* Add the WHERE clause if given */
6169 4678 : if (query->jointree->quals != NULL)
6170 : {
6171 1484 : appendContextKeyword(context, " WHERE ",
6172 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 1);
6173 1484 : get_rule_expr(query->jointree->quals, context, false);
6174 : }
6175 :
6176 : /* Add the GROUP BY clause if given */
6177 4678 : if (query->groupClause != NULL || query->groupingSets != NULL)
6178 : {
6179 : bool save_ingroupby;
6180 :
6181 220 : appendContextKeyword(context, " GROUP BY ",
6182 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 1);
6183 220 : if (query->groupDistinct)
6184 0 : appendStringInfoString(buf, "DISTINCT ");
6185 :
6186 220 : save_ingroupby = context->inGroupBy;
6187 220 : context->inGroupBy = true;
6188 :
6189 220 : if (query->groupByAll)
6190 6 : appendStringInfoString(buf, "ALL");
6191 214 : else if (query->groupingSets == NIL)
6192 : {
6193 208 : sep = "";
6194 474 : foreach(l, query->groupClause)
6195 : {
6196 266 : SortGroupClause *grp = (SortGroupClause *) lfirst(l);
6197 :
6198 266 : appendStringInfoString(buf, sep);
6199 266 : get_rule_sortgroupclause(grp->tleSortGroupRef, query->targetList,
6200 : false, context);
6201 266 : sep = ", ";
6202 : }
6203 : }
6204 : else
6205 : {
6206 6 : sep = "";
6207 12 : foreach(l, query->groupingSets)
6208 : {
6209 6 : GroupingSet *grp = lfirst(l);
6210 :
6211 6 : appendStringInfoString(buf, sep);
6212 6 : get_rule_groupingset(grp, query->targetList, true, context);
6213 6 : sep = ", ";
6214 : }
6215 : }
6216 :
6217 220 : context->inGroupBy = save_ingroupby;
6218 : }
6219 :
6220 : /* Add the HAVING clause if given */
6221 4678 : if (query->havingQual != NULL)
6222 : {
6223 10 : appendContextKeyword(context, " HAVING ",
6224 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 0);
6225 10 : get_rule_expr(query->havingQual, context, false);
6226 : }
6227 :
6228 : /* Add the WINDOW clause if needed */
6229 4678 : if (query->windowClause != NIL)
6230 48 : get_rule_windowclause(query, context);
6231 : }
6232 :
6233 : /* ----------
6234 : * get_target_list - Parse back a SELECT target list
6235 : *
6236 : * This is also used for RETURNING lists in INSERT/UPDATE/DELETE/MERGE.
6237 : * ----------
6238 : */
6239 : static void
6240 4824 : get_target_list(List *targetList, deparse_context *context)
6241 : {
6242 4824 : StringInfo buf = context->buf;
6243 : StringInfoData targetbuf;
6244 4824 : bool last_was_multiline = false;
6245 : char *sep;
6246 : int colno;
6247 : ListCell *l;
6248 :
6249 : /* we use targetbuf to hold each TLE's text temporarily */
6250 4824 : initStringInfo(&targetbuf);
6251 :
6252 4824 : sep = " ";
6253 4824 : colno = 0;
6254 25118 : foreach(l, targetList)
6255 : {
6256 20294 : TargetEntry *tle = (TargetEntry *) lfirst(l);
6257 : char *colname;
6258 : char *attname;
6259 :
6260 20294 : if (tle->resjunk)
6261 34 : continue; /* ignore junk entries */
6262 :
6263 20260 : appendStringInfoString(buf, sep);
6264 20260 : sep = ", ";
6265 20260 : colno++;
6266 :
6267 : /*
6268 : * Put the new field text into targetbuf so we can decide after we've
6269 : * got it whether or not it needs to go on a new line.
6270 : */
6271 20260 : resetStringInfo(&targetbuf);
6272 20260 : context->buf = &targetbuf;
6273 :
6274 : /*
6275 : * We special-case Var nodes rather than using get_rule_expr. This is
6276 : * needed because get_rule_expr will display a whole-row Var as
6277 : * "foo.*", which is the preferred notation in most contexts, but at
6278 : * the top level of a SELECT list it's not right (the parser will
6279 : * expand that notation into multiple columns, yielding behavior
6280 : * different from a whole-row Var). We need to call get_variable
6281 : * directly so that we can tell it to do the right thing, and so that
6282 : * we can get the attribute name which is the default AS label.
6283 : */
6284 20260 : if (tle->expr && (IsA(tle->expr, Var)))
6285 : {
6286 15632 : attname = get_variable((Var *) tle->expr, 0, true, context);
6287 : }
6288 : else
6289 : {
6290 4628 : get_rule_expr((Node *) tle->expr, context, true);
6291 :
6292 : /*
6293 : * When colNamesVisible is true, we should always show the
6294 : * assigned column name explicitly. Otherwise, show it only if
6295 : * it's not FigureColname's fallback.
6296 : */
6297 4628 : attname = context->colNamesVisible ? NULL : "?column?";
6298 : }
6299 :
6300 : /*
6301 : * Figure out what the result column should be called. In the context
6302 : * of a view, use the view's tuple descriptor (so as to pick up the
6303 : * effects of any column RENAME that's been done on the view).
6304 : * Otherwise, just use what we can find in the TLE.
6305 : */
6306 20260 : if (context->resultDesc && colno <= context->resultDesc->natts)
6307 18448 : colname = NameStr(TupleDescAttr(context->resultDesc,
6308 : colno - 1)->attname);
6309 : else
6310 1812 : colname = tle->resname;
6311 :
6312 : /* Show AS unless the column's name is correct as-is */
6313 20260 : if (colname) /* resname could be NULL */
6314 : {
6315 20208 : if (attname == NULL || strcmp(attname, colname) != 0)
6316 6574 : appendStringInfo(&targetbuf, " AS %s", quote_identifier(colname));
6317 : }
6318 :
6319 : /* Restore context's output buffer */
6320 20260 : context->buf = buf;
6321 :
6322 : /* Consider line-wrapping if enabled */
6323 20260 : if (PRETTY_INDENT(context) && context->wrapColumn >= 0)
6324 : {
6325 : int leading_nl_pos;
6326 :
6327 : /* Does the new field start with a new line? */
6328 20214 : if (targetbuf.len > 0 && targetbuf.data[0] == '\n')
6329 482 : leading_nl_pos = 0;
6330 : else
6331 19732 : leading_nl_pos = -1;
6332 :
6333 : /* If so, we shouldn't add anything */
6334 20214 : if (leading_nl_pos >= 0)
6335 : {
6336 : /* instead, remove any trailing spaces currently in buf */
6337 482 : removeStringInfoSpaces(buf);
6338 : }
6339 : else
6340 : {
6341 : char *trailing_nl;
6342 :
6343 : /* Locate the start of the current line in the output buffer */
6344 19732 : trailing_nl = strrchr(buf->data, '\n');
6345 19732 : if (trailing_nl == NULL)
6346 5924 : trailing_nl = buf->data;
6347 : else
6348 13808 : trailing_nl++;
6349 :
6350 : /*
6351 : * Add a newline, plus some indentation, if the new field is
6352 : * not the first and either the new field would cause an
6353 : * overflow or the last field used more than one line.
6354 : */
6355 19732 : if (colno > 1 &&
6356 14970 : ((strlen(trailing_nl) + targetbuf.len > context->wrapColumn) ||
6357 : last_was_multiline))
6358 14970 : appendContextKeyword(context, "", -PRETTYINDENT_STD,
6359 : PRETTYINDENT_STD, PRETTYINDENT_VAR);
6360 : }
6361 :
6362 : /* Remember this field's multiline status for next iteration */
6363 20214 : last_was_multiline =
6364 20214 : (strchr(targetbuf.data + leading_nl_pos + 1, '\n') != NULL);
6365 : }
6366 :
6367 : /* Add the new field */
6368 20260 : appendBinaryStringInfo(buf, targetbuf.data, targetbuf.len);
6369 : }
6370 :
6371 : /* clean up */
6372 4824 : pfree(targetbuf.data);
6373 4824 : }
6374 :
6375 : static void
6376 146 : get_returning_clause(Query *query, deparse_context *context)
6377 : {
6378 146 : StringInfo buf = context->buf;
6379 :
6380 146 : if (query->returningList)
6381 : {
6382 146 : bool have_with = false;
6383 :
6384 146 : appendContextKeyword(context, " RETURNING",
6385 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 1);
6386 :
6387 : /* Add WITH (OLD/NEW) options, if they're not the defaults */
6388 146 : if (query->returningOldAlias && strcmp(query->returningOldAlias, "old") != 0)
6389 : {
6390 18 : appendStringInfo(buf, " WITH (OLD AS %s",
6391 18 : quote_identifier(query->returningOldAlias));
6392 18 : have_with = true;
6393 : }
6394 146 : if (query->returningNewAlias && strcmp(query->returningNewAlias, "new") != 0)
6395 : {
6396 18 : if (have_with)
6397 12 : appendStringInfo(buf, ", NEW AS %s",
6398 12 : quote_identifier(query->returningNewAlias));
6399 : else
6400 : {
6401 6 : appendStringInfo(buf, " WITH (NEW AS %s",
6402 6 : quote_identifier(query->returningNewAlias));
6403 6 : have_with = true;
6404 : }
6405 : }
6406 146 : if (have_with)
6407 24 : appendStringInfoChar(buf, ')');
6408 :
6409 : /* Add the returning expressions themselves */
6410 146 : get_target_list(query->returningList, context);
6411 : }
6412 146 : }
6413 :
6414 : static void
6415 756 : get_setop_query(Node *setOp, Query *query, deparse_context *context)
6416 : {
6417 756 : StringInfo buf = context->buf;
6418 : bool need_paren;
6419 :
6420 : /* Guard against excessively long or deeply-nested queries */
6421 756 : CHECK_FOR_INTERRUPTS();
6422 756 : check_stack_depth();
6423 :
6424 756 : if (IsA(setOp, RangeTblRef))
6425 : {
6426 460 : RangeTblRef *rtr = (RangeTblRef *) setOp;
6427 460 : RangeTblEntry *rte = rt_fetch(rtr->rtindex, query->rtable);
6428 460 : Query *subquery = rte->subquery;
6429 :
6430 : Assert(subquery != NULL);
6431 :
6432 : /*
6433 : * We need parens if WITH, ORDER BY, FOR UPDATE, or LIMIT; see gram.y.
6434 : * Also add parens if the leaf query contains its own set operations.
6435 : * (That shouldn't happen unless one of the other clauses is also
6436 : * present, see transformSetOperationTree; but let's be safe.)
6437 : */
6438 1380 : need_paren = (subquery->cteList ||
6439 460 : subquery->sortClause ||
6440 460 : subquery->rowMarks ||
6441 460 : subquery->limitOffset ||
6442 1380 : subquery->limitCount ||
6443 460 : subquery->setOperations);
6444 460 : if (need_paren)
6445 0 : appendStringInfoChar(buf, '(');
6446 460 : get_query_def(subquery, buf, context->namespaces,
6447 460 : context->resultDesc, context->colNamesVisible,
6448 : context->prettyFlags, context->wrapColumn,
6449 : context->indentLevel);
6450 460 : if (need_paren)
6451 0 : appendStringInfoChar(buf, ')');
6452 : }
6453 296 : else if (IsA(setOp, SetOperationStmt))
6454 : {
6455 296 : SetOperationStmt *op = (SetOperationStmt *) setOp;
6456 : int subindent;
6457 : bool save_colnamesvisible;
6458 :
6459 : /*
6460 : * We force parens when nesting two SetOperationStmts, except when the
6461 : * lefthand input is another setop of the same kind. Syntactically,
6462 : * we could omit parens in rather more cases, but it seems best to use
6463 : * parens to flag cases where the setop operator changes. If we use
6464 : * parens, we also increase the indentation level for the child query.
6465 : *
6466 : * There are some cases in which parens are needed around a leaf query
6467 : * too, but those are more easily handled at the next level down (see
6468 : * code above).
6469 : */
6470 296 : if (IsA(op->larg, SetOperationStmt))
6471 : {
6472 132 : SetOperationStmt *lop = (SetOperationStmt *) op->larg;
6473 :
6474 132 : if (op->op == lop->op && op->all == lop->all)
6475 132 : need_paren = false;
6476 : else
6477 0 : need_paren = true;
6478 : }
6479 : else
6480 164 : need_paren = false;
6481 :
6482 296 : if (need_paren)
6483 : {
6484 0 : appendStringInfoChar(buf, '(');
6485 0 : subindent = PRETTYINDENT_STD;
6486 0 : appendContextKeyword(context, "", subindent, 0, 0);
6487 : }
6488 : else
6489 296 : subindent = 0;
6490 :
6491 296 : get_setop_query(op->larg, query, context);
6492 :
6493 296 : if (need_paren)
6494 0 : appendContextKeyword(context, ") ", -subindent, 0, 0);
6495 296 : else if (PRETTY_INDENT(context))
6496 296 : appendContextKeyword(context, "", -subindent, 0, 0);
6497 : else
6498 0 : appendStringInfoChar(buf, ' ');
6499 :
6500 296 : switch (op->op)
6501 : {
6502 296 : case SETOP_UNION:
6503 296 : appendStringInfoString(buf, "UNION ");
6504 296 : break;
6505 0 : case SETOP_INTERSECT:
6506 0 : appendStringInfoString(buf, "INTERSECT ");
6507 0 : break;
6508 0 : case SETOP_EXCEPT:
6509 0 : appendStringInfoString(buf, "EXCEPT ");
6510 0 : break;
6511 0 : default:
6512 0 : elog(ERROR, "unrecognized set op: %d",
6513 : (int) op->op);
6514 : }
6515 296 : if (op->all)
6516 284 : appendStringInfoString(buf, "ALL ");
6517 :
6518 : /* Always parenthesize if RHS is another setop */
6519 296 : need_paren = IsA(op->rarg, SetOperationStmt);
6520 :
6521 : /*
6522 : * The indentation code here is deliberately a bit different from that
6523 : * for the lefthand input, because we want the line breaks in
6524 : * different places.
6525 : */
6526 296 : if (need_paren)
6527 : {
6528 0 : appendStringInfoChar(buf, '(');
6529 0 : subindent = PRETTYINDENT_STD;
6530 : }
6531 : else
6532 296 : subindent = 0;
6533 296 : appendContextKeyword(context, "", subindent, 0, 0);
6534 :
6535 : /*
6536 : * The output column names of the RHS sub-select don't matter.
6537 : */
6538 296 : save_colnamesvisible = context->colNamesVisible;
6539 296 : context->colNamesVisible = false;
6540 :
6541 296 : get_setop_query(op->rarg, query, context);
6542 :
6543 296 : context->colNamesVisible = save_colnamesvisible;
6544 :
6545 296 : if (PRETTY_INDENT(context))
6546 296 : context->indentLevel -= subindent;
6547 296 : if (need_paren)
6548 0 : appendContextKeyword(context, ")", 0, 0, 0);
6549 : }
6550 : else
6551 : {
6552 0 : elog(ERROR, "unrecognized node type: %d",
6553 : (int) nodeTag(setOp));
6554 : }
6555 756 : }
6556 :
6557 : /*
6558 : * Display a sort/group clause.
6559 : *
6560 : * Also returns the expression tree, so caller need not find it again.
6561 : */
6562 : static Node *
6563 666 : get_rule_sortgroupclause(Index ref, List *tlist, bool force_colno,
6564 : deparse_context *context)
6565 : {
6566 666 : StringInfo buf = context->buf;
6567 : TargetEntry *tle;
6568 : Node *expr;
6569 :
6570 666 : tle = get_sortgroupref_tle(ref, tlist);
6571 666 : expr = (Node *) tle->expr;
6572 :
6573 : /*
6574 : * Use column-number form if requested by caller. Otherwise, if
6575 : * expression is a constant, force it to be dumped with an explicit cast
6576 : * as decoration --- this is because a simple integer constant is
6577 : * ambiguous (and will be misinterpreted by findTargetlistEntrySQL92()) if
6578 : * we dump it without any decoration. Similarly, if it's just a Var,
6579 : * there is risk of misinterpretation if the column name is reassigned in
6580 : * the SELECT list, so we may need to force table qualification. And, if
6581 : * it's anything more complex than a simple Var, then force extra parens
6582 : * around it, to ensure it can't be misinterpreted as a cube() or rollup()
6583 : * construct.
6584 : */
6585 666 : if (force_colno)
6586 : {
6587 : Assert(!tle->resjunk);
6588 12 : appendStringInfo(buf, "%d", tle->resno);
6589 : }
6590 654 : else if (!expr)
6591 : /* do nothing, probably can't happen */ ;
6592 654 : else if (IsA(expr, Const))
6593 0 : get_const_expr((Const *) expr, context, 1);
6594 654 : else if (IsA(expr, Var))
6595 : {
6596 : /* Tell get_variable to check for name conflict */
6597 626 : bool save_varinorderby = context->varInOrderBy;
6598 :
6599 626 : context->varInOrderBy = true;
6600 626 : (void) get_variable((Var *) expr, 0, false, context);
6601 626 : context->varInOrderBy = save_varinorderby;
6602 : }
6603 : else
6604 : {
6605 : /*
6606 : * We must force parens for function-like expressions even if
6607 : * PRETTY_PAREN is off, since those are the ones in danger of
6608 : * misparsing. For other expressions we need to force them only if
6609 : * PRETTY_PAREN is on, since otherwise the expression will output them
6610 : * itself. (We can't skip the parens.)
6611 : */
6612 56 : bool need_paren = (PRETTY_PAREN(context)
6613 28 : || IsA(expr, FuncExpr)
6614 24 : || IsA(expr, Aggref)
6615 24 : || IsA(expr, WindowFunc)
6616 56 : || IsA(expr, JsonConstructorExpr));
6617 :
6618 28 : if (need_paren)
6619 4 : appendStringInfoChar(context->buf, '(');
6620 28 : get_rule_expr(expr, context, true);
6621 28 : if (need_paren)
6622 4 : appendStringInfoChar(context->buf, ')');
6623 : }
6624 :
6625 666 : return expr;
6626 : }
6627 :
6628 : /*
6629 : * Display a GroupingSet
6630 : */
6631 : static void
6632 18 : get_rule_groupingset(GroupingSet *gset, List *targetlist,
6633 : bool omit_parens, deparse_context *context)
6634 : {
6635 : ListCell *l;
6636 18 : StringInfo buf = context->buf;
6637 18 : bool omit_child_parens = true;
6638 18 : char *sep = "";
6639 :
6640 18 : switch (gset->kind)
6641 : {
6642 0 : case GROUPING_SET_EMPTY:
6643 0 : appendStringInfoString(buf, "()");
6644 0 : return;
6645 :
6646 12 : case GROUPING_SET_SIMPLE:
6647 : {
6648 12 : if (!omit_parens || list_length(gset->content) != 1)
6649 12 : appendStringInfoChar(buf, '(');
6650 :
6651 42 : foreach(l, gset->content)
6652 : {
6653 30 : Index ref = lfirst_int(l);
6654 :
6655 30 : appendStringInfoString(buf, sep);
6656 30 : get_rule_sortgroupclause(ref, targetlist,
6657 : false, context);
6658 30 : sep = ", ";
6659 : }
6660 :
6661 12 : if (!omit_parens || list_length(gset->content) != 1)
6662 12 : appendStringInfoChar(buf, ')');
6663 : }
6664 12 : return;
6665 :
6666 6 : case GROUPING_SET_ROLLUP:
6667 6 : appendStringInfoString(buf, "ROLLUP(");
6668 6 : break;
6669 0 : case GROUPING_SET_CUBE:
6670 0 : appendStringInfoString(buf, "CUBE(");
6671 0 : break;
6672 0 : case GROUPING_SET_SETS:
6673 0 : appendStringInfoString(buf, "GROUPING SETS (");
6674 0 : omit_child_parens = false;
6675 0 : break;
6676 : }
6677 :
6678 18 : foreach(l, gset->content)
6679 : {
6680 12 : appendStringInfoString(buf, sep);
6681 12 : get_rule_groupingset(lfirst(l), targetlist, omit_child_parens, context);
6682 12 : sep = ", ";
6683 : }
6684 :
6685 6 : appendStringInfoChar(buf, ')');
6686 : }
6687 :
6688 : /*
6689 : * Display an ORDER BY list.
6690 : */
6691 : static void
6692 338 : get_rule_orderby(List *orderList, List *targetList,
6693 : bool force_colno, deparse_context *context)
6694 : {
6695 338 : StringInfo buf = context->buf;
6696 : const char *sep;
6697 : ListCell *l;
6698 :
6699 338 : sep = "";
6700 708 : foreach(l, orderList)
6701 : {
6702 370 : SortGroupClause *srt = (SortGroupClause *) lfirst(l);
6703 : Node *sortexpr;
6704 : Oid sortcoltype;
6705 : TypeCacheEntry *typentry;
6706 :
6707 370 : appendStringInfoString(buf, sep);
6708 370 : sortexpr = get_rule_sortgroupclause(srt->tleSortGroupRef, targetList,
6709 : force_colno, context);
6710 370 : sortcoltype = exprType(sortexpr);
6711 : /* See whether operator is default < or > for datatype */
6712 370 : typentry = lookup_type_cache(sortcoltype,
6713 : TYPECACHE_LT_OPR | TYPECACHE_GT_OPR);
6714 370 : if (srt->sortop == typentry->lt_opr)
6715 : {
6716 : /* ASC is default, so emit nothing for it */
6717 342 : if (srt->nulls_first)
6718 0 : appendStringInfoString(buf, " NULLS FIRST");
6719 : }
6720 28 : else if (srt->sortop == typentry->gt_opr)
6721 : {
6722 10 : appendStringInfoString(buf, " DESC");
6723 : /* DESC defaults to NULLS FIRST */
6724 10 : if (!srt->nulls_first)
6725 2 : appendStringInfoString(buf, " NULLS LAST");
6726 : }
6727 : else
6728 : {
6729 18 : appendStringInfo(buf, " USING %s",
6730 : generate_operator_name(srt->sortop,
6731 : sortcoltype,
6732 : sortcoltype));
6733 : /* be specific to eliminate ambiguity */
6734 18 : if (srt->nulls_first)
6735 0 : appendStringInfoString(buf, " NULLS FIRST");
6736 : else
6737 18 : appendStringInfoString(buf, " NULLS LAST");
6738 : }
6739 370 : sep = ", ";
6740 : }
6741 338 : }
6742 :
6743 : /*
6744 : * Display a WINDOW clause.
6745 : *
6746 : * Note that the windowClause list might contain only anonymous window
6747 : * specifications, in which case we should print nothing here.
6748 : */
6749 : static void
6750 48 : get_rule_windowclause(Query *query, deparse_context *context)
6751 : {
6752 48 : StringInfo buf = context->buf;
6753 : const char *sep;
6754 : ListCell *l;
6755 :
6756 48 : sep = NULL;
6757 96 : foreach(l, query->windowClause)
6758 : {
6759 48 : WindowClause *wc = (WindowClause *) lfirst(l);
6760 :
6761 48 : if (wc->name == NULL)
6762 42 : continue; /* ignore anonymous windows */
6763 :
6764 6 : if (sep == NULL)
6765 6 : appendContextKeyword(context, " WINDOW ",
6766 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 1);
6767 : else
6768 0 : appendStringInfoString(buf, sep);
6769 :
6770 6 : appendStringInfo(buf, "%s AS ", quote_identifier(wc->name));
6771 :
6772 6 : get_rule_windowspec(wc, query->targetList, context);
6773 :
6774 6 : sep = ", ";
6775 : }
6776 48 : }
6777 :
6778 : /*
6779 : * Display a window definition
6780 : */
6781 : static void
6782 48 : get_rule_windowspec(WindowClause *wc, List *targetList,
6783 : deparse_context *context)
6784 : {
6785 48 : StringInfo buf = context->buf;
6786 48 : bool needspace = false;
6787 : const char *sep;
6788 : ListCell *l;
6789 :
6790 48 : appendStringInfoChar(buf, '(');
6791 48 : if (wc->refname)
6792 : {
6793 0 : appendStringInfoString(buf, quote_identifier(wc->refname));
6794 0 : needspace = true;
6795 : }
6796 : /* partition clauses are always inherited, so only print if no refname */
6797 48 : if (wc->partitionClause && !wc->refname)
6798 : {
6799 0 : if (needspace)
6800 0 : appendStringInfoChar(buf, ' ');
6801 0 : appendStringInfoString(buf, "PARTITION BY ");
6802 0 : sep = "";
6803 0 : foreach(l, wc->partitionClause)
6804 : {
6805 0 : SortGroupClause *grp = (SortGroupClause *) lfirst(l);
6806 :
6807 0 : appendStringInfoString(buf, sep);
6808 0 : get_rule_sortgroupclause(grp->tleSortGroupRef, targetList,
6809 : false, context);
6810 0 : sep = ", ";
6811 : }
6812 0 : needspace = true;
6813 : }
6814 : /* print ordering clause only if not inherited */
6815 48 : if (wc->orderClause && !wc->copiedOrder)
6816 : {
6817 48 : if (needspace)
6818 0 : appendStringInfoChar(buf, ' ');
6819 48 : appendStringInfoString(buf, "ORDER BY ");
6820 48 : get_rule_orderby(wc->orderClause, targetList, false, context);
6821 48 : needspace = true;
6822 : }
6823 : /* framing clause is never inherited, so print unless it's default */
6824 48 : if (wc->frameOptions & FRAMEOPTION_NONDEFAULT)
6825 : {
6826 42 : if (needspace)
6827 42 : appendStringInfoChar(buf, ' ');
6828 42 : get_window_frame_options(wc->frameOptions,
6829 : wc->startOffset, wc->endOffset,
6830 : context);
6831 : }
6832 48 : appendStringInfoChar(buf, ')');
6833 48 : }
6834 :
6835 : /*
6836 : * Append the description of a window's framing options to context->buf
6837 : */
6838 : static void
6839 238 : get_window_frame_options(int frameOptions,
6840 : Node *startOffset, Node *endOffset,
6841 : deparse_context *context)
6842 : {
6843 238 : StringInfo buf = context->buf;
6844 :
6845 238 : if (frameOptions & FRAMEOPTION_NONDEFAULT)
6846 : {
6847 238 : if (frameOptions & FRAMEOPTION_RANGE)
6848 20 : appendStringInfoString(buf, "RANGE ");
6849 218 : else if (frameOptions & FRAMEOPTION_ROWS)
6850 206 : appendStringInfoString(buf, "ROWS ");
6851 12 : else if (frameOptions & FRAMEOPTION_GROUPS)
6852 12 : appendStringInfoString(buf, "GROUPS ");
6853 : else
6854 : Assert(false);
6855 238 : if (frameOptions & FRAMEOPTION_BETWEEN)
6856 92 : appendStringInfoString(buf, "BETWEEN ");
6857 238 : if (frameOptions & FRAMEOPTION_START_UNBOUNDED_PRECEDING)
6858 152 : appendStringInfoString(buf, "UNBOUNDED PRECEDING ");
6859 86 : else if (frameOptions & FRAMEOPTION_START_CURRENT_ROW)
6860 26 : appendStringInfoString(buf, "CURRENT ROW ");
6861 60 : else if (frameOptions & FRAMEOPTION_START_OFFSET)
6862 : {
6863 60 : get_rule_expr(startOffset, context, false);
6864 60 : if (frameOptions & FRAMEOPTION_START_OFFSET_PRECEDING)
6865 60 : appendStringInfoString(buf, " PRECEDING ");
6866 0 : else if (frameOptions & FRAMEOPTION_START_OFFSET_FOLLOWING)
6867 0 : appendStringInfoString(buf, " FOLLOWING ");
6868 : else
6869 : Assert(false);
6870 : }
6871 : else
6872 : Assert(false);
6873 238 : if (frameOptions & FRAMEOPTION_BETWEEN)
6874 : {
6875 92 : appendStringInfoString(buf, "AND ");
6876 92 : if (frameOptions & FRAMEOPTION_END_UNBOUNDED_FOLLOWING)
6877 20 : appendStringInfoString(buf, "UNBOUNDED FOLLOWING ");
6878 72 : else if (frameOptions & FRAMEOPTION_END_CURRENT_ROW)
6879 6 : appendStringInfoString(buf, "CURRENT ROW ");
6880 66 : else if (frameOptions & FRAMEOPTION_END_OFFSET)
6881 : {
6882 66 : get_rule_expr(endOffset, context, false);
6883 66 : if (frameOptions & FRAMEOPTION_END_OFFSET_PRECEDING)
6884 0 : appendStringInfoString(buf, " PRECEDING ");
6885 66 : else if (frameOptions & FRAMEOPTION_END_OFFSET_FOLLOWING)
6886 66 : appendStringInfoString(buf, " FOLLOWING ");
6887 : else
6888 : Assert(false);
6889 : }
6890 : else
6891 : Assert(false);
6892 : }
6893 238 : if (frameOptions & FRAMEOPTION_EXCLUDE_CURRENT_ROW)
6894 6 : appendStringInfoString(buf, "EXCLUDE CURRENT ROW ");
6895 232 : else if (frameOptions & FRAMEOPTION_EXCLUDE_GROUP)
6896 6 : appendStringInfoString(buf, "EXCLUDE GROUP ");
6897 226 : else if (frameOptions & FRAMEOPTION_EXCLUDE_TIES)
6898 6 : appendStringInfoString(buf, "EXCLUDE TIES ");
6899 : /* we will now have a trailing space; remove it */
6900 238 : buf->data[--(buf->len)] = '\0';
6901 : }
6902 238 : }
6903 :
6904 : /*
6905 : * Return the description of a window's framing options as a palloc'd string
6906 : */
6907 : char *
6908 196 : get_window_frame_options_for_explain(int frameOptions,
6909 : Node *startOffset, Node *endOffset,
6910 : List *dpcontext, bool forceprefix)
6911 : {
6912 : StringInfoData buf;
6913 : deparse_context context;
6914 :
6915 196 : initStringInfo(&buf);
6916 196 : context.buf = &buf;
6917 196 : context.namespaces = dpcontext;
6918 196 : context.resultDesc = NULL;
6919 196 : context.targetList = NIL;
6920 196 : context.windowClause = NIL;
6921 196 : context.varprefix = forceprefix;
6922 196 : context.prettyFlags = 0;
6923 196 : context.wrapColumn = WRAP_COLUMN_DEFAULT;
6924 196 : context.indentLevel = 0;
6925 196 : context.colNamesVisible = true;
6926 196 : context.inGroupBy = false;
6927 196 : context.varInOrderBy = false;
6928 196 : context.appendparents = NULL;
6929 :
6930 196 : get_window_frame_options(frameOptions, startOffset, endOffset, &context);
6931 :
6932 196 : return buf.data;
6933 : }
6934 :
6935 : /* ----------
6936 : * get_insert_query_def - Parse back an INSERT parsetree
6937 : * ----------
6938 : */
6939 : static void
6940 340 : get_insert_query_def(Query *query, deparse_context *context)
6941 : {
6942 340 : StringInfo buf = context->buf;
6943 340 : RangeTblEntry *select_rte = NULL;
6944 340 : RangeTblEntry *values_rte = NULL;
6945 : RangeTblEntry *rte;
6946 : char *sep;
6947 : ListCell *l;
6948 : List *strippedexprs;
6949 :
6950 : /* Insert the WITH clause if given */
6951 340 : get_with_clause(query, context);
6952 :
6953 : /*
6954 : * If it's an INSERT ... SELECT or multi-row VALUES, there will be a
6955 : * single RTE for the SELECT or VALUES. Plain VALUES has neither.
6956 : */
6957 1322 : foreach(l, query->rtable)
6958 : {
6959 982 : rte = (RangeTblEntry *) lfirst(l);
6960 :
6961 982 : if (rte->rtekind == RTE_SUBQUERY)
6962 : {
6963 50 : if (select_rte)
6964 0 : elog(ERROR, "too many subquery RTEs in INSERT");
6965 50 : select_rte = rte;
6966 : }
6967 :
6968 982 : if (rte->rtekind == RTE_VALUES)
6969 : {
6970 44 : if (values_rte)
6971 0 : elog(ERROR, "too many values RTEs in INSERT");
6972 44 : values_rte = rte;
6973 : }
6974 : }
6975 340 : if (select_rte && values_rte)
6976 0 : elog(ERROR, "both subquery and values RTEs in INSERT");
6977 :
6978 : /*
6979 : * Start the query with INSERT INTO relname
6980 : */
6981 340 : rte = rt_fetch(query->resultRelation, query->rtable);
6982 : Assert(rte->rtekind == RTE_RELATION);
6983 :
6984 340 : if (PRETTY_INDENT(context))
6985 : {
6986 340 : context->indentLevel += PRETTYINDENT_STD;
6987 340 : appendStringInfoChar(buf, ' ');
6988 : }
6989 340 : appendStringInfo(buf, "INSERT INTO %s",
6990 : generate_relation_name(rte->relid, NIL));
6991 :
6992 : /* Print the relation alias, if needed; INSERT requires explicit AS */
6993 340 : get_rte_alias(rte, query->resultRelation, true, context);
6994 :
6995 : /* always want a space here */
6996 340 : appendStringInfoChar(buf, ' ');
6997 :
6998 : /*
6999 : * Add the insert-column-names list. Any indirection decoration needed on
7000 : * the column names can be inferred from the top targetlist.
7001 : */
7002 340 : strippedexprs = NIL;
7003 340 : sep = "";
7004 340 : if (query->targetList)
7005 340 : appendStringInfoChar(buf, '(');
7006 1242 : foreach(l, query->targetList)
7007 : {
7008 902 : TargetEntry *tle = (TargetEntry *) lfirst(l);
7009 :
7010 902 : if (tle->resjunk)
7011 0 : continue; /* ignore junk entries */
7012 :
7013 902 : appendStringInfoString(buf, sep);
7014 902 : sep = ", ";
7015 :
7016 : /*
7017 : * Put out name of target column; look in the catalogs, not at
7018 : * tle->resname, since resname will fail to track RENAME.
7019 : */
7020 902 : appendStringInfoString(buf,
7021 902 : quote_identifier(get_attname(rte->relid,
7022 902 : tle->resno,
7023 : false)));
7024 :
7025 : /*
7026 : * Print any indirection needed (subfields or subscripts), and strip
7027 : * off the top-level nodes representing the indirection assignments.
7028 : * Add the stripped expressions to strippedexprs. (If it's a
7029 : * single-VALUES statement, the stripped expressions are the VALUES to
7030 : * print below. Otherwise they're just Vars and not really
7031 : * interesting.)
7032 : */
7033 902 : strippedexprs = lappend(strippedexprs,
7034 902 : processIndirection((Node *) tle->expr,
7035 : context));
7036 : }
7037 340 : if (query->targetList)
7038 340 : appendStringInfoString(buf, ") ");
7039 :
7040 340 : if (query->override)
7041 : {
7042 0 : if (query->override == OVERRIDING_SYSTEM_VALUE)
7043 0 : appendStringInfoString(buf, "OVERRIDING SYSTEM VALUE ");
7044 0 : else if (query->override == OVERRIDING_USER_VALUE)
7045 0 : appendStringInfoString(buf, "OVERRIDING USER VALUE ");
7046 : }
7047 :
7048 340 : if (select_rte)
7049 : {
7050 : /* Add the SELECT */
7051 50 : get_query_def(select_rte->subquery, buf, context->namespaces, NULL,
7052 : false,
7053 : context->prettyFlags, context->wrapColumn,
7054 : context->indentLevel);
7055 : }
7056 290 : else if (values_rte)
7057 : {
7058 : /* Add the multi-VALUES expression lists */
7059 44 : get_values_def(values_rte->values_lists, context);
7060 : }
7061 246 : else if (strippedexprs)
7062 : {
7063 : /* Add the single-VALUES expression list */
7064 246 : appendContextKeyword(context, "VALUES (",
7065 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 2);
7066 246 : get_rule_list_toplevel(strippedexprs, context, false);
7067 246 : appendStringInfoChar(buf, ')');
7068 : }
7069 : else
7070 : {
7071 : /* No expressions, so it must be DEFAULT VALUES */
7072 0 : appendStringInfoString(buf, "DEFAULT VALUES");
7073 : }
7074 :
7075 : /* Add ON CONFLICT if present */
7076 340 : if (query->onConflict)
7077 : {
7078 30 : OnConflictExpr *confl = query->onConflict;
7079 :
7080 30 : appendStringInfoString(buf, " ON CONFLICT");
7081 :
7082 30 : if (confl->arbiterElems)
7083 : {
7084 : /* Add the single-VALUES expression list */
7085 24 : appendStringInfoChar(buf, '(');
7086 24 : get_rule_expr((Node *) confl->arbiterElems, context, false);
7087 24 : appendStringInfoChar(buf, ')');
7088 :
7089 : /* Add a WHERE clause (for partial indexes) if given */
7090 24 : if (confl->arbiterWhere != NULL)
7091 : {
7092 : bool save_varprefix;
7093 :
7094 : /*
7095 : * Force non-prefixing of Vars, since parser assumes that they
7096 : * belong to target relation. WHERE clause does not use
7097 : * InferenceElem, so this is separately required.
7098 : */
7099 12 : save_varprefix = context->varprefix;
7100 12 : context->varprefix = false;
7101 :
7102 12 : appendContextKeyword(context, " WHERE ",
7103 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 1);
7104 12 : get_rule_expr(confl->arbiterWhere, context, false);
7105 :
7106 12 : context->varprefix = save_varprefix;
7107 : }
7108 : }
7109 6 : else if (OidIsValid(confl->constraint))
7110 : {
7111 0 : char *constraint = get_constraint_name(confl->constraint);
7112 :
7113 0 : if (!constraint)
7114 0 : elog(ERROR, "cache lookup failed for constraint %u",
7115 : confl->constraint);
7116 0 : appendStringInfo(buf, " ON CONSTRAINT %s",
7117 : quote_identifier(constraint));
7118 : }
7119 :
7120 30 : if (confl->action == ONCONFLICT_NOTHING)
7121 : {
7122 18 : appendStringInfoString(buf, " DO NOTHING");
7123 : }
7124 : else
7125 : {
7126 12 : appendStringInfoString(buf, " DO UPDATE SET ");
7127 : /* Deparse targetlist */
7128 12 : get_update_query_targetlist_def(query, confl->onConflictSet,
7129 : context, rte);
7130 :
7131 : /* Add a WHERE clause if given */
7132 12 : if (confl->onConflictWhere != NULL)
7133 : {
7134 12 : appendContextKeyword(context, " WHERE ",
7135 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 1);
7136 12 : get_rule_expr(confl->onConflictWhere, context, false);
7137 : }
7138 : }
7139 : }
7140 :
7141 : /* Add RETURNING if present */
7142 340 : if (query->returningList)
7143 78 : get_returning_clause(query, context);
7144 340 : }
7145 :
7146 :
7147 : /* ----------
7148 : * get_update_query_def - Parse back an UPDATE parsetree
7149 : * ----------
7150 : */
7151 : static void
7152 154 : get_update_query_def(Query *query, deparse_context *context)
7153 : {
7154 154 : StringInfo buf = context->buf;
7155 : RangeTblEntry *rte;
7156 :
7157 : /* Insert the WITH clause if given */
7158 154 : get_with_clause(query, context);
7159 :
7160 : /*
7161 : * Start the query with UPDATE relname SET
7162 : */
7163 154 : rte = rt_fetch(query->resultRelation, query->rtable);
7164 : Assert(rte->rtekind == RTE_RELATION);
7165 154 : if (PRETTY_INDENT(context))
7166 : {
7167 154 : appendStringInfoChar(buf, ' ');
7168 154 : context->indentLevel += PRETTYINDENT_STD;
7169 : }
7170 308 : appendStringInfo(buf, "UPDATE %s%s",
7171 154 : only_marker(rte),
7172 : generate_relation_name(rte->relid, NIL));
7173 :
7174 : /* Print the relation alias, if needed */
7175 154 : get_rte_alias(rte, query->resultRelation, false, context);
7176 :
7177 154 : appendStringInfoString(buf, " SET ");
7178 :
7179 : /* Deparse targetlist */
7180 154 : get_update_query_targetlist_def(query, query->targetList, context, rte);
7181 :
7182 : /* Add the FROM clause if needed */
7183 154 : get_from_clause(query, " FROM ", context);
7184 :
7185 : /* Add a WHERE clause if given */
7186 154 : if (query->jointree->quals != NULL)
7187 : {
7188 114 : appendContextKeyword(context, " WHERE ",
7189 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 1);
7190 114 : get_rule_expr(query->jointree->quals, context, false);
7191 : }
7192 :
7193 : /* Add RETURNING if present */
7194 154 : if (query->returningList)
7195 46 : get_returning_clause(query, context);
7196 154 : }
7197 :
7198 :
7199 : /* ----------
7200 : * get_update_query_targetlist_def - Parse back an UPDATE targetlist
7201 : * ----------
7202 : */
7203 : static void
7204 190 : get_update_query_targetlist_def(Query *query, List *targetList,
7205 : deparse_context *context, RangeTblEntry *rte)
7206 : {
7207 190 : StringInfo buf = context->buf;
7208 : ListCell *l;
7209 : ListCell *next_ma_cell;
7210 : int remaining_ma_columns;
7211 : const char *sep;
7212 : SubLink *cur_ma_sublink;
7213 : List *ma_sublinks;
7214 :
7215 : /*
7216 : * Prepare to deal with MULTIEXPR assignments: collect the source SubLinks
7217 : * into a list. We expect them to appear, in ID order, in resjunk tlist
7218 : * entries.
7219 : */
7220 190 : ma_sublinks = NIL;
7221 190 : if (query->hasSubLinks) /* else there can't be any */
7222 : {
7223 42 : foreach(l, targetList)
7224 : {
7225 30 : TargetEntry *tle = (TargetEntry *) lfirst(l);
7226 :
7227 30 : if (tle->resjunk && IsA(tle->expr, SubLink))
7228 : {
7229 6 : SubLink *sl = (SubLink *) tle->expr;
7230 :
7231 6 : if (sl->subLinkType == MULTIEXPR_SUBLINK)
7232 : {
7233 6 : ma_sublinks = lappend(ma_sublinks, sl);
7234 : Assert(sl->subLinkId == list_length(ma_sublinks));
7235 : }
7236 : }
7237 : }
7238 : }
7239 190 : next_ma_cell = list_head(ma_sublinks);
7240 190 : cur_ma_sublink = NULL;
7241 190 : remaining_ma_columns = 0;
7242 :
7243 : /* Add the comma separated list of 'attname = value' */
7244 190 : sep = "";
7245 488 : foreach(l, targetList)
7246 : {
7247 298 : TargetEntry *tle = (TargetEntry *) lfirst(l);
7248 : Node *expr;
7249 :
7250 298 : if (tle->resjunk)
7251 6 : continue; /* ignore junk entries */
7252 :
7253 : /* Emit separator (OK whether we're in multiassignment or not) */
7254 292 : appendStringInfoString(buf, sep);
7255 292 : sep = ", ";
7256 :
7257 : /*
7258 : * Check to see if we're starting a multiassignment group: if so,
7259 : * output a left paren.
7260 : */
7261 292 : if (next_ma_cell != NULL && cur_ma_sublink == NULL)
7262 : {
7263 : /*
7264 : * We must dig down into the expr to see if it's a PARAM_MULTIEXPR
7265 : * Param. That could be buried under FieldStores and
7266 : * SubscriptingRefs and CoerceToDomains (cf processIndirection()),
7267 : * and underneath those there could be an implicit type coercion.
7268 : * Because we would ignore implicit type coercions anyway, we
7269 : * don't need to be as careful as processIndirection() is about
7270 : * descending past implicit CoerceToDomains.
7271 : */
7272 6 : expr = (Node *) tle->expr;
7273 12 : while (expr)
7274 : {
7275 12 : if (IsA(expr, FieldStore))
7276 : {
7277 0 : FieldStore *fstore = (FieldStore *) expr;
7278 :
7279 0 : expr = (Node *) linitial(fstore->newvals);
7280 : }
7281 12 : else if (IsA(expr, SubscriptingRef))
7282 : {
7283 6 : SubscriptingRef *sbsref = (SubscriptingRef *) expr;
7284 :
7285 6 : if (sbsref->refassgnexpr == NULL)
7286 0 : break;
7287 :
7288 6 : expr = (Node *) sbsref->refassgnexpr;
7289 : }
7290 6 : else if (IsA(expr, CoerceToDomain))
7291 : {
7292 0 : CoerceToDomain *cdomain = (CoerceToDomain *) expr;
7293 :
7294 0 : if (cdomain->coercionformat != COERCE_IMPLICIT_CAST)
7295 0 : break;
7296 0 : expr = (Node *) cdomain->arg;
7297 : }
7298 : else
7299 6 : break;
7300 : }
7301 6 : expr = strip_implicit_coercions(expr);
7302 :
7303 6 : if (expr && IsA(expr, Param) &&
7304 6 : ((Param *) expr)->paramkind == PARAM_MULTIEXPR)
7305 : {
7306 6 : cur_ma_sublink = (SubLink *) lfirst(next_ma_cell);
7307 6 : next_ma_cell = lnext(ma_sublinks, next_ma_cell);
7308 6 : remaining_ma_columns = count_nonjunk_tlist_entries(((Query *) cur_ma_sublink->subselect)->targetList);
7309 : Assert(((Param *) expr)->paramid ==
7310 : ((cur_ma_sublink->subLinkId << 16) | 1));
7311 6 : appendStringInfoChar(buf, '(');
7312 : }
7313 : }
7314 :
7315 : /*
7316 : * Put out name of target column; look in the catalogs, not at
7317 : * tle->resname, since resname will fail to track RENAME.
7318 : */
7319 292 : appendStringInfoString(buf,
7320 292 : quote_identifier(get_attname(rte->relid,
7321 292 : tle->resno,
7322 : false)));
7323 :
7324 : /*
7325 : * Print any indirection needed (subfields or subscripts), and strip
7326 : * off the top-level nodes representing the indirection assignments.
7327 : */
7328 292 : expr = processIndirection((Node *) tle->expr, context);
7329 :
7330 : /*
7331 : * If we're in a multiassignment, skip printing anything more, unless
7332 : * this is the last column; in which case, what we print should be the
7333 : * sublink, not the Param.
7334 : */
7335 292 : if (cur_ma_sublink != NULL)
7336 : {
7337 18 : if (--remaining_ma_columns > 0)
7338 12 : continue; /* not the last column of multiassignment */
7339 6 : appendStringInfoChar(buf, ')');
7340 6 : expr = (Node *) cur_ma_sublink;
7341 6 : cur_ma_sublink = NULL;
7342 : }
7343 :
7344 280 : appendStringInfoString(buf, " = ");
7345 :
7346 280 : get_rule_expr(expr, context, false);
7347 : }
7348 190 : }
7349 :
7350 :
7351 : /* ----------
7352 : * get_delete_query_def - Parse back a DELETE parsetree
7353 : * ----------
7354 : */
7355 : static void
7356 76 : get_delete_query_def(Query *query, deparse_context *context)
7357 : {
7358 76 : StringInfo buf = context->buf;
7359 : RangeTblEntry *rte;
7360 :
7361 : /* Insert the WITH clause if given */
7362 76 : get_with_clause(query, context);
7363 :
7364 : /*
7365 : * Start the query with DELETE FROM relname
7366 : */
7367 76 : rte = rt_fetch(query->resultRelation, query->rtable);
7368 : Assert(rte->rtekind == RTE_RELATION);
7369 76 : if (PRETTY_INDENT(context))
7370 : {
7371 76 : appendStringInfoChar(buf, ' ');
7372 76 : context->indentLevel += PRETTYINDENT_STD;
7373 : }
7374 152 : appendStringInfo(buf, "DELETE FROM %s%s",
7375 76 : only_marker(rte),
7376 : generate_relation_name(rte->relid, NIL));
7377 :
7378 : /* Print the relation alias, if needed */
7379 76 : get_rte_alias(rte, query->resultRelation, false, context);
7380 :
7381 : /* Add the USING clause if given */
7382 76 : get_from_clause(query, " USING ", context);
7383 :
7384 : /* Add a WHERE clause if given */
7385 76 : if (query->jointree->quals != NULL)
7386 : {
7387 76 : appendContextKeyword(context, " WHERE ",
7388 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 1);
7389 76 : get_rule_expr(query->jointree->quals, context, false);
7390 : }
7391 :
7392 : /* Add RETURNING if present */
7393 76 : if (query->returningList)
7394 16 : get_returning_clause(query, context);
7395 76 : }
7396 :
7397 :
7398 : /* ----------
7399 : * get_merge_query_def - Parse back a MERGE parsetree
7400 : * ----------
7401 : */
7402 : static void
7403 12 : get_merge_query_def(Query *query, deparse_context *context)
7404 : {
7405 12 : StringInfo buf = context->buf;
7406 : RangeTblEntry *rte;
7407 : ListCell *lc;
7408 : bool haveNotMatchedBySource;
7409 :
7410 : /* Insert the WITH clause if given */
7411 12 : get_with_clause(query, context);
7412 :
7413 : /*
7414 : * Start the query with MERGE INTO relname
7415 : */
7416 12 : rte = rt_fetch(query->resultRelation, query->rtable);
7417 : Assert(rte->rtekind == RTE_RELATION);
7418 12 : if (PRETTY_INDENT(context))
7419 : {
7420 12 : appendStringInfoChar(buf, ' ');
7421 12 : context->indentLevel += PRETTYINDENT_STD;
7422 : }
7423 24 : appendStringInfo(buf, "MERGE INTO %s%s",
7424 12 : only_marker(rte),
7425 : generate_relation_name(rte->relid, NIL));
7426 :
7427 : /* Print the relation alias, if needed */
7428 12 : get_rte_alias(rte, query->resultRelation, false, context);
7429 :
7430 : /* Print the source relation and join clause */
7431 12 : get_from_clause(query, " USING ", context);
7432 12 : appendContextKeyword(context, " ON ",
7433 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 2);
7434 12 : get_rule_expr(query->mergeJoinCondition, context, false);
7435 :
7436 : /*
7437 : * Test for any NOT MATCHED BY SOURCE actions. If there are none, then
7438 : * any NOT MATCHED BY TARGET actions are output as "WHEN NOT MATCHED", per
7439 : * SQL standard. Otherwise, we have a non-SQL-standard query, so output
7440 : * "BY SOURCE" / "BY TARGET" qualifiers for all NOT MATCHED actions, to be
7441 : * more explicit.
7442 : */
7443 12 : haveNotMatchedBySource = false;
7444 84 : foreach(lc, query->mergeActionList)
7445 : {
7446 78 : MergeAction *action = lfirst_node(MergeAction, lc);
7447 :
7448 78 : if (action->matchKind == MERGE_WHEN_NOT_MATCHED_BY_SOURCE)
7449 : {
7450 6 : haveNotMatchedBySource = true;
7451 6 : break;
7452 : }
7453 : }
7454 :
7455 : /* Print each merge action */
7456 90 : foreach(lc, query->mergeActionList)
7457 : {
7458 78 : MergeAction *action = lfirst_node(MergeAction, lc);
7459 :
7460 78 : appendContextKeyword(context, " WHEN ",
7461 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 2);
7462 78 : switch (action->matchKind)
7463 : {
7464 36 : case MERGE_WHEN_MATCHED:
7465 36 : appendStringInfoString(buf, "MATCHED");
7466 36 : break;
7467 6 : case MERGE_WHEN_NOT_MATCHED_BY_SOURCE:
7468 6 : appendStringInfoString(buf, "NOT MATCHED BY SOURCE");
7469 6 : break;
7470 36 : case MERGE_WHEN_NOT_MATCHED_BY_TARGET:
7471 36 : if (haveNotMatchedBySource)
7472 6 : appendStringInfoString(buf, "NOT MATCHED BY TARGET");
7473 : else
7474 30 : appendStringInfoString(buf, "NOT MATCHED");
7475 36 : break;
7476 0 : default:
7477 0 : elog(ERROR, "unrecognized matchKind: %d",
7478 : (int) action->matchKind);
7479 : }
7480 :
7481 78 : if (action->qual)
7482 : {
7483 48 : appendContextKeyword(context, " AND ",
7484 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 3);
7485 48 : get_rule_expr(action->qual, context, false);
7486 : }
7487 78 : appendContextKeyword(context, " THEN ",
7488 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 3);
7489 :
7490 78 : if (action->commandType == CMD_INSERT)
7491 : {
7492 : /* This generally matches get_insert_query_def() */
7493 36 : List *strippedexprs = NIL;
7494 36 : const char *sep = "";
7495 : ListCell *lc2;
7496 :
7497 36 : appendStringInfoString(buf, "INSERT");
7498 :
7499 36 : if (action->targetList)
7500 30 : appendStringInfoString(buf, " (");
7501 102 : foreach(lc2, action->targetList)
7502 : {
7503 66 : TargetEntry *tle = (TargetEntry *) lfirst(lc2);
7504 :
7505 : Assert(!tle->resjunk);
7506 :
7507 66 : appendStringInfoString(buf, sep);
7508 66 : sep = ", ";
7509 :
7510 66 : appendStringInfoString(buf,
7511 66 : quote_identifier(get_attname(rte->relid,
7512 66 : tle->resno,
7513 : false)));
7514 66 : strippedexprs = lappend(strippedexprs,
7515 66 : processIndirection((Node *) tle->expr,
7516 : context));
7517 : }
7518 36 : if (action->targetList)
7519 30 : appendStringInfoChar(buf, ')');
7520 :
7521 36 : if (action->override)
7522 : {
7523 6 : if (action->override == OVERRIDING_SYSTEM_VALUE)
7524 0 : appendStringInfoString(buf, " OVERRIDING SYSTEM VALUE");
7525 6 : else if (action->override == OVERRIDING_USER_VALUE)
7526 6 : appendStringInfoString(buf, " OVERRIDING USER VALUE");
7527 : }
7528 :
7529 36 : if (strippedexprs)
7530 : {
7531 30 : appendContextKeyword(context, " VALUES (",
7532 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 4);
7533 30 : get_rule_list_toplevel(strippedexprs, context, false);
7534 30 : appendStringInfoChar(buf, ')');
7535 : }
7536 : else
7537 6 : appendStringInfoString(buf, " DEFAULT VALUES");
7538 : }
7539 42 : else if (action->commandType == CMD_UPDATE)
7540 : {
7541 24 : appendStringInfoString(buf, "UPDATE SET ");
7542 24 : get_update_query_targetlist_def(query, action->targetList,
7543 : context, rte);
7544 : }
7545 18 : else if (action->commandType == CMD_DELETE)
7546 12 : appendStringInfoString(buf, "DELETE");
7547 6 : else if (action->commandType == CMD_NOTHING)
7548 6 : appendStringInfoString(buf, "DO NOTHING");
7549 : }
7550 :
7551 : /* Add RETURNING if present */
7552 12 : if (query->returningList)
7553 6 : get_returning_clause(query, context);
7554 12 : }
7555 :
7556 :
7557 : /* ----------
7558 : * get_utility_query_def - Parse back a UTILITY parsetree
7559 : * ----------
7560 : */
7561 : static void
7562 16 : get_utility_query_def(Query *query, deparse_context *context)
7563 : {
7564 16 : StringInfo buf = context->buf;
7565 :
7566 16 : if (query->utilityStmt && IsA(query->utilityStmt, NotifyStmt))
7567 16 : {
7568 16 : NotifyStmt *stmt = (NotifyStmt *) query->utilityStmt;
7569 :
7570 16 : appendContextKeyword(context, "",
7571 : 0, PRETTYINDENT_STD, 1);
7572 16 : appendStringInfo(buf, "NOTIFY %s",
7573 16 : quote_identifier(stmt->conditionname));
7574 16 : if (stmt->payload)
7575 : {
7576 0 : appendStringInfoString(buf, ", ");
7577 0 : simple_quote_literal(buf, stmt->payload);
7578 : }
7579 : }
7580 : else
7581 : {
7582 : /* Currently only NOTIFY utility commands can appear in rules */
7583 0 : elog(ERROR, "unexpected utility statement type");
7584 : }
7585 16 : }
7586 :
7587 : /*
7588 : * Display a Var appropriately.
7589 : *
7590 : * In some cases (currently only when recursing into an unnamed join)
7591 : * the Var's varlevelsup has to be interpreted with respect to a context
7592 : * above the current one; levelsup indicates the offset.
7593 : *
7594 : * If istoplevel is true, the Var is at the top level of a SELECT's
7595 : * targetlist, which means we need special treatment of whole-row Vars.
7596 : * Instead of the normal "tab.*", we'll print "tab.*::typename", which is a
7597 : * dirty hack to prevent "tab.*" from being expanded into multiple columns.
7598 : * (The parser will strip the useless coercion, so no inefficiency is added in
7599 : * dump and reload.) We used to print just "tab" in such cases, but that is
7600 : * ambiguous and will yield the wrong result if "tab" is also a plain column
7601 : * name in the query.
7602 : *
7603 : * Returns the attname of the Var, or NULL if the Var has no attname (because
7604 : * it is a whole-row Var or a subplan output reference).
7605 : */
7606 : static char *
7607 188170 : get_variable(Var *var, int levelsup, bool istoplevel, deparse_context *context)
7608 : {
7609 188170 : StringInfo buf = context->buf;
7610 : RangeTblEntry *rte;
7611 : AttrNumber attnum;
7612 : int netlevelsup;
7613 : deparse_namespace *dpns;
7614 : int varno;
7615 : AttrNumber varattno;
7616 : deparse_columns *colinfo;
7617 : char *refname;
7618 : char *attname;
7619 : bool need_prefix;
7620 :
7621 : /* Find appropriate nesting depth */
7622 188170 : netlevelsup = var->varlevelsup + levelsup;
7623 188170 : if (netlevelsup >= list_length(context->namespaces))
7624 0 : elog(ERROR, "bogus varlevelsup: %d offset %d",
7625 : var->varlevelsup, levelsup);
7626 188170 : dpns = (deparse_namespace *) list_nth(context->namespaces,
7627 : netlevelsup);
7628 :
7629 : /*
7630 : * If we have a syntactic referent for the Var, and we're working from a
7631 : * parse tree, prefer to use the syntactic referent. Otherwise, fall back
7632 : * on the semantic referent. (Forcing use of the semantic referent when
7633 : * printing plan trees is a design choice that's perhaps more motivated by
7634 : * backwards compatibility than anything else. But it does have the
7635 : * advantage of making plans more explicit.)
7636 : */
7637 188170 : if (var->varnosyn > 0 && dpns->plan == NULL)
7638 : {
7639 38130 : varno = var->varnosyn;
7640 38130 : varattno = var->varattnosyn;
7641 : }
7642 : else
7643 : {
7644 150040 : varno = var->varno;
7645 150040 : varattno = var->varattno;
7646 : }
7647 :
7648 : /*
7649 : * Try to find the relevant RTE in this rtable. In a plan tree, it's
7650 : * likely that varno is OUTER_VAR or INNER_VAR, in which case we must dig
7651 : * down into the subplans, or INDEX_VAR, which is resolved similarly. Also
7652 : * find the aliases previously assigned for this RTE.
7653 : */
7654 188170 : if (varno >= 1 && varno <= list_length(dpns->rtable))
7655 : {
7656 : /*
7657 : * We might have been asked to map child Vars to some parent relation.
7658 : */
7659 137240 : if (context->appendparents && dpns->appendrels)
7660 : {
7661 3828 : int pvarno = varno;
7662 3828 : AttrNumber pvarattno = varattno;
7663 3828 : AppendRelInfo *appinfo = dpns->appendrels[pvarno];
7664 3828 : bool found = false;
7665 :
7666 : /* Only map up to inheritance parents, not UNION ALL appendrels */
7667 7730 : while (appinfo &&
7668 4252 : rt_fetch(appinfo->parent_relid,
7669 4252 : dpns->rtable)->rtekind == RTE_RELATION)
7670 : {
7671 3902 : found = false;
7672 3902 : if (pvarattno > 0) /* system columns stay as-is */
7673 : {
7674 3624 : if (pvarattno > appinfo->num_child_cols)
7675 0 : break; /* safety check */
7676 3624 : pvarattno = appinfo->parent_colnos[pvarattno - 1];
7677 3624 : if (pvarattno == 0)
7678 0 : break; /* Var is local to child */
7679 : }
7680 :
7681 3902 : pvarno = appinfo->parent_relid;
7682 3902 : found = true;
7683 :
7684 : /* If the parent is itself a child, continue up. */
7685 : Assert(pvarno > 0 && pvarno <= list_length(dpns->rtable));
7686 3902 : appinfo = dpns->appendrels[pvarno];
7687 : }
7688 :
7689 : /*
7690 : * If we found an ancestral rel, and that rel is included in
7691 : * appendparents, print that column not the original one.
7692 : */
7693 3828 : if (found && bms_is_member(pvarno, context->appendparents))
7694 : {
7695 3112 : varno = pvarno;
7696 3112 : varattno = pvarattno;
7697 : }
7698 : }
7699 :
7700 137240 : rte = rt_fetch(varno, dpns->rtable);
7701 :
7702 : /* might be returning old/new column value */
7703 137240 : if (var->varreturningtype == VAR_RETURNING_OLD)
7704 416 : refname = dpns->ret_old_alias;
7705 136824 : else if (var->varreturningtype == VAR_RETURNING_NEW)
7706 414 : refname = dpns->ret_new_alias;
7707 : else
7708 136410 : refname = (char *) list_nth(dpns->rtable_names, varno - 1);
7709 :
7710 137240 : colinfo = deparse_columns_fetch(varno, dpns);
7711 137240 : attnum = varattno;
7712 : }
7713 : else
7714 : {
7715 50930 : resolve_special_varno((Node *) var, context,
7716 : get_special_variable, NULL);
7717 50930 : return NULL;
7718 : }
7719 :
7720 : /*
7721 : * The planner will sometimes emit Vars referencing resjunk elements of a
7722 : * subquery's target list (this is currently only possible if it chooses
7723 : * to generate a "physical tlist" for a SubqueryScan or CteScan node).
7724 : * Although we prefer to print subquery-referencing Vars using the
7725 : * subquery's alias, that's not possible for resjunk items since they have
7726 : * no alias. So in that case, drill down to the subplan and print the
7727 : * contents of the referenced tlist item. This works because in a plan
7728 : * tree, such Vars can only occur in a SubqueryScan or CteScan node, and
7729 : * we'll have set dpns->inner_plan to reference the child plan node.
7730 : */
7731 141552 : if ((rte->rtekind == RTE_SUBQUERY || rte->rtekind == RTE_CTE) &&
7732 4312 : attnum > list_length(rte->eref->colnames) &&
7733 2 : dpns->inner_plan)
7734 : {
7735 : TargetEntry *tle;
7736 : deparse_namespace save_dpns;
7737 :
7738 2 : tle = get_tle_by_resno(dpns->inner_tlist, attnum);
7739 2 : if (!tle)
7740 0 : elog(ERROR, "invalid attnum %d for relation \"%s\"",
7741 : attnum, rte->eref->aliasname);
7742 :
7743 : Assert(netlevelsup == 0);
7744 2 : push_child_plan(dpns, dpns->inner_plan, &save_dpns);
7745 :
7746 : /*
7747 : * Force parentheses because our caller probably assumed a Var is a
7748 : * simple expression.
7749 : */
7750 2 : if (!IsA(tle->expr, Var))
7751 0 : appendStringInfoChar(buf, '(');
7752 2 : get_rule_expr((Node *) tle->expr, context, true);
7753 2 : if (!IsA(tle->expr, Var))
7754 0 : appendStringInfoChar(buf, ')');
7755 :
7756 2 : pop_child_plan(dpns, &save_dpns);
7757 2 : return NULL;
7758 : }
7759 :
7760 : /*
7761 : * If it's an unnamed join, look at the expansion of the alias variable.
7762 : * If it's a simple reference to one of the input vars, then recursively
7763 : * print the name of that var instead. When it's not a simple reference,
7764 : * we have to just print the unqualified join column name. (This can only
7765 : * happen with "dangerous" merged columns in a JOIN USING; we took pains
7766 : * previously to make the unqualified column name unique in such cases.)
7767 : *
7768 : * This wouldn't work in decompiling plan trees, because we don't store
7769 : * joinaliasvars lists after planning; but a plan tree should never
7770 : * contain a join alias variable.
7771 : */
7772 137238 : if (rte->rtekind == RTE_JOIN && rte->alias == NULL)
7773 : {
7774 96 : if (rte->joinaliasvars == NIL)
7775 0 : elog(ERROR, "cannot decompile join alias var in plan tree");
7776 96 : if (attnum > 0)
7777 : {
7778 : Var *aliasvar;
7779 :
7780 96 : aliasvar = (Var *) list_nth(rte->joinaliasvars, attnum - 1);
7781 : /* we intentionally don't strip implicit coercions here */
7782 96 : if (aliasvar && IsA(aliasvar, Var))
7783 : {
7784 0 : return get_variable(aliasvar, var->varlevelsup + levelsup,
7785 : istoplevel, context);
7786 : }
7787 : }
7788 :
7789 : /*
7790 : * Unnamed join has no refname. (Note: since it's unnamed, there is
7791 : * no way the user could have referenced it to create a whole-row Var
7792 : * for it. So we don't have to cover that case below.)
7793 : */
7794 : Assert(refname == NULL);
7795 : }
7796 :
7797 137238 : if (attnum == InvalidAttrNumber)
7798 1014 : attname = NULL;
7799 136224 : else if (attnum > 0)
7800 : {
7801 : /* Get column name to use from the colinfo struct */
7802 134346 : if (attnum > colinfo->num_cols)
7803 0 : elog(ERROR, "invalid attnum %d for relation \"%s\"",
7804 : attnum, rte->eref->aliasname);
7805 134346 : attname = colinfo->colnames[attnum - 1];
7806 :
7807 : /*
7808 : * If we find a Var referencing a dropped column, it seems better to
7809 : * print something (anything) than to fail. In general this should
7810 : * not happen, but it used to be possible for some cases involving
7811 : * functions returning named composite types, and perhaps there are
7812 : * still bugs out there.
7813 : */
7814 134346 : if (attname == NULL)
7815 6 : attname = "?dropped?column?";
7816 : }
7817 : else
7818 : {
7819 : /* System column - name is fixed, get it from the catalog */
7820 1878 : attname = get_rte_attribute_name(rte, attnum);
7821 : }
7822 :
7823 201778 : need_prefix = (context->varprefix || attname == NULL ||
7824 64540 : var->varreturningtype != VAR_RETURNING_DEFAULT);
7825 :
7826 : /*
7827 : * If we're considering a plain Var in an ORDER BY (but not GROUP BY)
7828 : * clause, we may need to add a table-name prefix to prevent
7829 : * findTargetlistEntrySQL92 from misinterpreting the name as an
7830 : * output-column name. To avoid cluttering the output with unnecessary
7831 : * prefixes, do so only if there is a name match to a SELECT tlist item
7832 : * that is different from the Var.
7833 : */
7834 137238 : if (context->varInOrderBy && !context->inGroupBy && !need_prefix)
7835 : {
7836 246 : int colno = 0;
7837 :
7838 964 : foreach_node(TargetEntry, tle, context->targetList)
7839 : {
7840 : char *colname;
7841 :
7842 484 : if (tle->resjunk)
7843 0 : continue; /* ignore junk entries */
7844 484 : colno++;
7845 :
7846 : /* This must match colname-choosing logic in get_target_list() */
7847 484 : if (context->resultDesc && colno <= context->resultDesc->natts)
7848 484 : colname = NameStr(TupleDescAttr(context->resultDesc,
7849 : colno - 1)->attname);
7850 : else
7851 0 : colname = tle->resname;
7852 :
7853 484 : if (colname && strcmp(colname, attname) == 0 &&
7854 174 : !equal(var, tle->expr))
7855 : {
7856 12 : need_prefix = true;
7857 12 : break;
7858 : }
7859 : }
7860 : }
7861 :
7862 137238 : if (refname && need_prefix)
7863 : {
7864 72642 : appendStringInfoString(buf, quote_identifier(refname));
7865 72642 : appendStringInfoChar(buf, '.');
7866 : }
7867 137238 : if (attname)
7868 136224 : appendStringInfoString(buf, quote_identifier(attname));
7869 : else
7870 : {
7871 1014 : appendStringInfoChar(buf, '*');
7872 1014 : if (istoplevel)
7873 84 : appendStringInfo(buf, "::%s",
7874 : format_type_with_typemod(var->vartype,
7875 : var->vartypmod));
7876 : }
7877 :
7878 137238 : return attname;
7879 : }
7880 :
7881 : /*
7882 : * Deparse a Var which references OUTER_VAR, INNER_VAR, or INDEX_VAR. This
7883 : * routine is actually a callback for resolve_special_varno, which handles
7884 : * finding the correct TargetEntry. We get the expression contained in that
7885 : * TargetEntry and just need to deparse it, a job we can throw back on
7886 : * get_rule_expr.
7887 : */
7888 : static void
7889 50930 : get_special_variable(Node *node, deparse_context *context, void *callback_arg)
7890 : {
7891 50930 : StringInfo buf = context->buf;
7892 :
7893 : /*
7894 : * For a non-Var referent, force parentheses because our caller probably
7895 : * assumed a Var is a simple expression.
7896 : */
7897 50930 : if (!IsA(node, Var))
7898 5092 : appendStringInfoChar(buf, '(');
7899 50930 : get_rule_expr(node, context, true);
7900 50930 : if (!IsA(node, Var))
7901 5092 : appendStringInfoChar(buf, ')');
7902 50930 : }
7903 :
7904 : /*
7905 : * Chase through plan references to special varnos (OUTER_VAR, INNER_VAR,
7906 : * INDEX_VAR) until we find a real Var or some kind of non-Var node; then,
7907 : * invoke the callback provided.
7908 : */
7909 : static void
7910 143614 : resolve_special_varno(Node *node, deparse_context *context,
7911 : rsv_callback callback, void *callback_arg)
7912 : {
7913 : Var *var;
7914 : deparse_namespace *dpns;
7915 :
7916 : /* This function is recursive, so let's be paranoid. */
7917 143614 : check_stack_depth();
7918 :
7919 : /* If it's not a Var, invoke the callback. */
7920 143614 : if (!IsA(node, Var))
7921 : {
7922 5868 : (*callback) (node, context, callback_arg);
7923 5868 : return;
7924 : }
7925 :
7926 : /* Find appropriate nesting depth */
7927 137746 : var = (Var *) node;
7928 137746 : dpns = (deparse_namespace *) list_nth(context->namespaces,
7929 137746 : var->varlevelsup);
7930 :
7931 : /*
7932 : * If varno is special, recurse. (Don't worry about varnosyn; if we're
7933 : * here, we already decided not to use that.)
7934 : */
7935 137746 : if (var->varno == OUTER_VAR && dpns->outer_tlist)
7936 : {
7937 : TargetEntry *tle;
7938 : deparse_namespace save_dpns;
7939 : Bitmapset *save_appendparents;
7940 :
7941 69390 : tle = get_tle_by_resno(dpns->outer_tlist, var->varattno);
7942 69390 : if (!tle)
7943 0 : elog(ERROR, "bogus varattno for OUTER_VAR var: %d", var->varattno);
7944 :
7945 : /*
7946 : * If we're descending to the first child of an Append or MergeAppend,
7947 : * update appendparents. This will affect deparsing of all Vars
7948 : * appearing within the eventually-resolved subexpression.
7949 : */
7950 69390 : save_appendparents = context->appendparents;
7951 :
7952 69390 : if (IsA(dpns->plan, Append))
7953 4492 : context->appendparents = bms_union(context->appendparents,
7954 4492 : ((Append *) dpns->plan)->apprelids);
7955 64898 : else if (IsA(dpns->plan, MergeAppend))
7956 608 : context->appendparents = bms_union(context->appendparents,
7957 608 : ((MergeAppend *) dpns->plan)->apprelids);
7958 :
7959 69390 : push_child_plan(dpns, dpns->outer_plan, &save_dpns);
7960 69390 : resolve_special_varno((Node *) tle->expr, context,
7961 : callback, callback_arg);
7962 69390 : pop_child_plan(dpns, &save_dpns);
7963 69390 : context->appendparents = save_appendparents;
7964 69390 : return;
7965 : }
7966 68356 : else if (var->varno == INNER_VAR && dpns->inner_tlist)
7967 : {
7968 : TargetEntry *tle;
7969 : deparse_namespace save_dpns;
7970 :
7971 16964 : tle = get_tle_by_resno(dpns->inner_tlist, var->varattno);
7972 16964 : if (!tle)
7973 0 : elog(ERROR, "bogus varattno for INNER_VAR var: %d", var->varattno);
7974 :
7975 16964 : push_child_plan(dpns, dpns->inner_plan, &save_dpns);
7976 16964 : resolve_special_varno((Node *) tle->expr, context,
7977 : callback, callback_arg);
7978 16964 : pop_child_plan(dpns, &save_dpns);
7979 16964 : return;
7980 : }
7981 51392 : else if (var->varno == INDEX_VAR && dpns->index_tlist)
7982 : {
7983 : TargetEntry *tle;
7984 :
7985 5554 : tle = get_tle_by_resno(dpns->index_tlist, var->varattno);
7986 5554 : if (!tle)
7987 0 : elog(ERROR, "bogus varattno for INDEX_VAR var: %d", var->varattno);
7988 :
7989 5554 : resolve_special_varno((Node *) tle->expr, context,
7990 : callback, callback_arg);
7991 5554 : return;
7992 : }
7993 45838 : else if (var->varno < 1 || var->varno > list_length(dpns->rtable))
7994 0 : elog(ERROR, "bogus varno: %d", var->varno);
7995 :
7996 : /* Not special. Just invoke the callback. */
7997 45838 : (*callback) (node, context, callback_arg);
7998 : }
7999 :
8000 : /*
8001 : * Get the name of a field of an expression of composite type. The
8002 : * expression is usually a Var, but we handle other cases too.
8003 : *
8004 : * levelsup is an extra offset to interpret the Var's varlevelsup correctly.
8005 : *
8006 : * This is fairly straightforward when the expression has a named composite
8007 : * type; we need only look up the type in the catalogs. However, the type
8008 : * could also be RECORD. Since no actual table or view column is allowed to
8009 : * have type RECORD, a Var of type RECORD must refer to a JOIN or FUNCTION RTE
8010 : * or to a subquery output. We drill down to find the ultimate defining
8011 : * expression and attempt to infer the field name from it. We ereport if we
8012 : * can't determine the name.
8013 : *
8014 : * Similarly, a PARAM of type RECORD has to refer to some expression of
8015 : * a determinable composite type.
8016 : */
8017 : static const char *
8018 1340 : get_name_for_var_field(Var *var, int fieldno,
8019 : int levelsup, deparse_context *context)
8020 : {
8021 : RangeTblEntry *rte;
8022 : AttrNumber attnum;
8023 : int netlevelsup;
8024 : deparse_namespace *dpns;
8025 : int varno;
8026 : AttrNumber varattno;
8027 : TupleDesc tupleDesc;
8028 : Node *expr;
8029 :
8030 : /*
8031 : * If it's a RowExpr that was expanded from a whole-row Var, use the
8032 : * column names attached to it. (We could let get_expr_result_tupdesc()
8033 : * handle this, but it's much cheaper to just pull out the name we need.)
8034 : */
8035 1340 : if (IsA(var, RowExpr))
8036 : {
8037 36 : RowExpr *r = (RowExpr *) var;
8038 :
8039 36 : if (fieldno > 0 && fieldno <= list_length(r->colnames))
8040 36 : return strVal(list_nth(r->colnames, fieldno - 1));
8041 : }
8042 :
8043 : /*
8044 : * If it's a Param of type RECORD, try to find what the Param refers to.
8045 : */
8046 1304 : if (IsA(var, Param))
8047 : {
8048 18 : Param *param = (Param *) var;
8049 : ListCell *ancestor_cell;
8050 :
8051 18 : expr = find_param_referent(param, context, &dpns, &ancestor_cell);
8052 18 : if (expr)
8053 : {
8054 : /* Found a match, so recurse to decipher the field name */
8055 : deparse_namespace save_dpns;
8056 : const char *result;
8057 :
8058 18 : push_ancestor_plan(dpns, ancestor_cell, &save_dpns);
8059 18 : result = get_name_for_var_field((Var *) expr, fieldno,
8060 : 0, context);
8061 18 : pop_ancestor_plan(dpns, &save_dpns);
8062 18 : return result;
8063 : }
8064 : }
8065 :
8066 : /*
8067 : * If it's a Var of type RECORD, we have to find what the Var refers to;
8068 : * if not, we can use get_expr_result_tupdesc().
8069 : */
8070 1286 : if (!IsA(var, Var) ||
8071 1206 : var->vartype != RECORDOID)
8072 : {
8073 1040 : tupleDesc = get_expr_result_tupdesc((Node *) var, false);
8074 : /* Got the tupdesc, so we can extract the field name */
8075 : Assert(fieldno >= 1 && fieldno <= tupleDesc->natts);
8076 1040 : return NameStr(TupleDescAttr(tupleDesc, fieldno - 1)->attname);
8077 : }
8078 :
8079 : /* Find appropriate nesting depth */
8080 246 : netlevelsup = var->varlevelsup + levelsup;
8081 246 : if (netlevelsup >= list_length(context->namespaces))
8082 0 : elog(ERROR, "bogus varlevelsup: %d offset %d",
8083 : var->varlevelsup, levelsup);
8084 246 : dpns = (deparse_namespace *) list_nth(context->namespaces,
8085 : netlevelsup);
8086 :
8087 : /*
8088 : * If we have a syntactic referent for the Var, and we're working from a
8089 : * parse tree, prefer to use the syntactic referent. Otherwise, fall back
8090 : * on the semantic referent. (See comments in get_variable().)
8091 : */
8092 246 : if (var->varnosyn > 0 && dpns->plan == NULL)
8093 : {
8094 96 : varno = var->varnosyn;
8095 96 : varattno = var->varattnosyn;
8096 : }
8097 : else
8098 : {
8099 150 : varno = var->varno;
8100 150 : varattno = var->varattno;
8101 : }
8102 :
8103 : /*
8104 : * Try to find the relevant RTE in this rtable. In a plan tree, it's
8105 : * likely that varno is OUTER_VAR or INNER_VAR, in which case we must dig
8106 : * down into the subplans, or INDEX_VAR, which is resolved similarly.
8107 : *
8108 : * Note: unlike get_variable and resolve_special_varno, we need not worry
8109 : * about inheritance mapping: a child Var should have the same datatype as
8110 : * its parent, and here we're really only interested in the Var's type.
8111 : */
8112 246 : if (varno >= 1 && varno <= list_length(dpns->rtable))
8113 : {
8114 168 : rte = rt_fetch(varno, dpns->rtable);
8115 168 : attnum = varattno;
8116 : }
8117 78 : else if (varno == OUTER_VAR && dpns->outer_tlist)
8118 : {
8119 : TargetEntry *tle;
8120 : deparse_namespace save_dpns;
8121 : const char *result;
8122 :
8123 60 : tle = get_tle_by_resno(dpns->outer_tlist, varattno);
8124 60 : if (!tle)
8125 0 : elog(ERROR, "bogus varattno for OUTER_VAR var: %d", varattno);
8126 :
8127 : Assert(netlevelsup == 0);
8128 60 : push_child_plan(dpns, dpns->outer_plan, &save_dpns);
8129 :
8130 60 : result = get_name_for_var_field((Var *) tle->expr, fieldno,
8131 : levelsup, context);
8132 :
8133 60 : pop_child_plan(dpns, &save_dpns);
8134 60 : return result;
8135 : }
8136 18 : else if (varno == INNER_VAR && dpns->inner_tlist)
8137 : {
8138 : TargetEntry *tle;
8139 : deparse_namespace save_dpns;
8140 : const char *result;
8141 :
8142 18 : tle = get_tle_by_resno(dpns->inner_tlist, varattno);
8143 18 : if (!tle)
8144 0 : elog(ERROR, "bogus varattno for INNER_VAR var: %d", varattno);
8145 :
8146 : Assert(netlevelsup == 0);
8147 18 : push_child_plan(dpns, dpns->inner_plan, &save_dpns);
8148 :
8149 18 : result = get_name_for_var_field((Var *) tle->expr, fieldno,
8150 : levelsup, context);
8151 :
8152 18 : pop_child_plan(dpns, &save_dpns);
8153 18 : return result;
8154 : }
8155 0 : else if (varno == INDEX_VAR && dpns->index_tlist)
8156 : {
8157 : TargetEntry *tle;
8158 : const char *result;
8159 :
8160 0 : tle = get_tle_by_resno(dpns->index_tlist, varattno);
8161 0 : if (!tle)
8162 0 : elog(ERROR, "bogus varattno for INDEX_VAR var: %d", varattno);
8163 :
8164 : Assert(netlevelsup == 0);
8165 :
8166 0 : result = get_name_for_var_field((Var *) tle->expr, fieldno,
8167 : levelsup, context);
8168 :
8169 0 : return result;
8170 : }
8171 : else
8172 : {
8173 0 : elog(ERROR, "bogus varno: %d", varno);
8174 : return NULL; /* keep compiler quiet */
8175 : }
8176 :
8177 168 : if (attnum == InvalidAttrNumber)
8178 : {
8179 : /* Var is whole-row reference to RTE, so select the right field */
8180 24 : return get_rte_attribute_name(rte, fieldno);
8181 : }
8182 :
8183 : /*
8184 : * This part has essentially the same logic as the parser's
8185 : * expandRecordVariable() function, but we are dealing with a different
8186 : * representation of the input context, and we only need one field name
8187 : * not a TupleDesc. Also, we need special cases for finding subquery and
8188 : * CTE subplans when deparsing Plan trees.
8189 : */
8190 144 : expr = (Node *) var; /* default if we can't drill down */
8191 :
8192 144 : switch (rte->rtekind)
8193 : {
8194 0 : case RTE_RELATION:
8195 : case RTE_VALUES:
8196 : case RTE_NAMEDTUPLESTORE:
8197 : case RTE_RESULT:
8198 :
8199 : /*
8200 : * This case should not occur: a column of a table, values list,
8201 : * or ENR shouldn't have type RECORD. Fall through and fail (most
8202 : * likely) at the bottom.
8203 : */
8204 0 : break;
8205 72 : case RTE_SUBQUERY:
8206 : /* Subselect-in-FROM: examine sub-select's output expr */
8207 : {
8208 72 : if (rte->subquery)
8209 : {
8210 42 : TargetEntry *ste = get_tle_by_resno(rte->subquery->targetList,
8211 : attnum);
8212 :
8213 42 : if (ste == NULL || ste->resjunk)
8214 0 : elog(ERROR, "subquery %s does not have attribute %d",
8215 : rte->eref->aliasname, attnum);
8216 42 : expr = (Node *) ste->expr;
8217 42 : if (IsA(expr, Var))
8218 : {
8219 : /*
8220 : * Recurse into the sub-select to see what its Var
8221 : * refers to. We have to build an additional level of
8222 : * namespace to keep in step with varlevelsup in the
8223 : * subselect; furthermore, the subquery RTE might be
8224 : * from an outer query level, in which case the
8225 : * namespace for the subselect must have that outer
8226 : * level as parent namespace.
8227 : */
8228 18 : List *save_nslist = context->namespaces;
8229 : List *parent_namespaces;
8230 : deparse_namespace mydpns;
8231 : const char *result;
8232 :
8233 18 : parent_namespaces = list_copy_tail(context->namespaces,
8234 : netlevelsup);
8235 :
8236 18 : set_deparse_for_query(&mydpns, rte->subquery,
8237 : parent_namespaces);
8238 :
8239 18 : context->namespaces = lcons(&mydpns, parent_namespaces);
8240 :
8241 18 : result = get_name_for_var_field((Var *) expr, fieldno,
8242 : 0, context);
8243 :
8244 18 : context->namespaces = save_nslist;
8245 :
8246 18 : return result;
8247 : }
8248 : /* else fall through to inspect the expression */
8249 : }
8250 : else
8251 : {
8252 : /*
8253 : * We're deparsing a Plan tree so we don't have complete
8254 : * RTE entries (in particular, rte->subquery is NULL). But
8255 : * the only place we'd normally see a Var directly
8256 : * referencing a SUBQUERY RTE is in a SubqueryScan plan
8257 : * node, and we can look into the child plan's tlist
8258 : * instead. An exception occurs if the subquery was
8259 : * proven empty and optimized away: then we'd find such a
8260 : * Var in a childless Result node, and there's nothing in
8261 : * the plan tree that would let us figure out what it had
8262 : * originally referenced. In that case, fall back on
8263 : * printing "fN", analogously to the default column names
8264 : * for RowExprs.
8265 : */
8266 : TargetEntry *tle;
8267 : deparse_namespace save_dpns;
8268 : const char *result;
8269 :
8270 30 : if (!dpns->inner_plan)
8271 : {
8272 12 : char *dummy_name = palloc(32);
8273 :
8274 : Assert(dpns->plan && IsA(dpns->plan, Result));
8275 12 : snprintf(dummy_name, 32, "f%d", fieldno);
8276 12 : return dummy_name;
8277 : }
8278 : Assert(dpns->plan && IsA(dpns->plan, SubqueryScan));
8279 :
8280 18 : tle = get_tle_by_resno(dpns->inner_tlist, attnum);
8281 18 : if (!tle)
8282 0 : elog(ERROR, "bogus varattno for subquery var: %d",
8283 : attnum);
8284 : Assert(netlevelsup == 0);
8285 18 : push_child_plan(dpns, dpns->inner_plan, &save_dpns);
8286 :
8287 18 : result = get_name_for_var_field((Var *) tle->expr, fieldno,
8288 : levelsup, context);
8289 :
8290 18 : pop_child_plan(dpns, &save_dpns);
8291 18 : return result;
8292 : }
8293 : }
8294 24 : break;
8295 0 : case RTE_JOIN:
8296 : /* Join RTE --- recursively inspect the alias variable */
8297 0 : if (rte->joinaliasvars == NIL)
8298 0 : elog(ERROR, "cannot decompile join alias var in plan tree");
8299 : Assert(attnum > 0 && attnum <= list_length(rte->joinaliasvars));
8300 0 : expr = (Node *) list_nth(rte->joinaliasvars, attnum - 1);
8301 : Assert(expr != NULL);
8302 : /* we intentionally don't strip implicit coercions here */
8303 0 : if (IsA(expr, Var))
8304 0 : return get_name_for_var_field((Var *) expr, fieldno,
8305 0 : var->varlevelsup + levelsup,
8306 : context);
8307 : /* else fall through to inspect the expression */
8308 0 : break;
8309 0 : case RTE_FUNCTION:
8310 : case RTE_TABLEFUNC:
8311 :
8312 : /*
8313 : * We couldn't get here unless a function is declared with one of
8314 : * its result columns as RECORD, which is not allowed.
8315 : */
8316 0 : break;
8317 72 : case RTE_CTE:
8318 : /* CTE reference: examine subquery's output expr */
8319 : {
8320 72 : CommonTableExpr *cte = NULL;
8321 : Index ctelevelsup;
8322 : ListCell *lc;
8323 :
8324 : /*
8325 : * Try to find the referenced CTE using the namespace stack.
8326 : */
8327 72 : ctelevelsup = rte->ctelevelsup + netlevelsup;
8328 72 : if (ctelevelsup >= list_length(context->namespaces))
8329 12 : lc = NULL;
8330 : else
8331 : {
8332 : deparse_namespace *ctedpns;
8333 :
8334 : ctedpns = (deparse_namespace *)
8335 60 : list_nth(context->namespaces, ctelevelsup);
8336 66 : foreach(lc, ctedpns->ctes)
8337 : {
8338 36 : cte = (CommonTableExpr *) lfirst(lc);
8339 36 : if (strcmp(cte->ctename, rte->ctename) == 0)
8340 30 : break;
8341 : }
8342 : }
8343 72 : if (lc != NULL)
8344 : {
8345 30 : Query *ctequery = (Query *) cte->ctequery;
8346 30 : TargetEntry *ste = get_tle_by_resno(GetCTETargetList(cte),
8347 : attnum);
8348 :
8349 30 : if (ste == NULL || ste->resjunk)
8350 0 : elog(ERROR, "CTE %s does not have attribute %d",
8351 : rte->eref->aliasname, attnum);
8352 30 : expr = (Node *) ste->expr;
8353 30 : if (IsA(expr, Var))
8354 : {
8355 : /*
8356 : * Recurse into the CTE to see what its Var refers to.
8357 : * We have to build an additional level of namespace
8358 : * to keep in step with varlevelsup in the CTE;
8359 : * furthermore it could be an outer CTE (compare
8360 : * SUBQUERY case above).
8361 : */
8362 18 : List *save_nslist = context->namespaces;
8363 : List *parent_namespaces;
8364 : deparse_namespace mydpns;
8365 : const char *result;
8366 :
8367 18 : parent_namespaces = list_copy_tail(context->namespaces,
8368 : ctelevelsup);
8369 :
8370 18 : set_deparse_for_query(&mydpns, ctequery,
8371 : parent_namespaces);
8372 :
8373 18 : context->namespaces = lcons(&mydpns, parent_namespaces);
8374 :
8375 18 : result = get_name_for_var_field((Var *) expr, fieldno,
8376 : 0, context);
8377 :
8378 18 : context->namespaces = save_nslist;
8379 :
8380 18 : return result;
8381 : }
8382 : /* else fall through to inspect the expression */
8383 : }
8384 : else
8385 : {
8386 : /*
8387 : * We're deparsing a Plan tree so we don't have a CTE
8388 : * list. But the only places we'd normally see a Var
8389 : * directly referencing a CTE RTE are in CteScan or
8390 : * WorkTableScan plan nodes. For those cases,
8391 : * set_deparse_plan arranged for dpns->inner_plan to be
8392 : * the plan node that emits the CTE or RecursiveUnion
8393 : * result, and we can look at its tlist instead. As
8394 : * above, this can fail if the CTE has been proven empty,
8395 : * in which case fall back to "fN".
8396 : */
8397 : TargetEntry *tle;
8398 : deparse_namespace save_dpns;
8399 : const char *result;
8400 :
8401 42 : if (!dpns->inner_plan)
8402 : {
8403 6 : char *dummy_name = palloc(32);
8404 :
8405 : Assert(dpns->plan && IsA(dpns->plan, Result));
8406 6 : snprintf(dummy_name, 32, "f%d", fieldno);
8407 6 : return dummy_name;
8408 : }
8409 : Assert(dpns->plan && (IsA(dpns->plan, CteScan) ||
8410 : IsA(dpns->plan, WorkTableScan)));
8411 :
8412 36 : tle = get_tle_by_resno(dpns->inner_tlist, attnum);
8413 36 : if (!tle)
8414 0 : elog(ERROR, "bogus varattno for subquery var: %d",
8415 : attnum);
8416 : Assert(netlevelsup == 0);
8417 36 : push_child_plan(dpns, dpns->inner_plan, &save_dpns);
8418 :
8419 36 : result = get_name_for_var_field((Var *) tle->expr, fieldno,
8420 : levelsup, context);
8421 :
8422 36 : pop_child_plan(dpns, &save_dpns);
8423 36 : return result;
8424 : }
8425 : }
8426 12 : break;
8427 0 : case RTE_GROUP:
8428 :
8429 : /*
8430 : * We couldn't get here: any Vars that reference the RTE_GROUP RTE
8431 : * should have been replaced with the underlying grouping
8432 : * expressions.
8433 : */
8434 0 : break;
8435 : }
8436 :
8437 : /*
8438 : * We now have an expression we can't expand any more, so see if
8439 : * get_expr_result_tupdesc() can do anything with it.
8440 : */
8441 36 : tupleDesc = get_expr_result_tupdesc(expr, false);
8442 : /* Got the tupdesc, so we can extract the field name */
8443 : Assert(fieldno >= 1 && fieldno <= tupleDesc->natts);
8444 36 : return NameStr(TupleDescAttr(tupleDesc, fieldno - 1)->attname);
8445 : }
8446 :
8447 : /*
8448 : * Try to find the referenced expression for a PARAM_EXEC Param that might
8449 : * reference a parameter supplied by an upper NestLoop or SubPlan plan node.
8450 : *
8451 : * If successful, return the expression and set *dpns_p and *ancestor_cell_p
8452 : * appropriately for calling push_ancestor_plan(). If no referent can be
8453 : * found, return NULL.
8454 : */
8455 : static Node *
8456 7192 : find_param_referent(Param *param, deparse_context *context,
8457 : deparse_namespace **dpns_p, ListCell **ancestor_cell_p)
8458 : {
8459 : /* Initialize output parameters to prevent compiler warnings */
8460 7192 : *dpns_p = NULL;
8461 7192 : *ancestor_cell_p = NULL;
8462 :
8463 : /*
8464 : * If it's a PARAM_EXEC parameter, look for a matching NestLoopParam or
8465 : * SubPlan argument. This will necessarily be in some ancestor of the
8466 : * current expression's Plan node.
8467 : */
8468 7192 : if (param->paramkind == PARAM_EXEC)
8469 : {
8470 : deparse_namespace *dpns;
8471 : Plan *child_plan;
8472 : ListCell *lc;
8473 :
8474 6300 : dpns = (deparse_namespace *) linitial(context->namespaces);
8475 6300 : child_plan = dpns->plan;
8476 :
8477 11168 : foreach(lc, dpns->ancestors)
8478 : {
8479 9508 : Node *ancestor = (Node *) lfirst(lc);
8480 : ListCell *lc2;
8481 :
8482 : /*
8483 : * NestLoops transmit params to their inner child only.
8484 : */
8485 9508 : if (IsA(ancestor, NestLoop) &&
8486 4332 : child_plan == innerPlan(ancestor))
8487 : {
8488 4152 : NestLoop *nl = (NestLoop *) ancestor;
8489 :
8490 5138 : foreach(lc2, nl->nestParams)
8491 : {
8492 4964 : NestLoopParam *nlp = (NestLoopParam *) lfirst(lc2);
8493 :
8494 4964 : if (nlp->paramno == param->paramid)
8495 : {
8496 : /* Found a match, so return it */
8497 3978 : *dpns_p = dpns;
8498 3978 : *ancestor_cell_p = lc;
8499 3978 : return (Node *) nlp->paramval;
8500 : }
8501 : }
8502 : }
8503 :
8504 : /*
8505 : * If ancestor is a SubPlan, check the arguments it provides.
8506 : */
8507 5530 : if (IsA(ancestor, SubPlan))
8508 366 : {
8509 1028 : SubPlan *subplan = (SubPlan *) ancestor;
8510 : ListCell *lc3;
8511 : ListCell *lc4;
8512 :
8513 1370 : forboth(lc3, subplan->parParam, lc4, subplan->args)
8514 : {
8515 1004 : int paramid = lfirst_int(lc3);
8516 1004 : Node *arg = (Node *) lfirst(lc4);
8517 :
8518 1004 : if (paramid == param->paramid)
8519 : {
8520 : /*
8521 : * Found a match, so return it. But, since Vars in
8522 : * the arg are to be evaluated in the surrounding
8523 : * context, we have to point to the next ancestor item
8524 : * that is *not* a SubPlan.
8525 : */
8526 : ListCell *rest;
8527 :
8528 662 : for_each_cell(rest, dpns->ancestors,
8529 : lnext(dpns->ancestors, lc))
8530 : {
8531 662 : Node *ancestor2 = (Node *) lfirst(rest);
8532 :
8533 662 : if (!IsA(ancestor2, SubPlan))
8534 : {
8535 662 : *dpns_p = dpns;
8536 662 : *ancestor_cell_p = rest;
8537 662 : return arg;
8538 : }
8539 : }
8540 0 : elog(ERROR, "SubPlan cannot be outermost ancestor");
8541 : }
8542 : }
8543 :
8544 : /* SubPlan isn't a kind of Plan, so skip the rest */
8545 366 : continue;
8546 : }
8547 :
8548 : /*
8549 : * We need not consider the ancestor's initPlan list, since
8550 : * initplans never have any parParams.
8551 : */
8552 :
8553 : /* No luck, crawl up to next ancestor */
8554 4502 : child_plan = (Plan *) ancestor;
8555 : }
8556 : }
8557 :
8558 : /* No referent found */
8559 2552 : return NULL;
8560 : }
8561 :
8562 : /*
8563 : * Try to find a subplan/initplan that emits the value for a PARAM_EXEC Param.
8564 : *
8565 : * If successful, return the generating subplan/initplan and set *column_p
8566 : * to the subplan's 0-based output column number.
8567 : * Otherwise, return NULL.
8568 : */
8569 : static SubPlan *
8570 2552 : find_param_generator(Param *param, deparse_context *context, int *column_p)
8571 : {
8572 : /* Initialize output parameter to prevent compiler warnings */
8573 2552 : *column_p = 0;
8574 :
8575 : /*
8576 : * If it's a PARAM_EXEC parameter, search the current plan node as well as
8577 : * ancestor nodes looking for a subplan or initplan that emits the value
8578 : * for the Param. It could appear in the setParams of an initplan or
8579 : * MULTIEXPR_SUBLINK subplan, or in the paramIds of an ancestral SubPlan.
8580 : */
8581 2552 : if (param->paramkind == PARAM_EXEC)
8582 : {
8583 : SubPlan *result;
8584 : deparse_namespace *dpns;
8585 : ListCell *lc;
8586 :
8587 1660 : dpns = (deparse_namespace *) linitial(context->namespaces);
8588 :
8589 : /* First check the innermost plan node's initplans */
8590 1660 : result = find_param_generator_initplan(param, dpns->plan, column_p);
8591 1660 : if (result)
8592 500 : return result;
8593 :
8594 : /*
8595 : * The plan's targetlist might contain MULTIEXPR_SUBLINK SubPlans,
8596 : * which can be referenced by Params elsewhere in the targetlist.
8597 : * (Such Params should always be in the same targetlist, so there's no
8598 : * need to do this work at upper plan nodes.)
8599 : */
8600 5944 : foreach_node(TargetEntry, tle, dpns->plan->targetlist)
8601 : {
8602 3728 : if (tle->expr && IsA(tle->expr, SubPlan))
8603 : {
8604 100 : SubPlan *subplan = (SubPlan *) tle->expr;
8605 :
8606 100 : if (subplan->subLinkType == MULTIEXPR_SUBLINK)
8607 : {
8608 78 : foreach_int(paramid, subplan->setParam)
8609 : {
8610 78 : if (paramid == param->paramid)
8611 : {
8612 : /* Found a match, so return it. */
8613 52 : *column_p = foreach_current_index(paramid);
8614 52 : return subplan;
8615 : }
8616 : }
8617 : }
8618 : }
8619 : }
8620 :
8621 : /* No luck, so check the ancestor nodes */
8622 1462 : foreach(lc, dpns->ancestors)
8623 : {
8624 1462 : Node *ancestor = (Node *) lfirst(lc);
8625 :
8626 : /*
8627 : * If ancestor is a SubPlan, check the paramIds it provides.
8628 : */
8629 1462 : if (IsA(ancestor, SubPlan))
8630 0 : {
8631 210 : SubPlan *subplan = (SubPlan *) ancestor;
8632 :
8633 236 : foreach_int(paramid, subplan->paramIds)
8634 : {
8635 236 : if (paramid == param->paramid)
8636 : {
8637 : /* Found a match, so return it. */
8638 210 : *column_p = foreach_current_index(paramid);
8639 210 : return subplan;
8640 : }
8641 : }
8642 :
8643 : /* SubPlan isn't a kind of Plan, so skip the rest */
8644 0 : continue;
8645 : }
8646 :
8647 : /*
8648 : * Otherwise, it's some kind of Plan node, so check its initplans.
8649 : */
8650 1252 : result = find_param_generator_initplan(param, (Plan *) ancestor,
8651 : column_p);
8652 1252 : if (result)
8653 898 : return result;
8654 :
8655 : /* No luck, crawl up to next ancestor */
8656 : }
8657 : }
8658 :
8659 : /* No generator found */
8660 892 : return NULL;
8661 : }
8662 :
8663 : /*
8664 : * Subroutine for find_param_generator: search one Plan node's initplans
8665 : */
8666 : static SubPlan *
8667 2912 : find_param_generator_initplan(Param *param, Plan *plan, int *column_p)
8668 : {
8669 4566 : foreach_node(SubPlan, subplan, plan->initPlan)
8670 : {
8671 1824 : foreach_int(paramid, subplan->setParam)
8672 : {
8673 1544 : if (paramid == param->paramid)
8674 : {
8675 : /* Found a match, so return it. */
8676 1398 : *column_p = foreach_current_index(paramid);
8677 1398 : return subplan;
8678 : }
8679 : }
8680 : }
8681 1514 : return NULL;
8682 : }
8683 :
8684 : /*
8685 : * Display a Param appropriately.
8686 : */
8687 : static void
8688 7174 : get_parameter(Param *param, deparse_context *context)
8689 : {
8690 : Node *expr;
8691 : deparse_namespace *dpns;
8692 : ListCell *ancestor_cell;
8693 : SubPlan *subplan;
8694 : int column;
8695 :
8696 : /*
8697 : * If it's a PARAM_EXEC parameter, try to locate the expression from which
8698 : * the parameter was computed. This stanza handles only cases in which
8699 : * the Param represents an input to the subplan we are currently in.
8700 : */
8701 7174 : expr = find_param_referent(param, context, &dpns, &ancestor_cell);
8702 7174 : if (expr)
8703 : {
8704 : /* Found a match, so print it */
8705 : deparse_namespace save_dpns;
8706 : bool save_varprefix;
8707 : bool need_paren;
8708 :
8709 : /* Switch attention to the ancestor plan node */
8710 4622 : push_ancestor_plan(dpns, ancestor_cell, &save_dpns);
8711 :
8712 : /*
8713 : * Force prefixing of Vars, since they won't belong to the relation
8714 : * being scanned in the original plan node.
8715 : */
8716 4622 : save_varprefix = context->varprefix;
8717 4622 : context->varprefix = true;
8718 :
8719 : /*
8720 : * A Param's expansion is typically a Var, Aggref, GroupingFunc, or
8721 : * upper-level Param, which wouldn't need extra parentheses.
8722 : * Otherwise, insert parens to ensure the expression looks atomic.
8723 : */
8724 4640 : need_paren = !(IsA(expr, Var) ||
8725 18 : IsA(expr, Aggref) ||
8726 18 : IsA(expr, GroupingFunc) ||
8727 12 : IsA(expr, Param));
8728 4622 : if (need_paren)
8729 0 : appendStringInfoChar(context->buf, '(');
8730 :
8731 4622 : get_rule_expr(expr, context, false);
8732 :
8733 4622 : if (need_paren)
8734 0 : appendStringInfoChar(context->buf, ')');
8735 :
8736 4622 : context->varprefix = save_varprefix;
8737 :
8738 4622 : pop_ancestor_plan(dpns, &save_dpns);
8739 :
8740 4622 : return;
8741 : }
8742 :
8743 : /*
8744 : * Alternatively, maybe it's a subplan output, which we print as a
8745 : * reference to the subplan. (We could drill down into the subplan and
8746 : * print the relevant targetlist expression, but that has been deemed too
8747 : * confusing since it would violate normal SQL scope rules. Also, we're
8748 : * relying on this reference to show that the testexpr containing the
8749 : * Param has anything to do with that subplan at all.)
8750 : */
8751 2552 : subplan = find_param_generator(param, context, &column);
8752 2552 : if (subplan)
8753 : {
8754 : const char *nameprefix;
8755 :
8756 1660 : if (subplan->isInitPlan)
8757 1398 : nameprefix = "InitPlan ";
8758 : else
8759 262 : nameprefix = "SubPlan ";
8760 :
8761 1660 : appendStringInfo(context->buf, "(%s%s%s).col%d",
8762 1660 : subplan->useHashTable ? "hashed " : "",
8763 : nameprefix,
8764 : subplan->plan_name, column + 1);
8765 :
8766 1660 : return;
8767 : }
8768 :
8769 : /*
8770 : * If it's an external parameter, see if the outermost namespace provides
8771 : * function argument names.
8772 : */
8773 892 : if (param->paramkind == PARAM_EXTERN && context->namespaces != NIL)
8774 : {
8775 892 : dpns = llast(context->namespaces);
8776 892 : if (dpns->argnames &&
8777 68 : param->paramid > 0 &&
8778 68 : param->paramid <= dpns->numargs)
8779 : {
8780 68 : char *argname = dpns->argnames[param->paramid - 1];
8781 :
8782 68 : if (argname)
8783 : {
8784 68 : bool should_qualify = false;
8785 : ListCell *lc;
8786 :
8787 : /*
8788 : * Qualify the parameter name if there are any other deparse
8789 : * namespaces with range tables. This avoids qualifying in
8790 : * trivial cases like "RETURN a + b", but makes it safe in all
8791 : * other cases.
8792 : */
8793 156 : foreach(lc, context->namespaces)
8794 : {
8795 118 : deparse_namespace *depns = lfirst(lc);
8796 :
8797 118 : if (depns->rtable_names != NIL)
8798 : {
8799 30 : should_qualify = true;
8800 30 : break;
8801 : }
8802 : }
8803 68 : if (should_qualify)
8804 : {
8805 30 : appendStringInfoString(context->buf, quote_identifier(dpns->funcname));
8806 30 : appendStringInfoChar(context->buf, '.');
8807 : }
8808 :
8809 68 : appendStringInfoString(context->buf, quote_identifier(argname));
8810 68 : return;
8811 : }
8812 : }
8813 : }
8814 :
8815 : /*
8816 : * Not PARAM_EXEC, or couldn't find referent: just print $N.
8817 : *
8818 : * It's a bug if we get here for anything except PARAM_EXTERN Params, but
8819 : * in production builds printing $N seems more useful than failing.
8820 : */
8821 : Assert(param->paramkind == PARAM_EXTERN);
8822 :
8823 824 : appendStringInfo(context->buf, "$%d", param->paramid);
8824 : }
8825 :
8826 : /*
8827 : * get_simple_binary_op_name
8828 : *
8829 : * helper function for isSimpleNode
8830 : * will return single char binary operator name, or NULL if it's not
8831 : */
8832 : static const char *
8833 150 : get_simple_binary_op_name(OpExpr *expr)
8834 : {
8835 150 : List *args = expr->args;
8836 :
8837 150 : if (list_length(args) == 2)
8838 : {
8839 : /* binary operator */
8840 150 : Node *arg1 = (Node *) linitial(args);
8841 150 : Node *arg2 = (Node *) lsecond(args);
8842 : const char *op;
8843 :
8844 150 : op = generate_operator_name(expr->opno, exprType(arg1), exprType(arg2));
8845 150 : if (strlen(op) == 1)
8846 150 : return op;
8847 : }
8848 0 : return NULL;
8849 : }
8850 :
8851 :
8852 : /*
8853 : * isSimpleNode - check if given node is simple (doesn't need parenthesizing)
8854 : *
8855 : * true : simple in the context of parent node's type
8856 : * false : not simple
8857 : */
8858 : static bool
8859 5612 : isSimpleNode(Node *node, Node *parentNode, int prettyFlags)
8860 : {
8861 5612 : if (!node)
8862 0 : return false;
8863 :
8864 5612 : switch (nodeTag(node))
8865 : {
8866 4690 : case T_Var:
8867 : case T_Const:
8868 : case T_Param:
8869 : case T_CoerceToDomainValue:
8870 : case T_SetToDefault:
8871 : case T_CurrentOfExpr:
8872 : /* single words: always simple */
8873 4690 : return true;
8874 :
8875 500 : case T_SubscriptingRef:
8876 : case T_ArrayExpr:
8877 : case T_RowExpr:
8878 : case T_CoalesceExpr:
8879 : case T_MinMaxExpr:
8880 : case T_SQLValueFunction:
8881 : case T_XmlExpr:
8882 : case T_NextValueExpr:
8883 : case T_NullIfExpr:
8884 : case T_Aggref:
8885 : case T_GroupingFunc:
8886 : case T_WindowFunc:
8887 : case T_MergeSupportFunc:
8888 : case T_FuncExpr:
8889 : case T_JsonConstructorExpr:
8890 : case T_JsonExpr:
8891 : /* function-like: name(..) or name[..] */
8892 500 : return true;
8893 :
8894 : /* CASE keywords act as parentheses */
8895 8 : case T_CaseExpr:
8896 8 : return true;
8897 :
8898 66 : case T_FieldSelect:
8899 :
8900 : /*
8901 : * appears simple since . has top precedence, unless parent is
8902 : * T_FieldSelect itself!
8903 : */
8904 66 : return !IsA(parentNode, FieldSelect);
8905 :
8906 0 : case T_FieldStore:
8907 :
8908 : /*
8909 : * treat like FieldSelect (probably doesn't matter)
8910 : */
8911 0 : return !IsA(parentNode, FieldStore);
8912 :
8913 0 : case T_CoerceToDomain:
8914 : /* maybe simple, check args */
8915 0 : return isSimpleNode((Node *) ((CoerceToDomain *) node)->arg,
8916 : node, prettyFlags);
8917 26 : case T_RelabelType:
8918 26 : return isSimpleNode((Node *) ((RelabelType *) node)->arg,
8919 : node, prettyFlags);
8920 0 : case T_CoerceViaIO:
8921 0 : return isSimpleNode((Node *) ((CoerceViaIO *) node)->arg,
8922 : node, prettyFlags);
8923 0 : case T_ArrayCoerceExpr:
8924 0 : return isSimpleNode((Node *) ((ArrayCoerceExpr *) node)->arg,
8925 : node, prettyFlags);
8926 0 : case T_ConvertRowtypeExpr:
8927 0 : return isSimpleNode((Node *) ((ConvertRowtypeExpr *) node)->arg,
8928 : node, prettyFlags);
8929 0 : case T_ReturningExpr:
8930 0 : return isSimpleNode((Node *) ((ReturningExpr *) node)->retexpr,
8931 : node, prettyFlags);
8932 :
8933 278 : case T_OpExpr:
8934 : {
8935 : /* depends on parent node type; needs further checking */
8936 278 : if (prettyFlags & PRETTYFLAG_PAREN && IsA(parentNode, OpExpr))
8937 : {
8938 : const char *op;
8939 : const char *parentOp;
8940 : bool is_lopriop;
8941 : bool is_hipriop;
8942 : bool is_lopriparent;
8943 : bool is_hipriparent;
8944 :
8945 78 : op = get_simple_binary_op_name((OpExpr *) node);
8946 78 : if (!op)
8947 0 : return false;
8948 :
8949 : /* We know only the basic operators + - and * / % */
8950 78 : is_lopriop = (strchr("+-", *op) != NULL);
8951 78 : is_hipriop = (strchr("*/%", *op) != NULL);
8952 78 : if (!(is_lopriop || is_hipriop))
8953 6 : return false;
8954 :
8955 72 : parentOp = get_simple_binary_op_name((OpExpr *) parentNode);
8956 72 : if (!parentOp)
8957 0 : return false;
8958 :
8959 72 : is_lopriparent = (strchr("+-", *parentOp) != NULL);
8960 72 : is_hipriparent = (strchr("*/%", *parentOp) != NULL);
8961 72 : if (!(is_lopriparent || is_hipriparent))
8962 0 : return false;
8963 :
8964 72 : if (is_hipriop && is_lopriparent)
8965 12 : return true; /* op binds tighter than parent */
8966 :
8967 60 : if (is_lopriop && is_hipriparent)
8968 48 : return false;
8969 :
8970 : /*
8971 : * Operators are same priority --- can skip parens only if
8972 : * we have (a - b) - c, not a - (b - c).
8973 : */
8974 12 : if (node == (Node *) linitial(((OpExpr *) parentNode)->args))
8975 6 : return true;
8976 :
8977 6 : return false;
8978 : }
8979 : /* else do the same stuff as for T_SubLink et al. */
8980 : }
8981 : /* FALLTHROUGH */
8982 :
8983 : case T_SubLink:
8984 : case T_NullTest:
8985 : case T_BooleanTest:
8986 : case T_DistinctExpr:
8987 : case T_JsonIsPredicate:
8988 218 : switch (nodeTag(parentNode))
8989 : {
8990 36 : case T_FuncExpr:
8991 : {
8992 : /* special handling for casts and COERCE_SQL_SYNTAX */
8993 36 : CoercionForm type = ((FuncExpr *) parentNode)->funcformat;
8994 :
8995 36 : if (type == COERCE_EXPLICIT_CAST ||
8996 6 : type == COERCE_IMPLICIT_CAST ||
8997 : type == COERCE_SQL_SYNTAX)
8998 36 : return false;
8999 0 : return true; /* own parentheses */
9000 : }
9001 152 : case T_BoolExpr: /* lower precedence */
9002 : case T_SubscriptingRef: /* other separators */
9003 : case T_ArrayExpr: /* other separators */
9004 : case T_RowExpr: /* other separators */
9005 : case T_CoalesceExpr: /* own parentheses */
9006 : case T_MinMaxExpr: /* own parentheses */
9007 : case T_XmlExpr: /* own parentheses */
9008 : case T_NullIfExpr: /* other separators */
9009 : case T_Aggref: /* own parentheses */
9010 : case T_GroupingFunc: /* own parentheses */
9011 : case T_WindowFunc: /* own parentheses */
9012 : case T_CaseExpr: /* other separators */
9013 152 : return true;
9014 30 : default:
9015 30 : return false;
9016 : }
9017 :
9018 18 : case T_BoolExpr:
9019 18 : switch (nodeTag(parentNode))
9020 : {
9021 18 : case T_BoolExpr:
9022 18 : if (prettyFlags & PRETTYFLAG_PAREN)
9023 : {
9024 : BoolExprType type;
9025 : BoolExprType parentType;
9026 :
9027 18 : type = ((BoolExpr *) node)->boolop;
9028 18 : parentType = ((BoolExpr *) parentNode)->boolop;
9029 : switch (type)
9030 : {
9031 12 : case NOT_EXPR:
9032 : case AND_EXPR:
9033 12 : if (parentType == AND_EXPR || parentType == OR_EXPR)
9034 12 : return true;
9035 0 : break;
9036 6 : case OR_EXPR:
9037 6 : if (parentType == OR_EXPR)
9038 0 : return true;
9039 6 : break;
9040 : }
9041 : }
9042 6 : return false;
9043 0 : case T_FuncExpr:
9044 : {
9045 : /* special handling for casts and COERCE_SQL_SYNTAX */
9046 0 : CoercionForm type = ((FuncExpr *) parentNode)->funcformat;
9047 :
9048 0 : if (type == COERCE_EXPLICIT_CAST ||
9049 0 : type == COERCE_IMPLICIT_CAST ||
9050 : type == COERCE_SQL_SYNTAX)
9051 0 : return false;
9052 0 : return true; /* own parentheses */
9053 : }
9054 0 : case T_SubscriptingRef: /* other separators */
9055 : case T_ArrayExpr: /* other separators */
9056 : case T_RowExpr: /* other separators */
9057 : case T_CoalesceExpr: /* own parentheses */
9058 : case T_MinMaxExpr: /* own parentheses */
9059 : case T_XmlExpr: /* own parentheses */
9060 : case T_NullIfExpr: /* other separators */
9061 : case T_Aggref: /* own parentheses */
9062 : case T_GroupingFunc: /* own parentheses */
9063 : case T_WindowFunc: /* own parentheses */
9064 : case T_CaseExpr: /* other separators */
9065 : case T_JsonExpr: /* own parentheses */
9066 0 : return true;
9067 0 : default:
9068 0 : return false;
9069 : }
9070 :
9071 0 : case T_JsonValueExpr:
9072 : /* maybe simple, check args */
9073 0 : return isSimpleNode((Node *) ((JsonValueExpr *) node)->raw_expr,
9074 : node, prettyFlags);
9075 :
9076 8 : default:
9077 8 : break;
9078 : }
9079 : /* those we don't know: in dubio complexo */
9080 8 : return false;
9081 : }
9082 :
9083 :
9084 : /*
9085 : * appendContextKeyword - append a keyword to buffer
9086 : *
9087 : * If prettyPrint is enabled, perform a line break, and adjust indentation.
9088 : * Otherwise, just append the keyword.
9089 : */
9090 : static void
9091 30080 : appendContextKeyword(deparse_context *context, const char *str,
9092 : int indentBefore, int indentAfter, int indentPlus)
9093 : {
9094 30080 : StringInfo buf = context->buf;
9095 :
9096 30080 : if (PRETTY_INDENT(context))
9097 : {
9098 : int indentAmount;
9099 :
9100 29164 : context->indentLevel += indentBefore;
9101 :
9102 : /* remove any trailing spaces currently in the buffer ... */
9103 29164 : removeStringInfoSpaces(buf);
9104 : /* ... then add a newline and some spaces */
9105 29164 : appendStringInfoChar(buf, '\n');
9106 :
9107 29164 : if (context->indentLevel < PRETTYINDENT_LIMIT)
9108 29164 : indentAmount = Max(context->indentLevel, 0) + indentPlus;
9109 : else
9110 : {
9111 : /*
9112 : * If we're indented more than PRETTYINDENT_LIMIT characters, try
9113 : * to conserve horizontal space by reducing the per-level
9114 : * indentation. For best results the scale factor here should
9115 : * divide all the indent amounts that get added to indentLevel
9116 : * (PRETTYINDENT_STD, etc). It's important that the indentation
9117 : * not grow unboundedly, else deeply-nested trees use O(N^2)
9118 : * whitespace; so we also wrap modulo PRETTYINDENT_LIMIT.
9119 : */
9120 0 : indentAmount = PRETTYINDENT_LIMIT +
9121 0 : (context->indentLevel - PRETTYINDENT_LIMIT) /
9122 : (PRETTYINDENT_STD / 2);
9123 0 : indentAmount %= PRETTYINDENT_LIMIT;
9124 : /* scale/wrap logic affects indentLevel, but not indentPlus */
9125 0 : indentAmount += indentPlus;
9126 : }
9127 29164 : appendStringInfoSpaces(buf, indentAmount);
9128 :
9129 29164 : appendStringInfoString(buf, str);
9130 :
9131 29164 : context->indentLevel += indentAfter;
9132 29164 : if (context->indentLevel < 0)
9133 0 : context->indentLevel = 0;
9134 : }
9135 : else
9136 916 : appendStringInfoString(buf, str);
9137 30080 : }
9138 :
9139 : /*
9140 : * removeStringInfoSpaces - delete trailing spaces from a buffer.
9141 : *
9142 : * Possibly this should move to stringinfo.c at some point.
9143 : */
9144 : static void
9145 29646 : removeStringInfoSpaces(StringInfo str)
9146 : {
9147 46482 : while (str->len > 0 && str->data[str->len - 1] == ' ')
9148 16836 : str->data[--(str->len)] = '\0';
9149 29646 : }
9150 :
9151 :
9152 : /*
9153 : * get_rule_expr_paren - deparse expr using get_rule_expr,
9154 : * embracing the string with parentheses if necessary for prettyPrint.
9155 : *
9156 : * Never embrace if prettyFlags=0, because it's done in the calling node.
9157 : *
9158 : * Any node that does *not* embrace its argument node by sql syntax (with
9159 : * parentheses, non-operator keywords like CASE/WHEN/ON, or comma etc) should
9160 : * use get_rule_expr_paren instead of get_rule_expr so parentheses can be
9161 : * added.
9162 : */
9163 : static void
9164 163232 : get_rule_expr_paren(Node *node, deparse_context *context,
9165 : bool showimplicit, Node *parentNode)
9166 : {
9167 : bool need_paren;
9168 :
9169 168818 : need_paren = PRETTY_PAREN(context) &&
9170 5586 : !isSimpleNode(node, parentNode, context->prettyFlags);
9171 :
9172 163232 : if (need_paren)
9173 140 : appendStringInfoChar(context->buf, '(');
9174 :
9175 163232 : get_rule_expr(node, context, showimplicit);
9176 :
9177 163232 : if (need_paren)
9178 140 : appendStringInfoChar(context->buf, ')');
9179 163232 : }
9180 :
9181 : static void
9182 84 : get_json_behavior(JsonBehavior *behavior, deparse_context *context,
9183 : const char *on)
9184 : {
9185 : /*
9186 : * The order of array elements must correspond to the order of
9187 : * JsonBehaviorType members.
9188 : */
9189 84 : const char *behavior_names[] =
9190 : {
9191 : " NULL",
9192 : " ERROR",
9193 : " EMPTY",
9194 : " TRUE",
9195 : " FALSE",
9196 : " UNKNOWN",
9197 : " EMPTY ARRAY",
9198 : " EMPTY OBJECT",
9199 : " DEFAULT "
9200 : };
9201 :
9202 84 : if ((int) behavior->btype < 0 || behavior->btype >= lengthof(behavior_names))
9203 0 : elog(ERROR, "invalid json behavior type: %d", behavior->btype);
9204 :
9205 84 : appendStringInfoString(context->buf, behavior_names[behavior->btype]);
9206 :
9207 84 : if (behavior->btype == JSON_BEHAVIOR_DEFAULT)
9208 18 : get_rule_expr(behavior->expr, context, false);
9209 :
9210 84 : appendStringInfo(context->buf, " ON %s", on);
9211 84 : }
9212 :
9213 : /*
9214 : * get_json_expr_options
9215 : *
9216 : * Parse back common options for JSON_QUERY, JSON_VALUE, JSON_EXISTS and
9217 : * JSON_TABLE columns.
9218 : */
9219 : static void
9220 456 : get_json_expr_options(JsonExpr *jsexpr, deparse_context *context,
9221 : JsonBehaviorType default_behavior)
9222 : {
9223 456 : if (jsexpr->op == JSON_QUERY_OP)
9224 : {
9225 210 : if (jsexpr->wrapper == JSW_CONDITIONAL)
9226 12 : appendStringInfoString(context->buf, " WITH CONDITIONAL WRAPPER");
9227 198 : else if (jsexpr->wrapper == JSW_UNCONDITIONAL)
9228 30 : appendStringInfoString(context->buf, " WITH UNCONDITIONAL WRAPPER");
9229 : /* The default */
9230 168 : else if (jsexpr->wrapper == JSW_NONE || jsexpr->wrapper == JSW_UNSPEC)
9231 168 : appendStringInfoString(context->buf, " WITHOUT WRAPPER");
9232 :
9233 210 : if (jsexpr->omit_quotes)
9234 42 : appendStringInfoString(context->buf, " OMIT QUOTES");
9235 : /* The default */
9236 : else
9237 168 : appendStringInfoString(context->buf, " KEEP QUOTES");
9238 : }
9239 :
9240 456 : if (jsexpr->on_empty && jsexpr->on_empty->btype != default_behavior)
9241 30 : get_json_behavior(jsexpr->on_empty, context, "EMPTY");
9242 :
9243 456 : if (jsexpr->on_error && jsexpr->on_error->btype != default_behavior)
9244 48 : get_json_behavior(jsexpr->on_error, context, "ERROR");
9245 456 : }
9246 :
9247 : /* ----------
9248 : * get_rule_expr - Parse back an expression
9249 : *
9250 : * Note: showimplicit determines whether we display any implicit cast that
9251 : * is present at the top of the expression tree. It is a passed argument,
9252 : * not a field of the context struct, because we change the value as we
9253 : * recurse down into the expression. In general we suppress implicit casts
9254 : * when the result type is known with certainty (eg, the arguments of an
9255 : * OR must be boolean). We display implicit casts for arguments of functions
9256 : * and operators, since this is needed to be certain that the same function
9257 : * or operator will be chosen when the expression is re-parsed.
9258 : * ----------
9259 : */
9260 : static void
9261 352950 : get_rule_expr(Node *node, deparse_context *context,
9262 : bool showimplicit)
9263 : {
9264 352950 : StringInfo buf = context->buf;
9265 :
9266 352950 : if (node == NULL)
9267 90 : return;
9268 :
9269 : /* Guard against excessively long or deeply-nested queries */
9270 352860 : CHECK_FOR_INTERRUPTS();
9271 352860 : check_stack_depth();
9272 :
9273 : /*
9274 : * Each level of get_rule_expr must emit an indivisible term
9275 : * (parenthesized if necessary) to ensure result is reparsed into the same
9276 : * expression tree. The only exception is that when the input is a List,
9277 : * we emit the component items comma-separated with no surrounding
9278 : * decoration; this is convenient for most callers.
9279 : */
9280 352860 : switch (nodeTag(node))
9281 : {
9282 170698 : case T_Var:
9283 170698 : (void) get_variable((Var *) node, 0, false, context);
9284 170698 : break;
9285 :
9286 61762 : case T_Const:
9287 61762 : get_const_expr((Const *) node, context, 0);
9288 61762 : break;
9289 :
9290 7174 : case T_Param:
9291 7174 : get_parameter((Param *) node, context);
9292 7174 : break;
9293 :
9294 3922 : case T_Aggref:
9295 3922 : get_agg_expr((Aggref *) node, context, (Aggref *) node);
9296 3922 : break;
9297 :
9298 112 : case T_GroupingFunc:
9299 : {
9300 112 : GroupingFunc *gexpr = (GroupingFunc *) node;
9301 :
9302 112 : appendStringInfoString(buf, "GROUPING(");
9303 112 : get_rule_expr((Node *) gexpr->args, context, true);
9304 112 : appendStringInfoChar(buf, ')');
9305 : }
9306 112 : break;
9307 :
9308 324 : case T_WindowFunc:
9309 324 : get_windowfunc_expr((WindowFunc *) node, context);
9310 324 : break;
9311 :
9312 6 : case T_MergeSupportFunc:
9313 6 : appendStringInfoString(buf, "MERGE_ACTION()");
9314 6 : break;
9315 :
9316 328 : case T_SubscriptingRef:
9317 : {
9318 328 : SubscriptingRef *sbsref = (SubscriptingRef *) node;
9319 : bool need_parens;
9320 :
9321 : /*
9322 : * If the argument is a CaseTestExpr, we must be inside a
9323 : * FieldStore, ie, we are assigning to an element of an array
9324 : * within a composite column. Since we already punted on
9325 : * displaying the FieldStore's target information, just punt
9326 : * here too, and display only the assignment source
9327 : * expression.
9328 : */
9329 328 : if (IsA(sbsref->refexpr, CaseTestExpr))
9330 : {
9331 : Assert(sbsref->refassgnexpr);
9332 0 : get_rule_expr((Node *) sbsref->refassgnexpr,
9333 : context, showimplicit);
9334 0 : break;
9335 : }
9336 :
9337 : /*
9338 : * Parenthesize the argument unless it's a simple Var or a
9339 : * FieldSelect. (In particular, if it's another
9340 : * SubscriptingRef, we *must* parenthesize to avoid
9341 : * confusion.)
9342 : */
9343 482 : need_parens = !IsA(sbsref->refexpr, Var) &&
9344 154 : !IsA(sbsref->refexpr, FieldSelect);
9345 328 : if (need_parens)
9346 94 : appendStringInfoChar(buf, '(');
9347 328 : get_rule_expr((Node *) sbsref->refexpr, context, showimplicit);
9348 328 : if (need_parens)
9349 94 : appendStringInfoChar(buf, ')');
9350 :
9351 : /*
9352 : * If there's a refassgnexpr, we want to print the node in the
9353 : * format "container[subscripts] := refassgnexpr". This is
9354 : * not legal SQL, so decompilation of INSERT or UPDATE
9355 : * statements should always use processIndirection as part of
9356 : * the statement-level syntax. We should only see this when
9357 : * EXPLAIN tries to print the targetlist of a plan resulting
9358 : * from such a statement.
9359 : */
9360 328 : if (sbsref->refassgnexpr)
9361 : {
9362 : Node *refassgnexpr;
9363 :
9364 : /*
9365 : * Use processIndirection to print this node's subscripts
9366 : * as well as any additional field selections or
9367 : * subscripting in immediate descendants. It returns the
9368 : * RHS expr that is actually being "assigned".
9369 : */
9370 12 : refassgnexpr = processIndirection(node, context);
9371 12 : appendStringInfoString(buf, " := ");
9372 12 : get_rule_expr(refassgnexpr, context, showimplicit);
9373 : }
9374 : else
9375 : {
9376 : /* Just an ordinary container fetch, so print subscripts */
9377 316 : printSubscripts(sbsref, context);
9378 : }
9379 : }
9380 328 : break;
9381 :
9382 12562 : case T_FuncExpr:
9383 12562 : get_func_expr((FuncExpr *) node, context, showimplicit);
9384 12562 : break;
9385 :
9386 30 : case T_NamedArgExpr:
9387 : {
9388 30 : NamedArgExpr *na = (NamedArgExpr *) node;
9389 :
9390 30 : appendStringInfo(buf, "%s => ", quote_identifier(na->name));
9391 30 : get_rule_expr((Node *) na->arg, context, showimplicit);
9392 : }
9393 30 : break;
9394 :
9395 61118 : case T_OpExpr:
9396 61118 : get_oper_expr((OpExpr *) node, context);
9397 61118 : break;
9398 :
9399 18 : case T_DistinctExpr:
9400 : {
9401 18 : DistinctExpr *expr = (DistinctExpr *) node;
9402 18 : List *args = expr->args;
9403 18 : Node *arg1 = (Node *) linitial(args);
9404 18 : Node *arg2 = (Node *) lsecond(args);
9405 :
9406 18 : if (!PRETTY_PAREN(context))
9407 12 : appendStringInfoChar(buf, '(');
9408 18 : get_rule_expr_paren(arg1, context, true, node);
9409 18 : appendStringInfoString(buf, " IS DISTINCT FROM ");
9410 18 : get_rule_expr_paren(arg2, context, true, node);
9411 18 : if (!PRETTY_PAREN(context))
9412 12 : appendStringInfoChar(buf, ')');
9413 : }
9414 18 : break;
9415 :
9416 160 : case T_NullIfExpr:
9417 : {
9418 160 : NullIfExpr *nullifexpr = (NullIfExpr *) node;
9419 :
9420 160 : appendStringInfoString(buf, "NULLIF(");
9421 160 : get_rule_expr((Node *) nullifexpr->args, context, true);
9422 160 : appendStringInfoChar(buf, ')');
9423 : }
9424 160 : break;
9425 :
9426 3032 : case T_ScalarArrayOpExpr:
9427 : {
9428 3032 : ScalarArrayOpExpr *expr = (ScalarArrayOpExpr *) node;
9429 3032 : List *args = expr->args;
9430 3032 : Node *arg1 = (Node *) linitial(args);
9431 3032 : Node *arg2 = (Node *) lsecond(args);
9432 :
9433 3032 : if (!PRETTY_PAREN(context))
9434 3018 : appendStringInfoChar(buf, '(');
9435 3032 : get_rule_expr_paren(arg1, context, true, node);
9436 3032 : appendStringInfo(buf, " %s %s (",
9437 : generate_operator_name(expr->opno,
9438 : exprType(arg1),
9439 : get_base_element_type(exprType(arg2))),
9440 3032 : expr->useOr ? "ANY" : "ALL");
9441 3032 : get_rule_expr_paren(arg2, context, true, node);
9442 :
9443 : /*
9444 : * There's inherent ambiguity in "x op ANY/ALL (y)" when y is
9445 : * a bare sub-SELECT. Since we're here, the sub-SELECT must
9446 : * be meant as a scalar sub-SELECT yielding an array value to
9447 : * be used in ScalarArrayOpExpr; but the grammar will
9448 : * preferentially interpret such a construct as an ANY/ALL
9449 : * SubLink. To prevent misparsing the output that way, insert
9450 : * a dummy coercion (which will be stripped by parse analysis,
9451 : * so no inefficiency is added in dump and reload). This is
9452 : * indeed most likely what the user wrote to get the construct
9453 : * accepted in the first place.
9454 : */
9455 3032 : if (IsA(arg2, SubLink) &&
9456 6 : ((SubLink *) arg2)->subLinkType == EXPR_SUBLINK)
9457 6 : appendStringInfo(buf, "::%s",
9458 : format_type_with_typemod(exprType(arg2),
9459 : exprTypmod(arg2)));
9460 3032 : appendStringInfoChar(buf, ')');
9461 3032 : if (!PRETTY_PAREN(context))
9462 3018 : appendStringInfoChar(buf, ')');
9463 : }
9464 3032 : break;
9465 :
9466 11176 : case T_BoolExpr:
9467 : {
9468 11176 : BoolExpr *expr = (BoolExpr *) node;
9469 11176 : Node *first_arg = linitial(expr->args);
9470 : ListCell *arg;
9471 :
9472 11176 : switch (expr->boolop)
9473 : {
9474 8908 : case AND_EXPR:
9475 8908 : if (!PRETTY_PAREN(context))
9476 8846 : appendStringInfoChar(buf, '(');
9477 8908 : get_rule_expr_paren(first_arg, context,
9478 : false, node);
9479 20300 : for_each_from(arg, expr->args, 1)
9480 : {
9481 11392 : appendStringInfoString(buf, " AND ");
9482 11392 : get_rule_expr_paren((Node *) lfirst(arg), context,
9483 : false, node);
9484 : }
9485 8908 : if (!PRETTY_PAREN(context))
9486 8846 : appendStringInfoChar(buf, ')');
9487 8908 : break;
9488 :
9489 1902 : case OR_EXPR:
9490 1902 : if (!PRETTY_PAREN(context))
9491 1888 : appendStringInfoChar(buf, '(');
9492 1902 : get_rule_expr_paren(first_arg, context,
9493 : false, node);
9494 4520 : for_each_from(arg, expr->args, 1)
9495 : {
9496 2618 : appendStringInfoString(buf, " OR ");
9497 2618 : get_rule_expr_paren((Node *) lfirst(arg), context,
9498 : false, node);
9499 : }
9500 1902 : if (!PRETTY_PAREN(context))
9501 1888 : appendStringInfoChar(buf, ')');
9502 1902 : break;
9503 :
9504 366 : case NOT_EXPR:
9505 366 : if (!PRETTY_PAREN(context))
9506 354 : appendStringInfoChar(buf, '(');
9507 366 : appendStringInfoString(buf, "NOT ");
9508 366 : get_rule_expr_paren(first_arg, context,
9509 : false, node);
9510 366 : if (!PRETTY_PAREN(context))
9511 354 : appendStringInfoChar(buf, ')');
9512 366 : break;
9513 :
9514 0 : default:
9515 0 : elog(ERROR, "unrecognized boolop: %d",
9516 : (int) expr->boolop);
9517 : }
9518 : }
9519 11176 : break;
9520 :
9521 460 : case T_SubLink:
9522 460 : get_sublink_expr((SubLink *) node, context);
9523 460 : break;
9524 :
9525 728 : case T_SubPlan:
9526 : {
9527 728 : SubPlan *subplan = (SubPlan *) node;
9528 :
9529 : /*
9530 : * We cannot see an already-planned subplan in rule deparsing,
9531 : * only while EXPLAINing a query plan. We don't try to
9532 : * reconstruct the original SQL, just reference the subplan
9533 : * that appears elsewhere in EXPLAIN's result. It does seem
9534 : * useful to show the subLinkType and testexpr (if any), and
9535 : * we also note whether the subplan will be hashed.
9536 : */
9537 728 : switch (subplan->subLinkType)
9538 : {
9539 96 : case EXISTS_SUBLINK:
9540 96 : appendStringInfoString(buf, "EXISTS(");
9541 : Assert(subplan->testexpr == NULL);
9542 96 : break;
9543 6 : case ALL_SUBLINK:
9544 6 : appendStringInfoString(buf, "(ALL ");
9545 : Assert(subplan->testexpr != NULL);
9546 6 : break;
9547 166 : case ANY_SUBLINK:
9548 166 : appendStringInfoString(buf, "(ANY ");
9549 : Assert(subplan->testexpr != NULL);
9550 166 : break;
9551 6 : case ROWCOMPARE_SUBLINK:
9552 : /* Parenthesizing the testexpr seems sufficient */
9553 6 : appendStringInfoChar(buf, '(');
9554 : Assert(subplan->testexpr != NULL);
9555 6 : break;
9556 416 : case EXPR_SUBLINK:
9557 : /* No need to decorate these subplan references */
9558 416 : appendStringInfoChar(buf, '(');
9559 : Assert(subplan->testexpr == NULL);
9560 416 : break;
9561 26 : case MULTIEXPR_SUBLINK:
9562 : /* MULTIEXPR isn't executed in the normal way */
9563 26 : appendStringInfoString(buf, "(rescan ");
9564 : Assert(subplan->testexpr == NULL);
9565 26 : break;
9566 12 : case ARRAY_SUBLINK:
9567 12 : appendStringInfoString(buf, "ARRAY(");
9568 : Assert(subplan->testexpr == NULL);
9569 12 : break;
9570 0 : case CTE_SUBLINK:
9571 : /* This case is unreachable within expressions */
9572 0 : appendStringInfoString(buf, "CTE(");
9573 : Assert(subplan->testexpr == NULL);
9574 0 : break;
9575 : }
9576 :
9577 728 : if (subplan->testexpr != NULL)
9578 : {
9579 : deparse_namespace *dpns;
9580 :
9581 : /*
9582 : * Push SubPlan into ancestors list while deparsing
9583 : * testexpr, so that we can handle PARAM_EXEC references
9584 : * to the SubPlan's paramIds. (This makes it look like
9585 : * the SubPlan is an "ancestor" of the current plan node,
9586 : * which is a little weird, but it does no harm.) In this
9587 : * path, we don't need to mention the SubPlan explicitly,
9588 : * because the referencing Params will show its existence.
9589 : */
9590 178 : dpns = (deparse_namespace *) linitial(context->namespaces);
9591 178 : dpns->ancestors = lcons(subplan, dpns->ancestors);
9592 :
9593 178 : get_rule_expr(subplan->testexpr, context, showimplicit);
9594 178 : appendStringInfoChar(buf, ')');
9595 :
9596 178 : dpns->ancestors = list_delete_first(dpns->ancestors);
9597 : }
9598 : else
9599 : {
9600 : const char *nameprefix;
9601 :
9602 : /* No referencing Params, so show the SubPlan's name */
9603 550 : if (subplan->isInitPlan)
9604 0 : nameprefix = "InitPlan ";
9605 : else
9606 550 : nameprefix = "SubPlan ";
9607 550 : if (subplan->useHashTable)
9608 0 : appendStringInfo(buf, "hashed %s%s)",
9609 : nameprefix, subplan->plan_name);
9610 : else
9611 550 : appendStringInfo(buf, "%s%s)",
9612 : nameprefix, subplan->plan_name);
9613 : }
9614 : }
9615 728 : break;
9616 :
9617 0 : case T_AlternativeSubPlan:
9618 : {
9619 0 : AlternativeSubPlan *asplan = (AlternativeSubPlan *) node;
9620 : ListCell *lc;
9621 :
9622 : /*
9623 : * This case cannot be reached in normal usage, since no
9624 : * AlternativeSubPlan can appear either in parsetrees or
9625 : * finished plan trees. We keep it just in case somebody
9626 : * wants to use this code to print planner data structures.
9627 : */
9628 0 : appendStringInfoString(buf, "(alternatives: ");
9629 0 : foreach(lc, asplan->subplans)
9630 : {
9631 0 : SubPlan *splan = lfirst_node(SubPlan, lc);
9632 : const char *nameprefix;
9633 :
9634 0 : if (splan->isInitPlan)
9635 0 : nameprefix = "InitPlan ";
9636 : else
9637 0 : nameprefix = "SubPlan ";
9638 0 : if (splan->useHashTable)
9639 0 : appendStringInfo(buf, "hashed %s%s", nameprefix,
9640 : splan->plan_name);
9641 : else
9642 0 : appendStringInfo(buf, "%s%s", nameprefix,
9643 : splan->plan_name);
9644 0 : if (lnext(asplan->subplans, lc))
9645 0 : appendStringInfoString(buf, " or ");
9646 : }
9647 0 : appendStringInfoChar(buf, ')');
9648 : }
9649 0 : break;
9650 :
9651 1154 : case T_FieldSelect:
9652 : {
9653 1154 : FieldSelect *fselect = (FieldSelect *) node;
9654 1154 : Node *arg = (Node *) fselect->arg;
9655 1154 : int fno = fselect->fieldnum;
9656 : const char *fieldname;
9657 : bool need_parens;
9658 :
9659 : /*
9660 : * Parenthesize the argument unless it's an SubscriptingRef or
9661 : * another FieldSelect. Note in particular that it would be
9662 : * WRONG to not parenthesize a Var argument; simplicity is not
9663 : * the issue here, having the right number of names is.
9664 : */
9665 2272 : need_parens = !IsA(arg, SubscriptingRef) &&
9666 1118 : !IsA(arg, FieldSelect);
9667 1154 : if (need_parens)
9668 1118 : appendStringInfoChar(buf, '(');
9669 1154 : get_rule_expr(arg, context, true);
9670 1154 : if (need_parens)
9671 1118 : appendStringInfoChar(buf, ')');
9672 :
9673 : /*
9674 : * Get and print the field name.
9675 : */
9676 1154 : fieldname = get_name_for_var_field((Var *) arg, fno,
9677 : 0, context);
9678 1154 : appendStringInfo(buf, ".%s", quote_identifier(fieldname));
9679 : }
9680 1154 : break;
9681 :
9682 6 : case T_FieldStore:
9683 : {
9684 6 : FieldStore *fstore = (FieldStore *) node;
9685 : bool need_parens;
9686 :
9687 : /*
9688 : * There is no good way to represent a FieldStore as real SQL,
9689 : * so decompilation of INSERT or UPDATE statements should
9690 : * always use processIndirection as part of the
9691 : * statement-level syntax. We should only get here when
9692 : * EXPLAIN tries to print the targetlist of a plan resulting
9693 : * from such a statement. The plan case is even harder than
9694 : * ordinary rules would be, because the planner tries to
9695 : * collapse multiple assignments to the same field or subfield
9696 : * into one FieldStore; so we can see a list of target fields
9697 : * not just one, and the arguments could be FieldStores
9698 : * themselves. We don't bother to try to print the target
9699 : * field names; we just print the source arguments, with a
9700 : * ROW() around them if there's more than one. This isn't
9701 : * terribly complete, but it's probably good enough for
9702 : * EXPLAIN's purposes; especially since anything more would be
9703 : * either hopelessly confusing or an even poorer
9704 : * representation of what the plan is actually doing.
9705 : */
9706 6 : need_parens = (list_length(fstore->newvals) != 1);
9707 6 : if (need_parens)
9708 6 : appendStringInfoString(buf, "ROW(");
9709 6 : get_rule_expr((Node *) fstore->newvals, context, showimplicit);
9710 6 : if (need_parens)
9711 6 : appendStringInfoChar(buf, ')');
9712 : }
9713 6 : break;
9714 :
9715 2624 : case T_RelabelType:
9716 : {
9717 2624 : RelabelType *relabel = (RelabelType *) node;
9718 2624 : Node *arg = (Node *) relabel->arg;
9719 :
9720 2624 : if (relabel->relabelformat == COERCE_IMPLICIT_CAST &&
9721 2424 : !showimplicit)
9722 : {
9723 : /* don't show the implicit cast */
9724 74 : get_rule_expr_paren(arg, context, false, node);
9725 : }
9726 : else
9727 : {
9728 2550 : get_coercion_expr(arg, context,
9729 : relabel->resulttype,
9730 : relabel->resulttypmod,
9731 : node);
9732 : }
9733 : }
9734 2624 : break;
9735 :
9736 668 : case T_CoerceViaIO:
9737 : {
9738 668 : CoerceViaIO *iocoerce = (CoerceViaIO *) node;
9739 668 : Node *arg = (Node *) iocoerce->arg;
9740 :
9741 668 : if (iocoerce->coerceformat == COERCE_IMPLICIT_CAST &&
9742 24 : !showimplicit)
9743 : {
9744 : /* don't show the implicit cast */
9745 24 : get_rule_expr_paren(arg, context, false, node);
9746 : }
9747 : else
9748 : {
9749 644 : get_coercion_expr(arg, context,
9750 : iocoerce->resulttype,
9751 : -1,
9752 : node);
9753 : }
9754 : }
9755 668 : break;
9756 :
9757 52 : case T_ArrayCoerceExpr:
9758 : {
9759 52 : ArrayCoerceExpr *acoerce = (ArrayCoerceExpr *) node;
9760 52 : Node *arg = (Node *) acoerce->arg;
9761 :
9762 52 : if (acoerce->coerceformat == COERCE_IMPLICIT_CAST &&
9763 52 : !showimplicit)
9764 : {
9765 : /* don't show the implicit cast */
9766 0 : get_rule_expr_paren(arg, context, false, node);
9767 : }
9768 : else
9769 : {
9770 52 : get_coercion_expr(arg, context,
9771 : acoerce->resulttype,
9772 : acoerce->resulttypmod,
9773 : node);
9774 : }
9775 : }
9776 52 : break;
9777 :
9778 88 : case T_ConvertRowtypeExpr:
9779 : {
9780 88 : ConvertRowtypeExpr *convert = (ConvertRowtypeExpr *) node;
9781 88 : Node *arg = (Node *) convert->arg;
9782 :
9783 88 : if (convert->convertformat == COERCE_IMPLICIT_CAST &&
9784 82 : !showimplicit)
9785 : {
9786 : /* don't show the implicit cast */
9787 24 : get_rule_expr_paren(arg, context, false, node);
9788 : }
9789 : else
9790 : {
9791 64 : get_coercion_expr(arg, context,
9792 : convert->resulttype, -1,
9793 : node);
9794 : }
9795 : }
9796 88 : break;
9797 :
9798 90 : case T_CollateExpr:
9799 : {
9800 90 : CollateExpr *collate = (CollateExpr *) node;
9801 90 : Node *arg = (Node *) collate->arg;
9802 :
9803 90 : if (!PRETTY_PAREN(context))
9804 84 : appendStringInfoChar(buf, '(');
9805 90 : get_rule_expr_paren(arg, context, showimplicit, node);
9806 90 : appendStringInfo(buf, " COLLATE %s",
9807 : generate_collation_name(collate->collOid));
9808 90 : if (!PRETTY_PAREN(context))
9809 84 : appendStringInfoChar(buf, ')');
9810 : }
9811 90 : break;
9812 :
9813 614 : case T_CaseExpr:
9814 : {
9815 614 : CaseExpr *caseexpr = (CaseExpr *) node;
9816 : ListCell *temp;
9817 :
9818 614 : appendContextKeyword(context, "CASE",
9819 : 0, PRETTYINDENT_VAR, 0);
9820 614 : if (caseexpr->arg)
9821 : {
9822 192 : appendStringInfoChar(buf, ' ');
9823 192 : get_rule_expr((Node *) caseexpr->arg, context, true);
9824 : }
9825 2698 : foreach(temp, caseexpr->args)
9826 : {
9827 2084 : CaseWhen *when = (CaseWhen *) lfirst(temp);
9828 2084 : Node *w = (Node *) when->expr;
9829 :
9830 2084 : if (caseexpr->arg)
9831 : {
9832 : /*
9833 : * The parser should have produced WHEN clauses of the
9834 : * form "CaseTestExpr = RHS", possibly with an
9835 : * implicit coercion inserted above the CaseTestExpr.
9836 : * For accurate decompilation of rules it's essential
9837 : * that we show just the RHS. However in an
9838 : * expression that's been through the optimizer, the
9839 : * WHEN clause could be almost anything (since the
9840 : * equality operator could have been expanded into an
9841 : * inline function). If we don't recognize the form
9842 : * of the WHEN clause, just punt and display it as-is.
9843 : */
9844 798 : if (IsA(w, OpExpr))
9845 : {
9846 798 : List *args = ((OpExpr *) w)->args;
9847 :
9848 798 : if (list_length(args) == 2 &&
9849 798 : IsA(strip_implicit_coercions(linitial(args)),
9850 : CaseTestExpr))
9851 798 : w = (Node *) lsecond(args);
9852 : }
9853 : }
9854 :
9855 2084 : if (!PRETTY_INDENT(context))
9856 118 : appendStringInfoChar(buf, ' ');
9857 2084 : appendContextKeyword(context, "WHEN ",
9858 : 0, 0, 0);
9859 2084 : get_rule_expr(w, context, false);
9860 2084 : appendStringInfoString(buf, " THEN ");
9861 2084 : get_rule_expr((Node *) when->result, context, true);
9862 : }
9863 614 : if (!PRETTY_INDENT(context))
9864 108 : appendStringInfoChar(buf, ' ');
9865 614 : appendContextKeyword(context, "ELSE ",
9866 : 0, 0, 0);
9867 614 : get_rule_expr((Node *) caseexpr->defresult, context, true);
9868 614 : if (!PRETTY_INDENT(context))
9869 108 : appendStringInfoChar(buf, ' ');
9870 614 : appendContextKeyword(context, "END",
9871 : -PRETTYINDENT_VAR, 0, 0);
9872 : }
9873 614 : break;
9874 :
9875 0 : case T_CaseTestExpr:
9876 : {
9877 : /*
9878 : * Normally we should never get here, since for expressions
9879 : * that can contain this node type we attempt to avoid
9880 : * recursing to it. But in an optimized expression we might
9881 : * be unable to avoid that (see comments for CaseExpr). If we
9882 : * do see one, print it as CASE_TEST_EXPR.
9883 : */
9884 0 : appendStringInfoString(buf, "CASE_TEST_EXPR");
9885 : }
9886 0 : break;
9887 :
9888 562 : case T_ArrayExpr:
9889 : {
9890 562 : ArrayExpr *arrayexpr = (ArrayExpr *) node;
9891 :
9892 562 : appendStringInfoString(buf, "ARRAY[");
9893 562 : get_rule_expr((Node *) arrayexpr->elements, context, true);
9894 562 : appendStringInfoChar(buf, ']');
9895 :
9896 : /*
9897 : * If the array isn't empty, we assume its elements are
9898 : * coerced to the desired type. If it's empty, though, we
9899 : * need an explicit coercion to the array type.
9900 : */
9901 562 : if (arrayexpr->elements == NIL)
9902 6 : appendStringInfo(buf, "::%s",
9903 : format_type_with_typemod(arrayexpr->array_typeid, -1));
9904 : }
9905 562 : break;
9906 :
9907 192 : case T_RowExpr:
9908 : {
9909 192 : RowExpr *rowexpr = (RowExpr *) node;
9910 192 : TupleDesc tupdesc = NULL;
9911 : ListCell *arg;
9912 : int i;
9913 : char *sep;
9914 :
9915 : /*
9916 : * If it's a named type and not RECORD, we may have to skip
9917 : * dropped columns and/or claim there are NULLs for added
9918 : * columns.
9919 : */
9920 192 : if (rowexpr->row_typeid != RECORDOID)
9921 : {
9922 54 : tupdesc = lookup_rowtype_tupdesc(rowexpr->row_typeid, -1);
9923 : Assert(list_length(rowexpr->args) <= tupdesc->natts);
9924 : }
9925 :
9926 : /*
9927 : * SQL99 allows "ROW" to be omitted when there is more than
9928 : * one column, but for simplicity we always print it.
9929 : */
9930 192 : appendStringInfoString(buf, "ROW(");
9931 192 : sep = "";
9932 192 : i = 0;
9933 570 : foreach(arg, rowexpr->args)
9934 : {
9935 378 : Node *e = (Node *) lfirst(arg);
9936 :
9937 378 : if (tupdesc == NULL ||
9938 120 : !TupleDescCompactAttr(tupdesc, i)->attisdropped)
9939 : {
9940 378 : appendStringInfoString(buf, sep);
9941 : /* Whole-row Vars need special treatment here */
9942 378 : get_rule_expr_toplevel(e, context, true);
9943 378 : sep = ", ";
9944 : }
9945 378 : i++;
9946 : }
9947 192 : if (tupdesc != NULL)
9948 : {
9949 54 : while (i < tupdesc->natts)
9950 : {
9951 0 : if (!TupleDescCompactAttr(tupdesc, i)->attisdropped)
9952 : {
9953 0 : appendStringInfoString(buf, sep);
9954 0 : appendStringInfoString(buf, "NULL");
9955 0 : sep = ", ";
9956 : }
9957 0 : i++;
9958 : }
9959 :
9960 54 : ReleaseTupleDesc(tupdesc);
9961 : }
9962 192 : appendStringInfoChar(buf, ')');
9963 192 : if (rowexpr->row_format == COERCE_EXPLICIT_CAST)
9964 36 : appendStringInfo(buf, "::%s",
9965 : format_type_with_typemod(rowexpr->row_typeid, -1));
9966 : }
9967 192 : break;
9968 :
9969 114 : case T_RowCompareExpr:
9970 : {
9971 114 : RowCompareExpr *rcexpr = (RowCompareExpr *) node;
9972 :
9973 : /*
9974 : * SQL99 allows "ROW" to be omitted when there is more than
9975 : * one column, but for simplicity we always print it. Within
9976 : * a ROW expression, whole-row Vars need special treatment, so
9977 : * use get_rule_list_toplevel.
9978 : */
9979 114 : appendStringInfoString(buf, "(ROW(");
9980 114 : get_rule_list_toplevel(rcexpr->largs, context, true);
9981 :
9982 : /*
9983 : * We assume that the name of the first-column operator will
9984 : * do for all the rest too. This is definitely open to
9985 : * failure, eg if some but not all operators were renamed
9986 : * since the construct was parsed, but there seems no way to
9987 : * be perfect.
9988 : */
9989 114 : appendStringInfo(buf, ") %s ROW(",
9990 114 : generate_operator_name(linitial_oid(rcexpr->opnos),
9991 114 : exprType(linitial(rcexpr->largs)),
9992 114 : exprType(linitial(rcexpr->rargs))));
9993 114 : get_rule_list_toplevel(rcexpr->rargs, context, true);
9994 114 : appendStringInfoString(buf, "))");
9995 : }
9996 114 : break;
9997 :
9998 1200 : case T_CoalesceExpr:
9999 : {
10000 1200 : CoalesceExpr *coalesceexpr = (CoalesceExpr *) node;
10001 :
10002 1200 : appendStringInfoString(buf, "COALESCE(");
10003 1200 : get_rule_expr((Node *) coalesceexpr->args, context, true);
10004 1200 : appendStringInfoChar(buf, ')');
10005 : }
10006 1200 : break;
10007 :
10008 36 : case T_MinMaxExpr:
10009 : {
10010 36 : MinMaxExpr *minmaxexpr = (MinMaxExpr *) node;
10011 :
10012 36 : switch (minmaxexpr->op)
10013 : {
10014 6 : case IS_GREATEST:
10015 6 : appendStringInfoString(buf, "GREATEST(");
10016 6 : break;
10017 30 : case IS_LEAST:
10018 30 : appendStringInfoString(buf, "LEAST(");
10019 30 : break;
10020 : }
10021 36 : get_rule_expr((Node *) minmaxexpr->args, context, true);
10022 36 : appendStringInfoChar(buf, ')');
10023 : }
10024 36 : break;
10025 :
10026 716 : case T_SQLValueFunction:
10027 : {
10028 716 : SQLValueFunction *svf = (SQLValueFunction *) node;
10029 :
10030 : /*
10031 : * Note: this code knows that typmod for time, timestamp, and
10032 : * timestamptz just prints as integer.
10033 : */
10034 716 : switch (svf->op)
10035 : {
10036 104 : case SVFOP_CURRENT_DATE:
10037 104 : appendStringInfoString(buf, "CURRENT_DATE");
10038 104 : break;
10039 12 : case SVFOP_CURRENT_TIME:
10040 12 : appendStringInfoString(buf, "CURRENT_TIME");
10041 12 : break;
10042 12 : case SVFOP_CURRENT_TIME_N:
10043 12 : appendStringInfo(buf, "CURRENT_TIME(%d)", svf->typmod);
10044 12 : break;
10045 12 : case SVFOP_CURRENT_TIMESTAMP:
10046 12 : appendStringInfoString(buf, "CURRENT_TIMESTAMP");
10047 12 : break;
10048 126 : case SVFOP_CURRENT_TIMESTAMP_N:
10049 126 : appendStringInfo(buf, "CURRENT_TIMESTAMP(%d)",
10050 : svf->typmod);
10051 126 : break;
10052 12 : case SVFOP_LOCALTIME:
10053 12 : appendStringInfoString(buf, "LOCALTIME");
10054 12 : break;
10055 12 : case SVFOP_LOCALTIME_N:
10056 12 : appendStringInfo(buf, "LOCALTIME(%d)", svf->typmod);
10057 12 : break;
10058 30 : case SVFOP_LOCALTIMESTAMP:
10059 30 : appendStringInfoString(buf, "LOCALTIMESTAMP");
10060 30 : break;
10061 18 : case SVFOP_LOCALTIMESTAMP_N:
10062 18 : appendStringInfo(buf, "LOCALTIMESTAMP(%d)",
10063 : svf->typmod);
10064 18 : break;
10065 12 : case SVFOP_CURRENT_ROLE:
10066 12 : appendStringInfoString(buf, "CURRENT_ROLE");
10067 12 : break;
10068 296 : case SVFOP_CURRENT_USER:
10069 296 : appendStringInfoString(buf, "CURRENT_USER");
10070 296 : break;
10071 12 : case SVFOP_USER:
10072 12 : appendStringInfoString(buf, "USER");
10073 12 : break;
10074 34 : case SVFOP_SESSION_USER:
10075 34 : appendStringInfoString(buf, "SESSION_USER");
10076 34 : break;
10077 12 : case SVFOP_CURRENT_CATALOG:
10078 12 : appendStringInfoString(buf, "CURRENT_CATALOG");
10079 12 : break;
10080 12 : case SVFOP_CURRENT_SCHEMA:
10081 12 : appendStringInfoString(buf, "CURRENT_SCHEMA");
10082 12 : break;
10083 : }
10084 : }
10085 716 : break;
10086 :
10087 176 : case T_XmlExpr:
10088 : {
10089 176 : XmlExpr *xexpr = (XmlExpr *) node;
10090 176 : bool needcomma = false;
10091 : ListCell *arg;
10092 : ListCell *narg;
10093 : Const *con;
10094 :
10095 176 : switch (xexpr->op)
10096 : {
10097 16 : case IS_XMLCONCAT:
10098 16 : appendStringInfoString(buf, "XMLCONCAT(");
10099 16 : break;
10100 32 : case IS_XMLELEMENT:
10101 32 : appendStringInfoString(buf, "XMLELEMENT(");
10102 32 : break;
10103 16 : case IS_XMLFOREST:
10104 16 : appendStringInfoString(buf, "XMLFOREST(");
10105 16 : break;
10106 16 : case IS_XMLPARSE:
10107 16 : appendStringInfoString(buf, "XMLPARSE(");
10108 16 : break;
10109 16 : case IS_XMLPI:
10110 16 : appendStringInfoString(buf, "XMLPI(");
10111 16 : break;
10112 16 : case IS_XMLROOT:
10113 16 : appendStringInfoString(buf, "XMLROOT(");
10114 16 : break;
10115 64 : case IS_XMLSERIALIZE:
10116 64 : appendStringInfoString(buf, "XMLSERIALIZE(");
10117 64 : break;
10118 0 : case IS_DOCUMENT:
10119 0 : break;
10120 : }
10121 176 : if (xexpr->op == IS_XMLPARSE || xexpr->op == IS_XMLSERIALIZE)
10122 : {
10123 80 : if (xexpr->xmloption == XMLOPTION_DOCUMENT)
10124 32 : appendStringInfoString(buf, "DOCUMENT ");
10125 : else
10126 48 : appendStringInfoString(buf, "CONTENT ");
10127 : }
10128 176 : if (xexpr->name)
10129 : {
10130 48 : appendStringInfo(buf, "NAME %s",
10131 48 : quote_identifier(map_xml_name_to_sql_identifier(xexpr->name)));
10132 48 : needcomma = true;
10133 : }
10134 176 : if (xexpr->named_args)
10135 : {
10136 32 : if (xexpr->op != IS_XMLFOREST)
10137 : {
10138 16 : if (needcomma)
10139 16 : appendStringInfoString(buf, ", ");
10140 16 : appendStringInfoString(buf, "XMLATTRIBUTES(");
10141 16 : needcomma = false;
10142 : }
10143 112 : forboth(arg, xexpr->named_args, narg, xexpr->arg_names)
10144 : {
10145 80 : Node *e = (Node *) lfirst(arg);
10146 80 : char *argname = strVal(lfirst(narg));
10147 :
10148 80 : if (needcomma)
10149 48 : appendStringInfoString(buf, ", ");
10150 80 : get_rule_expr((Node *) e, context, true);
10151 80 : appendStringInfo(buf, " AS %s",
10152 80 : quote_identifier(map_xml_name_to_sql_identifier(argname)));
10153 80 : needcomma = true;
10154 : }
10155 32 : if (xexpr->op != IS_XMLFOREST)
10156 16 : appendStringInfoChar(buf, ')');
10157 : }
10158 176 : if (xexpr->args)
10159 : {
10160 160 : if (needcomma)
10161 48 : appendStringInfoString(buf, ", ");
10162 160 : switch (xexpr->op)
10163 : {
10164 128 : case IS_XMLCONCAT:
10165 : case IS_XMLELEMENT:
10166 : case IS_XMLFOREST:
10167 : case IS_XMLPI:
10168 : case IS_XMLSERIALIZE:
10169 : /* no extra decoration needed */
10170 128 : get_rule_expr((Node *) xexpr->args, context, true);
10171 128 : break;
10172 16 : case IS_XMLPARSE:
10173 : Assert(list_length(xexpr->args) == 2);
10174 :
10175 16 : get_rule_expr((Node *) linitial(xexpr->args),
10176 : context, true);
10177 :
10178 16 : con = lsecond_node(Const, xexpr->args);
10179 : Assert(!con->constisnull);
10180 16 : if (DatumGetBool(con->constvalue))
10181 0 : appendStringInfoString(buf,
10182 : " PRESERVE WHITESPACE");
10183 : else
10184 16 : appendStringInfoString(buf,
10185 : " STRIP WHITESPACE");
10186 16 : break;
10187 16 : case IS_XMLROOT:
10188 : Assert(list_length(xexpr->args) == 3);
10189 :
10190 16 : get_rule_expr((Node *) linitial(xexpr->args),
10191 : context, true);
10192 :
10193 16 : appendStringInfoString(buf, ", VERSION ");
10194 16 : con = (Const *) lsecond(xexpr->args);
10195 16 : if (IsA(con, Const) &&
10196 16 : con->constisnull)
10197 16 : appendStringInfoString(buf, "NO VALUE");
10198 : else
10199 0 : get_rule_expr((Node *) con, context, false);
10200 :
10201 16 : con = lthird_node(Const, xexpr->args);
10202 16 : if (con->constisnull)
10203 : /* suppress STANDALONE NO VALUE */ ;
10204 : else
10205 : {
10206 16 : switch (DatumGetInt32(con->constvalue))
10207 : {
10208 16 : case XML_STANDALONE_YES:
10209 16 : appendStringInfoString(buf,
10210 : ", STANDALONE YES");
10211 16 : break;
10212 0 : case XML_STANDALONE_NO:
10213 0 : appendStringInfoString(buf,
10214 : ", STANDALONE NO");
10215 0 : break;
10216 0 : case XML_STANDALONE_NO_VALUE:
10217 0 : appendStringInfoString(buf,
10218 : ", STANDALONE NO VALUE");
10219 0 : break;
10220 0 : default:
10221 0 : break;
10222 : }
10223 : }
10224 16 : break;
10225 0 : case IS_DOCUMENT:
10226 0 : get_rule_expr_paren((Node *) xexpr->args, context, false, node);
10227 0 : break;
10228 : }
10229 : }
10230 176 : if (xexpr->op == IS_XMLSERIALIZE)
10231 : {
10232 64 : appendStringInfo(buf, " AS %s",
10233 : format_type_with_typemod(xexpr->type,
10234 : xexpr->typmod));
10235 64 : if (xexpr->indent)
10236 16 : appendStringInfoString(buf, " INDENT");
10237 : else
10238 48 : appendStringInfoString(buf, " NO INDENT");
10239 : }
10240 :
10241 176 : if (xexpr->op == IS_DOCUMENT)
10242 0 : appendStringInfoString(buf, " IS DOCUMENT");
10243 : else
10244 176 : appendStringInfoChar(buf, ')');
10245 : }
10246 176 : break;
10247 :
10248 2616 : case T_NullTest:
10249 : {
10250 2616 : NullTest *ntest = (NullTest *) node;
10251 :
10252 2616 : if (!PRETTY_PAREN(context))
10253 2560 : appendStringInfoChar(buf, '(');
10254 2616 : get_rule_expr_paren((Node *) ntest->arg, context, true, node);
10255 :
10256 : /*
10257 : * For scalar inputs, we prefer to print as IS [NOT] NULL,
10258 : * which is shorter and traditional. If it's a rowtype input
10259 : * but we're applying a scalar test, must print IS [NOT]
10260 : * DISTINCT FROM NULL to be semantically correct.
10261 : */
10262 2616 : if (ntest->argisrow ||
10263 2554 : !type_is_rowtype(exprType((Node *) ntest->arg)))
10264 : {
10265 5196 : switch (ntest->nulltesttype)
10266 : {
10267 824 : case IS_NULL:
10268 824 : appendStringInfoString(buf, " IS NULL");
10269 824 : break;
10270 1774 : case IS_NOT_NULL:
10271 1774 : appendStringInfoString(buf, " IS NOT NULL");
10272 1774 : break;
10273 0 : default:
10274 0 : elog(ERROR, "unrecognized nulltesttype: %d",
10275 : (int) ntest->nulltesttype);
10276 : }
10277 : }
10278 : else
10279 : {
10280 18 : switch (ntest->nulltesttype)
10281 : {
10282 6 : case IS_NULL:
10283 6 : appendStringInfoString(buf, " IS NOT DISTINCT FROM NULL");
10284 6 : break;
10285 12 : case IS_NOT_NULL:
10286 12 : appendStringInfoString(buf, " IS DISTINCT FROM NULL");
10287 12 : break;
10288 0 : default:
10289 0 : elog(ERROR, "unrecognized nulltesttype: %d",
10290 : (int) ntest->nulltesttype);
10291 : }
10292 : }
10293 2616 : if (!PRETTY_PAREN(context))
10294 2560 : appendStringInfoChar(buf, ')');
10295 : }
10296 2616 : break;
10297 :
10298 306 : case T_BooleanTest:
10299 : {
10300 306 : BooleanTest *btest = (BooleanTest *) node;
10301 :
10302 306 : if (!PRETTY_PAREN(context))
10303 306 : appendStringInfoChar(buf, '(');
10304 306 : get_rule_expr_paren((Node *) btest->arg, context, false, node);
10305 306 : switch (btest->booltesttype)
10306 : {
10307 36 : case IS_TRUE:
10308 36 : appendStringInfoString(buf, " IS TRUE");
10309 36 : break;
10310 138 : case IS_NOT_TRUE:
10311 138 : appendStringInfoString(buf, " IS NOT TRUE");
10312 138 : break;
10313 0 : case IS_FALSE:
10314 0 : appendStringInfoString(buf, " IS FALSE");
10315 0 : break;
10316 54 : case IS_NOT_FALSE:
10317 54 : appendStringInfoString(buf, " IS NOT FALSE");
10318 54 : break;
10319 24 : case IS_UNKNOWN:
10320 24 : appendStringInfoString(buf, " IS UNKNOWN");
10321 24 : break;
10322 54 : case IS_NOT_UNKNOWN:
10323 54 : appendStringInfoString(buf, " IS NOT UNKNOWN");
10324 54 : break;
10325 0 : default:
10326 0 : elog(ERROR, "unrecognized booltesttype: %d",
10327 : (int) btest->booltesttype);
10328 : }
10329 306 : if (!PRETTY_PAREN(context))
10330 306 : appendStringInfoChar(buf, ')');
10331 : }
10332 306 : break;
10333 :
10334 116 : case T_CoerceToDomain:
10335 : {
10336 116 : CoerceToDomain *ctest = (CoerceToDomain *) node;
10337 116 : Node *arg = (Node *) ctest->arg;
10338 :
10339 116 : if (ctest->coercionformat == COERCE_IMPLICIT_CAST &&
10340 48 : !showimplicit)
10341 : {
10342 : /* don't show the implicit cast */
10343 32 : get_rule_expr(arg, context, false);
10344 : }
10345 : else
10346 : {
10347 84 : get_coercion_expr(arg, context,
10348 : ctest->resulttype,
10349 : ctest->resulttypmod,
10350 : node);
10351 : }
10352 : }
10353 116 : break;
10354 :
10355 438 : case T_CoerceToDomainValue:
10356 438 : appendStringInfoString(buf, "VALUE");
10357 438 : break;
10358 :
10359 76 : case T_SetToDefault:
10360 76 : appendStringInfoString(buf, "DEFAULT");
10361 76 : break;
10362 :
10363 24 : case T_CurrentOfExpr:
10364 : {
10365 24 : CurrentOfExpr *cexpr = (CurrentOfExpr *) node;
10366 :
10367 24 : if (cexpr->cursor_name)
10368 24 : appendStringInfo(buf, "CURRENT OF %s",
10369 24 : quote_identifier(cexpr->cursor_name));
10370 : else
10371 0 : appendStringInfo(buf, "CURRENT OF $%d",
10372 : cexpr->cursor_param);
10373 : }
10374 24 : break;
10375 :
10376 0 : case T_NextValueExpr:
10377 : {
10378 0 : NextValueExpr *nvexpr = (NextValueExpr *) node;
10379 :
10380 : /*
10381 : * This isn't exactly nextval(), but that seems close enough
10382 : * for EXPLAIN's purposes.
10383 : */
10384 0 : appendStringInfoString(buf, "nextval(");
10385 0 : simple_quote_literal(buf,
10386 0 : generate_relation_name(nvexpr->seqid,
10387 : NIL));
10388 0 : appendStringInfoChar(buf, ')');
10389 : }
10390 0 : break;
10391 :
10392 24 : case T_InferenceElem:
10393 : {
10394 24 : InferenceElem *iexpr = (InferenceElem *) node;
10395 : bool save_varprefix;
10396 : bool need_parens;
10397 :
10398 : /*
10399 : * InferenceElem can only refer to target relation, so a
10400 : * prefix is not useful, and indeed would cause parse errors.
10401 : */
10402 24 : save_varprefix = context->varprefix;
10403 24 : context->varprefix = false;
10404 :
10405 : /*
10406 : * Parenthesize the element unless it's a simple Var or a bare
10407 : * function call. Follows pg_get_indexdef_worker().
10408 : */
10409 24 : need_parens = !IsA(iexpr->expr, Var);
10410 24 : if (IsA(iexpr->expr, FuncExpr) &&
10411 0 : ((FuncExpr *) iexpr->expr)->funcformat ==
10412 : COERCE_EXPLICIT_CALL)
10413 0 : need_parens = false;
10414 :
10415 24 : if (need_parens)
10416 0 : appendStringInfoChar(buf, '(');
10417 24 : get_rule_expr((Node *) iexpr->expr,
10418 : context, false);
10419 24 : if (need_parens)
10420 0 : appendStringInfoChar(buf, ')');
10421 :
10422 24 : context->varprefix = save_varprefix;
10423 :
10424 24 : if (iexpr->infercollid)
10425 12 : appendStringInfo(buf, " COLLATE %s",
10426 : generate_collation_name(iexpr->infercollid));
10427 :
10428 : /* Add the operator class name, if not default */
10429 24 : if (iexpr->inferopclass)
10430 : {
10431 12 : Oid inferopclass = iexpr->inferopclass;
10432 12 : Oid inferopcinputtype = get_opclass_input_type(iexpr->inferopclass);
10433 :
10434 12 : get_opclass_name(inferopclass, inferopcinputtype, buf);
10435 : }
10436 : }
10437 24 : break;
10438 :
10439 12 : case T_ReturningExpr:
10440 : {
10441 12 : ReturningExpr *retExpr = (ReturningExpr *) node;
10442 :
10443 : /*
10444 : * We cannot see a ReturningExpr in rule deparsing, only while
10445 : * EXPLAINing a query plan (ReturningExpr nodes are only ever
10446 : * adding during query rewriting). Just display the expression
10447 : * returned (an expanded view column).
10448 : */
10449 12 : get_rule_expr((Node *) retExpr->retexpr, context, showimplicit);
10450 : }
10451 12 : break;
10452 :
10453 4128 : case T_PartitionBoundSpec:
10454 : {
10455 4128 : PartitionBoundSpec *spec = (PartitionBoundSpec *) node;
10456 : ListCell *cell;
10457 : char *sep;
10458 :
10459 4128 : if (spec->is_default)
10460 : {
10461 156 : appendStringInfoString(buf, "DEFAULT");
10462 156 : break;
10463 : }
10464 :
10465 3972 : switch (spec->strategy)
10466 : {
10467 306 : case PARTITION_STRATEGY_HASH:
10468 : Assert(spec->modulus > 0 && spec->remainder >= 0);
10469 : Assert(spec->modulus > spec->remainder);
10470 :
10471 306 : appendStringInfoString(buf, "FOR VALUES");
10472 306 : appendStringInfo(buf, " WITH (modulus %d, remainder %d)",
10473 : spec->modulus, spec->remainder);
10474 306 : break;
10475 :
10476 1380 : case PARTITION_STRATEGY_LIST:
10477 : Assert(spec->listdatums != NIL);
10478 :
10479 1380 : appendStringInfoString(buf, "FOR VALUES IN (");
10480 1380 : sep = "";
10481 3666 : foreach(cell, spec->listdatums)
10482 : {
10483 2286 : Const *val = lfirst_node(Const, cell);
10484 :
10485 2286 : appendStringInfoString(buf, sep);
10486 2286 : get_const_expr(val, context, -1);
10487 2286 : sep = ", ";
10488 : }
10489 :
10490 1380 : appendStringInfoChar(buf, ')');
10491 1380 : break;
10492 :
10493 2286 : case PARTITION_STRATEGY_RANGE:
10494 : Assert(spec->lowerdatums != NIL &&
10495 : spec->upperdatums != NIL &&
10496 : list_length(spec->lowerdatums) ==
10497 : list_length(spec->upperdatums));
10498 :
10499 2286 : appendStringInfo(buf, "FOR VALUES FROM %s TO %s",
10500 : get_range_partbound_string(spec->lowerdatums),
10501 : get_range_partbound_string(spec->upperdatums));
10502 2286 : break;
10503 :
10504 0 : default:
10505 0 : elog(ERROR, "unrecognized partition strategy: %d",
10506 : (int) spec->strategy);
10507 : break;
10508 : }
10509 : }
10510 3972 : break;
10511 :
10512 150 : case T_JsonValueExpr:
10513 : {
10514 150 : JsonValueExpr *jve = (JsonValueExpr *) node;
10515 :
10516 150 : get_rule_expr((Node *) jve->raw_expr, context, false);
10517 150 : get_json_format(jve->format, context->buf);
10518 : }
10519 150 : break;
10520 :
10521 186 : case T_JsonConstructorExpr:
10522 186 : get_json_constructor((JsonConstructorExpr *) node, context, false);
10523 186 : break;
10524 :
10525 60 : case T_JsonIsPredicate:
10526 : {
10527 60 : JsonIsPredicate *pred = (JsonIsPredicate *) node;
10528 :
10529 60 : if (!PRETTY_PAREN(context))
10530 30 : appendStringInfoChar(context->buf, '(');
10531 :
10532 60 : get_rule_expr_paren(pred->expr, context, true, node);
10533 :
10534 60 : appendStringInfoString(context->buf, " IS JSON");
10535 :
10536 : /* TODO: handle FORMAT clause */
10537 :
10538 60 : switch (pred->item_type)
10539 : {
10540 12 : case JS_TYPE_SCALAR:
10541 12 : appendStringInfoString(context->buf, " SCALAR");
10542 12 : break;
10543 12 : case JS_TYPE_ARRAY:
10544 12 : appendStringInfoString(context->buf, " ARRAY");
10545 12 : break;
10546 12 : case JS_TYPE_OBJECT:
10547 12 : appendStringInfoString(context->buf, " OBJECT");
10548 12 : break;
10549 24 : default:
10550 24 : break;
10551 : }
10552 :
10553 60 : if (pred->unique_keys)
10554 12 : appendStringInfoString(context->buf, " WITH UNIQUE KEYS");
10555 :
10556 60 : if (!PRETTY_PAREN(context))
10557 30 : appendStringInfoChar(context->buf, ')');
10558 : }
10559 60 : break;
10560 :
10561 60 : case T_JsonExpr:
10562 : {
10563 60 : JsonExpr *jexpr = (JsonExpr *) node;
10564 :
10565 60 : switch (jexpr->op)
10566 : {
10567 12 : case JSON_EXISTS_OP:
10568 12 : appendStringInfoString(buf, "JSON_EXISTS(");
10569 12 : break;
10570 36 : case JSON_QUERY_OP:
10571 36 : appendStringInfoString(buf, "JSON_QUERY(");
10572 36 : break;
10573 12 : case JSON_VALUE_OP:
10574 12 : appendStringInfoString(buf, "JSON_VALUE(");
10575 12 : break;
10576 0 : default:
10577 0 : elog(ERROR, "unrecognized JsonExpr op: %d",
10578 : (int) jexpr->op);
10579 : }
10580 :
10581 60 : get_rule_expr(jexpr->formatted_expr, context, showimplicit);
10582 :
10583 60 : appendStringInfoString(buf, ", ");
10584 :
10585 60 : get_json_path_spec(jexpr->path_spec, context, showimplicit);
10586 :
10587 60 : if (jexpr->passing_values)
10588 : {
10589 : ListCell *lc1,
10590 : *lc2;
10591 12 : bool needcomma = false;
10592 :
10593 12 : appendStringInfoString(buf, " PASSING ");
10594 :
10595 48 : forboth(lc1, jexpr->passing_names,
10596 : lc2, jexpr->passing_values)
10597 : {
10598 36 : if (needcomma)
10599 24 : appendStringInfoString(buf, ", ");
10600 36 : needcomma = true;
10601 :
10602 36 : get_rule_expr((Node *) lfirst(lc2), context, showimplicit);
10603 36 : appendStringInfo(buf, " AS %s",
10604 36 : quote_identifier(lfirst_node(String, lc1)->sval));
10605 : }
10606 : }
10607 :
10608 60 : if (jexpr->op != JSON_EXISTS_OP ||
10609 12 : jexpr->returning->typid != BOOLOID)
10610 48 : get_json_returning(jexpr->returning, context->buf,
10611 48 : jexpr->op == JSON_QUERY_OP);
10612 :
10613 60 : get_json_expr_options(jexpr, context,
10614 60 : jexpr->op != JSON_EXISTS_OP ?
10615 : JSON_BEHAVIOR_NULL :
10616 : JSON_BEHAVIOR_FALSE);
10617 :
10618 60 : appendStringInfoChar(buf, ')');
10619 : }
10620 60 : break;
10621 :
10622 2690 : case T_List:
10623 : {
10624 : char *sep;
10625 : ListCell *l;
10626 :
10627 2690 : sep = "";
10628 7598 : foreach(l, (List *) node)
10629 : {
10630 4908 : appendStringInfoString(buf, sep);
10631 4908 : get_rule_expr((Node *) lfirst(l), context, showimplicit);
10632 4908 : sep = ", ";
10633 : }
10634 : }
10635 2690 : break;
10636 :
10637 72 : case T_TableFunc:
10638 72 : get_tablefunc((TableFunc *) node, context, showimplicit);
10639 72 : break;
10640 :
10641 0 : default:
10642 0 : elog(ERROR, "unrecognized node type: %d", (int) nodeTag(node));
10643 : break;
10644 : }
10645 : }
10646 :
10647 : /*
10648 : * get_rule_expr_toplevel - Parse back a toplevel expression
10649 : *
10650 : * Same as get_rule_expr(), except that if the expr is just a Var, we pass
10651 : * istoplevel = true not false to get_variable(). This causes whole-row Vars
10652 : * to get printed with decoration that will prevent expansion of "*".
10653 : * We need to use this in contexts such as ROW() and VALUES(), where the
10654 : * parser would expand "foo.*" appearing at top level. (In principle we'd
10655 : * use this in get_target_list() too, but that has additional worries about
10656 : * whether to print AS, so it needs to invoke get_variable() directly anyway.)
10657 : */
10658 : static void
10659 3044 : get_rule_expr_toplevel(Node *node, deparse_context *context,
10660 : bool showimplicit)
10661 : {
10662 3044 : if (node && IsA(node, Var))
10663 1214 : (void) get_variable((Var *) node, 0, true, context);
10664 : else
10665 1830 : get_rule_expr(node, context, showimplicit);
10666 3044 : }
10667 :
10668 : /*
10669 : * get_rule_list_toplevel - Parse back a list of toplevel expressions
10670 : *
10671 : * Apply get_rule_expr_toplevel() to each element of a List.
10672 : *
10673 : * This adds commas between the expressions, but caller is responsible
10674 : * for printing surrounding decoration.
10675 : */
10676 : static void
10677 504 : get_rule_list_toplevel(List *lst, deparse_context *context,
10678 : bool showimplicit)
10679 : {
10680 : const char *sep;
10681 : ListCell *lc;
10682 :
10683 504 : sep = "";
10684 1718 : foreach(lc, lst)
10685 : {
10686 1214 : Node *e = (Node *) lfirst(lc);
10687 :
10688 1214 : appendStringInfoString(context->buf, sep);
10689 1214 : get_rule_expr_toplevel(e, context, showimplicit);
10690 1214 : sep = ", ";
10691 : }
10692 504 : }
10693 :
10694 : /*
10695 : * get_rule_expr_funccall - Parse back a function-call expression
10696 : *
10697 : * Same as get_rule_expr(), except that we guarantee that the output will
10698 : * look like a function call, or like one of the things the grammar treats as
10699 : * equivalent to a function call (see the func_expr_windowless production).
10700 : * This is needed in places where the grammar uses func_expr_windowless and
10701 : * you can't substitute a parenthesized a_expr. If what we have isn't going
10702 : * to look like a function call, wrap it in a dummy CAST() expression, which
10703 : * will satisfy the grammar --- and, indeed, is likely what the user wrote to
10704 : * produce such a thing.
10705 : */
10706 : static void
10707 876 : get_rule_expr_funccall(Node *node, deparse_context *context,
10708 : bool showimplicit)
10709 : {
10710 876 : if (looks_like_function(node))
10711 864 : get_rule_expr(node, context, showimplicit);
10712 : else
10713 : {
10714 12 : StringInfo buf = context->buf;
10715 :
10716 12 : appendStringInfoString(buf, "CAST(");
10717 : /* no point in showing any top-level implicit cast */
10718 12 : get_rule_expr(node, context, false);
10719 12 : appendStringInfo(buf, " AS %s)",
10720 : format_type_with_typemod(exprType(node),
10721 : exprTypmod(node)));
10722 : }
10723 876 : }
10724 :
10725 : /*
10726 : * Helper function to identify node types that satisfy func_expr_windowless.
10727 : * If in doubt, "false" is always a safe answer.
10728 : */
10729 : static bool
10730 2066 : looks_like_function(Node *node)
10731 : {
10732 2066 : if (node == NULL)
10733 0 : return false; /* probably shouldn't happen */
10734 2066 : switch (nodeTag(node))
10735 : {
10736 904 : case T_FuncExpr:
10737 : /* OK, unless it's going to deparse as a cast */
10738 922 : return (((FuncExpr *) node)->funcformat == COERCE_EXPLICIT_CALL ||
10739 18 : ((FuncExpr *) node)->funcformat == COERCE_SQL_SYNTAX);
10740 108 : case T_NullIfExpr:
10741 : case T_CoalesceExpr:
10742 : case T_MinMaxExpr:
10743 : case T_SQLValueFunction:
10744 : case T_XmlExpr:
10745 : case T_JsonExpr:
10746 : /* these are all accepted by func_expr_common_subexpr */
10747 108 : return true;
10748 1054 : default:
10749 1054 : break;
10750 : }
10751 1054 : return false;
10752 : }
10753 :
10754 :
10755 : /*
10756 : * get_oper_expr - Parse back an OpExpr node
10757 : */
10758 : static void
10759 61118 : get_oper_expr(OpExpr *expr, deparse_context *context)
10760 : {
10761 61118 : StringInfo buf = context->buf;
10762 61118 : Oid opno = expr->opno;
10763 61118 : List *args = expr->args;
10764 :
10765 61118 : if (!PRETTY_PAREN(context))
10766 58826 : appendStringInfoChar(buf, '(');
10767 61118 : if (list_length(args) == 2)
10768 : {
10769 : /* binary operator */
10770 61088 : Node *arg1 = (Node *) linitial(args);
10771 61088 : Node *arg2 = (Node *) lsecond(args);
10772 :
10773 61088 : get_rule_expr_paren(arg1, context, true, (Node *) expr);
10774 61088 : appendStringInfo(buf, " %s ",
10775 : generate_operator_name(opno,
10776 : exprType(arg1),
10777 : exprType(arg2)));
10778 61088 : get_rule_expr_paren(arg2, context, true, (Node *) expr);
10779 : }
10780 : else
10781 : {
10782 : /* prefix operator */
10783 30 : Node *arg = (Node *) linitial(args);
10784 :
10785 30 : appendStringInfo(buf, "%s ",
10786 : generate_operator_name(opno,
10787 : InvalidOid,
10788 : exprType(arg)));
10789 30 : get_rule_expr_paren(arg, context, true, (Node *) expr);
10790 : }
10791 61118 : if (!PRETTY_PAREN(context))
10792 58826 : appendStringInfoChar(buf, ')');
10793 61118 : }
10794 :
10795 : /*
10796 : * get_func_expr - Parse back a FuncExpr node
10797 : */
10798 : static void
10799 12562 : get_func_expr(FuncExpr *expr, deparse_context *context,
10800 : bool showimplicit)
10801 : {
10802 12562 : StringInfo buf = context->buf;
10803 12562 : Oid funcoid = expr->funcid;
10804 : Oid argtypes[FUNC_MAX_ARGS];
10805 : int nargs;
10806 : List *argnames;
10807 : bool use_variadic;
10808 : ListCell *l;
10809 :
10810 : /*
10811 : * If the function call came from an implicit coercion, then just show the
10812 : * first argument --- unless caller wants to see implicit coercions.
10813 : */
10814 12562 : if (expr->funcformat == COERCE_IMPLICIT_CAST && !showimplicit)
10815 : {
10816 1314 : get_rule_expr_paren((Node *) linitial(expr->args), context,
10817 : false, (Node *) expr);
10818 3272 : return;
10819 : }
10820 :
10821 : /*
10822 : * If the function call came from a cast, then show the first argument
10823 : * plus an explicit cast operation.
10824 : */
10825 11248 : if (expr->funcformat == COERCE_EXPLICIT_CAST ||
10826 10556 : expr->funcformat == COERCE_IMPLICIT_CAST)
10827 : {
10828 1784 : Node *arg = linitial(expr->args);
10829 1784 : Oid rettype = expr->funcresulttype;
10830 : int32 coercedTypmod;
10831 :
10832 : /* Get the typmod if this is a length-coercion function */
10833 1784 : (void) exprIsLengthCoercion((Node *) expr, &coercedTypmod);
10834 :
10835 1784 : get_coercion_expr(arg, context,
10836 : rettype, coercedTypmod,
10837 : (Node *) expr);
10838 :
10839 1784 : return;
10840 : }
10841 :
10842 : /*
10843 : * If the function was called using one of the SQL spec's random special
10844 : * syntaxes, try to reproduce that. If we don't recognize the function,
10845 : * fall through.
10846 : */
10847 9464 : if (expr->funcformat == COERCE_SQL_SYNTAX)
10848 : {
10849 180 : if (get_func_sql_syntax(expr, context))
10850 174 : return;
10851 : }
10852 :
10853 : /*
10854 : * Normal function: display as proname(args). First we need to extract
10855 : * the argument datatypes.
10856 : */
10857 9290 : if (list_length(expr->args) > FUNC_MAX_ARGS)
10858 0 : ereport(ERROR,
10859 : (errcode(ERRCODE_TOO_MANY_ARGUMENTS),
10860 : errmsg("too many arguments")));
10861 9290 : nargs = 0;
10862 9290 : argnames = NIL;
10863 19208 : foreach(l, expr->args)
10864 : {
10865 9918 : Node *arg = (Node *) lfirst(l);
10866 :
10867 9918 : if (IsA(arg, NamedArgExpr))
10868 30 : argnames = lappend(argnames, ((NamedArgExpr *) arg)->name);
10869 9918 : argtypes[nargs] = exprType(arg);
10870 9918 : nargs++;
10871 : }
10872 :
10873 9290 : appendStringInfo(buf, "%s(",
10874 : generate_function_name(funcoid, nargs,
10875 : argnames, argtypes,
10876 9290 : expr->funcvariadic,
10877 : &use_variadic,
10878 9290 : context->inGroupBy));
10879 9290 : nargs = 0;
10880 19208 : foreach(l, expr->args)
10881 : {
10882 9918 : if (nargs++ > 0)
10883 1818 : appendStringInfoString(buf, ", ");
10884 9918 : if (use_variadic && lnext(expr->args, l) == NULL)
10885 12 : appendStringInfoString(buf, "VARIADIC ");
10886 9918 : get_rule_expr((Node *) lfirst(l), context, true);
10887 : }
10888 9290 : appendStringInfoChar(buf, ')');
10889 : }
10890 :
10891 : /*
10892 : * get_agg_expr - Parse back an Aggref node
10893 : */
10894 : static void
10895 4698 : get_agg_expr(Aggref *aggref, deparse_context *context,
10896 : Aggref *original_aggref)
10897 : {
10898 4698 : get_agg_expr_helper(aggref, context, original_aggref, NULL, NULL,
10899 : false);
10900 4698 : }
10901 :
10902 : /*
10903 : * get_agg_expr_helper - subroutine for get_agg_expr and
10904 : * get_json_agg_constructor
10905 : */
10906 : static void
10907 4752 : get_agg_expr_helper(Aggref *aggref, deparse_context *context,
10908 : Aggref *original_aggref, const char *funcname,
10909 : const char *options, bool is_json_objectagg)
10910 : {
10911 4752 : StringInfo buf = context->buf;
10912 : Oid argtypes[FUNC_MAX_ARGS];
10913 : int nargs;
10914 4752 : bool use_variadic = false;
10915 :
10916 : /*
10917 : * For a combining aggregate, we look up and deparse the corresponding
10918 : * partial aggregate instead. This is necessary because our input
10919 : * argument list has been replaced; the new argument list always has just
10920 : * one element, which will point to a partial Aggref that supplies us with
10921 : * transition states to combine.
10922 : */
10923 4752 : if (DO_AGGSPLIT_COMBINE(aggref->aggsplit))
10924 : {
10925 : TargetEntry *tle;
10926 :
10927 : Assert(list_length(aggref->args) == 1);
10928 776 : tle = linitial_node(TargetEntry, aggref->args);
10929 776 : resolve_special_varno((Node *) tle->expr, context,
10930 : get_agg_combine_expr, original_aggref);
10931 776 : return;
10932 : }
10933 :
10934 : /*
10935 : * Mark as PARTIAL, if appropriate. We look to the original aggref so as
10936 : * to avoid printing this when recursing from the code just above.
10937 : */
10938 3976 : if (DO_AGGSPLIT_SKIPFINAL(original_aggref->aggsplit))
10939 1724 : appendStringInfoString(buf, "PARTIAL ");
10940 :
10941 : /* Extract the argument types as seen by the parser */
10942 3976 : nargs = get_aggregate_argtypes(aggref, argtypes);
10943 :
10944 3976 : if (!funcname)
10945 3922 : funcname = generate_function_name(aggref->aggfnoid, nargs, NIL,
10946 3922 : argtypes, aggref->aggvariadic,
10947 : &use_variadic,
10948 3922 : context->inGroupBy);
10949 :
10950 : /* Print the aggregate name, schema-qualified if needed */
10951 3976 : appendStringInfo(buf, "%s(%s", funcname,
10952 3976 : (aggref->aggdistinct != NIL) ? "DISTINCT " : "");
10953 :
10954 3976 : if (AGGKIND_IS_ORDERED_SET(aggref->aggkind))
10955 : {
10956 : /*
10957 : * Ordered-set aggregates do not use "*" syntax. Also, we needn't
10958 : * worry about inserting VARIADIC. So we can just dump the direct
10959 : * args as-is.
10960 : */
10961 : Assert(!aggref->aggvariadic);
10962 28 : get_rule_expr((Node *) aggref->aggdirectargs, context, true);
10963 : Assert(aggref->aggorder != NIL);
10964 28 : appendStringInfoString(buf, ") WITHIN GROUP (ORDER BY ");
10965 28 : get_rule_orderby(aggref->aggorder, aggref->args, false, context);
10966 : }
10967 : else
10968 : {
10969 : /* aggstar can be set only in zero-argument aggregates */
10970 3948 : if (aggref->aggstar)
10971 1158 : appendStringInfoChar(buf, '*');
10972 : else
10973 : {
10974 : ListCell *l;
10975 : int i;
10976 :
10977 2790 : i = 0;
10978 5768 : foreach(l, aggref->args)
10979 : {
10980 2978 : TargetEntry *tle = (TargetEntry *) lfirst(l);
10981 2978 : Node *arg = (Node *) tle->expr;
10982 :
10983 : Assert(!IsA(arg, NamedArgExpr));
10984 2978 : if (tle->resjunk)
10985 50 : continue;
10986 2928 : if (i++ > 0)
10987 : {
10988 138 : if (is_json_objectagg)
10989 : {
10990 : /*
10991 : * the ABSENT ON NULL and WITH UNIQUE args are printed
10992 : * separately, so ignore them here
10993 : */
10994 30 : if (i > 2)
10995 0 : break;
10996 :
10997 30 : appendStringInfoString(buf, " : ");
10998 : }
10999 : else
11000 108 : appendStringInfoString(buf, ", ");
11001 : }
11002 2928 : if (use_variadic && i == nargs)
11003 8 : appendStringInfoString(buf, "VARIADIC ");
11004 2928 : get_rule_expr(arg, context, true);
11005 : }
11006 : }
11007 :
11008 3948 : if (aggref->aggorder != NIL)
11009 : {
11010 82 : appendStringInfoString(buf, " ORDER BY ");
11011 82 : get_rule_orderby(aggref->aggorder, aggref->args, false, context);
11012 : }
11013 : }
11014 :
11015 3976 : if (options)
11016 54 : appendStringInfoString(buf, options);
11017 :
11018 3976 : if (aggref->aggfilter != NULL)
11019 : {
11020 46 : appendStringInfoString(buf, ") FILTER (WHERE ");
11021 46 : get_rule_expr((Node *) aggref->aggfilter, context, false);
11022 : }
11023 :
11024 3976 : appendStringInfoChar(buf, ')');
11025 : }
11026 :
11027 : /*
11028 : * This is a helper function for get_agg_expr(). It's used when we deparse
11029 : * a combining Aggref; resolve_special_varno locates the corresponding partial
11030 : * Aggref and then calls this.
11031 : */
11032 : static void
11033 776 : get_agg_combine_expr(Node *node, deparse_context *context, void *callback_arg)
11034 : {
11035 : Aggref *aggref;
11036 776 : Aggref *original_aggref = callback_arg;
11037 :
11038 776 : if (!IsA(node, Aggref))
11039 0 : elog(ERROR, "combining Aggref does not point to an Aggref");
11040 :
11041 776 : aggref = (Aggref *) node;
11042 776 : get_agg_expr(aggref, context, original_aggref);
11043 776 : }
11044 :
11045 : /*
11046 : * get_windowfunc_expr - Parse back a WindowFunc node
11047 : */
11048 : static void
11049 324 : get_windowfunc_expr(WindowFunc *wfunc, deparse_context *context)
11050 : {
11051 324 : get_windowfunc_expr_helper(wfunc, context, NULL, NULL, false);
11052 324 : }
11053 :
11054 :
11055 : /*
11056 : * get_windowfunc_expr_helper - subroutine for get_windowfunc_expr and
11057 : * get_json_agg_constructor
11058 : */
11059 : static void
11060 336 : get_windowfunc_expr_helper(WindowFunc *wfunc, deparse_context *context,
11061 : const char *funcname, const char *options,
11062 : bool is_json_objectagg)
11063 : {
11064 336 : StringInfo buf = context->buf;
11065 : Oid argtypes[FUNC_MAX_ARGS];
11066 : int nargs;
11067 : List *argnames;
11068 : ListCell *l;
11069 :
11070 336 : if (list_length(wfunc->args) > FUNC_MAX_ARGS)
11071 0 : ereport(ERROR,
11072 : (errcode(ERRCODE_TOO_MANY_ARGUMENTS),
11073 : errmsg("too many arguments")));
11074 336 : nargs = 0;
11075 336 : argnames = NIL;
11076 570 : foreach(l, wfunc->args)
11077 : {
11078 234 : Node *arg = (Node *) lfirst(l);
11079 :
11080 234 : if (IsA(arg, NamedArgExpr))
11081 0 : argnames = lappend(argnames, ((NamedArgExpr *) arg)->name);
11082 234 : argtypes[nargs] = exprType(arg);
11083 234 : nargs++;
11084 : }
11085 :
11086 336 : if (!funcname)
11087 324 : funcname = generate_function_name(wfunc->winfnoid, nargs, argnames,
11088 : argtypes, false, NULL,
11089 324 : context->inGroupBy);
11090 :
11091 336 : appendStringInfo(buf, "%s(", funcname);
11092 :
11093 : /* winstar can be set only in zero-argument aggregates */
11094 336 : if (wfunc->winstar)
11095 24 : appendStringInfoChar(buf, '*');
11096 : else
11097 : {
11098 312 : if (is_json_objectagg)
11099 : {
11100 6 : get_rule_expr((Node *) linitial(wfunc->args), context, false);
11101 6 : appendStringInfoString(buf, " : ");
11102 6 : get_rule_expr((Node *) lsecond(wfunc->args), context, false);
11103 : }
11104 : else
11105 306 : get_rule_expr((Node *) wfunc->args, context, true);
11106 : }
11107 :
11108 336 : if (options)
11109 12 : appendStringInfoString(buf, options);
11110 :
11111 336 : if (wfunc->aggfilter != NULL)
11112 : {
11113 0 : appendStringInfoString(buf, ") FILTER (WHERE ");
11114 0 : get_rule_expr((Node *) wfunc->aggfilter, context, false);
11115 : }
11116 :
11117 336 : appendStringInfoString(buf, ") ");
11118 :
11119 336 : if (wfunc->ignore_nulls == PARSER_IGNORE_NULLS)
11120 6 : appendStringInfoString(buf, "IGNORE NULLS ");
11121 :
11122 336 : appendStringInfoString(buf, "OVER ");
11123 :
11124 336 : if (context->windowClause)
11125 : {
11126 : /* Query-decompilation case: search the windowClause list */
11127 60 : foreach(l, context->windowClause)
11128 : {
11129 60 : WindowClause *wc = (WindowClause *) lfirst(l);
11130 :
11131 60 : if (wc->winref == wfunc->winref)
11132 : {
11133 60 : if (wc->name)
11134 18 : appendStringInfoString(buf, quote_identifier(wc->name));
11135 : else
11136 42 : get_rule_windowspec(wc, context->targetList, context);
11137 60 : break;
11138 : }
11139 : }
11140 60 : if (l == NULL)
11141 0 : elog(ERROR, "could not find window clause for winref %u",
11142 : wfunc->winref);
11143 : }
11144 : else
11145 : {
11146 : /*
11147 : * In EXPLAIN, search the namespace stack for a matching WindowAgg
11148 : * node (probably it's always the first entry), and print winname.
11149 : */
11150 276 : foreach(l, context->namespaces)
11151 : {
11152 276 : deparse_namespace *dpns = (deparse_namespace *) lfirst(l);
11153 :
11154 276 : if (dpns->plan && IsA(dpns->plan, WindowAgg))
11155 : {
11156 276 : WindowAgg *wagg = (WindowAgg *) dpns->plan;
11157 :
11158 276 : if (wagg->winref == wfunc->winref)
11159 : {
11160 276 : appendStringInfoString(buf, quote_identifier(wagg->winname));
11161 276 : break;
11162 : }
11163 : }
11164 : }
11165 276 : if (l == NULL)
11166 0 : elog(ERROR, "could not find window clause for winref %u",
11167 : wfunc->winref);
11168 : }
11169 336 : }
11170 :
11171 : /*
11172 : * get_func_sql_syntax - Parse back a SQL-syntax function call
11173 : *
11174 : * Returns true if we successfully deparsed, false if we did not
11175 : * recognize the function.
11176 : */
11177 : static bool
11178 180 : get_func_sql_syntax(FuncExpr *expr, deparse_context *context)
11179 : {
11180 180 : StringInfo buf = context->buf;
11181 180 : Oid funcoid = expr->funcid;
11182 :
11183 180 : switch (funcoid)
11184 : {
11185 24 : case F_TIMEZONE_INTERVAL_TIMESTAMP:
11186 : case F_TIMEZONE_INTERVAL_TIMESTAMPTZ:
11187 : case F_TIMEZONE_INTERVAL_TIMETZ:
11188 : case F_TIMEZONE_TEXT_TIMESTAMP:
11189 : case F_TIMEZONE_TEXT_TIMESTAMPTZ:
11190 : case F_TIMEZONE_TEXT_TIMETZ:
11191 : /* AT TIME ZONE ... note reversed argument order */
11192 24 : appendStringInfoChar(buf, '(');
11193 24 : get_rule_expr_paren((Node *) lsecond(expr->args), context, false,
11194 : (Node *) expr);
11195 24 : appendStringInfoString(buf, " AT TIME ZONE ");
11196 24 : get_rule_expr_paren((Node *) linitial(expr->args), context, false,
11197 : (Node *) expr);
11198 24 : appendStringInfoChar(buf, ')');
11199 24 : return true;
11200 :
11201 18 : case F_TIMEZONE_TIMESTAMP:
11202 : case F_TIMEZONE_TIMESTAMPTZ:
11203 : case F_TIMEZONE_TIMETZ:
11204 : /* AT LOCAL */
11205 18 : appendStringInfoChar(buf, '(');
11206 18 : get_rule_expr_paren((Node *) linitial(expr->args), context, false,
11207 : (Node *) expr);
11208 18 : appendStringInfoString(buf, " AT LOCAL)");
11209 18 : return true;
11210 :
11211 6 : case F_OVERLAPS_TIMESTAMPTZ_INTERVAL_TIMESTAMPTZ_INTERVAL:
11212 : case F_OVERLAPS_TIMESTAMPTZ_INTERVAL_TIMESTAMPTZ_TIMESTAMPTZ:
11213 : case F_OVERLAPS_TIMESTAMPTZ_TIMESTAMPTZ_TIMESTAMPTZ_INTERVAL:
11214 : case F_OVERLAPS_TIMESTAMPTZ_TIMESTAMPTZ_TIMESTAMPTZ_TIMESTAMPTZ:
11215 : case F_OVERLAPS_TIMESTAMP_INTERVAL_TIMESTAMP_INTERVAL:
11216 : case F_OVERLAPS_TIMESTAMP_INTERVAL_TIMESTAMP_TIMESTAMP:
11217 : case F_OVERLAPS_TIMESTAMP_TIMESTAMP_TIMESTAMP_INTERVAL:
11218 : case F_OVERLAPS_TIMESTAMP_TIMESTAMP_TIMESTAMP_TIMESTAMP:
11219 : case F_OVERLAPS_TIMETZ_TIMETZ_TIMETZ_TIMETZ:
11220 : case F_OVERLAPS_TIME_INTERVAL_TIME_INTERVAL:
11221 : case F_OVERLAPS_TIME_INTERVAL_TIME_TIME:
11222 : case F_OVERLAPS_TIME_TIME_TIME_INTERVAL:
11223 : case F_OVERLAPS_TIME_TIME_TIME_TIME:
11224 : /* (x1, x2) OVERLAPS (y1, y2) */
11225 6 : appendStringInfoString(buf, "((");
11226 6 : get_rule_expr((Node *) linitial(expr->args), context, false);
11227 6 : appendStringInfoString(buf, ", ");
11228 6 : get_rule_expr((Node *) lsecond(expr->args), context, false);
11229 6 : appendStringInfoString(buf, ") OVERLAPS (");
11230 6 : get_rule_expr((Node *) lthird(expr->args), context, false);
11231 6 : appendStringInfoString(buf, ", ");
11232 6 : get_rule_expr((Node *) lfourth(expr->args), context, false);
11233 6 : appendStringInfoString(buf, "))");
11234 6 : return true;
11235 :
11236 18 : case F_EXTRACT_TEXT_DATE:
11237 : case F_EXTRACT_TEXT_TIME:
11238 : case F_EXTRACT_TEXT_TIMETZ:
11239 : case F_EXTRACT_TEXT_TIMESTAMP:
11240 : case F_EXTRACT_TEXT_TIMESTAMPTZ:
11241 : case F_EXTRACT_TEXT_INTERVAL:
11242 : /* EXTRACT (x FROM y) */
11243 18 : appendStringInfoString(buf, "EXTRACT(");
11244 : {
11245 18 : Const *con = (Const *) linitial(expr->args);
11246 :
11247 : Assert(IsA(con, Const) &&
11248 : con->consttype == TEXTOID &&
11249 : !con->constisnull);
11250 18 : appendStringInfoString(buf, TextDatumGetCString(con->constvalue));
11251 : }
11252 18 : appendStringInfoString(buf, " FROM ");
11253 18 : get_rule_expr((Node *) lsecond(expr->args), context, false);
11254 18 : appendStringInfoChar(buf, ')');
11255 18 : return true;
11256 :
11257 12 : case F_IS_NORMALIZED:
11258 : /* IS xxx NORMALIZED */
11259 12 : appendStringInfoChar(buf, '(');
11260 12 : get_rule_expr_paren((Node *) linitial(expr->args), context, false,
11261 : (Node *) expr);
11262 12 : appendStringInfoString(buf, " IS");
11263 12 : if (list_length(expr->args) == 2)
11264 : {
11265 6 : Const *con = (Const *) lsecond(expr->args);
11266 :
11267 : Assert(IsA(con, Const) &&
11268 : con->consttype == TEXTOID &&
11269 : !con->constisnull);
11270 6 : appendStringInfo(buf, " %s",
11271 6 : TextDatumGetCString(con->constvalue));
11272 : }
11273 12 : appendStringInfoString(buf, " NORMALIZED)");
11274 12 : return true;
11275 :
11276 6 : case F_PG_COLLATION_FOR:
11277 : /* COLLATION FOR */
11278 6 : appendStringInfoString(buf, "COLLATION FOR (");
11279 6 : get_rule_expr((Node *) linitial(expr->args), context, false);
11280 6 : appendStringInfoChar(buf, ')');
11281 6 : return true;
11282 :
11283 12 : case F_NORMALIZE:
11284 : /* NORMALIZE() */
11285 12 : appendStringInfoString(buf, "NORMALIZE(");
11286 12 : get_rule_expr((Node *) linitial(expr->args), context, false);
11287 12 : if (list_length(expr->args) == 2)
11288 : {
11289 6 : Const *con = (Const *) lsecond(expr->args);
11290 :
11291 : Assert(IsA(con, Const) &&
11292 : con->consttype == TEXTOID &&
11293 : !con->constisnull);
11294 6 : appendStringInfo(buf, ", %s",
11295 6 : TextDatumGetCString(con->constvalue));
11296 : }
11297 12 : appendStringInfoChar(buf, ')');
11298 12 : return true;
11299 :
11300 12 : case F_OVERLAY_BIT_BIT_INT4:
11301 : case F_OVERLAY_BIT_BIT_INT4_INT4:
11302 : case F_OVERLAY_BYTEA_BYTEA_INT4:
11303 : case F_OVERLAY_BYTEA_BYTEA_INT4_INT4:
11304 : case F_OVERLAY_TEXT_TEXT_INT4:
11305 : case F_OVERLAY_TEXT_TEXT_INT4_INT4:
11306 : /* OVERLAY() */
11307 12 : appendStringInfoString(buf, "OVERLAY(");
11308 12 : get_rule_expr((Node *) linitial(expr->args), context, false);
11309 12 : appendStringInfoString(buf, " PLACING ");
11310 12 : get_rule_expr((Node *) lsecond(expr->args), context, false);
11311 12 : appendStringInfoString(buf, " FROM ");
11312 12 : get_rule_expr((Node *) lthird(expr->args), context, false);
11313 12 : if (list_length(expr->args) == 4)
11314 : {
11315 6 : appendStringInfoString(buf, " FOR ");
11316 6 : get_rule_expr((Node *) lfourth(expr->args), context, false);
11317 : }
11318 12 : appendStringInfoChar(buf, ')');
11319 12 : return true;
11320 :
11321 6 : case F_POSITION_BIT_BIT:
11322 : case F_POSITION_BYTEA_BYTEA:
11323 : case F_POSITION_TEXT_TEXT:
11324 : /* POSITION() ... extra parens since args are b_expr not a_expr */
11325 6 : appendStringInfoString(buf, "POSITION((");
11326 6 : get_rule_expr((Node *) lsecond(expr->args), context, false);
11327 6 : appendStringInfoString(buf, ") IN (");
11328 6 : get_rule_expr((Node *) linitial(expr->args), context, false);
11329 6 : appendStringInfoString(buf, "))");
11330 6 : return true;
11331 :
11332 6 : case F_SUBSTRING_BIT_INT4:
11333 : case F_SUBSTRING_BIT_INT4_INT4:
11334 : case F_SUBSTRING_BYTEA_INT4:
11335 : case F_SUBSTRING_BYTEA_INT4_INT4:
11336 : case F_SUBSTRING_TEXT_INT4:
11337 : case F_SUBSTRING_TEXT_INT4_INT4:
11338 : /* SUBSTRING FROM/FOR (i.e., integer-position variants) */
11339 6 : appendStringInfoString(buf, "SUBSTRING(");
11340 6 : get_rule_expr((Node *) linitial(expr->args), context, false);
11341 6 : appendStringInfoString(buf, " FROM ");
11342 6 : get_rule_expr((Node *) lsecond(expr->args), context, false);
11343 6 : if (list_length(expr->args) == 3)
11344 : {
11345 6 : appendStringInfoString(buf, " FOR ");
11346 6 : get_rule_expr((Node *) lthird(expr->args), context, false);
11347 : }
11348 6 : appendStringInfoChar(buf, ')');
11349 6 : return true;
11350 :
11351 6 : case F_SUBSTRING_TEXT_TEXT_TEXT:
11352 : /* SUBSTRING SIMILAR/ESCAPE */
11353 6 : appendStringInfoString(buf, "SUBSTRING(");
11354 6 : get_rule_expr((Node *) linitial(expr->args), context, false);
11355 6 : appendStringInfoString(buf, " SIMILAR ");
11356 6 : get_rule_expr((Node *) lsecond(expr->args), context, false);
11357 6 : appendStringInfoString(buf, " ESCAPE ");
11358 6 : get_rule_expr((Node *) lthird(expr->args), context, false);
11359 6 : appendStringInfoChar(buf, ')');
11360 6 : return true;
11361 :
11362 12 : case F_BTRIM_BYTEA_BYTEA:
11363 : case F_BTRIM_TEXT:
11364 : case F_BTRIM_TEXT_TEXT:
11365 : /* TRIM() */
11366 12 : appendStringInfoString(buf, "TRIM(BOTH");
11367 12 : if (list_length(expr->args) == 2)
11368 : {
11369 12 : appendStringInfoChar(buf, ' ');
11370 12 : get_rule_expr((Node *) lsecond(expr->args), context, false);
11371 : }
11372 12 : appendStringInfoString(buf, " FROM ");
11373 12 : get_rule_expr((Node *) linitial(expr->args), context, false);
11374 12 : appendStringInfoChar(buf, ')');
11375 12 : return true;
11376 :
11377 12 : case F_LTRIM_BYTEA_BYTEA:
11378 : case F_LTRIM_TEXT:
11379 : case F_LTRIM_TEXT_TEXT:
11380 : /* TRIM() */
11381 12 : appendStringInfoString(buf, "TRIM(LEADING");
11382 12 : if (list_length(expr->args) == 2)
11383 : {
11384 12 : appendStringInfoChar(buf, ' ');
11385 12 : get_rule_expr((Node *) lsecond(expr->args), context, false);
11386 : }
11387 12 : appendStringInfoString(buf, " FROM ");
11388 12 : get_rule_expr((Node *) linitial(expr->args), context, false);
11389 12 : appendStringInfoChar(buf, ')');
11390 12 : return true;
11391 :
11392 12 : case F_RTRIM_BYTEA_BYTEA:
11393 : case F_RTRIM_TEXT:
11394 : case F_RTRIM_TEXT_TEXT:
11395 : /* TRIM() */
11396 12 : appendStringInfoString(buf, "TRIM(TRAILING");
11397 12 : if (list_length(expr->args) == 2)
11398 : {
11399 6 : appendStringInfoChar(buf, ' ');
11400 6 : get_rule_expr((Node *) lsecond(expr->args), context, false);
11401 : }
11402 12 : appendStringInfoString(buf, " FROM ");
11403 12 : get_rule_expr((Node *) linitial(expr->args), context, false);
11404 12 : appendStringInfoChar(buf, ')');
11405 12 : return true;
11406 :
11407 12 : case F_SYSTEM_USER:
11408 12 : appendStringInfoString(buf, "SYSTEM_USER");
11409 12 : return true;
11410 :
11411 0 : case F_XMLEXISTS:
11412 : /* XMLEXISTS ... extra parens because args are c_expr */
11413 0 : appendStringInfoString(buf, "XMLEXISTS((");
11414 0 : get_rule_expr((Node *) linitial(expr->args), context, false);
11415 0 : appendStringInfoString(buf, ") PASSING (");
11416 0 : get_rule_expr((Node *) lsecond(expr->args), context, false);
11417 0 : appendStringInfoString(buf, "))");
11418 0 : return true;
11419 : }
11420 6 : return false;
11421 : }
11422 :
11423 : /* ----------
11424 : * get_coercion_expr
11425 : *
11426 : * Make a string representation of a value coerced to a specific type
11427 : * ----------
11428 : */
11429 : static void
11430 5178 : get_coercion_expr(Node *arg, deparse_context *context,
11431 : Oid resulttype, int32 resulttypmod,
11432 : Node *parentNode)
11433 : {
11434 5178 : StringInfo buf = context->buf;
11435 :
11436 : /*
11437 : * Since parse_coerce.c doesn't immediately collapse application of
11438 : * length-coercion functions to constants, what we'll typically see in
11439 : * such cases is a Const with typmod -1 and a length-coercion function
11440 : * right above it. Avoid generating redundant output. However, beware of
11441 : * suppressing casts when the user actually wrote something like
11442 : * 'foo'::text::char(3).
11443 : *
11444 : * Note: it might seem that we are missing the possibility of needing to
11445 : * print a COLLATE clause for such a Const. However, a Const could only
11446 : * have nondefault collation in a post-constant-folding tree, in which the
11447 : * length coercion would have been folded too. See also the special
11448 : * handling of CollateExpr in coerce_to_target_type(): any collation
11449 : * marking will be above the coercion node, not below it.
11450 : */
11451 5178 : if (arg && IsA(arg, Const) &&
11452 614 : ((Const *) arg)->consttype == resulttype &&
11453 24 : ((Const *) arg)->consttypmod == -1)
11454 : {
11455 : /* Show the constant without normal ::typename decoration */
11456 24 : get_const_expr((Const *) arg, context, -1);
11457 : }
11458 : else
11459 : {
11460 5154 : if (!PRETTY_PAREN(context))
11461 4746 : appendStringInfoChar(buf, '(');
11462 5154 : get_rule_expr_paren(arg, context, false, parentNode);
11463 5154 : if (!PRETTY_PAREN(context))
11464 4746 : appendStringInfoChar(buf, ')');
11465 : }
11466 :
11467 : /*
11468 : * Never emit resulttype(arg) functional notation. A pg_proc entry could
11469 : * take precedence, and a resulttype in pg_temp would require schema
11470 : * qualification that format_type_with_typemod() would usually omit. We've
11471 : * standardized on arg::resulttype, but CAST(arg AS resulttype) notation
11472 : * would work fine.
11473 : */
11474 5178 : appendStringInfo(buf, "::%s",
11475 : format_type_with_typemod(resulttype, resulttypmod));
11476 5178 : }
11477 :
11478 : /* ----------
11479 : * get_const_expr
11480 : *
11481 : * Make a string representation of a Const
11482 : *
11483 : * showtype can be -1 to never show "::typename" decoration, or +1 to always
11484 : * show it, or 0 to show it only if the constant wouldn't be assumed to be
11485 : * the right type by default.
11486 : *
11487 : * If the Const's collation isn't default for its type, show that too.
11488 : * We mustn't do this when showtype is -1 (since that means the caller will
11489 : * print "::typename", and we can't put a COLLATE clause in between). It's
11490 : * caller's responsibility that collation isn't missed in such cases.
11491 : * ----------
11492 : */
11493 : static void
11494 69754 : get_const_expr(Const *constval, deparse_context *context, int showtype)
11495 : {
11496 69754 : StringInfo buf = context->buf;
11497 : Oid typoutput;
11498 : bool typIsVarlena;
11499 : char *extval;
11500 69754 : bool needlabel = false;
11501 :
11502 69754 : if (constval->constisnull)
11503 : {
11504 : /*
11505 : * Always label the type of a NULL constant to prevent misdecisions
11506 : * about type when reparsing.
11507 : */
11508 1170 : appendStringInfoString(buf, "NULL");
11509 1170 : if (showtype >= 0)
11510 : {
11511 1116 : appendStringInfo(buf, "::%s",
11512 : format_type_with_typemod(constval->consttype,
11513 : constval->consttypmod));
11514 1116 : get_const_collation(constval, context);
11515 : }
11516 9108 : return;
11517 : }
11518 :
11519 68584 : getTypeOutputInfo(constval->consttype,
11520 : &typoutput, &typIsVarlena);
11521 :
11522 68584 : extval = OidOutputFunctionCall(typoutput, constval->constvalue);
11523 :
11524 68584 : switch (constval->consttype)
11525 : {
11526 39432 : case INT4OID:
11527 :
11528 : /*
11529 : * INT4 can be printed without any decoration, unless it is
11530 : * negative; in that case print it as '-nnn'::integer to ensure
11531 : * that the output will re-parse as a constant, not as a constant
11532 : * plus operator. In most cases we could get away with printing
11533 : * (-nnn) instead, because of the way that gram.y handles negative
11534 : * literals; but that doesn't work for INT_MIN, and it doesn't
11535 : * seem that much prettier anyway.
11536 : */
11537 39432 : if (extval[0] != '-')
11538 38928 : appendStringInfoString(buf, extval);
11539 : else
11540 : {
11541 504 : appendStringInfo(buf, "'%s'", extval);
11542 504 : needlabel = true; /* we must attach a cast */
11543 : }
11544 39432 : break;
11545 :
11546 1090 : case NUMERICOID:
11547 :
11548 : /*
11549 : * NUMERIC can be printed without quotes if it looks like a float
11550 : * constant (not an integer, and not Infinity or NaN) and doesn't
11551 : * have a leading sign (for the same reason as for INT4).
11552 : */
11553 1090 : if (isdigit((unsigned char) extval[0]) &&
11554 1090 : strcspn(extval, "eE.") != strlen(extval))
11555 : {
11556 380 : appendStringInfoString(buf, extval);
11557 : }
11558 : else
11559 : {
11560 710 : appendStringInfo(buf, "'%s'", extval);
11561 710 : needlabel = true; /* we must attach a cast */
11562 : }
11563 1090 : break;
11564 :
11565 1668 : case BOOLOID:
11566 1668 : if (strcmp(extval, "t") == 0)
11567 740 : appendStringInfoString(buf, "true");
11568 : else
11569 928 : appendStringInfoString(buf, "false");
11570 1668 : break;
11571 :
11572 26394 : default:
11573 26394 : simple_quote_literal(buf, extval);
11574 26394 : break;
11575 : }
11576 :
11577 68584 : pfree(extval);
11578 :
11579 68584 : if (showtype < 0)
11580 7938 : return;
11581 :
11582 : /*
11583 : * For showtype == 0, append ::typename unless the constant will be
11584 : * implicitly typed as the right type when it is read in.
11585 : *
11586 : * XXX this code has to be kept in sync with the behavior of the parser,
11587 : * especially make_const.
11588 : */
11589 60646 : switch (constval->consttype)
11590 : {
11591 1736 : case BOOLOID:
11592 : case UNKNOWNOID:
11593 : /* These types can be left unlabeled */
11594 1736 : needlabel = false;
11595 1736 : break;
11596 34978 : case INT4OID:
11597 : /* We determined above whether a label is needed */
11598 34978 : break;
11599 1090 : case NUMERICOID:
11600 :
11601 : /*
11602 : * Float-looking constants will be typed as numeric, which we
11603 : * checked above; but if there's a nondefault typmod we need to
11604 : * show it.
11605 : */
11606 1090 : needlabel |= (constval->consttypmod >= 0);
11607 1090 : break;
11608 22842 : default:
11609 22842 : needlabel = true;
11610 22842 : break;
11611 : }
11612 60646 : if (needlabel || showtype > 0)
11613 24042 : appendStringInfo(buf, "::%s",
11614 : format_type_with_typemod(constval->consttype,
11615 : constval->consttypmod));
11616 :
11617 60646 : get_const_collation(constval, context);
11618 : }
11619 :
11620 : /*
11621 : * helper for get_const_expr: append COLLATE if needed
11622 : */
11623 : static void
11624 61762 : get_const_collation(Const *constval, deparse_context *context)
11625 : {
11626 61762 : StringInfo buf = context->buf;
11627 :
11628 61762 : if (OidIsValid(constval->constcollid))
11629 : {
11630 8882 : Oid typcollation = get_typcollation(constval->consttype);
11631 :
11632 8882 : if (constval->constcollid != typcollation)
11633 : {
11634 74 : appendStringInfo(buf, " COLLATE %s",
11635 : generate_collation_name(constval->constcollid));
11636 : }
11637 : }
11638 61762 : }
11639 :
11640 : /*
11641 : * get_json_path_spec - Parse back a JSON path specification
11642 : */
11643 : static void
11644 456 : get_json_path_spec(Node *path_spec, deparse_context *context, bool showimplicit)
11645 : {
11646 456 : if (IsA(path_spec, Const))
11647 456 : get_const_expr((Const *) path_spec, context, -1);
11648 : else
11649 0 : get_rule_expr(path_spec, context, showimplicit);
11650 456 : }
11651 :
11652 : /*
11653 : * get_json_format - Parse back a JsonFormat node
11654 : */
11655 : static void
11656 186 : get_json_format(JsonFormat *format, StringInfo buf)
11657 : {
11658 186 : if (format->format_type == JS_FORMAT_DEFAULT)
11659 108 : return;
11660 :
11661 78 : appendStringInfoString(buf,
11662 78 : format->format_type == JS_FORMAT_JSONB ?
11663 : " FORMAT JSONB" : " FORMAT JSON");
11664 :
11665 78 : if (format->encoding != JS_ENC_DEFAULT)
11666 : {
11667 : const char *encoding;
11668 :
11669 6 : encoding =
11670 12 : format->encoding == JS_ENC_UTF16 ? "UTF16" :
11671 6 : format->encoding == JS_ENC_UTF32 ? "UTF32" : "UTF8";
11672 :
11673 6 : appendStringInfo(buf, " ENCODING %s", encoding);
11674 : }
11675 : }
11676 :
11677 : /*
11678 : * get_json_returning - Parse back a JsonReturning structure
11679 : */
11680 : static void
11681 180 : get_json_returning(JsonReturning *returning, StringInfo buf,
11682 : bool json_format_by_default)
11683 : {
11684 180 : if (!OidIsValid(returning->typid))
11685 0 : return;
11686 :
11687 180 : appendStringInfo(buf, " RETURNING %s",
11688 : format_type_with_typemod(returning->typid,
11689 : returning->typmod));
11690 :
11691 348 : if (!json_format_by_default ||
11692 168 : returning->format->format_type !=
11693 168 : (returning->typid == JSONBOID ? JS_FORMAT_JSONB : JS_FORMAT_JSON))
11694 36 : get_json_format(returning->format, buf);
11695 : }
11696 :
11697 : /*
11698 : * get_json_constructor - Parse back a JsonConstructorExpr node
11699 : */
11700 : static void
11701 186 : get_json_constructor(JsonConstructorExpr *ctor, deparse_context *context,
11702 : bool showimplicit)
11703 : {
11704 186 : StringInfo buf = context->buf;
11705 : const char *funcname;
11706 : bool is_json_object;
11707 : int curridx;
11708 : ListCell *lc;
11709 :
11710 186 : if (ctor->type == JSCTOR_JSON_OBJECTAGG)
11711 : {
11712 36 : get_json_agg_constructor(ctor, context, "JSON_OBJECTAGG", true);
11713 36 : return;
11714 : }
11715 150 : else if (ctor->type == JSCTOR_JSON_ARRAYAGG)
11716 : {
11717 30 : get_json_agg_constructor(ctor, context, "JSON_ARRAYAGG", false);
11718 30 : return;
11719 : }
11720 :
11721 120 : switch (ctor->type)
11722 : {
11723 30 : case JSCTOR_JSON_OBJECT:
11724 30 : funcname = "JSON_OBJECT";
11725 30 : break;
11726 24 : case JSCTOR_JSON_ARRAY:
11727 24 : funcname = "JSON_ARRAY";
11728 24 : break;
11729 42 : case JSCTOR_JSON_PARSE:
11730 42 : funcname = "JSON";
11731 42 : break;
11732 12 : case JSCTOR_JSON_SCALAR:
11733 12 : funcname = "JSON_SCALAR";
11734 12 : break;
11735 12 : case JSCTOR_JSON_SERIALIZE:
11736 12 : funcname = "JSON_SERIALIZE";
11737 12 : break;
11738 0 : default:
11739 0 : elog(ERROR, "invalid JsonConstructorType %d", ctor->type);
11740 : }
11741 :
11742 120 : appendStringInfo(buf, "%s(", funcname);
11743 :
11744 120 : is_json_object = ctor->type == JSCTOR_JSON_OBJECT;
11745 318 : foreach(lc, ctor->args)
11746 : {
11747 198 : curridx = foreach_current_index(lc);
11748 198 : if (curridx > 0)
11749 : {
11750 : const char *sep;
11751 :
11752 78 : sep = (is_json_object && (curridx % 2) != 0) ? " : " : ", ";
11753 78 : appendStringInfoString(buf, sep);
11754 : }
11755 :
11756 198 : get_rule_expr((Node *) lfirst(lc), context, true);
11757 : }
11758 :
11759 120 : get_json_constructor_options(ctor, buf);
11760 120 : appendStringInfoChar(buf, ')');
11761 : }
11762 :
11763 : /*
11764 : * Append options, if any, to the JSON constructor being deparsed
11765 : */
11766 : static void
11767 186 : get_json_constructor_options(JsonConstructorExpr *ctor, StringInfo buf)
11768 : {
11769 186 : if (ctor->absent_on_null)
11770 : {
11771 36 : if (ctor->type == JSCTOR_JSON_OBJECT ||
11772 36 : ctor->type == JSCTOR_JSON_OBJECTAGG)
11773 0 : appendStringInfoString(buf, " ABSENT ON NULL");
11774 : }
11775 : else
11776 : {
11777 150 : if (ctor->type == JSCTOR_JSON_ARRAY ||
11778 150 : ctor->type == JSCTOR_JSON_ARRAYAGG)
11779 18 : appendStringInfoString(buf, " NULL ON NULL");
11780 : }
11781 :
11782 186 : if (ctor->unique)
11783 24 : appendStringInfoString(buf, " WITH UNIQUE KEYS");
11784 :
11785 : /*
11786 : * Append RETURNING clause if needed; JSON() and JSON_SCALAR() don't
11787 : * support one.
11788 : */
11789 186 : if (ctor->type != JSCTOR_JSON_PARSE && ctor->type != JSCTOR_JSON_SCALAR)
11790 132 : get_json_returning(ctor->returning, buf, true);
11791 186 : }
11792 :
11793 : /*
11794 : * get_json_agg_constructor - Parse back an aggregate JsonConstructorExpr node
11795 : */
11796 : static void
11797 66 : get_json_agg_constructor(JsonConstructorExpr *ctor, deparse_context *context,
11798 : const char *funcname, bool is_json_objectagg)
11799 : {
11800 : StringInfoData options;
11801 :
11802 66 : initStringInfo(&options);
11803 66 : get_json_constructor_options(ctor, &options);
11804 :
11805 66 : if (IsA(ctor->func, Aggref))
11806 54 : get_agg_expr_helper((Aggref *) ctor->func, context,
11807 54 : (Aggref *) ctor->func,
11808 54 : funcname, options.data, is_json_objectagg);
11809 12 : else if (IsA(ctor->func, WindowFunc))
11810 12 : get_windowfunc_expr_helper((WindowFunc *) ctor->func, context,
11811 12 : funcname, options.data,
11812 : is_json_objectagg);
11813 : else
11814 0 : elog(ERROR, "invalid JsonConstructorExpr underlying node type: %d",
11815 : nodeTag(ctor->func));
11816 66 : }
11817 :
11818 : /*
11819 : * simple_quote_literal - Format a string as a SQL literal, append to buf
11820 : */
11821 : static void
11822 27230 : simple_quote_literal(StringInfo buf, const char *val)
11823 : {
11824 : const char *valptr;
11825 :
11826 : /*
11827 : * We form the string literal according to the prevailing setting of
11828 : * standard_conforming_strings; we never use E''. User is responsible for
11829 : * making sure result is used correctly.
11830 : */
11831 27230 : appendStringInfoChar(buf, '\'');
11832 278540 : for (valptr = val; *valptr; valptr++)
11833 : {
11834 251310 : char ch = *valptr;
11835 :
11836 251310 : if (SQL_STR_DOUBLE(ch, !standard_conforming_strings))
11837 306 : appendStringInfoChar(buf, ch);
11838 251310 : appendStringInfoChar(buf, ch);
11839 : }
11840 27230 : appendStringInfoChar(buf, '\'');
11841 27230 : }
11842 :
11843 :
11844 : /* ----------
11845 : * get_sublink_expr - Parse back a sublink
11846 : * ----------
11847 : */
11848 : static void
11849 460 : get_sublink_expr(SubLink *sublink, deparse_context *context)
11850 : {
11851 460 : StringInfo buf = context->buf;
11852 460 : Query *query = (Query *) (sublink->subselect);
11853 460 : char *opname = NULL;
11854 : bool need_paren;
11855 :
11856 460 : if (sublink->subLinkType == ARRAY_SUBLINK)
11857 24 : appendStringInfoString(buf, "ARRAY(");
11858 : else
11859 436 : appendStringInfoChar(buf, '(');
11860 :
11861 : /*
11862 : * Note that we print the name of only the first operator, when there are
11863 : * multiple combining operators. This is an approximation that could go
11864 : * wrong in various scenarios (operators in different schemas, renamed
11865 : * operators, etc) but there is not a whole lot we can do about it, since
11866 : * the syntax allows only one operator to be shown.
11867 : */
11868 460 : if (sublink->testexpr)
11869 : {
11870 18 : if (IsA(sublink->testexpr, OpExpr))
11871 : {
11872 : /* single combining operator */
11873 6 : OpExpr *opexpr = (OpExpr *) sublink->testexpr;
11874 :
11875 6 : get_rule_expr(linitial(opexpr->args), context, true);
11876 6 : opname = generate_operator_name(opexpr->opno,
11877 6 : exprType(linitial(opexpr->args)),
11878 6 : exprType(lsecond(opexpr->args)));
11879 : }
11880 12 : else if (IsA(sublink->testexpr, BoolExpr))
11881 : {
11882 : /* multiple combining operators, = or <> cases */
11883 : char *sep;
11884 : ListCell *l;
11885 :
11886 6 : appendStringInfoChar(buf, '(');
11887 6 : sep = "";
11888 18 : foreach(l, ((BoolExpr *) sublink->testexpr)->args)
11889 : {
11890 12 : OpExpr *opexpr = lfirst_node(OpExpr, l);
11891 :
11892 12 : appendStringInfoString(buf, sep);
11893 12 : get_rule_expr(linitial(opexpr->args), context, true);
11894 12 : if (!opname)
11895 6 : opname = generate_operator_name(opexpr->opno,
11896 6 : exprType(linitial(opexpr->args)),
11897 6 : exprType(lsecond(opexpr->args)));
11898 12 : sep = ", ";
11899 : }
11900 6 : appendStringInfoChar(buf, ')');
11901 : }
11902 6 : else if (IsA(sublink->testexpr, RowCompareExpr))
11903 : {
11904 : /* multiple combining operators, < <= > >= cases */
11905 6 : RowCompareExpr *rcexpr = (RowCompareExpr *) sublink->testexpr;
11906 :
11907 6 : appendStringInfoChar(buf, '(');
11908 6 : get_rule_expr((Node *) rcexpr->largs, context, true);
11909 6 : opname = generate_operator_name(linitial_oid(rcexpr->opnos),
11910 6 : exprType(linitial(rcexpr->largs)),
11911 6 : exprType(linitial(rcexpr->rargs)));
11912 6 : appendStringInfoChar(buf, ')');
11913 : }
11914 : else
11915 0 : elog(ERROR, "unrecognized testexpr type: %d",
11916 : (int) nodeTag(sublink->testexpr));
11917 : }
11918 :
11919 460 : need_paren = true;
11920 :
11921 460 : switch (sublink->subLinkType)
11922 : {
11923 176 : case EXISTS_SUBLINK:
11924 176 : appendStringInfoString(buf, "EXISTS ");
11925 176 : break;
11926 :
11927 12 : case ANY_SUBLINK:
11928 12 : if (strcmp(opname, "=") == 0) /* Represent = ANY as IN */
11929 6 : appendStringInfoString(buf, " IN ");
11930 : else
11931 6 : appendStringInfo(buf, " %s ANY ", opname);
11932 12 : break;
11933 :
11934 6 : case ALL_SUBLINK:
11935 6 : appendStringInfo(buf, " %s ALL ", opname);
11936 6 : break;
11937 :
11938 0 : case ROWCOMPARE_SUBLINK:
11939 0 : appendStringInfo(buf, " %s ", opname);
11940 0 : break;
11941 :
11942 266 : case EXPR_SUBLINK:
11943 : case MULTIEXPR_SUBLINK:
11944 : case ARRAY_SUBLINK:
11945 266 : need_paren = false;
11946 266 : break;
11947 :
11948 0 : case CTE_SUBLINK: /* shouldn't occur in a SubLink */
11949 : default:
11950 0 : elog(ERROR, "unrecognized sublink type: %d",
11951 : (int) sublink->subLinkType);
11952 : break;
11953 : }
11954 :
11955 460 : if (need_paren)
11956 194 : appendStringInfoChar(buf, '(');
11957 :
11958 460 : get_query_def(query, buf, context->namespaces, NULL, false,
11959 : context->prettyFlags, context->wrapColumn,
11960 : context->indentLevel);
11961 :
11962 460 : if (need_paren)
11963 194 : appendStringInfoString(buf, "))");
11964 : else
11965 266 : appendStringInfoChar(buf, ')');
11966 460 : }
11967 :
11968 :
11969 : /* ----------
11970 : * get_xmltable - Parse back a XMLTABLE function
11971 : * ----------
11972 : */
11973 : static void
11974 62 : get_xmltable(TableFunc *tf, deparse_context *context, bool showimplicit)
11975 : {
11976 62 : StringInfo buf = context->buf;
11977 :
11978 62 : appendStringInfoString(buf, "XMLTABLE(");
11979 :
11980 62 : if (tf->ns_uris != NIL)
11981 : {
11982 : ListCell *lc1,
11983 : *lc2;
11984 16 : bool first = true;
11985 :
11986 16 : appendStringInfoString(buf, "XMLNAMESPACES (");
11987 32 : forboth(lc1, tf->ns_uris, lc2, tf->ns_names)
11988 : {
11989 16 : Node *expr = (Node *) lfirst(lc1);
11990 16 : String *ns_node = lfirst_node(String, lc2);
11991 :
11992 16 : if (!first)
11993 0 : appendStringInfoString(buf, ", ");
11994 : else
11995 16 : first = false;
11996 :
11997 16 : if (ns_node != NULL)
11998 : {
11999 16 : get_rule_expr(expr, context, showimplicit);
12000 16 : appendStringInfo(buf, " AS %s",
12001 16 : quote_identifier(strVal(ns_node)));
12002 : }
12003 : else
12004 : {
12005 0 : appendStringInfoString(buf, "DEFAULT ");
12006 0 : get_rule_expr(expr, context, showimplicit);
12007 : }
12008 : }
12009 16 : appendStringInfoString(buf, "), ");
12010 : }
12011 :
12012 62 : appendStringInfoChar(buf, '(');
12013 62 : get_rule_expr((Node *) tf->rowexpr, context, showimplicit);
12014 62 : appendStringInfoString(buf, ") PASSING (");
12015 62 : get_rule_expr((Node *) tf->docexpr, context, showimplicit);
12016 62 : appendStringInfoChar(buf, ')');
12017 :
12018 62 : if (tf->colexprs != NIL)
12019 : {
12020 : ListCell *l1;
12021 : ListCell *l2;
12022 : ListCell *l3;
12023 : ListCell *l4;
12024 : ListCell *l5;
12025 62 : int colnum = 0;
12026 :
12027 62 : appendStringInfoString(buf, " COLUMNS ");
12028 374 : forfive(l1, tf->colnames, l2, tf->coltypes, l3, tf->coltypmods,
12029 : l4, tf->colexprs, l5, tf->coldefexprs)
12030 : {
12031 312 : char *colname = strVal(lfirst(l1));
12032 312 : Oid typid = lfirst_oid(l2);
12033 312 : int32 typmod = lfirst_int(l3);
12034 312 : Node *colexpr = (Node *) lfirst(l4);
12035 312 : Node *coldefexpr = (Node *) lfirst(l5);
12036 312 : bool ordinality = (tf->ordinalitycol == colnum);
12037 312 : bool notnull = bms_is_member(colnum, tf->notnulls);
12038 :
12039 312 : if (colnum > 0)
12040 250 : appendStringInfoString(buf, ", ");
12041 312 : colnum++;
12042 :
12043 590 : appendStringInfo(buf, "%s %s", quote_identifier(colname),
12044 : ordinality ? "FOR ORDINALITY" :
12045 278 : format_type_with_typemod(typid, typmod));
12046 312 : if (ordinality)
12047 34 : continue;
12048 :
12049 278 : if (coldefexpr != NULL)
12050 : {
12051 34 : appendStringInfoString(buf, " DEFAULT (");
12052 34 : get_rule_expr((Node *) coldefexpr, context, showimplicit);
12053 34 : appendStringInfoChar(buf, ')');
12054 : }
12055 278 : if (colexpr != NULL)
12056 : {
12057 254 : appendStringInfoString(buf, " PATH (");
12058 254 : get_rule_expr((Node *) colexpr, context, showimplicit);
12059 254 : appendStringInfoChar(buf, ')');
12060 : }
12061 278 : if (notnull)
12062 34 : appendStringInfoString(buf, " NOT NULL");
12063 : }
12064 : }
12065 :
12066 62 : appendStringInfoChar(buf, ')');
12067 62 : }
12068 :
12069 : /*
12070 : * get_json_table_nested_columns - Parse back nested JSON_TABLE columns
12071 : */
12072 : static void
12073 102 : get_json_table_nested_columns(TableFunc *tf, JsonTablePlan *plan,
12074 : deparse_context *context, bool showimplicit,
12075 : bool needcomma)
12076 : {
12077 102 : if (IsA(plan, JsonTablePathScan))
12078 : {
12079 72 : JsonTablePathScan *scan = castNode(JsonTablePathScan, plan);
12080 :
12081 72 : if (needcomma)
12082 48 : appendStringInfoChar(context->buf, ',');
12083 :
12084 72 : appendStringInfoChar(context->buf, ' ');
12085 72 : appendContextKeyword(context, "NESTED PATH ", 0, 0, 0);
12086 72 : get_const_expr(scan->path->value, context, -1);
12087 72 : appendStringInfo(context->buf, " AS %s", quote_identifier(scan->path->name));
12088 72 : get_json_table_columns(tf, scan, context, showimplicit);
12089 : }
12090 30 : else if (IsA(plan, JsonTableSiblingJoin))
12091 : {
12092 30 : JsonTableSiblingJoin *join = (JsonTableSiblingJoin *) plan;
12093 :
12094 30 : get_json_table_nested_columns(tf, join->lplan, context, showimplicit,
12095 : needcomma);
12096 30 : get_json_table_nested_columns(tf, join->rplan, context, showimplicit,
12097 : true);
12098 : }
12099 102 : }
12100 :
12101 : /*
12102 : * get_json_table_columns - Parse back JSON_TABLE columns
12103 : */
12104 : static void
12105 180 : get_json_table_columns(TableFunc *tf, JsonTablePathScan *scan,
12106 : deparse_context *context,
12107 : bool showimplicit)
12108 : {
12109 180 : StringInfo buf = context->buf;
12110 : ListCell *lc_colname;
12111 : ListCell *lc_coltype;
12112 : ListCell *lc_coltypmod;
12113 : ListCell *lc_colvalexpr;
12114 180 : int colnum = 0;
12115 :
12116 180 : appendStringInfoChar(buf, ' ');
12117 180 : appendContextKeyword(context, "COLUMNS (", 0, 0, 0);
12118 :
12119 180 : if (PRETTY_INDENT(context))
12120 138 : context->indentLevel += PRETTYINDENT_VAR;
12121 :
12122 858 : forfour(lc_colname, tf->colnames,
12123 : lc_coltype, tf->coltypes,
12124 : lc_coltypmod, tf->coltypmods,
12125 : lc_colvalexpr, tf->colvalexprs)
12126 : {
12127 726 : char *colname = strVal(lfirst(lc_colname));
12128 : JsonExpr *colexpr;
12129 : Oid typid;
12130 : int32 typmod;
12131 : bool ordinality;
12132 : JsonBehaviorType default_behavior;
12133 :
12134 726 : typid = lfirst_oid(lc_coltype);
12135 726 : typmod = lfirst_int(lc_coltypmod);
12136 726 : colexpr = castNode(JsonExpr, lfirst(lc_colvalexpr));
12137 :
12138 : /* Skip columns that don't belong to this scan. */
12139 726 : if (scan->colMin < 0 || colnum < scan->colMin)
12140 : {
12141 264 : colnum++;
12142 264 : continue;
12143 : }
12144 462 : if (colnum > scan->colMax)
12145 48 : break;
12146 :
12147 414 : if (colnum > scan->colMin)
12148 258 : appendStringInfoString(buf, ", ");
12149 :
12150 414 : colnum++;
12151 :
12152 414 : ordinality = !colexpr;
12153 :
12154 414 : appendContextKeyword(context, "", 0, 0, 0);
12155 :
12156 810 : appendStringInfo(buf, "%s %s", quote_identifier(colname),
12157 : ordinality ? "FOR ORDINALITY" :
12158 396 : format_type_with_typemod(typid, typmod));
12159 414 : if (ordinality)
12160 18 : continue;
12161 :
12162 : /*
12163 : * Set default_behavior to guide get_json_expr_options() on whether to
12164 : * emit the ON ERROR / EMPTY clauses.
12165 : */
12166 396 : if (colexpr->op == JSON_EXISTS_OP)
12167 : {
12168 36 : appendStringInfoString(buf, " EXISTS");
12169 36 : default_behavior = JSON_BEHAVIOR_FALSE;
12170 : }
12171 : else
12172 : {
12173 360 : if (colexpr->op == JSON_QUERY_OP)
12174 : {
12175 : char typcategory;
12176 : bool typispreferred;
12177 :
12178 174 : get_type_category_preferred(typid, &typcategory, &typispreferred);
12179 :
12180 174 : if (typcategory == TYPCATEGORY_STRING)
12181 36 : appendStringInfoString(buf,
12182 36 : colexpr->format->format_type == JS_FORMAT_JSONB ?
12183 : " FORMAT JSONB" : " FORMAT JSON");
12184 : }
12185 :
12186 360 : default_behavior = JSON_BEHAVIOR_NULL;
12187 : }
12188 :
12189 396 : appendStringInfoString(buf, " PATH ");
12190 :
12191 396 : get_json_path_spec(colexpr->path_spec, context, showimplicit);
12192 :
12193 396 : get_json_expr_options(colexpr, context, default_behavior);
12194 : }
12195 :
12196 180 : if (scan->child)
12197 42 : get_json_table_nested_columns(tf, scan->child, context, showimplicit,
12198 42 : scan->colMin >= 0);
12199 :
12200 180 : if (PRETTY_INDENT(context))
12201 138 : context->indentLevel -= PRETTYINDENT_VAR;
12202 :
12203 180 : appendContextKeyword(context, ")", 0, 0, 0);
12204 180 : }
12205 :
12206 : /* ----------
12207 : * get_json_table - Parse back a JSON_TABLE function
12208 : * ----------
12209 : */
12210 : static void
12211 108 : get_json_table(TableFunc *tf, deparse_context *context, bool showimplicit)
12212 : {
12213 108 : StringInfo buf = context->buf;
12214 108 : JsonExpr *jexpr = castNode(JsonExpr, tf->docexpr);
12215 108 : JsonTablePathScan *root = castNode(JsonTablePathScan, tf->plan);
12216 :
12217 108 : appendStringInfoString(buf, "JSON_TABLE(");
12218 :
12219 108 : if (PRETTY_INDENT(context))
12220 66 : context->indentLevel += PRETTYINDENT_VAR;
12221 :
12222 108 : appendContextKeyword(context, "", 0, 0, 0);
12223 :
12224 108 : get_rule_expr(jexpr->formatted_expr, context, showimplicit);
12225 :
12226 108 : appendStringInfoString(buf, ", ");
12227 :
12228 108 : get_const_expr(root->path->value, context, -1);
12229 :
12230 108 : appendStringInfo(buf, " AS %s", quote_identifier(root->path->name));
12231 :
12232 108 : if (jexpr->passing_values)
12233 : {
12234 : ListCell *lc1,
12235 : *lc2;
12236 84 : bool needcomma = false;
12237 :
12238 84 : appendStringInfoChar(buf, ' ');
12239 84 : appendContextKeyword(context, "PASSING ", 0, 0, 0);
12240 :
12241 84 : if (PRETTY_INDENT(context))
12242 42 : context->indentLevel += PRETTYINDENT_VAR;
12243 :
12244 252 : forboth(lc1, jexpr->passing_names,
12245 : lc2, jexpr->passing_values)
12246 : {
12247 168 : if (needcomma)
12248 84 : appendStringInfoString(buf, ", ");
12249 168 : needcomma = true;
12250 :
12251 168 : appendContextKeyword(context, "", 0, 0, 0);
12252 :
12253 168 : get_rule_expr((Node *) lfirst(lc2), context, false);
12254 168 : appendStringInfo(buf, " AS %s",
12255 168 : quote_identifier((lfirst_node(String, lc1))->sval)
12256 : );
12257 : }
12258 :
12259 84 : if (PRETTY_INDENT(context))
12260 42 : context->indentLevel -= PRETTYINDENT_VAR;
12261 : }
12262 :
12263 108 : get_json_table_columns(tf, castNode(JsonTablePathScan, tf->plan), context,
12264 : showimplicit);
12265 :
12266 108 : if (jexpr->on_error->btype != JSON_BEHAVIOR_EMPTY_ARRAY)
12267 6 : get_json_behavior(jexpr->on_error, context, "ERROR");
12268 :
12269 108 : if (PRETTY_INDENT(context))
12270 66 : context->indentLevel -= PRETTYINDENT_VAR;
12271 :
12272 108 : appendContextKeyword(context, ")", 0, 0, 0);
12273 108 : }
12274 :
12275 : /* ----------
12276 : * get_tablefunc - Parse back a table function
12277 : * ----------
12278 : */
12279 : static void
12280 170 : get_tablefunc(TableFunc *tf, deparse_context *context, bool showimplicit)
12281 : {
12282 : /* XMLTABLE and JSON_TABLE are the only existing implementations. */
12283 :
12284 170 : if (tf->functype == TFT_XMLTABLE)
12285 62 : get_xmltable(tf, context, showimplicit);
12286 108 : else if (tf->functype == TFT_JSON_TABLE)
12287 108 : get_json_table(tf, context, showimplicit);
12288 170 : }
12289 :
12290 : /* ----------
12291 : * get_from_clause - Parse back a FROM clause
12292 : *
12293 : * "prefix" is the keyword that denotes the start of the list of FROM
12294 : * elements. It is FROM when used to parse back SELECT and UPDATE, but
12295 : * is USING when parsing back DELETE.
12296 : * ----------
12297 : */
12298 : static void
12299 4920 : get_from_clause(Query *query, const char *prefix, deparse_context *context)
12300 : {
12301 4920 : StringInfo buf = context->buf;
12302 4920 : bool first = true;
12303 : ListCell *l;
12304 :
12305 : /*
12306 : * We use the query's jointree as a guide to what to print. However, we
12307 : * must ignore auto-added RTEs that are marked not inFromCl. (These can
12308 : * only appear at the top level of the jointree, so it's sufficient to
12309 : * check here.) This check also ensures we ignore the rule pseudo-RTEs
12310 : * for NEW and OLD.
12311 : */
12312 9796 : foreach(l, query->jointree->fromlist)
12313 : {
12314 4876 : Node *jtnode = (Node *) lfirst(l);
12315 :
12316 4876 : if (IsA(jtnode, RangeTblRef))
12317 : {
12318 3910 : int varno = ((RangeTblRef *) jtnode)->rtindex;
12319 3910 : RangeTblEntry *rte = rt_fetch(varno, query->rtable);
12320 :
12321 3910 : if (!rte->inFromCl)
12322 400 : continue;
12323 : }
12324 :
12325 4476 : if (first)
12326 : {
12327 4106 : appendContextKeyword(context, prefix,
12328 : -PRETTYINDENT_STD, PRETTYINDENT_STD, 2);
12329 4106 : first = false;
12330 :
12331 4106 : get_from_clause_item(jtnode, query, context);
12332 : }
12333 : else
12334 : {
12335 : StringInfoData itembuf;
12336 :
12337 370 : appendStringInfoString(buf, ", ");
12338 :
12339 : /*
12340 : * Put the new FROM item's text into itembuf so we can decide
12341 : * after we've got it whether or not it needs to go on a new line.
12342 : */
12343 370 : initStringInfo(&itembuf);
12344 370 : context->buf = &itembuf;
12345 :
12346 370 : get_from_clause_item(jtnode, query, context);
12347 :
12348 : /* Restore context's output buffer */
12349 370 : context->buf = buf;
12350 :
12351 : /* Consider line-wrapping if enabled */
12352 370 : if (PRETTY_INDENT(context) && context->wrapColumn >= 0)
12353 : {
12354 : /* Does the new item start with a new line? */
12355 370 : if (itembuf.len > 0 && itembuf.data[0] == '\n')
12356 : {
12357 : /* If so, we shouldn't add anything */
12358 : /* instead, remove any trailing spaces currently in buf */
12359 0 : removeStringInfoSpaces(buf);
12360 : }
12361 : else
12362 : {
12363 : char *trailing_nl;
12364 :
12365 : /* Locate the start of the current line in the buffer */
12366 370 : trailing_nl = strrchr(buf->data, '\n');
12367 370 : if (trailing_nl == NULL)
12368 0 : trailing_nl = buf->data;
12369 : else
12370 370 : trailing_nl++;
12371 :
12372 : /*
12373 : * Add a newline, plus some indentation, if the new item
12374 : * would cause an overflow.
12375 : */
12376 370 : if (strlen(trailing_nl) + itembuf.len > context->wrapColumn)
12377 370 : appendContextKeyword(context, "", -PRETTYINDENT_STD,
12378 : PRETTYINDENT_STD,
12379 : PRETTYINDENT_VAR);
12380 : }
12381 : }
12382 :
12383 : /* Add the new item */
12384 370 : appendBinaryStringInfo(buf, itembuf.data, itembuf.len);
12385 :
12386 : /* clean up */
12387 370 : pfree(itembuf.data);
12388 : }
12389 : }
12390 4920 : }
12391 :
12392 : static void
12393 7520 : get_from_clause_item(Node *jtnode, Query *query, deparse_context *context)
12394 : {
12395 7520 : StringInfo buf = context->buf;
12396 7520 : deparse_namespace *dpns = (deparse_namespace *) linitial(context->namespaces);
12397 :
12398 7520 : if (IsA(jtnode, RangeTblRef))
12399 : {
12400 5998 : int varno = ((RangeTblRef *) jtnode)->rtindex;
12401 5998 : RangeTblEntry *rte = rt_fetch(varno, query->rtable);
12402 5998 : deparse_columns *colinfo = deparse_columns_fetch(varno, dpns);
12403 5998 : RangeTblFunction *rtfunc1 = NULL;
12404 :
12405 5998 : if (rte->lateral)
12406 124 : appendStringInfoString(buf, "LATERAL ");
12407 :
12408 : /* Print the FROM item proper */
12409 5998 : switch (rte->rtekind)
12410 : {
12411 4554 : case RTE_RELATION:
12412 : /* Normal relation RTE */
12413 9108 : appendStringInfo(buf, "%s%s",
12414 4554 : only_marker(rte),
12415 : generate_relation_name(rte->relid,
12416 : context->namespaces));
12417 4554 : break;
12418 292 : case RTE_SUBQUERY:
12419 : /* Subquery RTE */
12420 292 : appendStringInfoChar(buf, '(');
12421 292 : get_query_def(rte->subquery, buf, context->namespaces, NULL,
12422 : true,
12423 : context->prettyFlags, context->wrapColumn,
12424 : context->indentLevel);
12425 292 : appendStringInfoChar(buf, ')');
12426 292 : break;
12427 858 : case RTE_FUNCTION:
12428 : /* Function RTE */
12429 858 : rtfunc1 = (RangeTblFunction *) linitial(rte->functions);
12430 :
12431 : /*
12432 : * Omit ROWS FROM() syntax for just one function, unless it
12433 : * has both a coldeflist and WITH ORDINALITY. If it has both,
12434 : * we must use ROWS FROM() syntax to avoid ambiguity about
12435 : * whether the coldeflist includes the ordinality column.
12436 : */
12437 858 : if (list_length(rte->functions) == 1 &&
12438 828 : (rtfunc1->funccolnames == NIL || !rte->funcordinality))
12439 : {
12440 828 : get_rule_expr_funccall(rtfunc1->funcexpr, context, true);
12441 : /* we'll print the coldeflist below, if it has one */
12442 : }
12443 : else
12444 : {
12445 : bool all_unnest;
12446 : ListCell *lc;
12447 :
12448 : /*
12449 : * If all the function calls in the list are to unnest,
12450 : * and none need a coldeflist, then collapse the list back
12451 : * down to UNNEST(args). (If we had more than one
12452 : * built-in unnest function, this would get more
12453 : * difficult.)
12454 : *
12455 : * XXX This is pretty ugly, since it makes not-terribly-
12456 : * future-proof assumptions about what the parser would do
12457 : * with the output; but the alternative is to emit our
12458 : * nonstandard ROWS FROM() notation for what might have
12459 : * been a perfectly spec-compliant multi-argument
12460 : * UNNEST().
12461 : */
12462 30 : all_unnest = true;
12463 78 : foreach(lc, rte->functions)
12464 : {
12465 66 : RangeTblFunction *rtfunc = (RangeTblFunction *) lfirst(lc);
12466 :
12467 66 : if (!IsA(rtfunc->funcexpr, FuncExpr) ||
12468 66 : ((FuncExpr *) rtfunc->funcexpr)->funcid != F_UNNEST_ANYARRAY ||
12469 48 : rtfunc->funccolnames != NIL)
12470 : {
12471 18 : all_unnest = false;
12472 18 : break;
12473 : }
12474 : }
12475 :
12476 30 : if (all_unnest)
12477 : {
12478 12 : List *allargs = NIL;
12479 :
12480 48 : foreach(lc, rte->functions)
12481 : {
12482 36 : RangeTblFunction *rtfunc = (RangeTblFunction *) lfirst(lc);
12483 36 : List *args = ((FuncExpr *) rtfunc->funcexpr)->args;
12484 :
12485 36 : allargs = list_concat(allargs, args);
12486 : }
12487 :
12488 12 : appendStringInfoString(buf, "UNNEST(");
12489 12 : get_rule_expr((Node *) allargs, context, true);
12490 12 : appendStringInfoChar(buf, ')');
12491 : }
12492 : else
12493 : {
12494 18 : int funcno = 0;
12495 :
12496 18 : appendStringInfoString(buf, "ROWS FROM(");
12497 66 : foreach(lc, rte->functions)
12498 : {
12499 48 : RangeTblFunction *rtfunc = (RangeTblFunction *) lfirst(lc);
12500 :
12501 48 : if (funcno > 0)
12502 30 : appendStringInfoString(buf, ", ");
12503 48 : get_rule_expr_funccall(rtfunc->funcexpr, context, true);
12504 48 : if (rtfunc->funccolnames != NIL)
12505 : {
12506 : /* Reconstruct the column definition list */
12507 6 : appendStringInfoString(buf, " AS ");
12508 6 : get_from_clause_coldeflist(rtfunc,
12509 : NULL,
12510 : context);
12511 : }
12512 48 : funcno++;
12513 : }
12514 18 : appendStringInfoChar(buf, ')');
12515 : }
12516 : /* prevent printing duplicate coldeflist below */
12517 30 : rtfunc1 = NULL;
12518 : }
12519 858 : if (rte->funcordinality)
12520 18 : appendStringInfoString(buf, " WITH ORDINALITY");
12521 858 : break;
12522 98 : case RTE_TABLEFUNC:
12523 98 : get_tablefunc(rte->tablefunc, context, true);
12524 98 : break;
12525 12 : case RTE_VALUES:
12526 : /* Values list RTE */
12527 12 : appendStringInfoChar(buf, '(');
12528 12 : get_values_def(rte->values_lists, context);
12529 12 : appendStringInfoChar(buf, ')');
12530 12 : break;
12531 184 : case RTE_CTE:
12532 184 : appendStringInfoString(buf, quote_identifier(rte->ctename));
12533 184 : break;
12534 0 : default:
12535 0 : elog(ERROR, "unrecognized RTE kind: %d", (int) rte->rtekind);
12536 : break;
12537 : }
12538 :
12539 : /* Print the relation alias, if needed */
12540 5998 : get_rte_alias(rte, varno, false, context);
12541 :
12542 : /* Print the column definitions or aliases, if needed */
12543 5998 : if (rtfunc1 && rtfunc1->funccolnames != NIL)
12544 : {
12545 : /* Reconstruct the columndef list, which is also the aliases */
12546 0 : get_from_clause_coldeflist(rtfunc1, colinfo, context);
12547 : }
12548 : else
12549 : {
12550 : /* Else print column aliases as needed */
12551 5998 : get_column_alias_list(colinfo, context);
12552 : }
12553 :
12554 : /* Tablesample clause must go after any alias */
12555 5998 : if (rte->rtekind == RTE_RELATION && rte->tablesample)
12556 32 : get_tablesample_def(rte->tablesample, context);
12557 : }
12558 1522 : else if (IsA(jtnode, JoinExpr))
12559 : {
12560 1522 : JoinExpr *j = (JoinExpr *) jtnode;
12561 1522 : deparse_columns *colinfo = deparse_columns_fetch(j->rtindex, dpns);
12562 : bool need_paren_on_right;
12563 :
12564 3494 : need_paren_on_right = PRETTY_PAREN(context) &&
12565 1522 : !IsA(j->rarg, RangeTblRef) &&
12566 0 : !(IsA(j->rarg, JoinExpr) && ((JoinExpr *) j->rarg)->alias != NULL);
12567 :
12568 1522 : if (!PRETTY_PAREN(context) || j->alias != NULL)
12569 1180 : appendStringInfoChar(buf, '(');
12570 :
12571 1522 : get_from_clause_item(j->larg, query, context);
12572 :
12573 1522 : switch (j->jointype)
12574 : {
12575 836 : case JOIN_INNER:
12576 836 : if (j->quals)
12577 794 : appendContextKeyword(context, " JOIN ",
12578 : -PRETTYINDENT_STD,
12579 : PRETTYINDENT_STD,
12580 : PRETTYINDENT_JOIN);
12581 : else
12582 42 : appendContextKeyword(context, " CROSS JOIN ",
12583 : -PRETTYINDENT_STD,
12584 : PRETTYINDENT_STD,
12585 : PRETTYINDENT_JOIN);
12586 836 : break;
12587 584 : case JOIN_LEFT:
12588 584 : appendContextKeyword(context, " LEFT JOIN ",
12589 : -PRETTYINDENT_STD,
12590 : PRETTYINDENT_STD,
12591 : PRETTYINDENT_JOIN);
12592 584 : break;
12593 102 : case JOIN_FULL:
12594 102 : appendContextKeyword(context, " FULL JOIN ",
12595 : -PRETTYINDENT_STD,
12596 : PRETTYINDENT_STD,
12597 : PRETTYINDENT_JOIN);
12598 102 : break;
12599 0 : case JOIN_RIGHT:
12600 0 : appendContextKeyword(context, " RIGHT JOIN ",
12601 : -PRETTYINDENT_STD,
12602 : PRETTYINDENT_STD,
12603 : PRETTYINDENT_JOIN);
12604 0 : break;
12605 0 : default:
12606 0 : elog(ERROR, "unrecognized join type: %d",
12607 : (int) j->jointype);
12608 : }
12609 :
12610 1522 : if (need_paren_on_right)
12611 0 : appendStringInfoChar(buf, '(');
12612 1522 : get_from_clause_item(j->rarg, query, context);
12613 1522 : if (need_paren_on_right)
12614 0 : appendStringInfoChar(buf, ')');
12615 :
12616 1522 : if (j->usingClause)
12617 : {
12618 : ListCell *lc;
12619 424 : bool first = true;
12620 :
12621 424 : appendStringInfoString(buf, " USING (");
12622 : /* Use the assigned names, not what's in usingClause */
12623 1004 : foreach(lc, colinfo->usingNames)
12624 : {
12625 580 : char *colname = (char *) lfirst(lc);
12626 :
12627 580 : if (first)
12628 424 : first = false;
12629 : else
12630 156 : appendStringInfoString(buf, ", ");
12631 580 : appendStringInfoString(buf, quote_identifier(colname));
12632 : }
12633 424 : appendStringInfoChar(buf, ')');
12634 :
12635 424 : if (j->join_using_alias)
12636 12 : appendStringInfo(buf, " AS %s",
12637 12 : quote_identifier(j->join_using_alias->aliasname));
12638 : }
12639 1098 : else if (j->quals)
12640 : {
12641 1050 : appendStringInfoString(buf, " ON ");
12642 1050 : if (!PRETTY_PAREN(context))
12643 1032 : appendStringInfoChar(buf, '(');
12644 1050 : get_rule_expr(j->quals, context, false);
12645 1050 : if (!PRETTY_PAREN(context))
12646 1032 : appendStringInfoChar(buf, ')');
12647 : }
12648 48 : else if (j->jointype != JOIN_INNER)
12649 : {
12650 : /* If we didn't say CROSS JOIN above, we must provide an ON */
12651 6 : appendStringInfoString(buf, " ON TRUE");
12652 : }
12653 :
12654 1522 : if (!PRETTY_PAREN(context) || j->alias != NULL)
12655 1180 : appendStringInfoChar(buf, ')');
12656 :
12657 : /* Yes, it's correct to put alias after the right paren ... */
12658 1522 : if (j->alias != NULL)
12659 : {
12660 : /*
12661 : * Note that it's correct to emit an alias clause if and only if
12662 : * there was one originally. Otherwise we'd be converting a named
12663 : * join to unnamed or vice versa, which creates semantic
12664 : * subtleties we don't want. However, we might print a different
12665 : * alias name than was there originally.
12666 : */
12667 108 : appendStringInfo(buf, " %s",
12668 108 : quote_identifier(get_rtable_name(j->rtindex,
12669 : context)));
12670 108 : get_column_alias_list(colinfo, context);
12671 : }
12672 : }
12673 : else
12674 0 : elog(ERROR, "unrecognized node type: %d",
12675 : (int) nodeTag(jtnode));
12676 7520 : }
12677 :
12678 : /*
12679 : * get_rte_alias - print the relation's alias, if needed
12680 : *
12681 : * If printed, the alias is preceded by a space, or by " AS " if use_as is true.
12682 : */
12683 : static void
12684 6580 : get_rte_alias(RangeTblEntry *rte, int varno, bool use_as,
12685 : deparse_context *context)
12686 : {
12687 6580 : deparse_namespace *dpns = (deparse_namespace *) linitial(context->namespaces);
12688 6580 : char *refname = get_rtable_name(varno, context);
12689 6580 : deparse_columns *colinfo = deparse_columns_fetch(varno, dpns);
12690 6580 : bool printalias = false;
12691 :
12692 6580 : if (rte->alias != NULL)
12693 : {
12694 : /* Always print alias if user provided one */
12695 3096 : printalias = true;
12696 : }
12697 3484 : else if (colinfo->printaliases)
12698 : {
12699 : /* Always print alias if we need to print column aliases */
12700 330 : printalias = true;
12701 : }
12702 3154 : else if (rte->rtekind == RTE_RELATION)
12703 : {
12704 : /*
12705 : * No need to print alias if it's same as relation name (this would
12706 : * normally be the case, but not if set_rtable_names had to resolve a
12707 : * conflict).
12708 : */
12709 2882 : if (strcmp(refname, get_relation_name(rte->relid)) != 0)
12710 80 : printalias = true;
12711 : }
12712 272 : else if (rte->rtekind == RTE_FUNCTION)
12713 : {
12714 : /*
12715 : * For a function RTE, always print alias. This covers possible
12716 : * renaming of the function and/or instability of the FigureColname
12717 : * rules for things that aren't simple functions. Note we'd need to
12718 : * force it anyway for the columndef list case.
12719 : */
12720 0 : printalias = true;
12721 : }
12722 272 : else if (rte->rtekind == RTE_SUBQUERY ||
12723 248 : rte->rtekind == RTE_VALUES)
12724 : {
12725 : /*
12726 : * For a subquery, always print alias. This makes the output
12727 : * SQL-spec-compliant, even though we allow such aliases to be omitted
12728 : * on input.
12729 : */
12730 36 : printalias = true;
12731 : }
12732 236 : else if (rte->rtekind == RTE_CTE)
12733 : {
12734 : /*
12735 : * No need to print alias if it's same as CTE name (this would
12736 : * normally be the case, but not if set_rtable_names had to resolve a
12737 : * conflict).
12738 : */
12739 144 : if (strcmp(refname, rte->ctename) != 0)
12740 22 : printalias = true;
12741 : }
12742 :
12743 6580 : if (printalias)
12744 3564 : appendStringInfo(context->buf, "%s%s",
12745 : use_as ? " AS " : " ",
12746 : quote_identifier(refname));
12747 6580 : }
12748 :
12749 : /*
12750 : * get_column_alias_list - print column alias list for an RTE
12751 : *
12752 : * Caller must already have printed the relation's alias name.
12753 : */
12754 : static void
12755 6106 : get_column_alias_list(deparse_columns *colinfo, deparse_context *context)
12756 : {
12757 6106 : StringInfo buf = context->buf;
12758 : int i;
12759 6106 : bool first = true;
12760 :
12761 : /* Don't print aliases if not needed */
12762 6106 : if (!colinfo->printaliases)
12763 4888 : return;
12764 :
12765 9732 : for (i = 0; i < colinfo->num_new_cols; i++)
12766 : {
12767 8514 : char *colname = colinfo->new_colnames[i];
12768 :
12769 8514 : if (first)
12770 : {
12771 1218 : appendStringInfoChar(buf, '(');
12772 1218 : first = false;
12773 : }
12774 : else
12775 7296 : appendStringInfoString(buf, ", ");
12776 8514 : appendStringInfoString(buf, quote_identifier(colname));
12777 : }
12778 1218 : if (!first)
12779 1218 : appendStringInfoChar(buf, ')');
12780 : }
12781 :
12782 : /*
12783 : * get_from_clause_coldeflist - reproduce FROM clause coldeflist
12784 : *
12785 : * When printing a top-level coldeflist (which is syntactically also the
12786 : * relation's column alias list), use column names from colinfo. But when
12787 : * printing a coldeflist embedded inside ROWS FROM(), we prefer to use the
12788 : * original coldeflist's names, which are available in rtfunc->funccolnames.
12789 : * Pass NULL for colinfo to select the latter behavior.
12790 : *
12791 : * The coldeflist is appended immediately (no space) to buf. Caller is
12792 : * responsible for ensuring that an alias or AS is present before it.
12793 : */
12794 : static void
12795 6 : get_from_clause_coldeflist(RangeTblFunction *rtfunc,
12796 : deparse_columns *colinfo,
12797 : deparse_context *context)
12798 : {
12799 6 : StringInfo buf = context->buf;
12800 : ListCell *l1;
12801 : ListCell *l2;
12802 : ListCell *l3;
12803 : ListCell *l4;
12804 : int i;
12805 :
12806 6 : appendStringInfoChar(buf, '(');
12807 :
12808 6 : i = 0;
12809 24 : forfour(l1, rtfunc->funccoltypes,
12810 : l2, rtfunc->funccoltypmods,
12811 : l3, rtfunc->funccolcollations,
12812 : l4, rtfunc->funccolnames)
12813 : {
12814 18 : Oid atttypid = lfirst_oid(l1);
12815 18 : int32 atttypmod = lfirst_int(l2);
12816 18 : Oid attcollation = lfirst_oid(l3);
12817 : char *attname;
12818 :
12819 18 : if (colinfo)
12820 0 : attname = colinfo->colnames[i];
12821 : else
12822 18 : attname = strVal(lfirst(l4));
12823 :
12824 : Assert(attname); /* shouldn't be any dropped columns here */
12825 :
12826 18 : if (i > 0)
12827 12 : appendStringInfoString(buf, ", ");
12828 18 : appendStringInfo(buf, "%s %s",
12829 : quote_identifier(attname),
12830 : format_type_with_typemod(atttypid, atttypmod));
12831 24 : if (OidIsValid(attcollation) &&
12832 6 : attcollation != get_typcollation(atttypid))
12833 0 : appendStringInfo(buf, " COLLATE %s",
12834 : generate_collation_name(attcollation));
12835 :
12836 18 : i++;
12837 : }
12838 :
12839 6 : appendStringInfoChar(buf, ')');
12840 6 : }
12841 :
12842 : /*
12843 : * get_tablesample_def - print a TableSampleClause
12844 : */
12845 : static void
12846 32 : get_tablesample_def(TableSampleClause *tablesample, deparse_context *context)
12847 : {
12848 32 : StringInfo buf = context->buf;
12849 : Oid argtypes[1];
12850 : int nargs;
12851 : ListCell *l;
12852 :
12853 : /*
12854 : * We should qualify the handler's function name if it wouldn't be
12855 : * resolved by lookup in the current search path.
12856 : */
12857 32 : argtypes[0] = INTERNALOID;
12858 32 : appendStringInfo(buf, " TABLESAMPLE %s (",
12859 : generate_function_name(tablesample->tsmhandler, 1,
12860 : NIL, argtypes,
12861 : false, NULL, false));
12862 :
12863 32 : nargs = 0;
12864 64 : foreach(l, tablesample->args)
12865 : {
12866 32 : if (nargs++ > 0)
12867 0 : appendStringInfoString(buf, ", ");
12868 32 : get_rule_expr((Node *) lfirst(l), context, false);
12869 : }
12870 32 : appendStringInfoChar(buf, ')');
12871 :
12872 32 : if (tablesample->repeatable != NULL)
12873 : {
12874 16 : appendStringInfoString(buf, " REPEATABLE (");
12875 16 : get_rule_expr((Node *) tablesample->repeatable, context, false);
12876 16 : appendStringInfoChar(buf, ')');
12877 : }
12878 32 : }
12879 :
12880 : /*
12881 : * get_opclass_name - fetch name of an index operator class
12882 : *
12883 : * The opclass name is appended (after a space) to buf.
12884 : *
12885 : * Output is suppressed if the opclass is the default for the given
12886 : * actual_datatype. (If you don't want this behavior, just pass
12887 : * InvalidOid for actual_datatype.)
12888 : */
12889 : static void
12890 12618 : get_opclass_name(Oid opclass, Oid actual_datatype,
12891 : StringInfo buf)
12892 : {
12893 : HeapTuple ht_opc;
12894 : Form_pg_opclass opcrec;
12895 : char *opcname;
12896 : char *nspname;
12897 :
12898 12618 : ht_opc = SearchSysCache1(CLAOID, ObjectIdGetDatum(opclass));
12899 12618 : if (!HeapTupleIsValid(ht_opc))
12900 0 : elog(ERROR, "cache lookup failed for opclass %u", opclass);
12901 12618 : opcrec = (Form_pg_opclass) GETSTRUCT(ht_opc);
12902 :
12903 25196 : if (!OidIsValid(actual_datatype) ||
12904 12578 : GetDefaultOpClass(actual_datatype, opcrec->opcmethod) != opclass)
12905 : {
12906 : /* Okay, we need the opclass name. Do we need to qualify it? */
12907 558 : opcname = NameStr(opcrec->opcname);
12908 558 : if (OpclassIsVisible(opclass))
12909 558 : appendStringInfo(buf, " %s", quote_identifier(opcname));
12910 : else
12911 : {
12912 0 : nspname = get_namespace_name_or_temp(opcrec->opcnamespace);
12913 0 : appendStringInfo(buf, " %s.%s",
12914 : quote_identifier(nspname),
12915 : quote_identifier(opcname));
12916 : }
12917 : }
12918 12618 : ReleaseSysCache(ht_opc);
12919 12618 : }
12920 :
12921 : /*
12922 : * generate_opclass_name
12923 : * Compute the name to display for an opclass specified by OID
12924 : *
12925 : * The result includes all necessary quoting and schema-prefixing.
12926 : */
12927 : char *
12928 6 : generate_opclass_name(Oid opclass)
12929 : {
12930 : StringInfoData buf;
12931 :
12932 6 : initStringInfo(&buf);
12933 6 : get_opclass_name(opclass, InvalidOid, &buf);
12934 :
12935 6 : return &buf.data[1]; /* get_opclass_name() prepends space */
12936 : }
12937 :
12938 : /*
12939 : * processIndirection - take care of array and subfield assignment
12940 : *
12941 : * We strip any top-level FieldStore or assignment SubscriptingRef nodes that
12942 : * appear in the input, printing them as decoration for the base column
12943 : * name (which we assume the caller just printed). We might also need to
12944 : * strip CoerceToDomain nodes, but only ones that appear above assignment
12945 : * nodes.
12946 : *
12947 : * Returns the subexpression that's to be assigned.
12948 : */
12949 : static Node *
12950 1272 : processIndirection(Node *node, deparse_context *context)
12951 : {
12952 1272 : StringInfo buf = context->buf;
12953 1272 : CoerceToDomain *cdomain = NULL;
12954 :
12955 : for (;;)
12956 : {
12957 1578 : if (node == NULL)
12958 0 : break;
12959 1578 : if (IsA(node, FieldStore))
12960 : {
12961 108 : FieldStore *fstore = (FieldStore *) node;
12962 : Oid typrelid;
12963 : char *fieldname;
12964 :
12965 : /* lookup tuple type */
12966 108 : typrelid = get_typ_typrelid(fstore->resulttype);
12967 108 : if (!OidIsValid(typrelid))
12968 0 : elog(ERROR, "argument type %s of FieldStore is not a tuple type",
12969 : format_type_be(fstore->resulttype));
12970 :
12971 : /*
12972 : * Print the field name. There should only be one target field in
12973 : * stored rules. There could be more than that in executable
12974 : * target lists, but this function cannot be used for that case.
12975 : */
12976 : Assert(list_length(fstore->fieldnums) == 1);
12977 108 : fieldname = get_attname(typrelid,
12978 108 : linitial_int(fstore->fieldnums), false);
12979 108 : appendStringInfo(buf, ".%s", quote_identifier(fieldname));
12980 :
12981 : /*
12982 : * We ignore arg since it should be an uninteresting reference to
12983 : * the target column or subcolumn.
12984 : */
12985 108 : node = (Node *) linitial(fstore->newvals);
12986 : }
12987 1470 : else if (IsA(node, SubscriptingRef))
12988 : {
12989 138 : SubscriptingRef *sbsref = (SubscriptingRef *) node;
12990 :
12991 138 : if (sbsref->refassgnexpr == NULL)
12992 0 : break;
12993 :
12994 138 : printSubscripts(sbsref, context);
12995 :
12996 : /*
12997 : * We ignore refexpr since it should be an uninteresting reference
12998 : * to the target column or subcolumn.
12999 : */
13000 138 : node = (Node *) sbsref->refassgnexpr;
13001 : }
13002 1332 : else if (IsA(node, CoerceToDomain))
13003 : {
13004 60 : cdomain = (CoerceToDomain *) node;
13005 : /* If it's an explicit domain coercion, we're done */
13006 60 : if (cdomain->coercionformat != COERCE_IMPLICIT_CAST)
13007 0 : break;
13008 : /* Tentatively descend past the CoerceToDomain */
13009 60 : node = (Node *) cdomain->arg;
13010 : }
13011 : else
13012 1272 : break;
13013 : }
13014 :
13015 : /*
13016 : * If we descended past a CoerceToDomain whose argument turned out not to
13017 : * be a FieldStore or array assignment, back up to the CoerceToDomain.
13018 : * (This is not enough to be fully correct if there are nested implicit
13019 : * CoerceToDomains, but such cases shouldn't ever occur.)
13020 : */
13021 1272 : if (cdomain && node == (Node *) cdomain->arg)
13022 0 : node = (Node *) cdomain;
13023 :
13024 1272 : return node;
13025 : }
13026 :
13027 : static void
13028 454 : printSubscripts(SubscriptingRef *sbsref, deparse_context *context)
13029 : {
13030 454 : StringInfo buf = context->buf;
13031 : ListCell *lowlist_item;
13032 : ListCell *uplist_item;
13033 :
13034 454 : lowlist_item = list_head(sbsref->reflowerindexpr); /* could be NULL */
13035 908 : foreach(uplist_item, sbsref->refupperindexpr)
13036 : {
13037 454 : appendStringInfoChar(buf, '[');
13038 454 : if (lowlist_item)
13039 : {
13040 : /* If subexpression is NULL, get_rule_expr prints nothing */
13041 0 : get_rule_expr((Node *) lfirst(lowlist_item), context, false);
13042 0 : appendStringInfoChar(buf, ':');
13043 0 : lowlist_item = lnext(sbsref->reflowerindexpr, lowlist_item);
13044 : }
13045 : /* If subexpression is NULL, get_rule_expr prints nothing */
13046 454 : get_rule_expr((Node *) lfirst(uplist_item), context, false);
13047 454 : appendStringInfoChar(buf, ']');
13048 : }
13049 454 : }
13050 :
13051 : /*
13052 : * quote_identifier - Quote an identifier only if needed
13053 : *
13054 : * When quotes are needed, we palloc the required space; slightly
13055 : * space-wasteful but well worth it for notational simplicity.
13056 : */
13057 : const char *
13058 2558630 : quote_identifier(const char *ident)
13059 : {
13060 : /*
13061 : * Can avoid quoting if ident starts with a lowercase letter or underscore
13062 : * and contains only lowercase letters, digits, and underscores, *and* is
13063 : * not any SQL keyword. Otherwise, supply quotes.
13064 : */
13065 2558630 : int nquotes = 0;
13066 : bool safe;
13067 : const char *ptr;
13068 : char *result;
13069 : char *optr;
13070 :
13071 : /*
13072 : * would like to use <ctype.h> macros here, but they might yield unwanted
13073 : * locale-specific results...
13074 : */
13075 2558630 : safe = ((ident[0] >= 'a' && ident[0] <= 'z') || ident[0] == '_');
13076 :
13077 22050296 : for (ptr = ident; *ptr; ptr++)
13078 : {
13079 19491666 : char ch = *ptr;
13080 :
13081 19491666 : if ((ch >= 'a' && ch <= 'z') ||
13082 2337138 : (ch >= '0' && ch <= '9') ||
13083 : (ch == '_'))
13084 : {
13085 : /* okay */
13086 : }
13087 : else
13088 : {
13089 64006 : safe = false;
13090 64006 : if (ch == '"')
13091 164 : nquotes++;
13092 : }
13093 : }
13094 :
13095 2558630 : if (quote_all_identifiers)
13096 13098 : safe = false;
13097 :
13098 2558630 : if (safe)
13099 : {
13100 : /*
13101 : * Check for keyword. We quote keywords except for unreserved ones.
13102 : * (In some cases we could avoid quoting a col_name or type_func_name
13103 : * keyword, but it seems much harder than it's worth to tell that.)
13104 : *
13105 : * Note: ScanKeywordLookup() does case-insensitive comparison, but
13106 : * that's fine, since we already know we have all-lower-case.
13107 : */
13108 2519252 : int kwnum = ScanKeywordLookup(ident, &ScanKeywords);
13109 :
13110 2519252 : if (kwnum >= 0 && ScanKeywordCategories[kwnum] != UNRESERVED_KEYWORD)
13111 3500 : safe = false;
13112 : }
13113 :
13114 2558630 : if (safe)
13115 2515752 : return ident; /* no change needed */
13116 :
13117 42878 : result = (char *) palloc(strlen(ident) + nquotes + 2 + 1);
13118 :
13119 42878 : optr = result;
13120 42878 : *optr++ = '"';
13121 252104 : for (ptr = ident; *ptr; ptr++)
13122 : {
13123 209226 : char ch = *ptr;
13124 :
13125 209226 : if (ch == '"')
13126 164 : *optr++ = '"';
13127 209226 : *optr++ = ch;
13128 : }
13129 42878 : *optr++ = '"';
13130 42878 : *optr = '\0';
13131 :
13132 42878 : return result;
13133 : }
13134 :
13135 : /*
13136 : * quote_qualified_identifier - Quote a possibly-qualified identifier
13137 : *
13138 : * Return a name of the form qualifier.ident, or just ident if qualifier
13139 : * is NULL, quoting each component if necessary. The result is palloc'd.
13140 : */
13141 : char *
13142 1263966 : quote_qualified_identifier(const char *qualifier,
13143 : const char *ident)
13144 : {
13145 : StringInfoData buf;
13146 :
13147 1263966 : initStringInfo(&buf);
13148 1263966 : if (qualifier)
13149 453120 : appendStringInfo(&buf, "%s.", quote_identifier(qualifier));
13150 1263966 : appendStringInfoString(&buf, quote_identifier(ident));
13151 1263966 : return buf.data;
13152 : }
13153 :
13154 : /*
13155 : * get_relation_name
13156 : * Get the unqualified name of a relation specified by OID
13157 : *
13158 : * This differs from the underlying get_rel_name() function in that it will
13159 : * throw error instead of silently returning NULL if the OID is bad.
13160 : */
13161 : static char *
13162 16258 : get_relation_name(Oid relid)
13163 : {
13164 16258 : char *relname = get_rel_name(relid);
13165 :
13166 16258 : if (!relname)
13167 0 : elog(ERROR, "cache lookup failed for relation %u", relid);
13168 16258 : return relname;
13169 : }
13170 :
13171 : /*
13172 : * generate_relation_name
13173 : * Compute the name to display for a relation specified by OID
13174 : *
13175 : * The result includes all necessary quoting and schema-prefixing.
13176 : *
13177 : * If namespaces isn't NIL, it must be a list of deparse_namespace nodes.
13178 : * We will forcibly qualify the relation name if it equals any CTE name
13179 : * visible in the namespace list.
13180 : */
13181 : static char *
13182 7918 : generate_relation_name(Oid relid, List *namespaces)
13183 : {
13184 : HeapTuple tp;
13185 : Form_pg_class reltup;
13186 : bool need_qual;
13187 : ListCell *nslist;
13188 : char *relname;
13189 : char *nspname;
13190 : char *result;
13191 :
13192 7918 : tp = SearchSysCache1(RELOID, ObjectIdGetDatum(relid));
13193 7918 : if (!HeapTupleIsValid(tp))
13194 0 : elog(ERROR, "cache lookup failed for relation %u", relid);
13195 7918 : reltup = (Form_pg_class) GETSTRUCT(tp);
13196 7918 : relname = NameStr(reltup->relname);
13197 :
13198 : /* Check for conflicting CTE name */
13199 7918 : need_qual = false;
13200 13698 : foreach(nslist, namespaces)
13201 : {
13202 5780 : deparse_namespace *dpns = (deparse_namespace *) lfirst(nslist);
13203 : ListCell *ctlist;
13204 :
13205 5912 : foreach(ctlist, dpns->ctes)
13206 : {
13207 132 : CommonTableExpr *cte = (CommonTableExpr *) lfirst(ctlist);
13208 :
13209 132 : if (strcmp(cte->ctename, relname) == 0)
13210 : {
13211 0 : need_qual = true;
13212 0 : break;
13213 : }
13214 : }
13215 5780 : if (need_qual)
13216 0 : break;
13217 : }
13218 :
13219 : /* Otherwise, qualify the name if not visible in search path */
13220 7918 : if (!need_qual)
13221 7918 : need_qual = !RelationIsVisible(relid);
13222 :
13223 7918 : if (need_qual)
13224 2250 : nspname = get_namespace_name_or_temp(reltup->relnamespace);
13225 : else
13226 5668 : nspname = NULL;
13227 :
13228 7918 : result = quote_qualified_identifier(nspname, relname);
13229 :
13230 7918 : ReleaseSysCache(tp);
13231 :
13232 7918 : return result;
13233 : }
13234 :
13235 : /*
13236 : * generate_qualified_relation_name
13237 : * Compute the name to display for a relation specified by OID
13238 : *
13239 : * As above, but unconditionally schema-qualify the name.
13240 : */
13241 : static char *
13242 8104 : generate_qualified_relation_name(Oid relid)
13243 : {
13244 : HeapTuple tp;
13245 : Form_pg_class reltup;
13246 : char *relname;
13247 : char *nspname;
13248 : char *result;
13249 :
13250 8104 : tp = SearchSysCache1(RELOID, ObjectIdGetDatum(relid));
13251 8104 : if (!HeapTupleIsValid(tp))
13252 0 : elog(ERROR, "cache lookup failed for relation %u", relid);
13253 8104 : reltup = (Form_pg_class) GETSTRUCT(tp);
13254 8104 : relname = NameStr(reltup->relname);
13255 :
13256 8104 : nspname = get_namespace_name_or_temp(reltup->relnamespace);
13257 8104 : if (!nspname)
13258 0 : elog(ERROR, "cache lookup failed for namespace %u",
13259 : reltup->relnamespace);
13260 :
13261 8104 : result = quote_qualified_identifier(nspname, relname);
13262 :
13263 8104 : ReleaseSysCache(tp);
13264 :
13265 8104 : return result;
13266 : }
13267 :
13268 : /*
13269 : * generate_function_name
13270 : * Compute the name to display for a function specified by OID,
13271 : * given that it is being called with the specified actual arg names and
13272 : * types. (Those matter because of ambiguous-function resolution rules.)
13273 : *
13274 : * If we're dealing with a potentially variadic function (in practice, this
13275 : * means a FuncExpr or Aggref, not some other way of calling a function), then
13276 : * has_variadic must specify whether variadic arguments have been merged,
13277 : * and *use_variadic_p will be set to indicate whether to print VARIADIC in
13278 : * the output. For non-FuncExpr cases, has_variadic should be false and
13279 : * use_variadic_p can be NULL.
13280 : *
13281 : * inGroupBy must be true if we're deparsing a GROUP BY clause.
13282 : *
13283 : * The result includes all necessary quoting and schema-prefixing.
13284 : */
13285 : static char *
13286 14916 : generate_function_name(Oid funcid, int nargs, List *argnames, Oid *argtypes,
13287 : bool has_variadic, bool *use_variadic_p,
13288 : bool inGroupBy)
13289 : {
13290 : char *result;
13291 : HeapTuple proctup;
13292 : Form_pg_proc procform;
13293 : char *proname;
13294 : bool use_variadic;
13295 : char *nspname;
13296 : FuncDetailCode p_result;
13297 : int fgc_flags;
13298 : Oid p_funcid;
13299 : Oid p_rettype;
13300 : bool p_retset;
13301 : int p_nvargs;
13302 : Oid p_vatype;
13303 : Oid *p_true_typeids;
13304 14916 : bool force_qualify = false;
13305 :
13306 14916 : proctup = SearchSysCache1(PROCOID, ObjectIdGetDatum(funcid));
13307 14916 : if (!HeapTupleIsValid(proctup))
13308 0 : elog(ERROR, "cache lookup failed for function %u", funcid);
13309 14916 : procform = (Form_pg_proc) GETSTRUCT(proctup);
13310 14916 : proname = NameStr(procform->proname);
13311 :
13312 : /*
13313 : * Due to parser hacks to avoid needing to reserve CUBE, we need to force
13314 : * qualification of some function names within GROUP BY.
13315 : */
13316 14916 : if (inGroupBy)
13317 : {
13318 0 : if (strcmp(proname, "cube") == 0 || strcmp(proname, "rollup") == 0)
13319 0 : force_qualify = true;
13320 : }
13321 :
13322 : /*
13323 : * Determine whether VARIADIC should be printed. We must do this first
13324 : * since it affects the lookup rules in func_get_detail().
13325 : *
13326 : * We always print VARIADIC if the function has a merged variadic-array
13327 : * argument. Note that this is always the case for functions taking a
13328 : * VARIADIC argument type other than VARIADIC ANY. If we omitted VARIADIC
13329 : * and printed the array elements as separate arguments, the call could
13330 : * match a newer non-VARIADIC function.
13331 : */
13332 14916 : if (use_variadic_p)
13333 : {
13334 : /* Parser should not have set funcvariadic unless fn is variadic */
13335 : Assert(!has_variadic || OidIsValid(procform->provariadic));
13336 13212 : use_variadic = has_variadic;
13337 13212 : *use_variadic_p = use_variadic;
13338 : }
13339 : else
13340 : {
13341 : Assert(!has_variadic);
13342 1704 : use_variadic = false;
13343 : }
13344 :
13345 : /*
13346 : * The idea here is to schema-qualify only if the parser would fail to
13347 : * resolve the correct function given the unqualified func name with the
13348 : * specified argtypes and VARIADIC flag. But if we already decided to
13349 : * force qualification, then we can skip the lookup and pretend we didn't
13350 : * find it.
13351 : */
13352 14916 : if (!force_qualify)
13353 14916 : p_result = func_get_detail(list_make1(makeString(proname)),
13354 : NIL, argnames, nargs, argtypes,
13355 14916 : !use_variadic, true, false,
13356 : &fgc_flags,
13357 : &p_funcid, &p_rettype,
13358 : &p_retset, &p_nvargs, &p_vatype,
13359 14916 : &p_true_typeids, NULL);
13360 : else
13361 : {
13362 0 : p_result = FUNCDETAIL_NOTFOUND;
13363 0 : p_funcid = InvalidOid;
13364 : }
13365 :
13366 14916 : if ((p_result == FUNCDETAIL_NORMAL ||
13367 1268 : p_result == FUNCDETAIL_AGGREGATE ||
13368 13774 : p_result == FUNCDETAIL_WINDOWFUNC) &&
13369 13774 : p_funcid == funcid)
13370 13774 : nspname = NULL;
13371 : else
13372 1142 : nspname = get_namespace_name_or_temp(procform->pronamespace);
13373 :
13374 14916 : result = quote_qualified_identifier(nspname, proname);
13375 :
13376 14916 : ReleaseSysCache(proctup);
13377 :
13378 14916 : return result;
13379 : }
13380 :
13381 : /*
13382 : * generate_operator_name
13383 : * Compute the name to display for an operator specified by OID,
13384 : * given that it is being called with the specified actual arg types.
13385 : * (Arg types matter because of ambiguous-operator resolution rules.
13386 : * Pass InvalidOid for unused arg of a unary operator.)
13387 : *
13388 : * The result includes all necessary quoting and schema-prefixing,
13389 : * plus the OPERATOR() decoration needed to use a qualified operator name
13390 : * in an expression.
13391 : */
13392 : static char *
13393 64574 : generate_operator_name(Oid operid, Oid arg1, Oid arg2)
13394 : {
13395 : StringInfoData buf;
13396 : HeapTuple opertup;
13397 : Form_pg_operator operform;
13398 : char *oprname;
13399 : char *nspname;
13400 : Operator p_result;
13401 :
13402 64574 : initStringInfo(&buf);
13403 :
13404 64574 : opertup = SearchSysCache1(OPEROID, ObjectIdGetDatum(operid));
13405 64574 : if (!HeapTupleIsValid(opertup))
13406 0 : elog(ERROR, "cache lookup failed for operator %u", operid);
13407 64574 : operform = (Form_pg_operator) GETSTRUCT(opertup);
13408 64574 : oprname = NameStr(operform->oprname);
13409 :
13410 : /*
13411 : * The idea here is to schema-qualify only if the parser would fail to
13412 : * resolve the correct operator given the unqualified op name with the
13413 : * specified argtypes.
13414 : */
13415 64574 : switch (operform->oprkind)
13416 : {
13417 64544 : case 'b':
13418 64544 : p_result = oper(NULL, list_make1(makeString(oprname)), arg1, arg2,
13419 : true, -1);
13420 64544 : break;
13421 30 : case 'l':
13422 30 : p_result = left_oper(NULL, list_make1(makeString(oprname)), arg2,
13423 : true, -1);
13424 30 : break;
13425 0 : default:
13426 0 : elog(ERROR, "unrecognized oprkind: %d", operform->oprkind);
13427 : p_result = NULL; /* keep compiler quiet */
13428 : break;
13429 : }
13430 :
13431 64574 : if (p_result != NULL && oprid(p_result) == operid)
13432 64564 : nspname = NULL;
13433 : else
13434 : {
13435 10 : nspname = get_namespace_name_or_temp(operform->oprnamespace);
13436 10 : appendStringInfo(&buf, "OPERATOR(%s.", quote_identifier(nspname));
13437 : }
13438 :
13439 64574 : appendStringInfoString(&buf, oprname);
13440 :
13441 64574 : if (nspname)
13442 10 : appendStringInfoChar(&buf, ')');
13443 :
13444 64574 : if (p_result != NULL)
13445 64564 : ReleaseSysCache(p_result);
13446 :
13447 64574 : ReleaseSysCache(opertup);
13448 :
13449 64574 : return buf.data;
13450 : }
13451 :
13452 : /*
13453 : * generate_operator_clause --- generate a binary-operator WHERE clause
13454 : *
13455 : * This is used for internally-generated-and-executed SQL queries, where
13456 : * precision is essential and readability is secondary. The basic
13457 : * requirement is to append "leftop op rightop" to buf, where leftop and
13458 : * rightop are given as strings and are assumed to yield types leftoptype
13459 : * and rightoptype; the operator is identified by OID. The complexity
13460 : * comes from needing to be sure that the parser will select the desired
13461 : * operator when the query is parsed. We always name the operator using
13462 : * OPERATOR(schema.op) syntax, so as to avoid search-path uncertainties.
13463 : * We have to emit casts too, if either input isn't already the input type
13464 : * of the operator; else we are at the mercy of the parser's heuristics for
13465 : * ambiguous-operator resolution. The caller must ensure that leftop and
13466 : * rightop are suitable arguments for a cast operation; it's best to insert
13467 : * parentheses if they aren't just variables or parameters.
13468 : */
13469 : void
13470 6558 : generate_operator_clause(StringInfo buf,
13471 : const char *leftop, Oid leftoptype,
13472 : Oid opoid,
13473 : const char *rightop, Oid rightoptype)
13474 : {
13475 : HeapTuple opertup;
13476 : Form_pg_operator operform;
13477 : char *oprname;
13478 : char *nspname;
13479 :
13480 6558 : opertup = SearchSysCache1(OPEROID, ObjectIdGetDatum(opoid));
13481 6558 : if (!HeapTupleIsValid(opertup))
13482 0 : elog(ERROR, "cache lookup failed for operator %u", opoid);
13483 6558 : operform = (Form_pg_operator) GETSTRUCT(opertup);
13484 : Assert(operform->oprkind == 'b');
13485 6558 : oprname = NameStr(operform->oprname);
13486 :
13487 6558 : nspname = get_namespace_name(operform->oprnamespace);
13488 :
13489 6558 : appendStringInfoString(buf, leftop);
13490 6558 : if (leftoptype != operform->oprleft)
13491 1198 : add_cast_to(buf, operform->oprleft);
13492 6558 : appendStringInfo(buf, " OPERATOR(%s.", quote_identifier(nspname));
13493 6558 : appendStringInfoString(buf, oprname);
13494 6558 : appendStringInfo(buf, ") %s", rightop);
13495 6558 : if (rightoptype != operform->oprright)
13496 968 : add_cast_to(buf, operform->oprright);
13497 :
13498 6558 : ReleaseSysCache(opertup);
13499 6558 : }
13500 :
13501 : /*
13502 : * Add a cast specification to buf. We spell out the type name the hard way,
13503 : * intentionally not using format_type_be(). This is to avoid corner cases
13504 : * for CHARACTER, BIT, and perhaps other types, where specifying the type
13505 : * using SQL-standard syntax results in undesirable data truncation. By
13506 : * doing it this way we can be certain that the cast will have default (-1)
13507 : * target typmod.
13508 : */
13509 : static void
13510 2166 : add_cast_to(StringInfo buf, Oid typid)
13511 : {
13512 : HeapTuple typetup;
13513 : Form_pg_type typform;
13514 : char *typname;
13515 : char *nspname;
13516 :
13517 2166 : typetup = SearchSysCache1(TYPEOID, ObjectIdGetDatum(typid));
13518 2166 : if (!HeapTupleIsValid(typetup))
13519 0 : elog(ERROR, "cache lookup failed for type %u", typid);
13520 2166 : typform = (Form_pg_type) GETSTRUCT(typetup);
13521 :
13522 2166 : typname = NameStr(typform->typname);
13523 2166 : nspname = get_namespace_name_or_temp(typform->typnamespace);
13524 :
13525 2166 : appendStringInfo(buf, "::%s.%s",
13526 : quote_identifier(nspname), quote_identifier(typname));
13527 :
13528 2166 : ReleaseSysCache(typetup);
13529 2166 : }
13530 :
13531 : /*
13532 : * generate_qualified_type_name
13533 : * Compute the name to display for a type specified by OID
13534 : *
13535 : * This is different from format_type_be() in that we unconditionally
13536 : * schema-qualify the name. That also means no special syntax for
13537 : * SQL-standard type names ... although in current usage, this should
13538 : * only get used for domains, so such cases wouldn't occur anyway.
13539 : */
13540 : static char *
13541 14 : generate_qualified_type_name(Oid typid)
13542 : {
13543 : HeapTuple tp;
13544 : Form_pg_type typtup;
13545 : char *typname;
13546 : char *nspname;
13547 : char *result;
13548 :
13549 14 : tp = SearchSysCache1(TYPEOID, ObjectIdGetDatum(typid));
13550 14 : if (!HeapTupleIsValid(tp))
13551 0 : elog(ERROR, "cache lookup failed for type %u", typid);
13552 14 : typtup = (Form_pg_type) GETSTRUCT(tp);
13553 14 : typname = NameStr(typtup->typname);
13554 :
13555 14 : nspname = get_namespace_name_or_temp(typtup->typnamespace);
13556 14 : if (!nspname)
13557 0 : elog(ERROR, "cache lookup failed for namespace %u",
13558 : typtup->typnamespace);
13559 :
13560 14 : result = quote_qualified_identifier(nspname, typname);
13561 :
13562 14 : ReleaseSysCache(tp);
13563 :
13564 14 : return result;
13565 : }
13566 :
13567 : /*
13568 : * generate_collation_name
13569 : * Compute the name to display for a collation specified by OID
13570 : *
13571 : * The result includes all necessary quoting and schema-prefixing.
13572 : */
13573 : char *
13574 294 : generate_collation_name(Oid collid)
13575 : {
13576 : HeapTuple tp;
13577 : Form_pg_collation colltup;
13578 : char *collname;
13579 : char *nspname;
13580 : char *result;
13581 :
13582 294 : tp = SearchSysCache1(COLLOID, ObjectIdGetDatum(collid));
13583 294 : if (!HeapTupleIsValid(tp))
13584 0 : elog(ERROR, "cache lookup failed for collation %u", collid);
13585 294 : colltup = (Form_pg_collation) GETSTRUCT(tp);
13586 294 : collname = NameStr(colltup->collname);
13587 :
13588 294 : if (!CollationIsVisible(collid))
13589 0 : nspname = get_namespace_name_or_temp(colltup->collnamespace);
13590 : else
13591 294 : nspname = NULL;
13592 :
13593 294 : result = quote_qualified_identifier(nspname, collname);
13594 :
13595 294 : ReleaseSysCache(tp);
13596 :
13597 294 : return result;
13598 : }
13599 :
13600 : /*
13601 : * Given a C string, produce a TEXT datum.
13602 : *
13603 : * We assume that the input was palloc'd and may be freed.
13604 : */
13605 : static text *
13606 43976 : string_to_text(char *str)
13607 : {
13608 : text *result;
13609 :
13610 43976 : result = cstring_to_text(str);
13611 43976 : pfree(str);
13612 43976 : return result;
13613 : }
13614 :
13615 : /*
13616 : * Generate a C string representing a relation options from text[] datum.
13617 : */
13618 : static void
13619 244 : get_reloptions(StringInfo buf, Datum reloptions)
13620 : {
13621 : Datum *options;
13622 : int noptions;
13623 : int i;
13624 :
13625 244 : deconstruct_array_builtin(DatumGetArrayTypeP(reloptions), TEXTOID,
13626 : &options, NULL, &noptions);
13627 :
13628 508 : for (i = 0; i < noptions; i++)
13629 : {
13630 264 : char *option = TextDatumGetCString(options[i]);
13631 : char *name;
13632 : char *separator;
13633 : char *value;
13634 :
13635 : /*
13636 : * Each array element should have the form name=value. If the "=" is
13637 : * missing for some reason, treat it like an empty value.
13638 : */
13639 264 : name = option;
13640 264 : separator = strchr(option, '=');
13641 264 : if (separator)
13642 : {
13643 264 : *separator = '\0';
13644 264 : value = separator + 1;
13645 : }
13646 : else
13647 0 : value = "";
13648 :
13649 264 : if (i > 0)
13650 20 : appendStringInfoString(buf, ", ");
13651 264 : appendStringInfo(buf, "%s=", quote_identifier(name));
13652 :
13653 : /*
13654 : * In general we need to quote the value; but to avoid unnecessary
13655 : * clutter, do not quote if it is an identifier that would not need
13656 : * quoting. (We could also allow numbers, but that is a bit trickier
13657 : * than it looks --- for example, are leading zeroes significant? We
13658 : * don't want to assume very much here about what custom reloptions
13659 : * might mean.)
13660 : */
13661 264 : if (quote_identifier(value) == value)
13662 8 : appendStringInfoString(buf, value);
13663 : else
13664 256 : simple_quote_literal(buf, value);
13665 :
13666 264 : pfree(option);
13667 : }
13668 244 : }
13669 :
13670 : /*
13671 : * Generate a C string representing a relation's reloptions, or NULL if none.
13672 : */
13673 : static char *
13674 7684 : flatten_reloptions(Oid relid)
13675 : {
13676 7684 : char *result = NULL;
13677 : HeapTuple tuple;
13678 : Datum reloptions;
13679 : bool isnull;
13680 :
13681 7684 : tuple = SearchSysCache1(RELOID, ObjectIdGetDatum(relid));
13682 7684 : if (!HeapTupleIsValid(tuple))
13683 0 : elog(ERROR, "cache lookup failed for relation %u", relid);
13684 :
13685 7684 : reloptions = SysCacheGetAttr(RELOID, tuple,
13686 : Anum_pg_class_reloptions, &isnull);
13687 7684 : if (!isnull)
13688 : {
13689 : StringInfoData buf;
13690 :
13691 210 : initStringInfo(&buf);
13692 210 : get_reloptions(&buf, reloptions);
13693 :
13694 210 : result = buf.data;
13695 : }
13696 :
13697 7684 : ReleaseSysCache(tuple);
13698 :
13699 7684 : return result;
13700 : }
13701 :
13702 : /*
13703 : * get_range_partbound_string
13704 : * A C string representation of one range partition bound
13705 : */
13706 : char *
13707 4596 : get_range_partbound_string(List *bound_datums)
13708 : {
13709 : deparse_context context;
13710 4596 : StringInfo buf = makeStringInfo();
13711 : ListCell *cell;
13712 : char *sep;
13713 :
13714 4596 : memset(&context, 0, sizeof(deparse_context));
13715 4596 : context.buf = buf;
13716 :
13717 4596 : appendStringInfoChar(buf, '(');
13718 4596 : sep = "";
13719 9984 : foreach(cell, bound_datums)
13720 : {
13721 5388 : PartitionRangeDatum *datum =
13722 : lfirst_node(PartitionRangeDatum, cell);
13723 :
13724 5388 : appendStringInfoString(buf, sep);
13725 5388 : if (datum->kind == PARTITION_RANGE_DATUM_MINVALUE)
13726 222 : appendStringInfoString(buf, "MINVALUE");
13727 5166 : else if (datum->kind == PARTITION_RANGE_DATUM_MAXVALUE)
13728 120 : appendStringInfoString(buf, "MAXVALUE");
13729 : else
13730 : {
13731 5046 : Const *val = castNode(Const, datum->value);
13732 :
13733 5046 : get_const_expr(val, &context, -1);
13734 : }
13735 5388 : sep = ", ";
13736 : }
13737 4596 : appendStringInfoChar(buf, ')');
13738 :
13739 4596 : return buf->data;
13740 : }
|