functions/INFO.pg_sql

Functions

Source

001: \echo Start functions/INFO.pg_sql
002: 
003: /** Write log message if logging is set to INFO or more severe.
004:  *  To get output on standard out, client_min_messages in postgresql.conf
005:  *  needs to be set to info or less severe.
006:  *
007:  *  @function INFO
008:  *  @return void
009:  *  @param in text I_MESSAGE Value for LOG.MESSAGE.
010:  *  @version $Id: INFO.pg_sql 7 2018-06-12 04:15:42Z thiemo $
011:  *  @todo Once PostgreSQL supports packages, integrate this function into one.
012:  *        For the time being, it should get installed within a schema on its
013:  *        own and no execution grants should be given on it.
014:  *  @todo Once HyperSQL supports a license tag, convert the corresponding
015:  *        info tag into one.
016:  *  @copyright Thiemo Kellner, 2018 -
017:  *  @info License LGPLv3
018:  *  @webpage https://www.sourceforge.net/projects/pglogger
019:  */
020: create or replace function INFO(
021:     I_MESSAGE text
022: )
023:   returns void
024:   language plpgsql
025:   security definer
026:   stable
027:   -- Include the hosting schema into search_path so that dblink
028:   -- can find the pglogger objects. There is no need to access
029:   -- objects in other schematas not covered with public.
030:   set search_path = :SCHEMA_NAME, public
031:   as
032: $body$
033:     begin
034:         if
035:             GET_LOGGING_LEVEL() in (
036:                 'INFO',
037:                 'LOG',
038:                 'DEBUG'
039:             )
040:         then
041:             perform WRITE_MESSAGE(
042:                         I_MESSAGE => I_MESSAGE,
043:                         I_LEVEL => 'INFO'
044:                     );
045:         end if;
046:     end;
047: $body$;
048: 
049: comment on function INFO(I_MESSAGE text) is 'Write log message if logging is set to INFO or more severe.
050: To get output on standard out, client_min_messages in postgresql.conf needs to be set to info or less severe.
051: $Header: svn+ssh://thiemo@svn.code.sf.net/p/pglogger/code/functions/INFO.pg_sql 7 2018-06-12 04:15:42Z thiemo $';
052: 
053: commit; -- unlike Oracle not all ddl commit implicitly
054: 
055: \echo End functions/INFO.pg_sql