バージョンごとのドキュメント一覧

52.7. 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の列

<title><structname>pg_file_settings</structname> Columns</title>

Column Type 列 型

Description 説明

sourcefile text

Full path name of the configuration file 設定ファイルの完全なパス名

sourceline int4

Line number within the configuration file where the entry appears 設定ファイル内のエントリの行番号

seqno int4

Order in which the entries are processed (1..<replaceable>n</replaceable>) エントリが処理される順序(1..n

name text

Configuration parameter name 設定パラメータ名

setting text

Value to be assigned to the parameter パラメータに代入される値

applied bool

True if the value can be applied successfully trueの場合は、値が正しく適用可能

error text

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を参照してください。