↑↓ select ↵ open ⌫ change scope Open full search

PG.CENTER connects PostgreSQL documentation, reference, and ecosystem knowledge. Maintained by Pigsty.

System Catalogs / System catalogs

The catalog pg_proc stores information about functions, procedures, aggregate functions, and window functions (collectively also known as routines).

Reading PG 18current·documented in 24 of 24 versions, 7.4 to 20

Kind
System catalogs
Columns in this snapshot
30
Definition source
English manual
Metadata snapshot
18.6

Columns 30

As listed in the PostgreSQL 18 manual.

ColumnTypeDescription / reference
oidoidNOT NULLRow identifier
pronamenameNOT NULLName of the function
pronamespaceoidNOT NULLThe OID of the namespace that contains this function
pg_namespace.oid
proowneroidNOT NULLOwner of the function
pg_authid.oid
prolangoidNOT NULLImplementation language or call interface of this function
pg_language.oid
procostfloat4NOT NULLEstimated execution cost (in units of cpu_operator_cost); if proretset, this is cost per row returned
prorowsfloat4NOT NULLEstimated number of result rows (zero if not proretset)
provariadicoidNOT NULLData type of the variadic array parameter's elements, or zero if the function does not have a variadic parameter
pg_type.oid
prosupportregprocNOT NULLPlanner support function for this function (see Section 36.11), or zero if none
pg_proc.oid
prokindcharNOT NULLf for a normal function, p for a procedure, a for an aggregate function, or w for a window function
prosecdefboolNOT NULLFunction is a security definer (i.e., a “setuid” function)
proleakproofboolNOT NULLThe function has no side effects. No information about the arguments is conveyed except via the return value. Any function that might throw an error depending on the values of its arguments is not leakproof.
proisstrictboolNOT NULLFunction returns null if any call argument is null. In that case the function won't actually be called at all. Functions that are not “strict” must be prepared to handle null inputs.
proretsetboolNOT NULLFunction returns a set (i.e., multiple values of the specified data type)
provolatilecharNOT NULLprovolatile tells whether the function's result depends only on its input arguments, or is affected by outside factors. It is i for “immutable” functions, which always deliver the same result for the same inputs. It is s for “stable” functions, whose results (for fixed inputs) do not change within a scan. It is v for “volatile” functions, whose results might change at any time. (Use v also for functions with side-effects, so that calls to them cannot get optimized away.)
proparallelcharNOT NULLproparallel tells whether the function can be safely run in parallel mode. It is s for functions which are safe to run in parallel mode without restriction. It is r for functions which can be run in parallel mode, but their execution is restricted to the parallel group leader; parallel worker processes cannot invoke these functions. It is u for functions which are unsafe in parallel mode; the presence of such a function forces a serial execution plan.
pronargsint2NOT NULLNumber of input arguments
pronargdefaultsint2NOT NULLNumber of arguments that have defaults
prorettypeoidNOT NULLData type of the return value
pg_type.oid
proargtypesoidvectorNOT NULLAn array of the data types of the function arguments. This includes only input arguments (including INOUT and VARIADIC arguments), and thus represents the call signature of the function.
pg_type.oid
proallargtypesoid[]An array of the data types of the function arguments. This includes all arguments (including OUT and INOUT arguments); however, if all the arguments are IN arguments, this field will be null. Note that subscripting is 1-based, whereas for historical reasons proargtypes is subscripted from 0.
pg_type.oid
proargmodeschar[]An array of the modes of the function arguments, encoded as i for IN arguments, o for OUT arguments, b for INOUT arguments, v for VARIADIC arguments, t for TABLE arguments. If all the arguments are IN arguments, this field will be null. Note that subscripts correspond to positions of proallargtypes not proargtypes.
proargnamestext[]An array of the names of the function arguments. Arguments without a name are set to empty strings in the array. If none of the arguments have a name, this field will be null. Note that subscripts correspond to positions of proallargtypes not proargtypes.
proargdefaultspg_node_treeExpression trees (in nodeToString() representation) for default values. This is a list with pronargdefaults elements, corresponding to the last N input arguments (i.e., the last N proargtypes positions). If none of the arguments have defaults, this field will be null.
protrftypesoid[]An array of the argument/result data type(s) for which to apply transforms (from the function's TRANSFORM clause). Null if none.
pg_type.oid
prosrctextNOT NULLThis tells the function handler how to invoke the function. It might be the actual source code of the function for interpreted languages, a link symbol, a file name, or just about anything else, depending on the implementation language/call convention.
probintextAdditional information about how to invoke the function. Again, the interpretation is language-specific.
prosqlbodypg_node_treePre-parsed SQL function body. This is used for SQL-language functions when the body is given in SQL-standard notation rather than as a string literal. It's null in other cases.
proconfigtext[]Function's local settings for run-time configuration variables
proaclaclitem[]Access privileges; see Section 5.8 for details
Column history across versions
Version history 18
  1. 18 → 19 reworded
  2. 17 → 18 reworded
  3. 16 → 17 reworded
  4. 13 → 14 changed
  5. 12 → 13 reworded
  6. 11 → 12 changed
  7. 10 → 11 changed
  8. 9.6 → 10 reworded
  9. 9.5 → 9.6 changed
  10. 9.4 → 9.5 changed
  11. 9.1 → 9.2 changed
  12. 9.0 → 9.1 changed
  13. 8.4 → 9.0 changed
  14. 8.3 → 8.4 changed
  15. 8.2 → 8.3 changed
  16. 8.1 → 8.2 reworded
  17. 8.0 → 8.1 changed
  18. 7.4 → 8.0 changed

Definition snapshot: english-manuals:fc501feeb941adb173a51e415b5… · English manual source