1 /*-------------------------------------------------------------------------
4 * Contains functions which control the execution of the POSTGRES utility
5 * commands. At one time acted as an interface between the Lisp and C
8 * Portions Copyright (c) 1996-2013, PostgreSQL Global Development Group
9 * Portions Copyright (c) 1994, Regents of the University of California
13 * src/backend/tcop/utility.c
15 *-------------------------------------------------------------------------
19 #include "access/htup_details.h"
20 #include "access/reloptions.h"
21 #include "access/twophase.h"
22 #include "access/xact.h"
23 #include "catalog/catalog.h"
24 #include "catalog/namespace.h"
25 #include "catalog/toasting.h"
26 #include "commands/alter.h"
27 #include "commands/async.h"
28 #include "commands/cluster.h"
29 #include "commands/comment.h"
30 #include "commands/collationcmds.h"
31 #include "commands/conversioncmds.h"
32 #include "commands/copy.h"
33 #include "commands/createas.h"
34 #include "commands/dbcommands.h"
35 #include "commands/defrem.h"
36 #include "commands/discard.h"
37 #include "commands/event_trigger.h"
38 #include "commands/explain.h"
39 #include "commands/extension.h"
40 #include "commands/matview.h"
41 #include "commands/lockcmds.h"
42 #include "commands/portalcmds.h"
43 #include "commands/prepare.h"
44 #include "commands/proclang.h"
45 #include "commands/schemacmds.h"
46 #include "commands/seclabel.h"
47 #include "commands/sequence.h"
48 #include "commands/tablecmds.h"
49 #include "commands/tablespace.h"
50 #include "commands/trigger.h"
51 #include "commands/typecmds.h"
52 #include "commands/user.h"
53 #include "commands/vacuum.h"
54 #include "commands/view.h"
55 #include "miscadmin.h"
56 #include "parser/parse_utilcmd.h"
57 #include "postmaster/bgwriter.h"
58 #include "rewrite/rewriteDefine.h"
59 #include "rewrite/rewriteRemove.h"
60 #include "storage/fd.h"
61 #include "tcop/pquery.h"
62 #include "tcop/utility.h"
63 #include "utils/acl.h"
64 #include "utils/guc.h"
65 #include "utils/syscache.h"
68 /* Hook for plugins to get control in ProcessUtility() */
69 ProcessUtility_hook_type ProcessUtility_hook = NULL;
71 /* local function declarations */
72 static void ProcessUtilitySlow(Node *parsetree,
73 const char *queryString,
74 ProcessUtilityContext context,
78 static void ExecDropStmt(DropStmt *stmt, bool isTopLevel);
82 * Verify user has ownership of specified relation, else ereport.
84 * If noCatalogs is true then we also deny access to system catalogs,
85 * except when allowSystemTableMods is true.
88 CheckRelationOwnership(RangeVar *rel, bool noCatalogs)
94 * XXX: This is unsafe in the presence of concurrent DDL, since it is
95 * called before acquiring any lock on the target relation. However,
96 * locking the target relation (especially using something like
97 * AccessExclusiveLock) before verifying that the user has permissions is
98 * not appealing either.
100 relOid = RangeVarGetRelid(rel, NoLock, false);
102 tuple = SearchSysCache1(RELOID, ObjectIdGetDatum(relOid));
103 if (!HeapTupleIsValid(tuple)) /* should not happen */
104 elog(ERROR, "cache lookup failed for relation %u", relOid);
106 if (!pg_class_ownercheck(relOid, GetUserId()))
107 aclcheck_error(ACLCHECK_NOT_OWNER, ACL_KIND_CLASS,
112 if (!allowSystemTableMods &&
113 IsSystemClass((Form_pg_class) GETSTRUCT(tuple)))
115 (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
116 errmsg("permission denied: \"%s\" is a system catalog",
120 ReleaseSysCache(tuple);
125 * CommandIsReadOnly: is an executable query read-only?
127 * This is a much stricter test than we apply for XactReadOnly mode;
128 * the query must be *in truth* read-only, because the caller wishes
129 * not to do CommandCounterIncrement for it.
131 * Note: currently no need to support Query nodes here
134 CommandIsReadOnly(Node *parsetree)
136 if (IsA(parsetree, PlannedStmt))
138 PlannedStmt *stmt = (PlannedStmt *) parsetree;
140 switch (stmt->commandType)
143 if (stmt->rowMarks != NIL)
144 return false; /* SELECT FOR [KEY] UPDATE/SHARE */
145 else if (stmt->hasModifyingCTE)
146 return false; /* data-modifying CTE */
154 elog(WARNING, "unrecognized commandType: %d",
155 (int) stmt->commandType);
159 /* For now, treat all utility commands as read/write */
164 * check_xact_readonly: is a utility command read-only?
166 * Here we use the loose rules of XactReadOnly mode: no permanent effects
167 * on the database are allowed.
170 check_xact_readonly(Node *parsetree)
176 * Note: Commands that need to do more complicated checking are handled
177 * elsewhere, in particular COPY and plannable statements do their own
178 * checking. However they should all call PreventCommandIfReadOnly to
179 * actually throw the error.
182 switch (nodeTag(parsetree))
184 case T_AlterDatabaseStmt:
185 case T_AlterDatabaseSetStmt:
186 case T_AlterDomainStmt:
187 case T_AlterFunctionStmt:
188 case T_AlterRoleStmt:
189 case T_AlterRoleSetStmt:
190 case T_AlterObjectSchemaStmt:
191 case T_AlterOwnerStmt:
193 case T_AlterTableStmt:
197 case T_CreateCastStmt:
198 case T_CreateEventTrigStmt:
199 case T_AlterEventTrigStmt:
200 case T_CreateConversionStmt:
202 case T_CreateDomainStmt:
203 case T_CreateFunctionStmt:
204 case T_CreateRoleStmt:
206 case T_CreatePLangStmt:
207 case T_CreateOpClassStmt:
208 case T_CreateOpFamilyStmt:
209 case T_AlterOpFamilyStmt:
211 case T_CreateSchemaStmt:
212 case T_CreateSeqStmt:
214 case T_CreateTableAsStmt:
215 case T_RefreshMatViewStmt:
216 case T_CreateTableSpaceStmt:
217 case T_CreateTrigStmt:
218 case T_CompositeTypeStmt:
219 case T_CreateEnumStmt:
220 case T_CreateRangeStmt:
221 case T_AlterEnumStmt:
225 case T_DropTableSpaceStmt:
228 case T_GrantRoleStmt:
229 case T_AlterDefaultPrivilegesStmt:
231 case T_DropOwnedStmt:
232 case T_ReassignOwnedStmt:
233 case T_AlterTSDictionaryStmt:
234 case T_AlterTSConfigurationStmt:
235 case T_CreateExtensionStmt:
236 case T_AlterExtensionStmt:
237 case T_AlterExtensionContentsStmt:
238 case T_CreateFdwStmt:
240 case T_CreateForeignServerStmt:
241 case T_AlterForeignServerStmt:
242 case T_CreateUserMappingStmt:
243 case T_AlterUserMappingStmt:
244 case T_DropUserMappingStmt:
245 case T_AlterTableSpaceOptionsStmt:
246 case T_CreateForeignTableStmt:
248 PreventCommandIfReadOnly(CreateCommandTag(parsetree));
257 * PreventCommandIfReadOnly: throw error if XactReadOnly
259 * This is useful mainly to ensure consistency of the error message wording;
260 * most callers have checked XactReadOnly for themselves.
263 PreventCommandIfReadOnly(const char *cmdname)
267 (errcode(ERRCODE_READ_ONLY_SQL_TRANSACTION),
268 /* translator: %s is name of a SQL command, eg CREATE */
269 errmsg("cannot execute %s in a read-only transaction",
274 * PreventCommandDuringRecovery: throw error if RecoveryInProgress
276 * The majority of operations that are unsafe in a Hot Standby slave
277 * will be rejected by XactReadOnly tests. However there are a few
278 * commands that are allowed in "read-only" xacts but cannot be allowed
279 * in Hot Standby mode. Those commands should call this function.
282 PreventCommandDuringRecovery(const char *cmdname)
284 if (RecoveryInProgress())
286 (errcode(ERRCODE_READ_ONLY_SQL_TRANSACTION),
287 /* translator: %s is name of a SQL command, eg CREATE */
288 errmsg("cannot execute %s during recovery",
293 * CheckRestrictedOperation: throw error for hazardous command if we're
294 * inside a security restriction context.
296 * This is needed to protect session-local state for which there is not any
297 * better-defined protection mechanism, such as ownership.
300 CheckRestrictedOperation(const char *cmdname)
302 if (InSecurityRestrictedOperation())
304 (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
305 /* translator: %s is name of a SQL command, eg PREPARE */
306 errmsg("cannot execute %s within security-restricted operation",
313 * general utility function invoker
315 * parsetree: the parse tree for the utility statement
316 * queryString: original source text of command
317 * context: identifies source of statement (toplevel client command,
318 * non-toplevel client command, subcommand of a larger utility command)
319 * params: parameters to use during execution
320 * dest: where to send results
321 * completionTag: points to a buffer of size COMPLETION_TAG_BUFSIZE
322 * in which to store a command completion status string.
324 * Notes: as of PG 8.4, caller MUST supply a queryString; it is not
325 * allowed anymore to pass NULL. (If you really don't have source text,
326 * you can pass a constant string, perhaps "(query not available)".)
328 * completionTag is only set nonempty if we want to return a nondefault status.
330 * completionTag may be NULL if caller doesn't want a status string.
333 ProcessUtility(Node *parsetree,
334 const char *queryString,
335 ProcessUtilityContext context,
336 ParamListInfo params,
340 Assert(queryString != NULL); /* required as of 8.4 */
343 * We provide a function hook variable that lets loadable plugins get
344 * control when ProcessUtility is called. Such a plugin would normally
345 * call standard_ProcessUtility().
347 if (ProcessUtility_hook)
348 (*ProcessUtility_hook) (parsetree, queryString,
350 dest, completionTag);
352 standard_ProcessUtility(parsetree, queryString,
354 dest, completionTag);
358 * standard_ProcessUtility itself deals only with utility commands for
359 * which we do not provide event trigger support. Commands that do have
360 * such support are passed down to ProcessUtilitySlow, which contains the
361 * necessary infrastructure for such triggers.
363 * This division is not just for performance: it's critical that the
364 * event trigger code not be invoked when doing START TRANSACTION for
365 * example, because we might need to refresh the event trigger cache,
366 * which requires being in a valid transaction.
369 standard_ProcessUtility(Node *parsetree,
370 const char *queryString,
371 ProcessUtilityContext context,
372 ParamListInfo params,
376 bool isTopLevel = (context == PROCESS_UTILITY_TOPLEVEL);
378 check_xact_readonly(parsetree);
381 completionTag[0] = '\0';
383 switch (nodeTag(parsetree))
386 * ******************** transactions ********************
388 case T_TransactionStmt:
390 TransactionStmt *stmt = (TransactionStmt *) parsetree;
395 * START TRANSACTION, as defined by SQL99: Identical
396 * to BEGIN. Same code for both.
398 case TRANS_STMT_BEGIN:
399 case TRANS_STMT_START:
403 BeginTransactionBlock();
404 foreach(lc, stmt->options)
406 DefElem *item = (DefElem *) lfirst(lc);
408 if (strcmp(item->defname, "transaction_isolation") == 0)
409 SetPGVariable("transaction_isolation",
410 list_make1(item->arg),
412 else if (strcmp(item->defname, "transaction_read_only") == 0)
413 SetPGVariable("transaction_read_only",
414 list_make1(item->arg),
416 else if (strcmp(item->defname, "transaction_deferrable") == 0)
417 SetPGVariable("transaction_deferrable",
418 list_make1(item->arg),
424 case TRANS_STMT_COMMIT:
425 if (!EndTransactionBlock())
427 /* report unsuccessful commit in completionTag */
429 strcpy(completionTag, "ROLLBACK");
433 case TRANS_STMT_PREPARE:
434 PreventCommandDuringRecovery("PREPARE TRANSACTION");
435 if (!PrepareTransactionBlock(stmt->gid))
437 /* report unsuccessful commit in completionTag */
439 strcpy(completionTag, "ROLLBACK");
443 case TRANS_STMT_COMMIT_PREPARED:
444 PreventTransactionChain(isTopLevel, "COMMIT PREPARED");
445 PreventCommandDuringRecovery("COMMIT PREPARED");
446 FinishPreparedTransaction(stmt->gid, true);
449 case TRANS_STMT_ROLLBACK_PREPARED:
450 PreventTransactionChain(isTopLevel, "ROLLBACK PREPARED");
451 PreventCommandDuringRecovery("ROLLBACK PREPARED");
452 FinishPreparedTransaction(stmt->gid, false);
455 case TRANS_STMT_ROLLBACK:
456 UserAbortTransactionBlock();
459 case TRANS_STMT_SAVEPOINT:
464 RequireTransactionChain(isTopLevel, "SAVEPOINT");
466 foreach(cell, stmt->options)
468 DefElem *elem = lfirst(cell);
470 if (strcmp(elem->defname, "savepoint_name") == 0)
471 name = strVal(elem->arg);
474 Assert(PointerIsValid(name));
476 DefineSavepoint(name);
480 case TRANS_STMT_RELEASE:
481 RequireTransactionChain(isTopLevel, "RELEASE SAVEPOINT");
482 ReleaseSavepoint(stmt->options);
485 case TRANS_STMT_ROLLBACK_TO:
486 RequireTransactionChain(isTopLevel, "ROLLBACK TO SAVEPOINT");
487 RollbackToSavepoint(stmt->options);
490 * CommitTransactionCommand is in charge of
491 * re-defining the savepoint again
499 * Portal (cursor) manipulation
501 * Note: DECLARE CURSOR is processed mostly as a SELECT, and
502 * therefore what we will get here is a PlannedStmt not a bare
507 PlannedStmt *stmt = (PlannedStmt *) parsetree;
509 if (stmt->utilityStmt == NULL ||
510 !IsA(stmt->utilityStmt, DeclareCursorStmt))
511 elog(ERROR, "non-DECLARE CURSOR PlannedStmt passed to ProcessUtility");
512 PerformCursorOpen(stmt, params, queryString, isTopLevel);
516 case T_ClosePortalStmt:
518 ClosePortalStmt *stmt = (ClosePortalStmt *) parsetree;
520 CheckRestrictedOperation("CLOSE");
521 PerformPortalClose(stmt->portalname);
526 PerformPortalFetch((FetchStmt *) parsetree, dest,
531 ExecuteDoStmt((DoStmt *) parsetree);
534 case T_CreateTableSpaceStmt:
535 /* no event triggers for global objects */
536 PreventTransactionChain(isTopLevel, "CREATE TABLESPACE");
537 CreateTableSpace((CreateTableSpaceStmt *) parsetree);
540 case T_DropTableSpaceStmt:
541 /* no event triggers for global objects */
542 PreventTransactionChain(isTopLevel, "DROP TABLESPACE");
543 DropTableSpace((DropTableSpaceStmt *) parsetree);
546 case T_AlterTableSpaceOptionsStmt:
547 /* no event triggers for global objects */
548 AlterTableSpaceOptions((AlterTableSpaceOptionsStmt *) parsetree);
552 ExecuteTruncate((TruncateStmt *) parsetree);
556 CommentObject((CommentStmt *) parsetree);
560 ExecSecLabelStmt((SecLabelStmt *) parsetree);
567 DoCopy((CopyStmt *) parsetree, queryString, &processed);
569 snprintf(completionTag, COMPLETION_TAG_BUFSIZE,
570 "COPY " UINT64_FORMAT, processed);
575 CheckRestrictedOperation("PREPARE");
576 PrepareQuery((PrepareStmt *) parsetree, queryString);
580 ExecuteQuery((ExecuteStmt *) parsetree, NULL,
582 dest, completionTag);
585 case T_DeallocateStmt:
586 CheckRestrictedOperation("DEALLOCATE");
587 DeallocateQuery((DeallocateStmt *) parsetree);
591 /* no event triggers for global objects */
592 ExecuteGrantStmt((GrantStmt *) parsetree);
595 case T_GrantRoleStmt:
596 /* no event triggers for global objects */
597 GrantRole((GrantRoleStmt *) parsetree);
601 /* no event triggers for global objects */
602 PreventTransactionChain(isTopLevel, "CREATE DATABASE");
603 createdb((CreatedbStmt *) parsetree);
606 case T_AlterDatabaseStmt:
607 /* no event triggers for global objects */
608 AlterDatabase((AlterDatabaseStmt *) parsetree, isTopLevel);
611 case T_AlterDatabaseSetStmt:
612 /* no event triggers for global objects */
613 AlterDatabaseSet((AlterDatabaseSetStmt *) parsetree);
618 DropdbStmt *stmt = (DropdbStmt *) parsetree;
620 /* no event triggers for global objects */
621 PreventTransactionChain(isTopLevel, "DROP DATABASE");
622 dropdb(stmt->dbname, stmt->missing_ok);
626 /* Query-level asynchronous notification */
629 NotifyStmt *stmt = (NotifyStmt *) parsetree;
631 PreventCommandDuringRecovery("NOTIFY");
632 Async_Notify(stmt->conditionname, stmt->payload);
638 ListenStmt *stmt = (ListenStmt *) parsetree;
640 PreventCommandDuringRecovery("LISTEN");
641 CheckRestrictedOperation("LISTEN");
642 Async_Listen(stmt->conditionname);
648 UnlistenStmt *stmt = (UnlistenStmt *) parsetree;
650 PreventCommandDuringRecovery("UNLISTEN");
651 CheckRestrictedOperation("UNLISTEN");
652 if (stmt->conditionname)
653 Async_Unlisten(stmt->conditionname);
661 LoadStmt *stmt = (LoadStmt *) parsetree;
663 closeAllVfds(); /* probably not necessary... */
664 /* Allowed names are restricted if you're not superuser */
665 load_file(stmt->filename, !superuser());
670 /* we choose to allow this during "read only" transactions */
671 PreventCommandDuringRecovery("CLUSTER");
672 cluster((ClusterStmt *) parsetree, isTopLevel);
677 VacuumStmt *stmt = (VacuumStmt *) parsetree;
679 /* we choose to allow this during "read only" transactions */
680 PreventCommandDuringRecovery((stmt->options & VACOPT_VACUUM) ?
681 "VACUUM" : "ANALYZE");
682 vacuum(stmt, InvalidOid, true, NULL, false, isTopLevel);
687 ExplainQuery((ExplainStmt *) parsetree, queryString, params, dest);
690 case T_VariableSetStmt:
691 ExecSetVariableStmt((VariableSetStmt *) parsetree);
694 case T_VariableShowStmt:
696 VariableShowStmt *n = (VariableShowStmt *) parsetree;
698 GetPGVariable(n->name, dest);
703 /* should we allow DISCARD PLANS? */
704 CheckRestrictedOperation("DISCARD");
705 DiscardCommand((DiscardStmt *) parsetree, isTopLevel);
708 case T_CreateEventTrigStmt:
709 /* no event triggers on event triggers */
710 CreateEventTrigger((CreateEventTrigStmt *) parsetree);
713 case T_AlterEventTrigStmt:
714 /* no event triggers on event triggers */
715 AlterEventTrigger((AlterEventTrigStmt *) parsetree);
719 * ******************************** ROLE statements ****
721 case T_CreateRoleStmt:
722 /* no event triggers for global objects */
723 CreateRole((CreateRoleStmt *) parsetree);
726 case T_AlterRoleStmt:
727 /* no event triggers for global objects */
728 AlterRole((AlterRoleStmt *) parsetree);
731 case T_AlterRoleSetStmt:
732 /* no event triggers for global objects */
733 AlterRoleSet((AlterRoleSetStmt *) parsetree);
737 /* no event triggers for global objects */
738 DropRole((DropRoleStmt *) parsetree);
741 case T_ReassignOwnedStmt:
742 /* no event triggers for global objects */
743 ReassignOwnedObjects((ReassignOwnedStmt *) parsetree);
749 * Since the lock would just get dropped immediately, LOCK TABLE
750 * outside a transaction block is presumed to be user error.
752 RequireTransactionChain(isTopLevel, "LOCK TABLE");
753 LockTableCommand((LockStmt *) parsetree);
756 case T_ConstraintsSetStmt:
757 AfterTriggerSetState((ConstraintsSetStmt *) parsetree);
760 case T_CheckPointStmt:
763 (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
764 errmsg("must be superuser to do CHECKPOINT")));
767 * You might think we should have a PreventCommandDuringRecovery()
768 * here, but we interpret a CHECKPOINT command during recovery as
769 * a request for a restartpoint instead. We allow this since it
770 * can be a useful way of reducing switchover time when using
771 * various forms of replication.
773 RequestCheckpoint(CHECKPOINT_IMMEDIATE | CHECKPOINT_WAIT |
774 (RecoveryInProgress() ? 0 : CHECKPOINT_FORCE));
779 ReindexStmt *stmt = (ReindexStmt *) parsetree;
781 /* we choose to allow this during "read only" transactions */
782 PreventCommandDuringRecovery("REINDEX");
786 ReindexIndex(stmt->relation);
790 ReindexTable(stmt->relation);
792 case OBJECT_DATABASE:
795 * This cannot run inside a user transaction block; if
796 * we were inside a transaction, then its commit- and
797 * start-transaction-command calls would not have the
800 PreventTransactionChain(isTopLevel,
802 ReindexDatabase(stmt->name,
803 stmt->do_system, stmt->do_user);
806 elog(ERROR, "unrecognized object type: %d",
814 * The following statements are supported by Event Triggers only
815 * in some cases, so we "fast path" them in the other cases.
820 DropStmt *stmt = (DropStmt *) parsetree;
822 if (EventTriggerSupportsObjectType(stmt->removeType))
823 ProcessUtilitySlow(parsetree, queryString,
825 dest, completionTag);
827 ExecDropStmt(stmt, isTopLevel);
833 RenameStmt *stmt = (RenameStmt *) parsetree;
835 if (EventTriggerSupportsObjectType(stmt->renameType))
836 ProcessUtilitySlow(parsetree, queryString,
838 dest, completionTag);
840 ExecRenameStmt(stmt);
844 case T_AlterObjectSchemaStmt:
846 AlterObjectSchemaStmt *stmt = (AlterObjectSchemaStmt *) parsetree;
848 if (EventTriggerSupportsObjectType(stmt->objectType))
849 ProcessUtilitySlow(parsetree, queryString,
851 dest, completionTag);
853 ExecAlterObjectSchemaStmt(stmt);
857 case T_AlterOwnerStmt:
859 AlterOwnerStmt *stmt = (AlterOwnerStmt *) parsetree;
861 if (EventTriggerSupportsObjectType(stmt->objectType))
862 ProcessUtilitySlow(parsetree, queryString,
864 dest, completionTag);
866 ExecAlterOwnerStmt(stmt);
871 /* All other statement types have event trigger support */
872 ProcessUtilitySlow(parsetree, queryString,
874 dest, completionTag);
880 * The "Slow" variant of ProcessUtility should only receive statements
881 * supported by the event triggers facility. Therefore, we always
882 * perform the trigger support calls if the context allows it.
885 ProcessUtilitySlow(Node *parsetree,
886 const char *queryString,
887 ProcessUtilityContext context,
888 ParamListInfo params,
892 bool isTopLevel = (context == PROCESS_UTILITY_TOPLEVEL);
893 bool isCompleteQuery = (context <= PROCESS_UTILITY_QUERY);
896 /* All event trigger calls are done only when isCompleteQuery is true */
897 needCleanup = isCompleteQuery && EventTriggerBeginCompleteQuery();
899 /* PG_TRY block is to ensure we call EventTriggerEndCompleteQuery */
903 EventTriggerDDLCommandStart(parsetree);
905 switch (nodeTag(parsetree))
908 * relation and attribute manipulation
910 case T_CreateSchemaStmt:
911 CreateSchemaCommand((CreateSchemaStmt *) parsetree,
916 case T_CreateForeignTableStmt:
922 /* Run parse analysis ... */
923 stmts = transformCreateStmt((CreateStmt *) parsetree,
929 Node *stmt = (Node *) lfirst(l);
931 if (IsA(stmt, CreateStmt))
934 static char *validnsps[] = HEAP_RELOPT_NAMESPACES;
936 /* Create the table itself */
937 relOid = DefineRelation((CreateStmt *) stmt,
942 * Let AlterTableCreateToastTable decide if this
943 * one needs a secondary relation too.
945 CommandCounterIncrement();
948 * parse and validate reloptions for the toast
951 toast_options = transformRelOptions((Datum) 0,
952 ((CreateStmt *) stmt)->options,
957 (void) heap_reloptions(RELKIND_TOASTVALUE,
961 AlterTableCreateToastTable(relOid, toast_options);
963 else if (IsA(stmt, CreateForeignTableStmt))
965 /* Create the table itself */
966 relOid = DefineRelation((CreateStmt *) stmt,
967 RELKIND_FOREIGN_TABLE,
969 CreateForeignTable((CreateForeignTableStmt *) stmt,
974 /* Recurse for anything else */
977 PROCESS_UTILITY_SUBCOMMAND,
983 /* Need CCI between commands */
984 if (lnext(l) != NULL)
985 CommandCounterIncrement();
990 case T_AlterTableStmt:
992 AlterTableStmt *atstmt = (AlterTableStmt *) parsetree;
999 * Figure out lock mode, and acquire lock. This also does
1000 * basic permissions checks, so that we won't wait for a
1001 * lock on (for example) a relation on which we have no
1004 lockmode = AlterTableGetLockLevel(atstmt->cmds);
1005 relid = AlterTableLookupRelation(atstmt, lockmode);
1007 if (OidIsValid(relid))
1009 /* Run parse analysis ... */
1010 stmts = transformAlterTableStmt(atstmt, queryString);
1015 Node *stmt = (Node *) lfirst(l);
1017 if (IsA(stmt, AlterTableStmt))
1019 /* Do the table alteration proper */
1020 AlterTable(relid, lockmode,
1021 (AlterTableStmt *) stmt);
1025 /* Recurse for anything else */
1026 ProcessUtility(stmt,
1028 PROCESS_UTILITY_SUBCOMMAND,
1034 /* Need CCI between commands */
1035 if (lnext(l) != NULL)
1036 CommandCounterIncrement();
1041 (errmsg("relation \"%s\" does not exist, skipping",
1042 atstmt->relation->relname)));
1046 case T_AlterDomainStmt:
1048 AlterDomainStmt *stmt = (AlterDomainStmt *) parsetree;
1051 * Some or all of these functions are recursive to cover
1052 * inherited things, so permission checks are done there.
1054 switch (stmt->subtype)
1056 case 'T': /* ALTER DOMAIN DEFAULT */
1059 * Recursively alter column default for table and,
1060 * if requested, for descendants
1062 AlterDomainDefault(stmt->typeName,
1065 case 'N': /* ALTER DOMAIN DROP NOT NULL */
1066 AlterDomainNotNull(stmt->typeName,
1069 case 'O': /* ALTER DOMAIN SET NOT NULL */
1070 AlterDomainNotNull(stmt->typeName,
1073 case 'C': /* ADD CONSTRAINT */
1074 AlterDomainAddConstraint(stmt->typeName,
1077 case 'X': /* DROP CONSTRAINT */
1078 AlterDomainDropConstraint(stmt->typeName,
1083 case 'V': /* VALIDATE CONSTRAINT */
1084 AlterDomainValidateConstraint(stmt->typeName,
1088 elog(ERROR, "unrecognized alter domain type: %d",
1089 (int) stmt->subtype);
1096 * ************* object creation / destruction **************
1100 DefineStmt *stmt = (DefineStmt *) parsetree;
1104 case OBJECT_AGGREGATE:
1105 DefineAggregate(stmt->defnames, stmt->args,
1106 stmt->oldstyle, stmt->definition,
1109 case OBJECT_OPERATOR:
1110 Assert(stmt->args == NIL);
1111 DefineOperator(stmt->defnames, stmt->definition);
1114 Assert(stmt->args == NIL);
1115 DefineType(stmt->defnames, stmt->definition);
1117 case OBJECT_TSPARSER:
1118 Assert(stmt->args == NIL);
1119 DefineTSParser(stmt->defnames, stmt->definition);
1121 case OBJECT_TSDICTIONARY:
1122 Assert(stmt->args == NIL);
1123 DefineTSDictionary(stmt->defnames,
1126 case OBJECT_TSTEMPLATE:
1127 Assert(stmt->args == NIL);
1128 DefineTSTemplate(stmt->defnames,
1131 case OBJECT_TSCONFIGURATION:
1132 Assert(stmt->args == NIL);
1133 DefineTSConfiguration(stmt->defnames,
1136 case OBJECT_COLLATION:
1137 Assert(stmt->args == NIL);
1138 DefineCollation(stmt->defnames, stmt->definition);
1141 elog(ERROR, "unrecognized define stmt type: %d",
1148 case T_IndexStmt: /* CREATE INDEX */
1150 IndexStmt *stmt = (IndexStmt *) parsetree;
1152 if (stmt->concurrent)
1153 PreventTransactionChain(isTopLevel,
1154 "CREATE INDEX CONCURRENTLY");
1156 CheckRelationOwnership(stmt->relation, true);
1158 /* Run parse analysis ... */
1159 stmt = transformIndexStmt(stmt, queryString);
1163 InvalidOid, /* no predefined OID */
1164 false, /* is_alter_table */
1165 true, /* check_rights */
1166 false, /* skip_build */
1171 case T_CreateExtensionStmt:
1172 CreateExtension((CreateExtensionStmt *) parsetree);
1175 case T_AlterExtensionStmt:
1176 ExecAlterExtensionStmt((AlterExtensionStmt *) parsetree);
1179 case T_AlterExtensionContentsStmt:
1180 ExecAlterExtensionContentsStmt((AlterExtensionContentsStmt *) parsetree);
1183 case T_CreateFdwStmt:
1184 CreateForeignDataWrapper((CreateFdwStmt *) parsetree);
1187 case T_AlterFdwStmt:
1188 AlterForeignDataWrapper((AlterFdwStmt *) parsetree);
1191 case T_CreateForeignServerStmt:
1192 CreateForeignServer((CreateForeignServerStmt *) parsetree);
1195 case T_AlterForeignServerStmt:
1196 AlterForeignServer((AlterForeignServerStmt *) parsetree);
1199 case T_CreateUserMappingStmt:
1200 CreateUserMapping((CreateUserMappingStmt *) parsetree);
1203 case T_AlterUserMappingStmt:
1204 AlterUserMapping((AlterUserMappingStmt *) parsetree);
1207 case T_DropUserMappingStmt:
1208 RemoveUserMapping((DropUserMappingStmt *) parsetree);
1211 case T_CompositeTypeStmt: /* CREATE TYPE (composite) */
1213 CompositeTypeStmt *stmt = (CompositeTypeStmt *) parsetree;
1215 DefineCompositeType(stmt->typevar, stmt->coldeflist);
1219 case T_CreateEnumStmt: /* CREATE TYPE AS ENUM */
1220 DefineEnum((CreateEnumStmt *) parsetree);
1223 case T_CreateRangeStmt: /* CREATE TYPE AS RANGE */
1224 DefineRange((CreateRangeStmt *) parsetree);
1227 case T_AlterEnumStmt: /* ALTER TYPE (enum) */
1228 AlterEnum((AlterEnumStmt *) parsetree, isTopLevel);
1231 case T_ViewStmt: /* CREATE VIEW */
1232 DefineView((ViewStmt *) parsetree, queryString);
1235 case T_CreateFunctionStmt: /* CREATE FUNCTION */
1236 CreateFunction((CreateFunctionStmt *) parsetree, queryString);
1239 case T_AlterFunctionStmt: /* ALTER FUNCTION */
1240 AlterFunction((AlterFunctionStmt *) parsetree);
1243 case T_RuleStmt: /* CREATE RULE */
1244 DefineRule((RuleStmt *) parsetree, queryString);
1247 case T_CreateSeqStmt:
1248 DefineSequence((CreateSeqStmt *) parsetree);
1251 case T_AlterSeqStmt:
1252 AlterSequence((AlterSeqStmt *) parsetree);
1255 case T_CreateTableAsStmt:
1256 ExecCreateTableAs((CreateTableAsStmt *) parsetree,
1257 queryString, params, completionTag);
1260 case T_RefreshMatViewStmt:
1261 ExecRefreshMatView((RefreshMatViewStmt *) parsetree,
1262 queryString, params, completionTag);
1265 case T_CreateTrigStmt:
1266 (void) CreateTrigger((CreateTrigStmt *) parsetree, queryString,
1267 InvalidOid, InvalidOid, false);
1270 case T_CreatePLangStmt:
1271 CreateProceduralLanguage((CreatePLangStmt *) parsetree);
1274 case T_CreateDomainStmt:
1275 DefineDomain((CreateDomainStmt *) parsetree);
1278 case T_CreateConversionStmt:
1279 CreateConversionCommand((CreateConversionStmt *) parsetree);
1282 case T_CreateCastStmt:
1283 CreateCast((CreateCastStmt *) parsetree);
1286 case T_CreateOpClassStmt:
1287 DefineOpClass((CreateOpClassStmt *) parsetree);
1290 case T_CreateOpFamilyStmt:
1291 DefineOpFamily((CreateOpFamilyStmt *) parsetree);
1294 case T_AlterOpFamilyStmt:
1295 AlterOpFamily((AlterOpFamilyStmt *) parsetree);
1298 case T_AlterTSDictionaryStmt:
1299 AlterTSDictionary((AlterTSDictionaryStmt *) parsetree);
1302 case T_AlterTSConfigurationStmt:
1303 AlterTSConfiguration((AlterTSConfigurationStmt *) parsetree);
1307 ExecDropStmt((DropStmt *) parsetree, isTopLevel);
1311 ExecRenameStmt((RenameStmt *) parsetree);
1314 case T_AlterObjectSchemaStmt:
1315 ExecAlterObjectSchemaStmt((AlterObjectSchemaStmt *) parsetree);
1318 case T_AlterOwnerStmt:
1319 ExecAlterOwnerStmt((AlterOwnerStmt *) parsetree);
1322 case T_DropOwnedStmt:
1323 DropOwnedObjects((DropOwnedStmt *) parsetree);
1326 case T_AlterDefaultPrivilegesStmt:
1327 ExecAlterDefaultPrivilegesStmt((AlterDefaultPrivilegesStmt *) parsetree);
1331 elog(ERROR, "unrecognized node type: %d",
1332 (int) nodeTag(parsetree));
1336 if (isCompleteQuery)
1338 EventTriggerSQLDrop(parsetree);
1339 EventTriggerDDLCommandEnd(parsetree);
1345 EventTriggerEndCompleteQuery();
1351 EventTriggerEndCompleteQuery();
1355 * Dispatch function for DropStmt
1358 ExecDropStmt(DropStmt *stmt, bool isTopLevel)
1360 switch (stmt->removeType)
1363 if (stmt->concurrent)
1364 PreventTransactionChain(isTopLevel,
1365 "DROP INDEX CONCURRENTLY");
1369 case OBJECT_SEQUENCE:
1371 case OBJECT_MATVIEW:
1372 case OBJECT_FOREIGN_TABLE:
1373 RemoveRelations(stmt);
1376 RemoveObjects(stmt);
1383 * UtilityReturnsTuples
1384 * Return "true" if this utility statement will send output to the
1387 * Generally, there should be a case here for each case in ProcessUtility
1388 * where "dest" is passed on.
1391 UtilityReturnsTuples(Node *parsetree)
1393 switch (nodeTag(parsetree))
1397 FetchStmt *stmt = (FetchStmt *) parsetree;
1402 portal = GetPortalByName(stmt->portalname);
1403 if (!PortalIsValid(portal))
1404 return false; /* not our business to raise error */
1405 return portal->tupDesc ? true : false;
1410 ExecuteStmt *stmt = (ExecuteStmt *) parsetree;
1411 PreparedStatement *entry;
1413 entry = FetchPreparedStatement(stmt->name, false);
1415 return false; /* not our business to raise error */
1416 if (entry->plansource->resultDesc)
1424 case T_VariableShowStmt:
1433 * UtilityTupleDescriptor
1434 * Fetch the actual output tuple descriptor for a utility statement
1435 * for which UtilityReturnsTuples() previously returned "true".
1437 * The returned descriptor is created in (or copied into) the current memory
1441 UtilityTupleDescriptor(Node *parsetree)
1443 switch (nodeTag(parsetree))
1447 FetchStmt *stmt = (FetchStmt *) parsetree;
1452 portal = GetPortalByName(stmt->portalname);
1453 if (!PortalIsValid(portal))
1454 return NULL; /* not our business to raise error */
1455 return CreateTupleDescCopy(portal->tupDesc);
1460 ExecuteStmt *stmt = (ExecuteStmt *) parsetree;
1461 PreparedStatement *entry;
1463 entry = FetchPreparedStatement(stmt->name, false);
1465 return NULL; /* not our business to raise error */
1466 return FetchPreparedStatementResultDesc(entry);
1470 return ExplainResultDesc((ExplainStmt *) parsetree);
1472 case T_VariableShowStmt:
1474 VariableShowStmt *n = (VariableShowStmt *) parsetree;
1476 return GetPGVariableResultDesc(n->name);
1486 * QueryReturnsTuples
1487 * Return "true" if this Query will send output to the destination.
1491 QueryReturnsTuples(Query *parsetree)
1493 switch (parsetree->commandType)
1496 /* returns tuples ... unless it's DECLARE CURSOR */
1497 if (parsetree->utilityStmt == NULL)
1503 /* the forms with RETURNING return tuples */
1504 if (parsetree->returningList)
1508 return UtilityReturnsTuples(parsetree->utilityStmt);
1511 /* probably shouldn't get here */
1514 return false; /* default */
1520 * UtilityContainsQuery
1521 * Return the contained Query, or NULL if there is none
1523 * Certain utility statements, such as EXPLAIN, contain a plannable Query.
1524 * This function encapsulates knowledge of exactly which ones do.
1525 * We assume it is invoked only on already-parse-analyzed statements
1526 * (else the contained parsetree isn't a Query yet).
1528 * In some cases (currently, only EXPLAIN of CREATE TABLE AS/SELECT INTO and
1529 * CREATE MATERIALIZED VIEW), potentially Query-containing utility statements
1530 * can be nested. This function will drill down to a non-utility Query, or
1531 * return NULL if none.
1534 UtilityContainsQuery(Node *parsetree)
1538 switch (nodeTag(parsetree))
1541 qry = (Query *) ((ExplainStmt *) parsetree)->query;
1542 Assert(IsA(qry, Query));
1543 if (qry->commandType == CMD_UTILITY)
1544 return UtilityContainsQuery(qry->utilityStmt);
1547 case T_CreateTableAsStmt:
1548 qry = (Query *) ((CreateTableAsStmt *) parsetree)->query;
1549 Assert(IsA(qry, Query));
1550 if (qry->commandType == CMD_UTILITY)
1551 return UtilityContainsQuery(qry->utilityStmt);
1561 * AlterObjectTypeCommandTag
1562 * helper function for CreateCommandTag
1564 * This covers most cases where ALTER is used with an ObjectType enum.
1567 AlterObjectTypeCommandTag(ObjectType objtype)
1573 case OBJECT_AGGREGATE:
1574 tag = "ALTER AGGREGATE";
1576 case OBJECT_ATTRIBUTE:
1582 case OBJECT_COLLATION:
1583 tag = "ALTER COLLATION";
1586 tag = "ALTER TABLE";
1588 case OBJECT_CONSTRAINT:
1589 tag = "ALTER TABLE";
1591 case OBJECT_CONVERSION:
1592 tag = "ALTER CONVERSION";
1594 case OBJECT_DATABASE:
1595 tag = "ALTER DATABASE";
1598 tag = "ALTER DOMAIN";
1600 case OBJECT_EXTENSION:
1601 tag = "ALTER EXTENSION";
1604 tag = "ALTER FOREIGN DATA WRAPPER";
1606 case OBJECT_FOREIGN_SERVER:
1607 tag = "ALTER SERVER";
1609 case OBJECT_FOREIGN_TABLE:
1610 tag = "ALTER FOREIGN TABLE";
1612 case OBJECT_FUNCTION:
1613 tag = "ALTER FUNCTION";
1616 tag = "ALTER INDEX";
1618 case OBJECT_LANGUAGE:
1619 tag = "ALTER LANGUAGE";
1621 case OBJECT_LARGEOBJECT:
1622 tag = "ALTER LARGE OBJECT";
1624 case OBJECT_OPCLASS:
1625 tag = "ALTER OPERATOR CLASS";
1627 case OBJECT_OPERATOR:
1628 tag = "ALTER OPERATOR";
1630 case OBJECT_OPFAMILY:
1631 tag = "ALTER OPERATOR FAMILY";
1640 tag = "ALTER SCHEMA";
1642 case OBJECT_SEQUENCE:
1643 tag = "ALTER SEQUENCE";
1646 tag = "ALTER TABLE";
1648 case OBJECT_TABLESPACE:
1649 tag = "ALTER TABLESPACE";
1651 case OBJECT_TRIGGER:
1652 tag = "ALTER TRIGGER";
1654 case OBJECT_EVENT_TRIGGER:
1655 tag = "ALTER EVENT TRIGGER";
1657 case OBJECT_TSCONFIGURATION:
1658 tag = "ALTER TEXT SEARCH CONFIGURATION";
1660 case OBJECT_TSDICTIONARY:
1661 tag = "ALTER TEXT SEARCH DICTIONARY";
1663 case OBJECT_TSPARSER:
1664 tag = "ALTER TEXT SEARCH PARSER";
1666 case OBJECT_TSTEMPLATE:
1667 tag = "ALTER TEXT SEARCH TEMPLATE";
1675 case OBJECT_MATVIEW:
1676 tag = "ALTER MATERIALIZED VIEW";
1688 * utility to get a string representation of the command operation,
1689 * given either a raw (un-analyzed) parsetree or a planned query.
1691 * This must handle all command types, but since the vast majority
1692 * of 'em are utility commands, it seems sensible to keep it here.
1694 * NB: all result strings must be shorter than COMPLETION_TAG_BUFSIZE.
1695 * Also, the result must point at a true constant (permanent storage).
1698 CreateCommandTag(Node *parsetree)
1702 switch (nodeTag(parsetree))
1704 /* raw plannable queries */
1721 /* utility statements --- same whether raw or cooked */
1722 case T_TransactionStmt:
1724 TransactionStmt *stmt = (TransactionStmt *) parsetree;
1728 case TRANS_STMT_BEGIN:
1732 case TRANS_STMT_START:
1733 tag = "START TRANSACTION";
1736 case TRANS_STMT_COMMIT:
1740 case TRANS_STMT_ROLLBACK:
1741 case TRANS_STMT_ROLLBACK_TO:
1745 case TRANS_STMT_SAVEPOINT:
1749 case TRANS_STMT_RELEASE:
1753 case TRANS_STMT_PREPARE:
1754 tag = "PREPARE TRANSACTION";
1757 case TRANS_STMT_COMMIT_PREPARED:
1758 tag = "COMMIT PREPARED";
1761 case TRANS_STMT_ROLLBACK_PREPARED:
1762 tag = "ROLLBACK PREPARED";
1772 case T_DeclareCursorStmt:
1773 tag = "DECLARE CURSOR";
1776 case T_ClosePortalStmt:
1778 ClosePortalStmt *stmt = (ClosePortalStmt *) parsetree;
1780 if (stmt->portalname == NULL)
1781 tag = "CLOSE CURSOR ALL";
1783 tag = "CLOSE CURSOR";
1789 FetchStmt *stmt = (FetchStmt *) parsetree;
1791 tag = (stmt->ismove) ? "MOVE" : "FETCH";
1795 case T_CreateDomainStmt:
1796 tag = "CREATE DOMAIN";
1799 case T_CreateSchemaStmt:
1800 tag = "CREATE SCHEMA";
1804 tag = "CREATE TABLE";
1807 case T_CreateTableSpaceStmt:
1808 tag = "CREATE TABLESPACE";
1811 case T_DropTableSpaceStmt:
1812 tag = "DROP TABLESPACE";
1815 case T_AlterTableSpaceOptionsStmt:
1816 tag = "ALTER TABLESPACE";
1819 case T_CreateExtensionStmt:
1820 tag = "CREATE EXTENSION";
1823 case T_AlterExtensionStmt:
1824 tag = "ALTER EXTENSION";
1827 case T_AlterExtensionContentsStmt:
1828 tag = "ALTER EXTENSION";
1831 case T_CreateFdwStmt:
1832 tag = "CREATE FOREIGN DATA WRAPPER";
1835 case T_AlterFdwStmt:
1836 tag = "ALTER FOREIGN DATA WRAPPER";
1839 case T_CreateForeignServerStmt:
1840 tag = "CREATE SERVER";
1843 case T_AlterForeignServerStmt:
1844 tag = "ALTER SERVER";
1847 case T_CreateUserMappingStmt:
1848 tag = "CREATE USER MAPPING";
1851 case T_AlterUserMappingStmt:
1852 tag = "ALTER USER MAPPING";
1855 case T_DropUserMappingStmt:
1856 tag = "DROP USER MAPPING";
1859 case T_CreateForeignTableStmt:
1860 tag = "CREATE FOREIGN TABLE";
1864 switch (((DropStmt *) parsetree)->removeType)
1869 case OBJECT_SEQUENCE:
1870 tag = "DROP SEQUENCE";
1875 case OBJECT_MATVIEW:
1876 tag = "DROP MATERIALIZED VIEW";
1885 tag = "DROP DOMAIN";
1887 case OBJECT_COLLATION:
1888 tag = "DROP COLLATION";
1890 case OBJECT_CONVERSION:
1891 tag = "DROP CONVERSION";
1894 tag = "DROP SCHEMA";
1896 case OBJECT_TSPARSER:
1897 tag = "DROP TEXT SEARCH PARSER";
1899 case OBJECT_TSDICTIONARY:
1900 tag = "DROP TEXT SEARCH DICTIONARY";
1902 case OBJECT_TSTEMPLATE:
1903 tag = "DROP TEXT SEARCH TEMPLATE";
1905 case OBJECT_TSCONFIGURATION:
1906 tag = "DROP TEXT SEARCH CONFIGURATION";
1908 case OBJECT_FOREIGN_TABLE:
1909 tag = "DROP FOREIGN TABLE";
1911 case OBJECT_EXTENSION:
1912 tag = "DROP EXTENSION";
1914 case OBJECT_FUNCTION:
1915 tag = "DROP FUNCTION";
1917 case OBJECT_AGGREGATE:
1918 tag = "DROP AGGREGATE";
1920 case OBJECT_OPERATOR:
1921 tag = "DROP OPERATOR";
1923 case OBJECT_LANGUAGE:
1924 tag = "DROP LANGUAGE";
1929 case OBJECT_TRIGGER:
1930 tag = "DROP TRIGGER";
1932 case OBJECT_EVENT_TRIGGER:
1933 tag = "DROP EVENT TRIGGER";
1939 tag = "DROP FOREIGN DATA WRAPPER";
1941 case OBJECT_FOREIGN_SERVER:
1942 tag = "DROP SERVER";
1944 case OBJECT_OPCLASS:
1945 tag = "DROP OPERATOR CLASS";
1947 case OBJECT_OPFAMILY:
1948 tag = "DROP OPERATOR FAMILY";
1955 case T_TruncateStmt:
1956 tag = "TRUNCATE TABLE";
1963 case T_SecLabelStmt:
1964 tag = "SECURITY LABEL";
1972 tag = AlterObjectTypeCommandTag(((RenameStmt *) parsetree)->renameType);
1975 case T_AlterObjectSchemaStmt:
1976 tag = AlterObjectTypeCommandTag(((AlterObjectSchemaStmt *) parsetree)->objectType);
1979 case T_AlterOwnerStmt:
1980 tag = AlterObjectTypeCommandTag(((AlterOwnerStmt *) parsetree)->objectType);
1983 case T_AlterTableStmt:
1984 tag = AlterObjectTypeCommandTag(((AlterTableStmt *) parsetree)->relkind);
1987 case T_AlterDomainStmt:
1988 tag = "ALTER DOMAIN";
1991 case T_AlterFunctionStmt:
1992 tag = "ALTER FUNCTION";
1997 GrantStmt *stmt = (GrantStmt *) parsetree;
1999 tag = (stmt->is_grant) ? "GRANT" : "REVOKE";
2003 case T_GrantRoleStmt:
2005 GrantRoleStmt *stmt = (GrantRoleStmt *) parsetree;
2007 tag = (stmt->is_grant) ? "GRANT ROLE" : "REVOKE ROLE";
2011 case T_AlterDefaultPrivilegesStmt:
2012 tag = "ALTER DEFAULT PRIVILEGES";
2016 switch (((DefineStmt *) parsetree)->kind)
2018 case OBJECT_AGGREGATE:
2019 tag = "CREATE AGGREGATE";
2021 case OBJECT_OPERATOR:
2022 tag = "CREATE OPERATOR";
2025 tag = "CREATE TYPE";
2027 case OBJECT_TSPARSER:
2028 tag = "CREATE TEXT SEARCH PARSER";
2030 case OBJECT_TSDICTIONARY:
2031 tag = "CREATE TEXT SEARCH DICTIONARY";
2033 case OBJECT_TSTEMPLATE:
2034 tag = "CREATE TEXT SEARCH TEMPLATE";
2036 case OBJECT_TSCONFIGURATION:
2037 tag = "CREATE TEXT SEARCH CONFIGURATION";
2039 case OBJECT_COLLATION:
2040 tag = "CREATE COLLATION";
2047 case T_CompositeTypeStmt:
2048 tag = "CREATE TYPE";
2051 case T_CreateEnumStmt:
2052 tag = "CREATE TYPE";
2055 case T_CreateRangeStmt:
2056 tag = "CREATE TYPE";
2059 case T_AlterEnumStmt:
2064 tag = "CREATE VIEW";
2067 case T_CreateFunctionStmt:
2068 tag = "CREATE FUNCTION";
2072 tag = "CREATE INDEX";
2076 tag = "CREATE RULE";
2079 case T_CreateSeqStmt:
2080 tag = "CREATE SEQUENCE";
2083 case T_AlterSeqStmt:
2084 tag = "ALTER SEQUENCE";
2091 case T_CreatedbStmt:
2092 tag = "CREATE DATABASE";
2095 case T_AlterDatabaseStmt:
2096 tag = "ALTER DATABASE";
2099 case T_AlterDatabaseSetStmt:
2100 tag = "ALTER DATABASE";
2104 tag = "DROP DATABASE";
2115 case T_UnlistenStmt:
2128 if (((VacuumStmt *) parsetree)->options & VACOPT_VACUUM)
2138 case T_CreateTableAsStmt:
2139 switch (((CreateTableAsStmt *) parsetree)->relkind)
2142 if (((CreateTableAsStmt *) parsetree)->is_select_into)
2143 tag = "SELECT INTO";
2145 tag = "CREATE TABLE AS";
2147 case OBJECT_MATVIEW:
2148 tag = "CREATE MATERIALIZED VIEW";
2155 case T_RefreshMatViewStmt:
2156 tag = "REFRESH MATERIALIZED VIEW";
2159 case T_VariableSetStmt:
2160 switch (((VariableSetStmt *) parsetree)->kind)
2163 case VAR_SET_CURRENT:
2164 case VAR_SET_DEFAULT:
2177 case T_VariableShowStmt:
2182 switch (((DiscardStmt *) parsetree)->target)
2185 tag = "DISCARD ALL";
2188 tag = "DISCARD PLANS";
2191 tag = "DISCARD TEMP";
2198 case T_CreateTrigStmt:
2199 tag = "CREATE TRIGGER";
2202 case T_CreateEventTrigStmt:
2203 tag = "CREATE EVENT TRIGGER";
2206 case T_AlterEventTrigStmt:
2207 tag = "ALTER EVENT TRIGGER";
2210 case T_CreatePLangStmt:
2211 tag = "CREATE LANGUAGE";
2214 case T_CreateRoleStmt:
2215 tag = "CREATE ROLE";
2218 case T_AlterRoleStmt:
2222 case T_AlterRoleSetStmt:
2226 case T_DropRoleStmt:
2230 case T_DropOwnedStmt:
2234 case T_ReassignOwnedStmt:
2235 tag = "REASSIGN OWNED";
2242 case T_ConstraintsSetStmt:
2243 tag = "SET CONSTRAINTS";
2246 case T_CheckPointStmt:
2254 case T_CreateConversionStmt:
2255 tag = "CREATE CONVERSION";
2258 case T_CreateCastStmt:
2259 tag = "CREATE CAST";
2262 case T_CreateOpClassStmt:
2263 tag = "CREATE OPERATOR CLASS";
2266 case T_CreateOpFamilyStmt:
2267 tag = "CREATE OPERATOR FAMILY";
2270 case T_AlterOpFamilyStmt:
2271 tag = "ALTER OPERATOR FAMILY";
2274 case T_AlterTSDictionaryStmt:
2275 tag = "ALTER TEXT SEARCH DICTIONARY";
2278 case T_AlterTSConfigurationStmt:
2279 tag = "ALTER TEXT SEARCH CONFIGURATION";
2290 case T_DeallocateStmt:
2292 DeallocateStmt *stmt = (DeallocateStmt *) parsetree;
2294 if (stmt->name == NULL)
2295 tag = "DEALLOCATE ALL";
2301 /* already-planned queries */
2304 PlannedStmt *stmt = (PlannedStmt *) parsetree;
2306 switch (stmt->commandType)
2311 * We take a little extra care here so that the result
2312 * will be useful for complaints about read-only
2315 if (stmt->utilityStmt != NULL)
2317 Assert(IsA(stmt->utilityStmt, DeclareCursorStmt));
2318 tag = "DECLARE CURSOR";
2320 else if (stmt->rowMarks != NIL)
2322 /* not 100% but probably close enough */
2323 switch (((PlanRowMark *) linitial(stmt->rowMarks))->markType)
2325 case ROW_MARK_EXCLUSIVE:
2326 tag = "SELECT FOR UPDATE";
2328 case ROW_MARK_NOKEYEXCLUSIVE:
2329 tag = "SELECT FOR NO KEY UPDATE";
2331 case ROW_MARK_SHARE:
2332 tag = "SELECT FOR SHARE";
2334 case ROW_MARK_KEYSHARE:
2335 tag = "SELECT FOR KEY SHARE";
2337 case ROW_MARK_REFERENCE:
2359 elog(WARNING, "unrecognized commandType: %d",
2360 (int) stmt->commandType);
2367 /* parsed-and-rewritten-but-not-planned queries */
2370 Query *stmt = (Query *) parsetree;
2372 switch (stmt->commandType)
2377 * We take a little extra care here so that the result
2378 * will be useful for complaints about read-only
2381 if (stmt->utilityStmt != NULL)
2383 Assert(IsA(stmt->utilityStmt, DeclareCursorStmt));
2384 tag = "DECLARE CURSOR";
2386 else if (stmt->rowMarks != NIL)
2388 /* not 100% but probably close enough */
2389 switch (((RowMarkClause *) linitial(stmt->rowMarks))->strength)
2391 case LCS_FORKEYSHARE:
2392 tag = "SELECT FOR KEY SHARE";
2395 tag = "SELECT FOR SHARE";
2397 case LCS_FORNOKEYUPDATE:
2398 tag = "SELECT FOR NO KEY UPDATE";
2401 tag = "SELECT FOR UPDATE";
2421 tag = CreateCommandTag(stmt->utilityStmt);
2424 elog(WARNING, "unrecognized commandType: %d",
2425 (int) stmt->commandType);
2433 elog(WARNING, "unrecognized node type: %d",
2434 (int) nodeTag(parsetree));
2444 * GetCommandLogLevel
2445 * utility to get the minimum log_statement level for a command,
2446 * given either a raw (un-analyzed) parsetree or a planned query.
2448 * This must handle all command types, but since the vast majority
2449 * of 'em are utility commands, it seems sensible to keep it here.
2452 GetCommandLogLevel(Node *parsetree)
2456 switch (nodeTag(parsetree))
2458 /* raw plannable queries */
2466 if (((SelectStmt *) parsetree)->intoClause)
2467 lev = LOGSTMT_DDL; /* SELECT INTO */
2472 /* utility statements --- same whether raw or cooked */
2473 case T_TransactionStmt:
2477 case T_DeclareCursorStmt:
2481 case T_ClosePortalStmt:
2489 case T_CreateSchemaStmt:
2494 case T_CreateForeignTableStmt:
2498 case T_CreateTableSpaceStmt:
2499 case T_DropTableSpaceStmt:
2500 case T_AlterTableSpaceOptionsStmt:
2504 case T_CreateExtensionStmt:
2505 case T_AlterExtensionStmt:
2506 case T_AlterExtensionContentsStmt:
2510 case T_CreateFdwStmt:
2511 case T_AlterFdwStmt:
2512 case T_CreateForeignServerStmt:
2513 case T_AlterForeignServerStmt:
2514 case T_CreateUserMappingStmt:
2515 case T_AlterUserMappingStmt:
2516 case T_DropUserMappingStmt:
2524 case T_TruncateStmt:
2532 case T_SecLabelStmt:
2537 if (((CopyStmt *) parsetree)->is_from)
2545 PrepareStmt *stmt = (PrepareStmt *) parsetree;
2547 /* Look through a PREPARE to the contained stmt */
2548 lev = GetCommandLogLevel(stmt->query);
2554 ExecuteStmt *stmt = (ExecuteStmt *) parsetree;
2555 PreparedStatement *ps;
2557 /* Look through an EXECUTE to the referenced stmt */
2558 ps = FetchPreparedStatement(stmt->name, false);
2560 lev = GetCommandLogLevel(ps->plansource->raw_parse_tree);
2566 case T_DeallocateStmt:
2574 case T_AlterObjectSchemaStmt:
2578 case T_AlterOwnerStmt:
2582 case T_AlterTableStmt:
2586 case T_AlterDomainStmt:
2594 case T_GrantRoleStmt:
2598 case T_AlterDefaultPrivilegesStmt:
2606 case T_CompositeTypeStmt:
2610 case T_CreateEnumStmt:
2614 case T_CreateRangeStmt:
2618 case T_AlterEnumStmt:
2626 case T_CreateFunctionStmt:
2630 case T_AlterFunctionStmt:
2642 case T_CreateSeqStmt:
2646 case T_AlterSeqStmt:
2654 case T_CreatedbStmt:
2658 case T_AlterDatabaseStmt:
2662 case T_AlterDatabaseSetStmt:
2678 case T_UnlistenStmt:
2696 ExplainStmt *stmt = (ExplainStmt *) parsetree;
2697 bool analyze = false;
2700 /* Look through an EXPLAIN ANALYZE to the contained stmt */
2701 foreach(lc, stmt->options)
2703 DefElem *opt = (DefElem *) lfirst(lc);
2705 if (strcmp(opt->defname, "analyze") == 0)
2706 analyze = defGetBoolean(opt);
2707 /* don't "break", as explain.c will use the last value */
2710 return GetCommandLogLevel(stmt->query);
2712 /* Plain EXPLAIN isn't so interesting */
2717 case T_CreateTableAsStmt:
2721 case T_RefreshMatViewStmt:
2725 case T_VariableSetStmt:
2729 case T_VariableShowStmt:
2737 case T_CreateTrigStmt:
2741 case T_CreateEventTrigStmt:
2745 case T_AlterEventTrigStmt:
2749 case T_CreatePLangStmt:
2753 case T_CreateDomainStmt:
2757 case T_CreateRoleStmt:
2761 case T_AlterRoleStmt:
2765 case T_AlterRoleSetStmt:
2769 case T_DropRoleStmt:
2773 case T_DropOwnedStmt:
2777 case T_ReassignOwnedStmt:
2785 case T_ConstraintsSetStmt:
2789 case T_CheckPointStmt:
2794 lev = LOGSTMT_ALL; /* should this be DDL? */
2797 case T_CreateConversionStmt:
2801 case T_CreateCastStmt:
2805 case T_CreateOpClassStmt:
2809 case T_CreateOpFamilyStmt:
2813 case T_AlterOpFamilyStmt:
2817 case T_AlterTSDictionaryStmt:
2821 case T_AlterTSConfigurationStmt:
2825 /* already-planned queries */
2828 PlannedStmt *stmt = (PlannedStmt *) parsetree;
2830 switch (stmt->commandType)
2843 elog(WARNING, "unrecognized commandType: %d",
2844 (int) stmt->commandType);
2851 /* parsed-and-rewritten-but-not-planned queries */
2854 Query *stmt = (Query *) parsetree;
2856 switch (stmt->commandType)
2869 lev = GetCommandLogLevel(stmt->utilityStmt);
2873 elog(WARNING, "unrecognized commandType: %d",
2874 (int) stmt->commandType);
2883 elog(WARNING, "unrecognized node type: %d",
2884 (int) nodeTag(parsetree));