From cf851605fca52708f41aa8f07b76c4ce75b46558 Mon Sep 17 00:00:00 2001 From: Kyotaro Horiguchi Date: Tue, 14 Nov 2017 19:05:01 +0900 Subject: [PATCH] Edit Japanese documents. Make it up to date, fixed some wrong descriptions and removed some items with less importance. --- doc/objects-ja.html | 6 ++-- doc/pg_dbms_stats-ja.html | 72 +++++++++-------------------------------------- 2 files changed, 16 insertions(+), 62 deletions(-) diff --git a/doc/objects-ja.html b/doc/objects-ja.html index 67da71e..76d565e 100644 --- a/doc/objects-ja.html +++ b/doc/objects-ja.html @@ -8,7 +8,7 @@ -

pg_dbms_stats-1.3.1

+

pg_dbms_stats-1.3.9

pg_dbms_stats > Appendix A. オブジェクト一覧 @@ -235,7 +235,7 @@ d:データベース、s:スキーマ、t:テーブル、c:列 プランナに見せるテーブルごとの統計情報を表示します。PostgreSQLのpg_classカタログに対応します。 dbms_stats.column_stats_effective プランナに見せる列ごとの統計情報を表示します。PostgreSQLのpg_statisticカタログに対応します。 -dbms_stats.status +dbms_stats.stats プランナに見せる列ごとの統計情報のうち、ユーザが読み取り可能なものを表示します。PostgreSQLのpg_statsビューに対応します。 @@ -245,7 +245,7 @@ d:データベース、s:スキーマ、t:テーブル、c:列 vacuumdb
-

Copyright (c) 2009-2016, NIPPON TELEGRAPH AND TELEPHONE CORPORATION

+

Copyright (c) 2009-2017, NIPPON TELEGRAPH AND TELEPHONE CORPORATION

diff --git a/doc/pg_dbms_stats-ja.html b/doc/pg_dbms_stats-ja.html index a8aa0b6..7af7327 100755 --- a/doc/pg_dbms_stats-ja.html +++ b/doc/pg_dbms_stats-ja.html @@ -8,7 +8,7 @@ -

pg_dbms_stats 1.3.7

+

pg_dbms_stats 1.3.9

pg_dbms_stats
@@ -126,7 +126,7 @@

3.6. クリーンアップ

概要
-
PostgreSQL本来の実行計画選択基準に戻すために、統計情報の固定状態を解除します。
+
すでに存在しないオブジェクトの統計情報を削除します。
利用方法
clean_up_stats()というSQL関数を実行
詳細
@@ -188,7 +188,7 @@ $ su

4.3. pg_dbms_statsのロード

pg_dbms_statsを有効にするには、以下の例のようにpg_dbms_statsの共有ライブラリをロードしてください。 -全てのセッションでpg_dbms_statsを有効にするには、postgresql.confのshared_preload_libraries GUCパラメータに'pg_dbms_stats'を追加してからサーバを再起動して下さい。 +全てのセッションでpg_dbms_statsを有効にするには、postgresql.confのshared_preload_libraries GUCパラメータに'pg_dbms_stats'を追加してから設定をリロードして下さい。 

postgres=# LOAD 'pg_dbms_stats';
 LOAD
 postgres=#
@@ -218,13 +218,7 @@ test=# SELECT * FROM test; -- ダミー統計情報でプランを作成

-

全てのセッションでpg_dbms_statsを無効にするには、postgresql.confでpg_dbms_stats.use_locked_statsをoffに設定してからサーバを再起動して下さい。 -PostgreSQL 9.1の環境でpg_dbms_stats.use_locked_statsをpostgresql.confファイルで設定するためにはcustom_variable_classesにpg_dbms_statsを加える必要があります。 -

# postgresql.conf
-shared_preload_libraries = 'pg_dbms_stats'
-custom_variable_classes = 'pg_dbms_stats'	# 9.2以降は廃止されたため記述不要
-pg_dbms_stats.use_locked_stats = off
-PostgreSQL 9.2以降ではcustom_variable_classesは廃止されているため、pg_dbms_stats.use_locked_statsを標準のGUCパラメータと同様に記述することができます。 +

全てのセッションでpg_dbms_statsを無効にするには、postgresql.confでpg_dbms_stats.use_locked_statsをoffに設定してから設定をリロードしてください。PG9.4以降では ALTER SYSTEM が利用可能です。

5. アンインストール

@@ -346,24 +340,20 @@ test=#
統計情報のバックアップ契機
ANALYZEコマンドや統計情報の書き換えをトリガとして統計情報をバックアップすることはできません。 ジョブ管理ツールから定期的に統計情報をバックアップするか、autovacuum の ANALYZE を無効化し、統計情報のバックアップと取得をセットのジョブとして実行してください。
-
ツールの用途
-
このモジュールは過去の統計情報を再現するものであり、新しい実行計画を試すチューニングには利用できません。
-
GUCパラメータの影響
-
このツールは、実行計画に影響する要素のうち統計情報のみを保存するため、実行計画の生成に関するGUCパラメータが変更された場合は、統計情報を固定していても実行計画が変化する場合があります。
-
フック関数を使うツールとの競合
-
pg_dbms_statsでは、以下のフック関数を使用しています。 +
実行計画が変化する他の要因
+
このツールは、実行計画に影響する要素のうち統計情報のみを保存するため、実行計画の生成に関するGUCパラメータの変更やテーブルの行密度の大きな変化などにより、統計情報を固定していても実行計画が変化する場合があります。
+
フックを使うツールとの競合
+
pg_dbms_statsでは、以下のフックを使用しているため、同じフックを使用する他のツールと競合する可能性があります。
    -
  • get_relation_info_hook: 既存のフック関数を呼び出した後に独自処理
    • -
  • get_attavgwidth_hook: 既存のフック関数を呼び出さずに独自処理
    • -
  • get_relation_stats_hook: 既存のフック関数を呼び出さずに独自処理
    • -
  • get_index_stats_hook: 既存のフック関数を呼び出さずに独自処理
    • +
  • get_relation_info_hook
    • +
  • get_attavgwidth_hook
    • +
  • get_relation_stats_hook
    • +
  • get_index_stats_hook
