functions/LOG.pg_sql

Functions

Source

001: \echo Start functions/LOG.pg_sql
002: 
003: /** Write log message if logging is set to LOG or more severe.
004:  *  To get output on standard out, client_min_messages in postgresql.conf
005:  *  needs to be set to log or less severe.
006:  *
007:  *  @function LOG
008:  *  @return void
009:  *  @param in text I_MESSAGE Value for LOG.MESSAGE.
010:  *  @version $Id: LOG.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 LOG(
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:                 'LOG',
037:                 'DEBUG'
038:             )
039:         then
040:             perform WRITE_MESSAGE(
041:                         I_MESSAGE => I_MESSAGE,
042:                         I_LEVEL => 'LOG'
043:                     );
044:         end if;
045:     end;
046: $body$;
047: 
048: comment on function LOG(I_MESSAGE text) is 'Write log message if logging is set to LOG or more severe.
049: To get output on standard out, client_min_messages in postgresql.conf needs to be set to log or less severe.
050: $Header: svn+ssh://thiemo@svn.code.sf.net/p/pglogger/code/functions/LOG.pg_sql 7 2018-06-12 04:15:42Z thiemo $';
051: 
052: commit; -- unlike Oracle not all ddl commit implicitly
053: 
054: \echo End functions/LOG.pg_sql