client_min_messages
(enum
)
#
Controls which
<link linkend="runtime-config-severity-levels">message levels</link>
are sent to the client.
Valid values are <literal>DEBUG5</literal>,
<literal>DEBUG4</literal>, <literal>DEBUG3</literal>, <literal>DEBUG2</literal>,
<literal>DEBUG1</literal>, <literal>LOG</literal>, <literal>NOTICE</literal>,
<literal>WARNING</literal>, and <literal>ERROR</literal>.
Each level includes all the levels that follow it. The later the level,
the fewer messages are sent. The default is
<literal>NOTICE</literal>. Note that <literal>LOG</literal> has a different
rank here than in <xref linkend="guc-log-min-messages"/>.
どのメッセージレベルをクライアントに送るかを管理します。有効な値は、DEBUG5
、DEBUG4
、DEBUG3
、DEBUG2
、DEBUG1
、LOG
、NOTICE
、WARNING
およびERROR
です。
それぞれのレベルはそれに続く全てのレベルを包含します。
レベルが後の方になるにつれ、より少ないメッセージが送られます。
デフォルトはNOTICE
です。
ここでのLOG
の優先順位がlog_min_messagesの場合と異なることに注意してください。
<literal>INFO</literal> level messages are always sent to the client.
INFO
レベルのメッセージは常にクライアントに送られます。
search_path
(string
)
#This variable specifies the order in which schemas are searched when an object (table, data type, function, etc.) is referenced by a simple name with no schema specified. When there are objects of identical names in different schemas, the one found first in the search path is used. An object that is not in any of the schemas in the search path can only be referenced by specifying its containing schema with a qualified (dotted) name. この変数は、オブジェクト(テーブル、データ型、関数など)がスキーマを指定されていない単純な名前で参照されている場合に、スキーマを検索する順番を指定します。 異なるスキーマに同じ名前のオブジェクトがある場合、検索パスで最初に見つかったものが使用されます。 検索パス内のどのスキーマにも存在しないオブジェクトを参照するには、修飾名(ドット付き)でそのオブジェクトが含まれるスキーマを指定する必要があります。
The value for <varname>search_path</varname> must be a comma-separated
list of schema names. Any name that is not an existing schema, or is
a schema for which the user does not have <literal>USAGE</literal>
permission, is silently ignored.
search_path
の値は、スキーマの名前をカンマで区切った一覧でなければなりません。
存在していないスキーマ、またはユーザがUSAGE
権限を所有していないスキーマは警告なしに無視されます。
If one of the list items is the special name
<literal>$user</literal>, then the schema having the name returned by
<function>CURRENT_USER</function> is substituted, if there is such a schema
and the user has <literal>USAGE</literal> permission for it.
(If not, <literal>$user</literal> is ignored.)
もしそのようなスキーマが存在し、ユーザがそれにたいしてUSAGE
権限を所有している場合、一覧内の項目の1つが特別な名前である$user
の場合、CURRENT_USER
と同じ名前を持つスキーマがあれば、そのスキーマが置換されます。
(このような名前空間がない場合は$user
は無視されます。)
The system catalog schema, <literal>pg_catalog</literal>, is always
searched, whether it is mentioned in the path or not. If it is
mentioned in the path then it will be searched in the specified
order. If <literal>pg_catalog</literal> is not in the path then it will
be searched <emphasis>before</emphasis> searching any of the path items.
システムカタログのスキーマであるpg_catalog
は、パスでの指定の有無にかかわらず、常に検索されます。
パスで指定されている場合は、指定された順序で検索されます。
pg_catalog
がパスに含まれていない場合、パスに含まれる項目を検索する前に検索が行われます
Likewise, the current session's temporary-table schema,
<literal>pg_temp_<replaceable>nnn</replaceable></literal>, is always searched if it
exists. It can be explicitly listed in the path by using the
alias <literal>pg_temp</literal><indexterm><primary>pg_temp</primary></indexterm>. If it is not listed in the path then
it is searched first (even before <literal>pg_catalog</literal>). However,
the temporary schema is only searched for relation (table, view,
sequence, etc.) and data type names. It is never searched for
function or operator names.
同様に、現在のセッションの一時テーブルスキーマpg_temp_
も、存在すれば常に検索されます。
これはnnn
pg_temp
という別名を使用してパスに明示的に列挙させることができます。
パスに列挙されていない場合、最初に(pg_catalog
よりも前であっても)検索されます。
しかし、一時スキーマはリレーション(テーブル、ビュー、シーケンスなど)とデータ型名に対してのみ検索されます。
関数や演算子名に対してはまったく検索されません。
When objects are created without specifying a particular target
schema, they will be placed in the first valid schema named in
<varname>search_path</varname>. An error is reported if the search
path is empty.
対象となる特定のスキーマを指定せずにオブジェクトが作成された場合、それらのオブジェクトはsearch_path
で名前を付けられた最初に有効となっているスキーマに配置されます。
検索パスが空の場合、エラーが報告されます。
The default value for this parameter is
<literal>"$user", public</literal>.
This setting supports shared use of a database (where no users
have private schemas, and all share use of <literal>public</literal>),
private per-user schemas, and combinations of these. Other
effects can be obtained by altering the default search path
setting, either globally or per-user.
このパラメータのデフォルト値は"$user", public
です。
この設定はデータベースの共有(どのユーザも非公開のスキーマを持たず、全員がpublic
を共有)、ユーザごとの非公開のスキーマ、およびこれらの組み合わせがサポートします。
デフォルトの検索パスの設定を全体的またはユーザごとに変更することで、その他の効果を得ることもできます。
For more information on schema handling, see <xref linkend="ddl-schemas"/>. In particular, the default configuration is suitable only when the database has a single user or a few mutually-trusting users. スキーマの扱いについての詳細は、5.10をご覧ください。 とりわけ、デフォルトの設定はデータベースのユーザが、一人あるいはお互いに信頼できる少数のユーザだけである場合にのみ適切です。
The current effective value of the search path can be examined
via the <acronym>SQL</acronym> function
<function>current_schemas</function>
(see <xref linkend="functions-info"/>).
This is not quite the same as
examining the value of <varname>search_path</varname>, since
<function>current_schemas</function> shows how the items
appearing in <varname>search_path</varname> were resolved.
SQL関数のcurrent_schemas
によって、検索パスの現在の有効な値を調べることができます(9.27を参照してください)。
これは、search_path
の値を調べるのとは異なります。
current_schemas
は、search_path
に現れる項目がどのように解決されたかを表すからです。
row_security
(boolean
)
#
This variable controls whether to raise an error in lieu of applying a
row security policy. When set to <literal>on</literal>, policies apply
normally. When set to <literal>off</literal>, queries fail which would
otherwise apply at least one policy. The default is <literal>on</literal>.
Change to <literal>off</literal> where limited row visibility could cause
incorrect results; for example, <application>pg_dump</application> makes that
change by default. This variable has no effect on roles which bypass
every row security policy, to wit, superusers and roles with
the <literal>BYPASSRLS</literal> attribute.
この設定値は、行セキュリティポリシーの適用によってエラーを生じさせるかどうかを制御します。
on
に設定すると、通常通りポリシーが適用されます。
off
にすると、少なくともひとつのポリシーが適用されたクエリは失敗します。
デフォルトはon
です。
行の可視性が制限されている場合、off
にすると不正な結果を招くことがあります。
たとえば、pg_dumpはデフォルトでoff
にしています。
この設定値は、行セキュリティポリシーを迂回するロールには効果がありません。
それはすなわち、BYPASSRLS
アトリビュートを持つスーパーユーザです。
For more information on row security policies, see <xref linkend="sql-createpolicy"/>. 行セキュリティポリシーについての更なる情報はCREATE POLICYをご覧ください。
default_table_access_method
(string
)
#
This parameter specifies the default table access method to use when
creating tables or materialized views if the <command>CREATE</command>
command does not explicitly specify an access method, or when
<command>SELECT ... INTO</command> is used, which does not allow
specifying a table access method. The default is <literal>heap</literal>.
このパラメータは、テーブルあるいはマテリアライズドビューの作成時にCREATE
コマンドが明示的にアクセスメソッドを指定しないか、あるいはテーブルアクセスメソッドを指定できないSELECT ... INTO
が利用された時に使われるデフォルトのテーブルアクセスメソッドを指定します。
デフォルトはheap
です。
default_tablespace
(string
)
#
This variable specifies the default tablespace in which to create
objects (tables and indexes) when a <command>CREATE</command> command does
not explicitly specify a tablespace.
この変数は、CREATE
コマンドで明示的にテーブル空間を指定していない場合にオブジェクト(テーブルとインデックス)の作成先となるデフォルトのテーブル空間を指定します。
The value is either the name of a tablespace, or an empty string
to specify using the default tablespace of the current database.
If the value does not match the name of any existing tablespace,
<productname>PostgreSQL</productname> will automatically use the default
tablespace of the current database. If a nondefault tablespace
is specified, the user must have <literal>CREATE</literal> privilege
for it, or creation attempts will fail.
値はテーブル空間名、もしくは現在のデータベースのデフォルトのテーブル空間を使用することを意味する空文字列です。
この値が既存のテーブル空間名と一致しない場合、PostgreSQLは自動的に現在のデータベースのデフォルトのテーブル空間を使用します。
デフォルト以外のテーブル空間が指定された場合、ユーザはそのテーブル空間でCREATE
権限を持たなければなりません。
さもなくば作成に失敗します。
This variable is not used for temporary tables; for them, <xref linkend="guc-temp-tablespaces"/> is consulted instead. この変数は一時テーブル向けには使用されません。 一時テーブル向けには代わりにtemp_tablespacesが考慮されます。
This variable is also not used when creating databases. By default, a new database inherits its tablespace setting from the template database it is copied from. また、この変数はデータベース作成時には使用されません。 デフォルトでは、新しいデータベースはコピー元のテンプレートデータベースからテーブル空間の設定を引き継ぎます。
If this parameter is set to a value other than the empty string
when a partitioned table is created, the partitioned table's
tablespace will be set to that value, which will be used as
the default tablespace for partitions created in the future,
even if <varname>default_tablespace</varname> has changed since then.
パーティションテーブルが作られたときにこのパラメータが空文字以外に設定されていると、default_tablespace
がその後変更されたとしても、パーティションテーブルのテーブル空間はその値になり、今後作られるパーティションのデフォルトテーブル空間として使われます。
For more information on tablespaces, see <xref linkend="manage-ag-tablespaces"/>. テーブル空間に付いてより詳細な情報は22.6を参照してください。
default_toast_compression
(enum
)
#
This variable sets the default
<link linkend="storage-toast">TOAST</link>
compression method for values of compressible columns.
(This can be overridden for individual columns by setting
the <literal>COMPRESSION</literal> column option in
<command>CREATE TABLE</command> or
<command>ALTER TABLE</command>.)
The supported compression methods are <literal>pglz</literal> and
(if <productname>PostgreSQL</productname> was compiled with
<option>--with-lz4</option>) <literal>lz4</literal>.
The default is <literal>pglz</literal>.
この変数は圧縮可能な列の値のデフォルトTOAST圧縮方式を設定します。
(これはCREATE TABLE
あるいはALTER TABLE
のCOMPRESSION
列オプションを設定することにより、置き換えることができます。)
サポートされている圧縮方式は、pglz
とlz4
(PostgreSQLが--with-lz4
でコンパイルされている場合)です。
デフォルトはpglz
です。
temp_tablespaces
(string
)
#
This variable specifies tablespaces in which to create temporary
objects (temp tables and indexes on temp tables) when a
<command>CREATE</command> command does not explicitly specify a tablespace.
Temporary files for purposes such as sorting large data sets
are also created in these tablespaces.
この変数は、CREATE
コマンドで明示的にテーブル空間が指定されない場合に、生成する一時オブジェクト(一時テーブルと一時テーブル上のインデックス)を格納するテーブル空間(複数可)を指定します。
大規模データ集合のソートなどを目的とした一時ファイルもまた、このテーブル空間(複数可)に作成されます。
The value is a list of names of tablespaces. When there is more than one name in the list, <productname>PostgreSQL</productname> chooses a random member of the list each time a temporary object is to be created; except that within a transaction, successively created temporary objects are placed in successive tablespaces from the list. If the selected element of the list is an empty string, <productname>PostgreSQL</productname> will automatically use the default tablespace of the current database instead. この値はテーブル空間名のリストです。 リストに複数の名前が存在する場合、一時オブジェクトが作成される度にPostgreSQLは無作為にリストから要素を選択します。 トランザクションの内側は例外で、連続して作成される一時オブジェクトはそのリストで連続するテーブル空間に格納されます。 リスト内の選択された要素が空文字列だった場合、PostgreSQLは自動的に現在のデータベースのデフォルトのテーブル空間を代わりに使用します。
When <varname>temp_tablespaces</varname> is set interactively, specifying a
nonexistent tablespace is an error, as is specifying a tablespace for
which the user does not have <literal>CREATE</literal> privilege. However,
when using a previously set value, nonexistent tablespaces are
ignored, as are tablespaces for which the user lacks
<literal>CREATE</literal> privilege. In particular, this rule applies when
using a value set in <filename>postgresql.conf</filename>.
temp_tablespaces
を対話式に設定する場合、存在しないテーブル空間を指定するとエラーになります。
ユーザがCREATE
権限を持たないテーブル空間を指定した場合も同様です。
しかし事前に設定された値を使用する場合、存在しないテーブル空間は無視されます。
ユーザがCREATE
権限を持たないテーブル空間も同様です。
具体的には、この規則はpostgresql.conf
内で設定した値を使用する場合に適用されます。
The default value is an empty string, which results in all temporary objects being created in the default tablespace of the current database. デフォルト値は空文字列です。 この結果、すべての一時オブジェクトは現在のデータベースのデフォルトのテーブル空間内に作成されます。
See also <xref linkend="guc-default-tablespace"/>. default_tablespaceも参照してください
check_function_bodies
(boolean
)
#
This parameter is normally on. When set to <literal>off</literal>, it
disables validation of the routine body string during <xref
linkend="sql-createfunction"/> and <xref
linkend="sql-createprocedure"/>. Disabling validation avoids side
effects of the validation process, in particular preventing false
positives due to problems such as forward references.
Set this parameter
to <literal>off</literal> before loading functions on behalf of other
users; <application>pg_dump</application> does so automatically.
このパラメータは通常オンです。
off
に設定すると、CREATE FUNCTIONとCREATE PROCEDUREの実行中の関数本体文字列の妥当性検証を無効にします。
妥当性検証を無効にするとその妥当性検証処理の副作用を避け、前方参照による問題から起こる偽陽性(false positive)を避けることができます。
関数をロードする前にこのパラメータを他のユーザとしてoff
にします。
pg_dumpはこれを自動的に行います。
default_transaction_isolation
(enum
)
#Each SQL transaction has an isolation level, which can be either <quote>read uncommitted</quote>, <quote>read committed</quote>, <quote>repeatable read</quote>, or <quote>serializable</quote>. This parameter controls the default isolation level of each new transaction. The default is <quote>read committed</quote>. SQLトランザクションはそれぞれ、「read uncommitted」、「read committed」、「repeatable read」、または「serializable」のいずれかの分離レベルを持ちます。 このパラメータは各新規トランザクションのデフォルトの分離レベルを制御します。 デフォルトは「read committed」です。
Consult <xref linkend="mvcc"/> and <xref linkend="sql-set-transaction"/> for more information. より詳細は 第13章 および SET TRANSACTION を調べてください。
default_transaction_read_only
(boolean
)
#
A read-only SQL transaction cannot alter non-temporary tables.
This parameter controls the default read-only status of each new
transaction. The default is <literal>off</literal> (read/write).
読み取り専用のSQLトランザクションでは、非一時的テーブルを変更することができません。
このパラメータは、各新規トランザクションのデフォルトの読み取りのみ状況を制御します。
デフォルトoff
(読み書き)です。
Consult <xref linkend="sql-set-transaction"/> for more information. より詳細な情報はSET TRANSACTIONを調べてください。
default_transaction_deferrable
(boolean
)
#
When running at the <literal>serializable</literal> isolation level,
a deferrable read-only SQL transaction may be delayed before
it is allowed to proceed. However, once it begins executing
it does not incur any of the overhead required to ensure
serializability; so serialization code will have no reason to
force it to abort because of concurrent updates, making this
option suitable for long-running read-only transactions.
シリアライザブル
分離レベルで運用されている場合、繰り延べ読み取り専用SQLトランザクションは、その処理の許可の前に遅延されることがあります。
しかし、ひとたび処理が開始されるとシリアライザブル可能性を保障するために必要ないかなるオーバーヘッドも発生させません。
従って、シリアル化(直列化)のコードは、このオプションを長期間にわたる読み取り専用トランザクションに対して適切な処置と位置づけ、同時実行の更新の観点から中断を強制する理由はありません。
This parameter controls the default deferrable status of each
new transaction. It currently has no effect on read-write
transactions or those operating at isolation levels lower
than <literal>serializable</literal>. The default is <literal>off</literal>.
このパラメータはそれぞれの新規トランザクションのデフォルトでの繰り延べ状態を制御します。
現時点では、読み取り専用トランザクション、またはシリアライザブル
より低位の分離レベルの運用に対して効果はありません。
デフォルトはoff
です。
Consult <xref linkend="sql-set-transaction"/> for more information. より詳細はSET TRANSACTIONを参照してください。
transaction_isolation
(enum
)
#This parameter reflects the current transaction's isolation level. At the beginning of each transaction, it is set to the current value of <xref linkend="guc-default-transaction-isolation"/>. Any subsequent attempt to change it is equivalent to a <xref linkend="sql-set-transaction"/> command. このパラメータは現在のトランザクションの隔離レベルを反映します。 個々のトランザクションの開始時、これにdefault_transaction_isolationの現在の値が設定されます。 その後のこの変数の値を変更する試みは、SET TRANSACTIONと同等です。
transaction_read_only
(boolean
)
#This parameter reflects the current transaction's read-only status. At the beginning of each transaction, it is set to the current value of <xref linkend="guc-default-transaction-read-only"/>. Any subsequent attempt to change it is equivalent to a <xref linkend="sql-set-transaction"/> command. このパラメータは現在のトランザクションの読み込み専用状態を反映します。 個々のトランザクションの開始時、これにdefault_transaction_read_onlyの現在の値が設定されます。 その後のこの変数の値を変更する試みは、SET TRANSACTIONと同等です。
transaction_deferrable
(boolean
)
#This parameter reflects the current transaction's deferrability status. At the beginning of each transaction, it is set to the current value of <xref linkend="guc-default-transaction-deferrable"/>. Any subsequent attempt to change it is equivalent to a <xref linkend="sql-set-transaction"/> command. このパラメータは現在のトランザクションの延期状態(deferrable status)を反映します。 個々のトランザクションの開始時、これにdefault_transaction_deferrableの現在の値が設定されます。 その後のこの変数の値を変更する試みは、SET TRANSACTIONと同等です。
session_replication_role
(enum
)
#
Controls firing of replication-related triggers and rules for the
current session.
Possible values are <literal>origin</literal> (the default),
<literal>replica</literal> and <literal>local</literal>.
Setting this parameter results in discarding any previously cached
query plans.
Only superusers and users with the appropriate <literal>SET</literal>
privilege can change this setting.
現在のセッションに対するレプリケーション関連のトリガおよびルールの起動を制御します。
使用可能な値は、origin
(デフォルト)、replica
およびlocal
です。
このパラメータを設定すると、以前にキャッシュされた問合せ計画が破棄されます。
スーパーユーザおよび適切なSET
権限を持つユーザのみがこの設定を変更できます。
The intended use of this setting is that logical replication systems
set it to <literal>replica</literal> when they are applying replicated
changes. The effect of that will be that triggers and rules (that
have not been altered from their default configuration) will not fire
on the replica. See the <link linkend="sql-altertable"><command>ALTER TABLE</command></link> clauses
<literal>ENABLE TRIGGER</literal> and <literal>ENABLE RULE</literal>
for more information.
この設定の使い方の趣旨としては、レプリケーションされた更新を適用する際にロジカルレプリケーションシステムがreplica
に設定するということです。
このことによる効果としては、(デフォルトの設定から変更されていない)トリガとルールはレプリカ上では起動されない、ということです。
更なる情報は、ALTER TABLE
節のENABLE TRIGGER
とENABLE RULE
をご覧ください。
PostgreSQL treats the settings <literal>origin</literal> and
<literal>local</literal> the same internally. Third-party replication
systems may use these two values for their internal purposes, for
example using <literal>local</literal> to designate a session whose
changes should not be replicated.
PostgreSQLはorigin
とlocal
の設定を内部的に同じものとして扱います。
サードパーティのレプリケーションシステムは内部的な目的、たとえばlocal
を使ってレプリケーションされるべきでないセッションを指定するためにこれら2つの値を使って構いません。
Since foreign keys are implemented as triggers, setting this parameter
to <literal>replica</literal> also disables all foreign key checks,
which can leave data in an inconsistent state if improperly used.
外部キーはトリガとして実装されているため、このパラメータをreplica
とすることによって同時にすべての外部キー検査が無効になります。
このことにより、正しく使用しないと、データを不整合状態にしてしまう可能性があります。
statement_timeout
(integer
)
#
Abort any statement that takes more than the specified amount of time.
If <varname>log_min_error_statement</varname> is set
to <literal>ERROR</literal> or lower, the statement that timed out
will also be logged.
If this value is specified without units, it is taken as milliseconds.
A value of zero (the default) disables the timeout.
コマンドがクライアントからサーバに届いた時から数えて、実行時間が指定された時間を越えた文を停止します。
log_min_error_statement
がERROR
もしくはそれ以下に設定されている場合は、タイムアウトした文はログに書き込まれます。
この値が単位なしで指定された場合は、ミリ秒単位であるとみなします。
値がゼロ(デフォルト)の場合、これを無効にします。
The timeout is measured from the time a command arrives at the server until it is completed by the server. If multiple SQL statements appear in a single simple-query message, the timeout is applied to each statement separately. (<productname>PostgreSQL</productname> versions before 13 usually treated the timeout as applying to the whole query string.) In extended query protocol, the timeout starts running when any query-related message (Parse, Bind, Execute, Describe) arrives, and it is canceled by completion of an Execute or Sync message. タイムアウトは、コマンドがサーバに到着したときから、サーバがそのコマンドの実行を完了するまでを基準にします。 複数のSQL文が一つの単純問い合わせメッセージに含まれる場合、タイムアウトは個々のSQL文に別々に適用されます。 (13よりも前のPostgreSQLバージョンでは、通常SQL文字列全体に対してタイムアウトが適用されていました。) 拡張問い合わせでは、タイムアウトは問い合わせに関するメッセージ(Parse、Bind、Execute、Describe)が到着したときに開始し、ExecuteあるいはSyncメッセージが完了した時にキャンセルされます。
Setting <varname>statement_timeout</varname> in
<filename>postgresql.conf</filename> is not recommended because it would
affect all sessions.
すべてのセッションに影響することがあるので、postgresql.conf
内でstatement_timeout
を設定することは推奨されません。
transaction_timeout
(integer
)
#
Terminate any session that spans longer than the specified amount of
time in a transaction. The limit applies both to explicit transactions
(started with <command>BEGIN</command>) and to an implicitly started
transaction corresponding to a single statement.
If this value is specified without units, it is taken as milliseconds.
A value of zero (the default) disables the timeout.
トランザクションが指定された時間を超えていた場合に、このセッションを終了します。
この時間制限は、明示的なトランザクション(BEGIN
で開始)と、単一の文に対応する暗黙的に開始されたトランザクションの両方に適用されます。
この値が単位なしで指定された場合は、ミリ秒単位であるとみなします。
値がゼロ(デフォルト)の場合はタイムアウトは無効になります。
If <varname>transaction_timeout</varname> is shorter or equal to
<varname>idle_in_transaction_session_timeout</varname> or <varname>statement_timeout</varname>
then the longer timeout is ignored.
transaction_timeout
がidle_in_transaction_session_timeout
またはstatement_timeout
より短いか、等しい場合、長い方のタイムアウトは無視されます。
Setting <varname>transaction_timeout</varname> in
<filename>postgresql.conf</filename> is not recommended because it would
affect all sessions.
すべてのセッションに影響することがあるので、postgresql.conf
内でtransaction_timeout
を設定することは推奨されません。
Prepared transactions are not subject to this timeout. 準備されたトランザクションには、このタイムアウトは影響ありません。
lock_timeout
(integer
)
#
Abort any statement that waits longer than the specified amount of
time while attempting to acquire a lock on a table, index,
row, or other database object. The time limit applies separately to
each lock acquisition attempt. The limit applies both to explicit
locking requests (such as <command>LOCK TABLE</command>, or <command>SELECT
FOR UPDATE</command> without <literal>NOWAIT</literal>) and to implicitly-acquired
locks.
If this value is specified without units, it is taken as milliseconds.
A value of zero (the default) disables the timeout.
テーブル、インデックス、行、またはその他のデータベースオブジェクトに対してロック獲得を試みている最中、指定された時間を超えて待機するいかなる命令も停止されます。
時間制限はそれぞれのロック取得の試みに対し個別に適用されます。
制限は明示的ロック要求(例えばLOCK TABLE
、またはSELECT FOR UPDATE
without NOWAIT
など)および暗黙的に取得されるロックに適用されます。
この値が単位なしで指定された場合は、ミリ秒単位であるとみなします。
値ゼロ(デフォルト)はこの機能を無効にします。
Unlike <varname>statement_timeout</varname>, this timeout can only occur
while waiting for locks. Note that if <varname>statement_timeout</varname>
is nonzero, it is rather pointless to set <varname>lock_timeout</varname> to
the same or larger value, since the statement timeout would always
trigger first. If <varname>log_min_error_statement</varname> is set to
<literal>ERROR</literal> or lower, the statement that timed out will be
logged.
statement_timeout
と異なり、このタイムアウトはロックを待機しているときのみ発生します。
命令によるタイムアウトは常に第一に起動されるため、もしstatement_timeout
が非ゼロであればlock_timeout
を同一、もしくはより大きい値に設定するのは的を射ていません。
log_min_error_statement
がERROR
またはそれより低く設定されると、時間制限を超えた命令はログに記録されます。
Setting <varname>lock_timeout</varname> in
<filename>postgresql.conf</filename> is not recommended because it would
affect all sessions.
lock_timeout
をpostgresql.conf
にて設定することは、すべてのセッションに影響を与える可能性があるため推奨されません。
idle_in_transaction_session_timeout
(integer
)
#Terminate any session that has been idle (that is, waiting for a client query) within an open transaction for longer than the specified amount of time. If this value is specified without units, it is taken as milliseconds. A value of zero (the default) disables the timeout. 開いているトランザクションが、指定された時間を超えてアイドルだった場合(つまりクライアントからの問い合わせを待っている場合)に、セッションを終了します。 この値が単位なしで指定された場合は、ミリ秒単位であるとみなします。 値がゼロ(デフォルト)の場合はタイムアウトは無効になります。
This option can be used to ensure that idle sessions do not hold locks for an unreasonable amount of time. Even when no significant locks are held, an open transaction prevents vacuuming away recently-dead tuples that may be visible only to this transaction; so remaining idle for a long time can contribute to table bloat. See <xref linkend="routine-vacuuming"/> for more details. このオプションにより、アイドル状態のセッションが不合理なほど長い時間ロックを保持することを防ぐことができます。 強いロックが保持されていなくても、開いたトランザクションは、自分にしか可視でない、最近無効になったタプルをvacuumが掃除するのを妨げます。 ですから、長時間アイドルのままになっていると、テーブルの溢れにつながります。 更なる詳細は24.1を見てください。
idle_session_timeout
(integer
)
#Terminate any session that has been idle (that is, waiting for a client query), but not within an open transaction, for longer than the specified amount of time. If this value is specified without units, it is taken as milliseconds. A value of zero (the default) disables the timeout. トランザクションが開いた状態ではなく、指定した時間よりも長い時間アイドル(すなわちクライアントからの問い合わせを待っている)であるセッションを終了させます。 この値が単位なしで指定された場合は、ミリ秒単位であるとみなします。 値ゼロ(デフォルトです)はタイムアウトを無効にします。
Unlike the case with an open transaction, an idle session without a
transaction imposes no large costs on the server, so there is less
need to enable this timeout
than <varname>idle_in_transaction_session_timeout</varname>.
開いたトランザクションの場合と違って、トランザクションを伴わないアイドルなセッションは、サーバに対して大きなコストにはなりません。
ですからこのタイムアウトを有効にする必要性は、idle_in_transaction_session_timeout
よりも低いと言えます。
Be wary of enforcing this timeout on connections made through connection-pooling software or other middleware, as such a layer may not react well to unexpected connection closure. It may be helpful to enable this timeout only for interactive sessions, perhaps by applying it only to particular users. コネクションプーリングソフトウェアその他のミドルウェアを通じたコネクションに対してこのタイムアウトを強制することには慎重になってください。 そのようなレイヤは、突然のコネクション切断に対して好ましくない振る舞いをするかもしれないからです。 おそらく特定のユーザに対してのみ適用し、対話形式のセッションに対してのみこのタイムアウトを有効にするのが助けになるかもしれません。
vacuum_freeze_table_age
(integer
)
#
<command>VACUUM</command> performs an aggressive scan if the table's
<structname>pg_class</structname>.<structfield>relfrozenxid</structfield> field has reached
the age specified by this setting. An aggressive scan differs from
a regular <command>VACUUM</command> in that it visits every page that might
contain unfrozen XIDs or MXIDs, not just those that might contain dead
tuples. The default is 150 million transactions. Although users can
set this value anywhere from zero to two billion, <command>VACUUM</command>
will silently limit the effective value to 95% of
<xref linkend="guc-autovacuum-freeze-max-age"/>, so that a
periodic manual <command>VACUUM</command> has a chance to run before an
anti-wraparound autovacuum is launched for the table. For more
information see
<xref linkend="vacuum-for-wraparound"/>.
テーブルのpg_class
.relfrozenxid
フィールドがこの設定で指定した時期に達すると、VACUUM
は積極的なテーブルスキャンを行います。
積極的なスキャンは、無効タプルを含む可能性のあるページだけではなく、凍結されていないXIDあるいはMXIDを含むすべてのページを読む点で通常のVACUUM
とは異なります。
デフォルトは1.5億トランザクションです。
ユーザはこの値をゼロから20億までの任意の値に設定することができますが、VACUUM
は警告することなく、周回問題対策のautovacuumがテーブルに対して起動する前に定期的な手動VACUUM
が実行する機会を持つように、autovacuum_freeze_max_ageの95%に実効値を制限します。
詳細は24.1.5を参照してください。
vacuum_freeze_min_age
(integer
)
#
Specifies the cutoff age (in transactions) that
<command>VACUUM</command> should use to decide whether to
trigger freezing of pages that have an older XID.
The default is 50 million transactions. Although
users can set this value anywhere from zero to one billion,
<command>VACUUM</command> will silently limit the effective value to half
the value of <xref linkend="guc-autovacuum-freeze-max-age"/>, so
that there is not an unreasonably short time between forced
autovacuums. For more information see <xref
linkend="vacuum-for-wraparound"/>.
VACUUM
が、古いXIDを持つページをフリーズするきっかけとするかどうかを決定する、カットオフ年代を(トランザクション単位で)指定します。
デフォルトは5千万トランザクションです。
ユーザはこの値を0から10億までの間で任意の値に設定することができますが、VACUUM
は警告なくautovacuum_freeze_max_ageの半分までの値に値を制限します。
このため、強制的なautovacuumの間隔が不合理に短くなることはありません。
詳細は24.1.5を参照してください。
vacuum_failsafe_age
(integer
)
#
Specifies the maximum age (in transactions) that a table's
<structname>pg_class</structname>.<structfield>relfrozenxid</structfield>
field can attain before <command>VACUUM</command> takes
extraordinary measures to avoid system-wide transaction ID
wraparound failure. This is <command>VACUUM</command>'s
strategy of last resort. The failsafe typically triggers
when an autovacuum to prevent transaction ID wraparound has
already been running for some time, though it's possible for
the failsafe to trigger during any <command>VACUUM</command>.
VACUUM
がシステム全体に渡るトランザクションID周回障害を避けるために異例の措置を取るようになる、テーブルのpg_class
.relfrozenxid
フィールドが到達する最大の(トランザクション数単位での)年齢を指定します。
これはVACUUM
の最後の手段となる戦略です。
この安全機構は典型的には、トランザクションID周回を防ぐための自動バキュームがすでに走っているときに起動されます。
しかし、すべてのVACUUM
の実行中にこの安全機構が起動する可能性があります。
When the failsafe is triggered, any cost-based delay that is
in effect will no longer be applied, further non-essential
maintenance tasks (such as index vacuuming) are bypassed, and any
<glossterm linkend="glossary-buffer-access-strategy">Buffer Access Strategy</glossterm>
in use will be disabled resulting in <command>VACUUM</command> being
free to make use of all of
<glossterm linkend="glossary-shared-memory">shared buffers</glossterm>.
この安全機構が起動すると、すべての有効なコストに基づく遅延はもはや適用されず、(インデックスのバキュームのような)必須ではない保守タスクは迂回されます。
使用中のバッファアクセスストラテジは無効になり、その結果VACUUM
は共有バッファのすべてを自由に使用することになります。
The default is 1.6 billion transactions. Although users can
set this value anywhere from zero to 2.1 billion,
<command>VACUUM</command> will silently adjust the effective
value to no less than 105% of <xref
linkend="guc-autovacuum-freeze-max-age"/>.
デフォルトは16億トランザクションです。
ユーザはこの値をゼロから21億までの間で設定できますが、VACUUM
はautovacuum_freeze_max_ageの105%よりも小さくならないように実際の値を調整します。
vacuum_multixact_freeze_table_age
(integer
)
#
<command>VACUUM</command> performs an aggressive scan if the table's
<structname>pg_class</structname>.<structfield>relminmxid</structfield> field has reached
the age specified by this setting. An aggressive scan differs from
a regular <command>VACUUM</command> in that it visits every page that might
contain unfrozen XIDs or MXIDs, not just those that might contain dead
tuples. The default is 150 million multixacts.
Although users can set this value anywhere from zero to two billion,
<command>VACUUM</command> will silently limit the effective value to 95% of
<xref linkend="guc-autovacuum-multixact-freeze-max-age"/>, so that a
periodic manual <command>VACUUM</command> has a chance to run before an
anti-wraparound is launched for the table.
For more information see <xref linkend="vacuum-for-multixact-wraparound"/>.
pg_class
.relminmxid
フィールドがこの設定値で指定した年代に達するとVACUUM
はテーブルの積極的なスキャンを行います。
積極的なスキャンは、無効タプルを含む可能性のあるページだけではなく、凍結XIDあるいはMXIDを含むすべてのページを読む点で通常のVACUUM
とは異なります。
デフォルトは1億5千万トランザクションです。
ユーザは0から20億まで任意の値を設定できますが、テーブルに対してラップアラウンド防止処理が起動される前に定期的な手動VACUUM
が走ることができるように、VACUUM
はautovacuum_multixact_freeze_max_ageの95%に暗黙的に制限します。
詳細は24.1.5.1をご覧ください。
vacuum_multixact_freeze_min_age
(integer
)
#
Specifies the cutoff age (in multixacts) that <command>VACUUM</command>
should use to decide whether to trigger freezing of pages with
an older multixact ID. The default is 5 million multixacts.
Although users can set this value anywhere from zero to one billion,
<command>VACUUM</command> will silently limit the effective value to half
the value of <xref linkend="guc-autovacuum-multixact-freeze-max-age"/>,
so that there is not an unreasonably short time between forced
autovacuums.
For more information see <xref linkend="vacuum-for-multixact-wraparound"/>.
VACUUM
がテーブルをスキャンする際に、ページを凍結するきっかけとするかどうかを決める下限値をマルチトランザクション単位で指定します。
デフォルトは500万マルチトランザクションです。
ユーザは0から10億まで任意の値を設定できますが、強制的な自動バキュームの間隔が短くなり過ぎないように、VACUUM
はautovacuum_multixact_freeze_max_ageの半分に暗黙的に実効的な値を制限します。
詳細は24.1.5.1をご覧ください。
vacuum_multixact_failsafe_age
(integer
)
#
Specifies the maximum age (in multixacts) that a table's
<structname>pg_class</structname>.<structfield>relminmxid</structfield>
field can attain before <command>VACUUM</command> takes
extraordinary measures to avoid system-wide multixact ID
wraparound failure. This is <command>VACUUM</command>'s
strategy of last resort. The failsafe typically triggers when
an autovacuum to prevent transaction ID wraparound has already
been running for some time, though it's possible for the
failsafe to trigger during any <command>VACUUM</command>.
VACUUM
がシステム全体マルチトランザクションID周回障害を避けるために異例の措置を取るようになる、テーブルのpg_class
.relminmxid
フィールドが到達する最大の(マルチトランザクション数単位での)年齢を指定します。
これはVACUUM
最後の手段となる戦略です。
この安全機構は典型的には、トランザクションID周回を防ぐための自動バキュームがすでに走っているときに起動されます。
しかし、すべてのVACUUM
の実行中にこの安全機構が起動する可能性があります。
When the failsafe is triggered, any cost-based delay that is in effect will no longer be applied, and further non-essential maintenance tasks (such as index vacuuming) are bypassed. この安全機構が起動すると、すべての有効なコストに基づく遅延はもはや適用されず、(インデックスのバキュームのような)必須ではない保守タスクは迂回されます。
The default is 1.6 billion multixacts. Although users can set
this value anywhere from zero to 2.1 billion,
<command>VACUUM</command> will silently adjust the effective
value to no less than 105% of <xref
linkend="guc-autovacuum-multixact-freeze-max-age"/>.
デフォルトは16億マルチトランザクションです。
ユーザはこの値をゼロから21億までの間で設定できますが、VACUUM
はautovacuum_multixact_freeze_max_ageの105%よりも小さくならないように実際の値を調整します。
bytea_output
(enum
)
#
Sets the output format for values of type <type>bytea</type>.
Valid values are <literal>hex</literal> (the default)
and <literal>escape</literal> (the traditional PostgreSQL
format). See <xref linkend="datatype-binary"/> for more
information. The <type>bytea</type> type always
accepts both formats on input, regardless of this setting.
bytea
型の値の出力形式を設定します。
有効な値はhex
(デフォルト)、およびescape
(PostgreSQLの伝統的な書式)です。
より詳細は8.4を参照してください。
bytea
型は常にこの設定に係わらず、入力時に双方の書式を受け付けます。
xmlbinary
(enum
)
#
Sets how binary values are to be encoded in XML. This applies
for example when <type>bytea</type> values are converted to
XML by the functions <function>xmlelement</function> or
<function>xmlforest</function>. Possible values are
<literal>base64</literal> and <literal>hex</literal>, which
are both defined in the XML Schema standard. The default is
<literal>base64</literal>. For further information about
XML-related functions, see <xref linkend="functions-xml"/>.
バイナリデータをXMLに符号化する方法を設定します。
例えばこれは、xmlelement
やxmlforest
関数でbytea
値をXMLに変換する際に適用されます。
取り得る値はbase64
とhex
です。
どちらもXMLスキーマ標準で定義されています。
デフォルトはbase64
です。
XMLに関連した関数については9.15を参照してください。
The actual choice here is mostly a matter of taste, constrained only by possible restrictions in client applications. Both methods support all possible values, although the hex encoding will be somewhat larger than the base64 encoding. 実のところこの選択はほとんど趣味の問題で、クライアントアプリケーションで起こり得る制限のみに制約されます。 どちらの方法もすべての値をサポートしますが、hex符号化方式はbase64符号化方式より少し大きくなります。
xmloption
(enum
)
#
Sets whether <literal>DOCUMENT</literal> or
<literal>CONTENT</literal> is implicit when converting between
XML and character string values. See <xref
linkend="datatype-xml"/> for a description of this. Valid
values are <literal>DOCUMENT</literal> and
<literal>CONTENT</literal>. The default is
<literal>CONTENT</literal>.
XMLと文字列値との変換時にDOCUMENT
とするかCONTENT
とするかを設定します。
この説明については8.13を参照してください。
有効な値はDOCUMENT
とCONTENT
です。
デフォルトはCONTENT
です。
According to the SQL standard, the command to set this option is 標準SQLに従うと、このオプションを設定するコマンドは以下のようになります。
SET XML OPTION { DOCUMENT | CONTENT };
This syntax is also available in PostgreSQL. この構文はPostgreSQLでも使用可能です。
gin_pending_list_limit
(integer
)
#
Sets the maximum size of a GIN index's pending list, which is used
when <literal>fastupdate</literal> is enabled. If the list grows
larger than this maximum size, it is cleaned up by moving
the entries in it to the index's main GIN data structure in bulk.
If this value is specified without units, it is taken as kilobytes.
The default is four megabytes (<literal>4MB</literal>). This setting
can be overridden for individual GIN indexes by changing
index storage parameters.
See <xref linkend="gin-fast-update"/> and <xref linkend="gin-tips"/>
for more information.
fastupdate
が有効なときに使用されるGINインデックスのペンディングリストの最大サイズを設定します。
リストがこの設定値よりも大きくなったら、エントリをインデックスのGINの主データ構造に一括転送してリストはクリアされます。
この値が単位なしで指定された場合は、キロバイト単位であるとみなします。
デフォルトは4メガバイト(4MB
)です。
この設定は、個々のGINインデックスに対してインデックスストレージパラメータを変更することにより、上書きできます。
更なる情報については、64.4.4.1と64.4.5を参照してください。
createrole_self_grant
(string
)
#
If a user who has <literal>CREATEROLE</literal> but not
<literal>SUPERUSER</literal> creates a role, and if this
is set to a non-empty value, the newly-created role will be granted
to the creating user with the options specified. The value must be
<literal>set</literal>, <literal>inherit</literal>, or a
comma-separated list of these. The default value is an empty string,
which disables the feature.
CREATEROLE
を持ち、SUPERUSER
を持たないユーザがロールを作成し、これが空でない値に設定されている場合、新しく作成されたロールは、この指定されたオプションを持ち、ロールを作成したユーザに付与されます。
値は、set
、inherit
、またはこれらのリストをカンマで区切ったものである必要があります。
デフォルト値は空の文字列であるため、この機能は無効になります。
The purpose of this option is to allow a <literal>CREATEROLE</literal>
user who is not a superuser to automatically inherit, or automatically
gain the ability to <literal>SET ROLE</literal> to, any created users.
Since a <literal>CREATEROLE</literal> user is always implicitly granted
<literal>ADMIN OPTION</literal> on created roles, that user could
always execute a <literal>GRANT</literal> statement that would achieve
the same effect as this setting. However, it can be convenient for
usability reasons if the grant happens automatically. A superuser
automatically inherits the privileges of every role and can always
<literal>SET ROLE</literal> to any role, and this setting can be used
to produce a similar behavior for <literal>CREATEROLE</literal> users
for users which they create.
このオプションの目的は、CREATEROLE
が許可されているスーパーユーザではないユーザが、作成されたユーザを自動的に継承するか、またはSET ROLE
権限を自動的に取得できるようにすることです。
CREATEROLE
ユーザは、作成されたロールに対して常に暗黙的にADMIN OPTION
が付与されるため、そのユーザは、この設定と同じ効果を達成するGRANT
文を常に実行できます。
しかし、権限付与が自動的に行われることは、使用上の理由から便利です。
スーパーユーザは、すべてのロールの権限を自動的に継承し、どのロールに対しても常にSET ROLE
できます。
また、この設定を使用して、CREATEROLE
ユーザが作成したユーザに対して同様の動作を生成できます。
event_triggers
(boolean
)
#
Allow temporarily disabling execution of event triggers in order to
troubleshoot and repair faulty event triggers. All event triggers will
be disabled by setting it to <literal>false</literal>. Setting the value
to <literal>true</literal> allows all event triggers to fire, this
is the default value. Only superusers and users with the appropriate
<literal>SET</literal> privilege can change this setting.
イベントトリガーの実行を一時的に無効化して、障害のあるイベントトリガーのトラブルシューティングおよび修復を可能にします。
false
に設定することですべてのイベントトリガーが無効になります。
値をtrue
に設定すると、すべてのイベントトリガーが起動します。
これがデフォルト値です。
スーパーユーザおよび適切なSET
権限を持つユーザのみがこの設定を変更できます。
restrict_nonsystem_relation_kind
(string
)
#
Set relation kinds for which access to non-system relations is prohibited.
The value takes the form of a comma-separated list of relation kinds.
Currently, the supported relation kinds are <literal>view</literal> and
<literal>foreign-table</literal>.
非システムリレーションへのアクセスが禁止されているリレーションの種類を設定します。
値は、カンマで区切られたリレーションの種類のリストのフォームを取ります。
現在サポートされているリレーション種別はview
とforeign-table
です。
DateStyle
(string
)
#
Sets the display format for date and time values, as well as the
rules for interpreting ambiguous date input values. For
historical reasons, this variable contains two independent
components: the output format specification (<literal>ISO</literal>,
<literal>Postgres</literal>, <literal>SQL</literal>, or <literal>German</literal>)
and the input/output specification for year/month/day ordering
(<literal>DMY</literal>, <literal>MDY</literal>, or <literal>YMD</literal>). These
can be set separately or together. The keywords <literal>Euro</literal>
and <literal>European</literal> are synonyms for <literal>DMY</literal>; the
keywords <literal>US</literal>, <literal>NonEuro</literal>, and
<literal>NonEuropean</literal> are synonyms for <literal>MDY</literal>. See
<xref linkend="datatype-datetime"/> for more information. The
built-in default is <literal>ISO, MDY</literal>, but
<application>initdb</application> will initialize the
configuration file with a setting that corresponds to the
behavior of the chosen <varname>lc_time</varname> locale.
日付時刻値の表示書式を設定し、曖昧な日付入力の解釈規則を設定します。
歴史的な理由により、この変数には2つの独立した要素が含まれています。
出力書式指定(ISO
、Postgres
、SQL
、German
)と年/月/日の順序の入出力指定(DMY
、MDY
、YMD
)です。
これらは分けて設定することもまとめて設定することもできます。
Euro
およびEuropean
キーワードはDMY
の同義語であり、US
、NonEuro
、NonEuropean
はMDY
の同義語です。
詳細は8.5を参照してください。
組み込みのデフォルトはISO, MDY
ですが、initdbにより、選択されたlc_time
ロケールの動作に対応した設定で設定ファイルが初期化されます。
IntervalStyle
(enum
)
#
Sets the display format for interval values.
The value <literal>sql_standard</literal> will produce
output matching <acronym>SQL</acronym> standard interval literals.
The value <literal>postgres</literal> (which is the default) will produce
output matching <productname>PostgreSQL</productname> releases prior to 8.4
when the <xref linkend="guc-datestyle"/>
parameter was set to <literal>ISO</literal>.
The value <literal>postgres_verbose</literal> will produce output
matching <productname>PostgreSQL</productname> releases prior to 8.4
when the <varname>DateStyle</varname>
parameter was set to non-<literal>ISO</literal> output.
The value <literal>iso_8601</literal> will produce output matching the time
interval <quote>format with designators</quote> defined in section
4.4.3.2 of ISO 8601.
間隔の値の表示形式を設定します。sql_standard
値は、標準SQL間隔リテラルに一致する出力を生成します。
(デフォルトの)値postgres
は、DateStyleパラメータがISO
に設定されている場合、リリース8.4以前のPostgreSQLに一致する出力を生成します。
値postgres_verbose
は、DateStyle
パラメータが非ISO
出力に設定されている場合、リリース8.4以前のPostgreSQLに一致する出力を生成します。
値iso_8601
は、ISO 8601の4.4.3.2節で定義されている時間間隔「format with designators」に一致する出力を生成します。
The <varname>IntervalStyle</varname> parameter also affects the
interpretation of ambiguous interval input. See
<xref linkend="datatype-interval-input"/> for more information.
またIntervalStyle
パラメータはあいまいに入力された時間間隔の解釈に影響を与えます。
詳細については8.5.4を参照してください。
TimeZone
(string
)
#
Sets the time zone for displaying and interpreting time stamps.
The built-in default is <literal>GMT</literal>, but that is typically
overridden in <filename>postgresql.conf</filename>; <application>initdb</application>
will install a setting there corresponding to its system environment.
See <xref linkend="datatype-timezones"/> for more information.
表示用およびタイムスタンプ解釈用の時間帯を設定します。
組み込まれているデフォルトはGMT
ですが、通常はpostgresql.conf
により上書きされます。initdbによりこれらと関連した設定をシステム環境にインストールされます。
詳細は8.5.3を参照してください。
timezone_abbreviations
(string
)
#
Sets the collection of time zone abbreviations that will be accepted
by the server for datetime input. The default is <literal>'Default'</literal>,
which is a collection that works in most of the world; there are
also <literal>'Australia'</literal> and <literal>'India'</literal>,
and other collections can be defined for a particular installation.
See <xref linkend="datetime-config-files"/> for more information.
サーバで日付時刻の入力として受付け可能となる時間帯省略形の集合を設定します。
デフォルトは'Default'
です。
これはほぼ全世界で通じる集合です。
また、Australia
、India
、その他特定のインストレーションで定義可能な集合が存在します。
詳細はB.4を参照してください。
extra_float_digits
(integer
)
#
This parameter adjusts the number of digits used for textual output of
floating-point values, including <type>float4</type>, <type>float8</type>,
and geometric data types.
このパラメータは、float4
、float8
、幾何データ型などにおいて、浮動小数点数値のテキスト形式の出力で使用される桁数を調整します。
If the value is 1 (the default) or above, float values are output in
shortest-precise format; see <xref linkend="datatype-float"/>. The
actual number of digits generated depends only on the value being
output, not on the value of this parameter. At most 17 digits are
required for <type>float8</type> values, and 9 for <type>float4</type>
values. This format is both fast and precise, preserving the original
binary float value exactly when correctly read. For historical
compatibility, values up to 3 are permitted.
この値が1(デフォルト)あるいはそれ以上なら、浮動小数点数値の出力は最も短い精度の形式で出力されます。
8.1.3を参照してください。
生成される実際の桁数は出力される値にのみ依存します。
float8
値では最大でも17桁、float4
値では最大9桁必要です。
この形式は高速かつ高精度で、正しく読まれる際には元の2進数における浮動小数点値を正確に保存します。
歴史的な互換性の理由により、3までの値が許容されています。
If the value is zero or negative, then the output is rounded to a
given decimal precision. The precision used is the standard number of
digits for the type (<literal>FLT_DIG</literal>
or <literal>DBL_DIG</literal> as appropriate) reduced according to the
value of this parameter. (For example, specifying -1 will cause
<type>float4</type> values to be output rounded to 5 significant
digits, and <type>float8</type> values
rounded to 14 digits.) This format is slower and does not preserve all
the bits of the binary float value, but may be more human-readable.
この値がゼロまたは負なら、出力は与えられた10進精度に丸められます。
使用される精度は、各々の型の標準的の桁数(型に応じてFLT_DIG
あるいはDBL_DIG
)がこのパラメータの値により制限されたものになります。
(たとえば、-1にするとfloat4
値は5桁に、float8
値では14桁に丸められます。)
この形式は低速、かつ元の2進数における浮動小数点値のビットを保存しませんが、人間にとってより読みやすいかも知れません。
The meaning of this parameter, and its default value, changed in <productname>PostgreSQL</productname> 12; see <xref linkend="datatype-float"/> for further discussion. このパラメータの意味とデフォルト値はPostgreSQL 12で変更されました。 更なる説明については8.1.3をご覧ください。
client_encoding
(string
)
#Sets the client-side encoding (character set). The default is to use the database encoding. The character sets supported by the <productname>PostgreSQL</productname> server are described in <xref linkend="multibyte-charset-supported"/>. クライアント側符号化方式(文字セット)を設定します。デフォルトはデータベース符号化方式を使用します。 PostgreSQLサーバでサポートされている文字セットは23.3.1に記載されています。
lc_messages
(string
)
#Sets the language in which messages are displayed. Acceptable values are system-dependent; see <xref linkend="locale"/> for more information. If this variable is set to the empty string (which is the default) then the value is inherited from the execution environment of the server in a system-dependent way. メッセージが表示される言語を設定します。使用可能な値はシステムに依存します。詳細については23.1を参照してください。 この変数が空に設定された場合(これがデフォルトです)、値はシステムに依存する方法でサーバの実行環境から継承されます。
On some systems, this locale category does not exist. Setting this variable will still work, but there will be no effect. Also, there is a chance that no translated messages for the desired language exist. In that case you will continue to see the English messages. システムによっては、このロケールのカテゴリが存在しません。この変数を設定することはできますが、実効性はありません。 また、指定の言語に翻訳されたメッセージが存在しないこともあります。 その場合は、引き続き英語のメッセージが表示されます。
Only superusers and users with the appropriate <literal>SET</literal>
privilege can change this setting.
この設定を変更できるのは、スーパーユーザと適切なSET
権限を持つユーザだけです。
lc_monetary
(string
)
#
Sets the locale to use for formatting monetary amounts, for
example with the <function>to_char</function> family of
functions. Acceptable values are system-dependent; see <xref
linkend="locale"/> for more information. If this variable is
set to the empty string (which is the default) then the value
is inherited from the execution environment of the server in a
system-dependent way.
通貨書式で使用するロケールを設定します。
例えば、to_char()
系の関数で使用します。
使用可能な値はシステムに依存します。
詳細については23.1を参照してください。
この変数が空に設定された場合(これがデフォルトです)、値はシステムに依存する方法でサーバの実行環境から継承されます。
lc_numeric
(string
)
#
Sets the locale to use for formatting numbers, for example
with the <function>to_char</function> family of
functions. Acceptable values are system-dependent; see <xref
linkend="locale"/> for more information. If this variable is
set to the empty string (which is the default) then the value
is inherited from the execution environment of the server in a
system-dependent way.
数字の書式で使用するロケールを設定します。
例えば、to_char
系の関数で使用します。
使用可能な値はシステムに依存します。
詳細については23.1を参照してください。
この変数が空に設定された場合(これがデフォルトです)、値はシステムに依存する方法でサーバの実行環境から継承されます。
lc_time
(string
)
#
Sets the locale to use for formatting dates and times, for example
with the <function>to_char</function> family of
functions. Acceptable values are system-dependent; see <xref
linkend="locale"/> for more information. If this variable is
set to the empty string (which is the default) then the value
is inherited from the execution environment of the server in a
system-dependent way.
例えばto_char
系関数における、日付と時間の書式で使用するロケールを設定します。
使用可能な値はシステムに依存します。
詳細については23.1を参照してください。
この変数が空に設定された場合(これがデフォルトです)、値はシステムに依存する方法でサーバの実行環境から継承されます。
icu_validation_level
(enum
)
#
When ICU locale validation problems are encountered, controls which
<link linkend="runtime-config-severity-levels">message level</link> is
used to report the problem. Valid values are
<literal>DISABLED</literal>, <literal>DEBUG5</literal>,
<literal>DEBUG4</literal>, <literal>DEBUG3</literal>,
<literal>DEBUG2</literal>, <literal>DEBUG1</literal>,
<literal>INFO</literal>, <literal>NOTICE</literal>,
<literal>WARNING</literal>, <literal>ERROR</literal>, and
<literal>LOG</literal>.
ICUロケール検証の問題が発生した場合、問題を報告するために使用されるメッセージレベルを制御します。
有効な値は、DISABLED
、DEBUG5
、DEBUG4
、DEBUG3
、DEBUG2
、DEBUG1
、INFO
、NOTICE
、WARNING
、ERROR
、および LOG
です。
If set to <literal>DISABLED</literal>, does not report validation
problems at all. Otherwise reports problems at the given message
level. The default is <literal>WARNING</literal>.
DISABLED
に設定すると、検証で見つかった問題は全く報告されません。
それ以外の場合は、指定したメッセージレベルの問題が報告されます。
デフォルトはWARNING
です。
default_text_search_config
(string
)
#
Selects the text search configuration that is used by those variants
of the text search functions that do not have an explicit argument
specifying the configuration.
See <xref linkend="textsearch"/> for further information.
The built-in default is <literal>pg_catalog.simple</literal>, but
<application>initdb</application> will initialize the
configuration file with a setting that corresponds to the
chosen <varname>lc_ctype</varname> locale, if a configuration
matching that locale can be identified.
明示的な設定指定引数を持たないテキスト検索関数の亜種で使用される、テキスト検索設定を選択します。
詳細は第12章を参照してください。
組み込みのデフォルトはpg_catalog.simple
ですが、initdbは、ロケールに合う設定を認識することができれば、選択されたlc_ctype
ロケールに対応した設定で設定ファイルを初期化します。
Several settings are available for preloading shared libraries into the
server, in order to load additional functionality or achieve performance
benefits. For example, a setting of
<literal>'$libdir/mylib'</literal> would cause
<literal>mylib.so</literal> (or on some platforms,
<literal>mylib.sl</literal>) to be preloaded from the installation's standard
library directory. The differences between the settings are when they
take effect and what privileges are required to change them.
追加機能や性能改良の目的で共有ライブラリをプリロードするいくつかの設定があります。
たとえば'$libdir/mylib'
を設定するとmylib.so
(あるいは他のプラットフォームではmylib.sl
)を導入設定したの標準ディレクトリからプリロードします。
各設定の違いは、設定変更を行うためにいつ、どのような権限が必要かにあります。
<productname>PostgreSQL</productname> procedural language libraries can
be preloaded in this way, typically by using the
syntax <literal>'$libdir/plXXX'</literal> where
<literal>XXX</literal> is <literal>pgsql</literal>, <literal>perl</literal>,
<literal>tcl</literal>, or <literal>python</literal>.
典型的には'$libdir/plXXX'
のような構文を用いてPostgreSQL手続き言語ライブラリをこの方法でプリロードできます。
XXX
はpgsql
、perl
、tcl
、python
です。
Only shared libraries specifically intended to be used with PostgreSQL
can be loaded this way. Every PostgreSQL-supported library has
a <quote>magic block</quote> that is checked to guarantee compatibility. For
this reason, non-PostgreSQL libraries cannot be loaded in this way. You
might be able to use operating-system facilities such
as <envar>LD_PRELOAD</envar> for that.
PostgreSQLで使用することを意図したライブラリだけがこの方法でロードできます。
すべてのPostgreSQL用のライブラリは「magic block」を持ち、互換性を保証するためにチェックされます。
ですからPostgreSQL用ではないライブラリはこの方法ではロードできません。
LD_PRELOAD
のようなOSの機能を使えばあるいは使用できるかもしれません。
In general, refer to the documentation of a specific module for the recommended way to load that module. 一般的に言ってモジュールのドキュメントを参照し、推奨される方法でロードしてください。
local_preload_libraries
(string
)
#
This variable specifies one or more shared libraries that are to be
preloaded at connection start.
It contains a comma-separated list of library names, where each name
is interpreted as for the <link linkend="sql-load"><command>LOAD</command></link> command.
Whitespace between entries is ignored; surround a library name with
double quotes if you need to include whitespace or commas in the name.
The parameter value only takes effect at the start of the connection.
Subsequent changes have no effect. If a specified library is not
found, the connection attempt will fail.
この変数は、接続時に事前読み込みされる、1つまたは複数の共有ライブラリを指定します。
ここにはカンマ区切りでライブラリ名のリストを格納し、各々の名前はLOAD
コマンドで解釈されます。
項目の間の空白は無視されます。
名前の中に空白あるいはカンマを含める場合は、二重引用符で囲ってください。
このパラメータは、接続の開始時にのみ効果があります。
以降の変更は効果がありません。
もし指定したライブラリが見つからない場合は、接続は失敗します。
This option can be set by any user. Because of that, the libraries
that can be loaded are restricted to those appearing in the
<filename>plugins</filename> subdirectory of the installation's
standard library directory. (It is the database administrator's
responsibility to ensure that only <quote>safe</quote> libraries
are installed there.) Entries in <varname>local_preload_libraries</varname>
can specify this directory explicitly, for example
<literal>$libdir/plugins/mylib</literal>, or just specify
the library name — <literal>mylib</literal> would have
the same effect as <literal>$libdir/plugins/mylib</literal>.
このオプションはすべてのユーザが設定できます。
この理由で、読み込み可能なライブラリはインストレーションの共有ライブラリディレクトリのサブディレクトリplugins
内にあるものに制限されています。
(確実に「安全」なライブラリのみをここにインストールすることはデータベース管理者の責任です。)
local_preload_libraries
内の項目で、たとえば$libdir/plugins/mylib
のようにこのディレクトリを明示的に指定することも、単にライブラリ名を指定することも可能です。
mylib
は$libdir/plugins/mylib
と同じ効果です。
The intent of this feature is to allow unprivileged users to load
debugging or performance-measurement libraries into specific sessions
without requiring an explicit <command>LOAD</command> command. To that end,
it would be typical to set this parameter using
the <envar>PGOPTIONS</envar> environment variable on the client or by
using
<command>ALTER ROLE SET</command>.
この機能の意図するところは、明示的なLOAD
コマンドを使わずに、特定のセッションにおいて非特権ユーザがデバッグ用あるいは性能計測用のライブラリをロードできるようにすることにあります。
そのためにも、クライアント側でPGOPTIONS
環境変数を使う、あるいはALTER ROLE SET
を使うことが典型的になるでしょう。
However, unless a module is specifically designed to be used in this way by non-superusers, this is usually not the right setting to use. Look at <xref linkend="guc-session-preload-libraries"/> instead. しかし、モジュールが特にスーパーユーザ以外に使われることを意図しているのでない限り、通常この方法は正しい使い方ではありません。 代わりにsession_preload_librariesを見てください。
session_preload_libraries
(string
)
#
This variable specifies one or more shared libraries that are to be
preloaded at connection start.
It contains a comma-separated list of library names, where each name
is interpreted as for the <link linkend="sql-load"><command>LOAD</command></link> command.
Whitespace between entries is ignored; surround a library name with
double quotes if you need to include whitespace or commas in the name.
The parameter value only takes effect at the start of the connection.
Subsequent changes have no effect. If a specified library is not
found, the connection attempt will fail.
この変数は、接続時に事前読み込みされる、1つまたは複数の共有ライブラリを指定します。
ここにはカンマ区切りでライブラリ名のリストを格納し、各々の名前はLOAD
コマンドで解釈されます。
項目の間の空白は無視されます。
名前の中に空白あるいはカンマを含める場合は、二重引用符で囲ってください。
このパラメータは、接続の開始時にのみ効果があります。
以降の変更は効果がありません。
もし指定したライブラリが見つからない場合は、接続は失敗します。
Only superusers and users with the appropriate <literal>SET</literal>
privilege can change this setting.
この設定を変更できるのは、スーパーユーザと適切なSET
権限を持つユーザだけです。
The intent of this feature is to allow debugging or
performance-measurement libraries to be loaded into specific sessions
without an explicit
<command>LOAD</command> command being given. For
example, <xref linkend="auto-explain"/> could be enabled for all
sessions under a given user name by setting this parameter
with <command>ALTER ROLE SET</command>. Also, this parameter can be changed
without restarting the server (but changes only take effect when a new
session is started), so it is easier to add new modules this way, even
if they should apply to all sessions.
この機能は、デバッグや性能測定の目的でLOAD
コマンドを使わずに特定のセッションでライブラリをロードする目的で使われます。
たとえばALTER ROLE SET
で設定することにより、特定のユーザが開始するすべてのセッションでauto_explainが有効になります。
また、このパラメータはサーバを再起動せずに変更できます(しかし変更は新しいセッションが開始するときにのみ有効となります)。すべてのセッションで有効にしたいのであれば、この方法で新しいモジュールを容易に追加できます。
Unlike <xref linkend="guc-shared-preload-libraries"/>, there is no large performance advantage to loading a library at session start rather than when it is first used. There is some advantage, however, when connection pooling is used. shared_preload_librariesと違って、ライブラリがはじめて使われるときにロードする方法と比べてセッションが開始するときにライブラリをロードする方法には大きな性能的な優位性はありません。 しかし、コネクションプーリングを使うのであれば、いくらか優位性があります。
shared_preload_libraries
(string
)
#
This variable specifies one or more shared libraries to be preloaded at
server start.
It contains a comma-separated list of library names, where each name
is interpreted as for the <link linkend="sql-load"><command>LOAD</command></link> command.
Whitespace between entries is ignored; surround a library name with
double quotes if you need to include whitespace or commas in the name.
This parameter can only be set at server start. If a specified
library is not found, the server will fail to start.
この変数はサーバ起動時にプリロードされる一つ以上の共有ライブラリを指定します。
ここにはカンマ区切りでライブラリ名のリストを格納し、各々の名前はLOAD
コマンドで解釈されます。
項目の間の空白は無視されます。
名前の中に空白あるいはカンマを含める場合は、二重引用符で囲ってください。
このパラメータはサーバ起動時のみ設定可能です。
もし指定したライブラリが見つからない場合は、サーバの起動は失敗します。
Some libraries need to perform certain operations that can only take place at postmaster start, such as allocating shared memory, reserving light-weight locks, or starting background workers. Those libraries must be loaded at server start through this parameter. See the documentation of each library for details. ライブラリによってはpostmaster起動時にのみ可能な操作を実行する必要があるものがあります。 たとえば、共有メモリの獲得、軽量ロックの予約、バックグラウンドワーカーの起動などです。 このようなライブラリはこのパラメータを使ってサーバ起動時にロードしなければなりません。 詳細は各ライブラリのドキュメントを見てください。
Other libraries can also be preloaded. By preloading a shared library, the library startup time is avoided when the library is first used. However, the time to start each new server process might increase slightly, even if that process never uses the library. So this parameter is recommended only for libraries that will be used in most sessions. Also, changing this parameter requires a server restart, so this is not the right setting to use for short-term debugging tasks, say. Use <xref linkend="guc-session-preload-libraries"/> for that instead. これ以外のライブラリもプリロードできます。 共有ライブラリをプリロードすることにより、最初にライブラリが使われる際にライブラリが起動する時間を避けることができます。 しかし、そのライブラリが使われないとしても、サーバプロセスが起動する時間がわずかに長くなる可能性があります。 したがって、この方法は、ほとんどのセッションで使われるライブラリにのみ使用することを推奨します。 また、パラメータの変更にはサーバの再起動が必要になります。 ですから、たとえば短期のデバッグ仕事にこの設定を使うのは適当とは言えません。 session_preload_librariesを代わりに使ってください。
On Windows hosts, preloading a library at server start will not reduce
the time required to start each new server process; each server process
will re-load all preload libraries. However, <varname>shared_preload_libraries
</varname> is still useful on Windows hosts for libraries that need to
perform operations at postmaster start time.
Windowsのホストでは、ライブラリのプリロードは、新しいサーバプロセスの起動に要する時間を短縮しません。
個々のサーバプロセスは、すべてのプリロードライブラリを再読み込みします。
それでもpostmaster起動時に操作を実行しなければならないライブラリを使用するWindowsホストにとってはshared_preload_libraries
は有用です。
jit_provider
(string
)
#
This variable is the name of the JIT provider library to be used
(see <xref linkend="jit-pluggable"/>).
The default is <literal>llvmjit</literal>.
This parameter can only be set at server start.
この変数は、使用するJITプロバイダライブラリ(30.4.2参照)の名前です。
デフォルトはllvmjit
です。
このパラメータはサーバ起動時のみ設定可能です。
If set to a non-existent library, <acronym>JIT</acronym> will not be available, but no error will be raised. This allows JIT support to be installed separately from the main <productname>PostgreSQL</productname> package. 存在しないライブラリが指定されると、JITは利用できませんが、エラーは起こりません。 これにより、PostgreSQLパッケージとは別にJITサポートをインストールできるようになります。
dynamic_library_path
(string
)
#
If a dynamically loadable module needs to be opened and the
file name specified in the <command>CREATE FUNCTION</command> or
<command>LOAD</command> command
does not have a directory component (i.e., the
name does not contain a slash), the system will search this
path for the required file.
オープンする必要がある動的ロード可能なモジュールについて、そのCREATE FUNCTION
やLOAD
コマンドで指定されたファイル名にディレクトリ要素がなく(つまり、名前にスラッシュが含まれずに)指定された場合、システムは必要なファイルをこのパスから検索します。
The value for <varname>dynamic_library_path</varname> must be a
list of absolute directory paths separated by colons (or semi-colons
on Windows). If a list element starts
with the special string <literal>$libdir</literal>, the
compiled-in <productname>PostgreSQL</productname> package
library directory is substituted for <literal>$libdir</literal>; this
is where the modules provided by the standard
<productname>PostgreSQL</productname> distribution are installed.
(Use <literal>pg_config --pkglibdir</literal> to find out the name of
this directory.) For example:
dynamic_library_path
の値は、絶対パスのディレクトリ名をコロン(Windowsの場合はセミコロン)で区切った一覧です。
この一覧の要素が特別な$libdir
という値から始まる場合、コンパイルされたPostgreSQLパッケージのライブラリディレクトリで$libdir
は置換されます。
ここには、PostgreSQLの標準配布物により提供されるモジュールがインストールされます。
(このディレクトリ名を表示するには、pg_config --pkglibdir
を使用してください。)
例を以下に示します。
dynamic_library_path = '/usr/local/lib/postgresql:/home/my_project/lib:$libdir'
or, in a Windows environment: Windows環境の場合は以下です。
dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
The default value for this parameter is
<literal>'$libdir'</literal>. If the value is set to an empty
string, the automatic path search is turned off.
このパラメータのデフォルト値は'$libdir'
です。
この値が空に設定された場合、自動的なパス検索は無効になります。
This parameter can be changed at run time by superusers and users
with the appropriate <literal>SET</literal> privilege, but a
setting done that way will only persist until the end of the
client connection, so this method should be reserved for
development purposes. The recommended way to set this parameter
is in the <filename>postgresql.conf</filename> configuration
file.
このパラメータはスーパーユーザと、適切なSET
権限を持つユーザによって実行時に変更することができますが、この方法での設定は、そのクライアント接続が終わるまでしか有効になりません。
ですので、この方法は開発目的でのみ使用すべきです。
推奨方法はこのパラメータをpostgresql.conf
設定ファイル内で設定することです。
gin_fuzzy_search_limit
(integer
)
#Soft upper limit of the size of the set returned by GIN index scans. For more information see <xref linkend="gin-tips"/>. GINインデックススキャンにより返されるセットのソフトな上限サイズです。 詳細は64.4.5を参照してください。