pg_notice_handler
Prev | 4.5.Notification and Notice Processing Commands | Next

## pg_notice_handler

pg_notice_handler — 中央集中処理装置からの通知や警告伝言文の為に呼戻しを設定する Set a callback for notice or warning messages from the server

## Synopsis

    pg_notice_handler conn ?command?

## 説明 Description

`pg_notice_handler` は中央集中処理装置から､通知や警告の伝言文が届いた時､実行される命令を得るか設定する｡ 通知や警告の伝言文は､応用譜依頼者により送られた命令に応答して送られるが､不都合伝言文ではなく､且つ､命令からの不都合状態内の結果でもない｡ そうではなく､通知把持子は伝言文を処理する為に呼出される｡ 既定の通知把持子は､標準不都合並び(stderr)を表示する｡ `pg_notice_handler` は､通知と警告の伝言文を応用譜に処理させる｡ `pg_notice_handler` gets or sets the command to be executed when a notice or warning message arrives from the server. Notice and warning messages are sent in response to a command sent by an application client, but are not error messages and do not result in an error condition from the command. Instead, a notice handler is called to process the message. The default notice handler displays the message to the standard error stream (stderr). `pg_notice_handler` lets the application control the processing of notice and warning messages.

## Arguments

`conn`

  通知把持子を設立する為の接続の把持子｡ The handle of the connection for which to establish the notice handler.

`command`

  通知と警告伝言文の把持子への追加の新しい命令｡命令が何も供給されないと､通知把持子は変更されない｡ 中央集中処理装置からの伝言文の文書は命令にリスト要素として追記される｡ Optional new command to handler notice and warning messages. If no command is supplied, the notice handler is not changed. The text of the message from the server will be appended as list element to the command.

## Return Value

以前の通知把持子の命令が返される｡(もし､新命令が何も供給されない場合､現在の通知把持子の命令が返される) The previous notice handler command is returned. (The current notice handler command is returned, if no new command is supplied).

引数の不都合を除いて､不都合状態はない｡もし､通知把持子そのものがｔｃｌ不都合を発すると､不都合は無視される｡ There are no error conditions, except for argument errors. If a notice handler itself throws a Tcl error, the error will be ignored.

## Notes

既定の通知把持子は`puts -nonewline stderr` と等しい｡ (現在は､全てのPostgreSQL 通知と警告の伝言文は行替え符号で終る) The default notice handler is equivalent to `puts -nonewline stderr`. (Currently, all PostgreSQL notice and warning messages end in a newline.)

もし､通知と警告の伝言文を完全に抑制したい場合､通知把持子を空文字列に設定できる｡ 但し､通知伝言文の無視を望むなら､より良い方法は､SQL 命令: `SET CLIENT_MIN_MESSAGES TO WARNING` により伝言の閾値を増加することである｡ If you want to suppress notice and warning messages completely, you can set the notice handler to an empty string. But if you just want to ignore notice messages, a better way is to increase the message threshold with the SQL command: `SET CLIENT_MIN_MESSAGES TO WARNING`.

通知を通告と混同してはならない｡通知と警告伝言文は､ 依頼者からの命令への応答内で､中央集中処理装置により生成される､しかし､命令の失敗を示唆しないので､ 結果の状態に影響しない｡ 通知の例は､基本的な鍵を伴う表生成の結果としての索引生成である｡ 警告の例は､ ROLLBACK が業務処理の外で発行されるかもしれないことである｡ 反対に､通告は他のデータベース依頼者の為に送られる伝言文である｡ Don't confuse Notices with Notification. Notice and warning messages are generated by the server in response to a command from the client, but do not imply failure of the command so they don't affect the result status. An example of a notice is index creation as a result of creating a table with a primary key. An example of a warning is if `ROLLBACK` is issued outside a transaction. By contrast, notifications are messages sent on behalf of another database client.

Prev | Up | Next
pg_on_connection_loss | Home | 4.6.Large Object Processing Commands