Heroku PGSettings
この記事の英語版に更新があります。ご覧の翻訳には含まれていない変更点があるかもしれません。
最終更新日 2018年08月17日(金)
Table of Contents
Heroku Postgres の非レガシー本番プラン (Standard、Premium、Private、Shield) では、pg:settings コマンドでパラメータを設定することによってデータベース設定を管理できます。
$ heroku pg:settings postgresql-large-1234 -a sushi
=== postgresql-large-1234
log-lock-waits: true
log-min-duration-statement: 2000
log-statement: ddl
Heroku Postgres の設定は、Postgres 9.6 以上の本番クラスのプラン (Standard、Premium、Private、Shield) に対してのみ使用できます。Hobby 層プランには、再構成できないデフォルト設定が含まれています。
log-lock-waits
log-lock-waits は、セッションがロックを取得するために 1 秒より長い時間待ったときにログメッセージを生成するかどうかを制御します。これは、ロックの待機がパフォーマンス低下の問題の原因になっているかどうかを判定するのに役立ちます。Heroku Postgres でのデフォルト値はオンです。
$ heroku pg:settings:log-lock-waits off -a sushi
log-lock-waits has been set to false for postgresql-large-1234.
When a deadlock is detected, no log message will be emitted in your application's logs.
log-min-duration-statement
log-min-duration-statement では、ステートメントが少なくとも指定された期間 (ミリ秒数単位) 実行された場合は、完了した各ステートメントの期間がログに記録されます。ここで、0 の値はすべてをログに記録し、-1 の値はログ記録を無効にします。この設定は、アプリケーション内の最適化されていないクエリを追求するのに役立ちます。Heroku Postgres での log-min-duration-statement のデフォルト値は 2000 ミリ秒 (2 秒) に設定されています。
毎秒数百個のクエリが実行されるシステムでは、この設定によってログファイルが急速に増大し、データベースのパフォーマンスが低下する可能性があります。
$ heroku pg:settings:log-min-duration-statement 3000 postgresql-large-1234 -a sushi
log-min-duration-statement has been set to 3000 for postgresql-large-1234.
log-statement
log-statement は、どの正常な SQL ステートメントをログに記録するかを制御します。この機能は、複雑なクエリが関連しているバグを調べたり、アプリまたはデータベースユーザーによって作成されたクエリを検査したりする場合に役立ちます。log-statement の有効な値は次のとおりです。
- none: 正常なクエリのログ記録を停止します。その他のログ (遅いクエリのログ、ロックを待機しているクエリ、構文エラーなど) は引き続き生成されます。
- ddl: すべてのデータ定義ステートメント (CREATE、ALTER、DROP など) がログに記録されます。
- mod: ddl のすべてのステートメントのほか、INSERT、UPDATE、DELETE、TRUNCATE、COPY などのデータ変更ステートメントが含まれます。
- all: すべてのステートメントがログに記録されます。
Heroku Postgres での log-statement のデフォルト値は ddl です。
$ heroku pg:settings:log-statement all postgresql-large-1234 -a sushi
log-statement has been set to all for postgresql-large-1234.