-get_relation_info_hookを使用するツールについては、pg_dbms_statsを後からロードすることで併用可能ですが、残りの三つのフック関数を使用している外部ツールは併用しないでください。 -なお、フック関数とはプランナやエグゼキュータ等のPostgreSQL本体の処理に外部ツールが割り込むために使用する関数です。
ダンプ・リストア時の注意点
-pg_dbms_statsは、列単位の統計情報をユーザ定義テーブルで保持する列に独自に定義したanyarray型を使用しています。この列の値をテキスト形式でダンプするとデータ型の情報が失われるため、リストア時にエラーが発生します。リストア時にエラーが発生します。pg_dbms_statsのオブジェクトを含むダンプ/リストアは、以下の手順で実施してください。 +pg_dbms_statsは、列単位の統計情報をユーザ定義テーブルで保持する列に独自に定義したanyarray型を使用しています。この列の値をテキスト形式でダンプするとデータ型の情報が失われるため、リストア時にエラーが発生します。pg_dbms_statsのオブジェクトを含むダンプ/リストアは、以下の手順で実施してください。
  1. 「COPY <dbms_statsスキーマが持つテーブル名> TO '<ファイル名>' FORMAT binary;」 でpg_dbms_stats が管理している統計情報を <ファイル名>にバイナリ形式で保存します。
  2. 「pgdump --exclude-schema 'dbms_stats' <旧データベース名> > <ダンプファイル名>」 で dbms_stats スキーマを除いてダンプします。
    3. @@ -372,24 +362,6 @@ pg_dbms_statsは、列単位の統計情報をユーザ定義テーブルで保
  3. 「COPY <dbms_statsスキーマが持つテーブル名> FROM '<ファイル名>' FORMAT binary;」 で<ファイル名>に保存されている統計情報をdbms_statsスキーマが持つテーブルに保存します。
-
同時実行が不可能な機能
-
以下の機能は、ダミー統計情報の格納テーブルをテーブルロックします。そのため、先に実行した処理を終了する前に別の処理を実行した場合、先に実行した処理の終了を待ってから残りの処理を開始します。 -
    -
  • リストア
    • -
  • ロック
    • -
  • ロック解除
    • -
  • インポート
    • -
  • クリーンアップ
    • -
-また、以下の機能は、統計情報バックアップの格納テーブルをテーブルロックします。そのため、先に実行した処理が終了する前に次の機能を実行した場合、先に実行した処理の終了を待ってから残りの処理を開始します。 -
    -
  • パージ
    • -
-
-
オブジェクト削除時の注意点
-
テーブルや列などのオブジェクトを削除する場合は、ロック解除機能やパージ機能を使ってpg_dbms_stats独自の統計情報を先に削除してください。オブジェクトを先に削除した場合は、削除したオブジェクトのpg_dbms_stats独自の統計情報をクリーンアップ機能を使って削除してください。なお、ロック以外にも、リストアやインポートを実行した場合もpg_dbms_stats独自の統計情報が作成されます。
-
-

8. 詳細

8.1. 全体構成

pg_dbms_statsは、ANALYZEで作成された統計情報の代わりに pg_dbms_stats が保持する独自の統計情報を PostgreSQL に使わせることで実行計画を制御します。使用する統計情報は、以下のいずれかの方法で選択できます。 @@ -415,24 +387,6 @@ pg_dbms_statsは、列単位の統計情報をユーザ定義テーブルで保

8.2. pg_dbms_statsのユーザインターフェース

pg_dbms_statsの各機能は、前節で説明した独自の統計情報テーブルの内容をSQL文で更新することで実現されています。ただし、ユーザが直接SQL文を実行すると操作ミスによる削除やデータ不整合などが起こりうるため、ユーザインターフェースとして各機能に対応するSQL関数を提供しており、これらを使っての操作が強く推奨されています。

-

8.3. autovacuum による ANALYZE の無効化について

-

pg_dbms_stats は ANALYZE を無効化も禁止もしません。 -ANALYZE は pg_statistic システムカタログを変更しますが、最終的に pg_dbms_stats の独自統計情報で値を隠されます。 -効果の無い ANALYZE を繰り返すのは資源の無駄と考えるのであれば、autovacuum による ANALYZE を無効化してください。 -無効化は、下記のように ANALYZE の必要性判定の閾値を上げることで行います。 -ただし、無効化しなくても異常な動作をすることはありません。

- -

全体設定の場合

-
# postgresql.conf
-autovacuum_analyze_threshold = 100000
-autovacuum_analyze_scale_factor = 100
-
- -

個別設定の場合

-
test=# ALTER TABLE tbl SET (
-  autovacuum_analyze_threshold = 100000,
-  autovacuum_analyze_scale_factor = 100);
-

8.3. ロックする統計情報について

実行計画を作成する際、クエリ・オプティマイザは以下の統計情報または実際のデータの状態に基づいてコストを計算します。pg_dbms_stats は、これら全ての情報をロックすることができます。実際のファイルサイズが変化しても、ロックしたときのファイルサイズを継続して参照します。