Add notes to import stats to different major versions.

ossc-db · Jan 12, 2024 · 4061a05 · 4061a05
1 parent e041b7c
commit 4061a05
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 0 deletions.
diff --git a/doc/pg_dbms_stats-en.md b/doc/pg_dbms_stats-en.md
@@ -317,6 +317,8 @@ CAVEAT: The base script uses binary format of COPY command so import
 might fail if the format is incompatible with the export side. See [COPY
 command](http://www.postgresql.jp/document/current/html/sql-copy.html) for details.
 
+If the major version of the PostgreSQL you are importing to is different, a beneficial execution plan may not necessarily be generated with the statistics from the export side. Therefore, do not import the statistics and create it anew.
+
 ## RESTRICTIONS
 
 There are some important poins and restrictions to use pg_dbms_stats.

diff --git a/doc/pg_dbms_stats-ja.md b/doc/pg_dbms_stats-ja.md
@@ -324,6 +324,8 @@ backup_xxx() と restore_xxx() 関数を使用します。
 
 また、エクスポートファイルにはCOPYのバイナリフォーマットを利用しているため、エクスポート元とインポート先でアーキテクチャやPostgreSQLバージョンに差がある場合は正常に動作しない場合があります。詳しくは、[COPYコマンドのドキュメント](http://www.postgresql.jp/document/current/html/sql-copy.html)を参照して下さい。
 
+インポート先のPostgreSQLのメジャーバージョンが異なる場合は、エクスポート元の統計情報で有利な実行計画が生成されるとは限らないため、統計情報はインポートせず、新たに作成してください。
+
 ## 使用上の注意と制約
 
 pg_dbms_stats を使用する際には、以下の使用上の注意と制約があります。