pg_file_settings
#
The view <structname>pg_file_settings</structname> provides a summary of
the contents of the server's configuration file(s). A row appears in
this view for each <quote>name = value</quote> entry appearing in the files,
with annotations indicating whether the value could be applied
successfully. Additional row(s) may appear for problems not linked to
a <quote>name = value</quote> entry, such as syntax errors in the files.
pg_file_settings
ビューはサーバの設定ファイルの内容の要約を提供します。
ファイル内にある各「name = value」のエントリについて、このビューの1行が存在し、その値が正しく適用可能かどうかの注釈が含まれます。
ファイル内の構文エラーなど「name = value」のエントリと関係のない問題についての行がさらに存在することもあります。
This view is helpful for checking whether planned changes in the
configuration files will work, or for diagnosing a previous failure.
Note that this view reports on the <emphasis>current</emphasis> contents of the
files, not on what was last applied by the server. (The
<link linkend="view-pg-settings"><structname>pg_settings</structname></link>
view is usually sufficient to determine that.)
設定ファイルについて予定している変更が動作するかどうかの確認や、以前のエラーの調査分析をする際にこのビューは役立ちます。
このビューはファイルの現在の内容についてレポートするのであって、サーバが最後に適用した内容ではないことに注意してください。
(後者を知るには、通常はpg_settings
ビューで十分でしょう。)
By default, the <structname>pg_file_settings</structname> view can be read
only by superusers.
デフォルトで、pg_file_settings
ビューはスーパーユーザのみが参照可能です。
表52.7 pg_file_settings
の列
Column Type 列 型 Description 説明 |
---|
Full path name of the configuration file 設定ファイルの完全なパス名 |
Line number within the configuration file where the entry appears 設定ファイル内のエントリの行番号 |
Order in which the entries are processed (1..<replaceable>n</replaceable>)
エントリが処理される順序(1.. |
Configuration parameter name 設定パラメータ名 |
Value to be assigned to the parameter パラメータに代入される値 |
True if the value can be applied successfully trueの場合は、値が正しく適用可能 |
If not null, an error message indicating why this entry could not be applied NULLでないときは、このエントリが適用できない理由についてのエラーメッセージ |
If the configuration file contains syntax errors or invalid parameter
names, the server will not attempt to apply any settings from it, and
therefore all the <structfield>applied</structfield> fields will read as false.
In such a case there will be one or more rows with
non-null <structfield>error</structfield> fields indicating the
problem(s). Otherwise, individual settings will be applied if possible.
If an individual setting cannot be applied (e.g., invalid value, or the
setting cannot be changed after server start) it will have an appropriate
message in the <structfield>error</structfield> field. Another way that
an entry might have <structfield>applied</structfield> = false is that it is
overridden by a later entry for the same parameter name; this case is not
considered an error so nothing appears in
the <structfield>error</structfield> field.
設定ファイルに構文エラーや不正なパラメータ名がある場合、サーバはファイル内の設定をまったく適用せず、すべてのapplied
フィールドはfalseになります。
このような場合は、error
フィールドが非NULLで問題を示唆する行が1行以上あるでしょう。
それ以外の場合は、個々の設定は可能であれば適用されます。
個々の設定が適用できない場合(例えば、不正な値、サーバの起動後は設定が変更できないなど)はerror
フィールドに適切なメッセージがあります。
エントリのapplied
= falseになる別の理由は、同じパラメータがそれより後のエントリで上書きされている場合です。
この場合はエラーとはみなされませんので、error
フィールドには何も表示されません。
See <xref linkend="config-setting"/> for more information about the various ways to change run-time parameters. 実行時パラメータを変更する様々な方法について、詳しくは19.1を参照してください。