pg_test_fsync
<refpurpose>determine fastest <varname>wal_sync_method</varname> for <productname>PostgreSQL</productname></refpurpose>
— PostgreSQLの最も高速なwal_sync_method
を決定する
pg_test_fsync
[option
...]
<application>pg_test_fsync</application> is intended to give you a reasonable
idea of what the fastest <xref linkend="guc-wal-sync-method"/> is on your
specific system,
as well as supplying diagnostic information in the event of an identified I/O
problem. However, differences shown by
<application>pg_test_fsync</application> might not make any significant
difference in real database throughput, especially since many database servers
are not speed-limited by their write-ahead logs.
<application>pg_test_fsync</application> reports average file sync operation
time in microseconds for each <literal>wal_sync_method</literal>, which can also be used to
inform efforts to optimize the value of <xref linkend="guc-commit-delay"/>.
pg_test_fsyncは使用するシステムにおいて最速なwal_sync_methodは何かについて、合理的な見解を提供することを意図したものです。
同時に識別されたI/O問題のイベントに診断情報を提供します。
しかしpg_test_fsyncで示される差異が、実際のデータベーススループットにおいて差異として現れないことがあります。
特に、多くのデータベースサーバは先行書き込みログにより速度制限されていないからです。
pg_test_fsyncは各wal_sync_method
に対する平均ファイル同期処理時間をマイクロ秒単位で報告します。
これはcommit_delayの値を最適化する時の情報としても使うことができます。
<application>pg_test_fsync</application> accepts the following command-line options: pg_test_fsyncは以下のコマンドラインオプションを受け付けます。
-f
--filename
Specifies the file name to write test data in.
This file should be in the same file system that the
<filename>pg_wal</filename> directory is or will be placed in.
(<filename>pg_wal</filename> contains the <acronym>WAL</acronym> files.)
The default is <filename>pg_test_fsync.out</filename> in the current
directory.
テストデータを書き込むためのファイルの名前を指定します。
このファイルはpg_wal
ディレクトリがある、または格納する予定のファイルシステムと同じファイルシステムになければなりません。
(pg_wal
にはWALファイルが含まれます。)
デフォルトは現在のディレクトリ内のpg_test_fsync.out
です。
-s
--secs-per-test
Specifies the number of seconds for each test. The more time per test, the greater the test's accuracy, but the longer it takes to run. The default is 5 seconds, which allows the program to complete in under 2 minutes. 1テストあたりの秒数を指定します。 テストあたりの時間を多くするほど、テストの精度が向上しますが、実行により時間がかかるようになります。 デフォルトは、本プログラムがおよそ2分で完了することができる、5秒です。
-V
--version
Print the <application>pg_test_fsync</application> version and exit. pg_test_fsyncのバージョンを表示し、終了します。
-?
--help
Show help about <application>pg_test_fsync</application> command line arguments, and exit. pg_test_fsyncのコマンドライン引数の説明を表示し、終了します。
The environment variable <envar>PG_COLOR</envar> specifies whether to use
color in diagnostic messages. Possible values are
<literal>always</literal>, <literal>auto</literal> and
<literal>never</literal>.
環境変数PG_COLOR
は診断メッセージで色を使うかどうかを指定します。
指定可能な値はalways
、auto
、never
です。