Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add notes to prevent importing statistics to different major versions. #13

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Add notes to prevent importing statistics to different major versions. #13

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions doc/pg_dbms_stats-en.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Import of exported statistics into PostgreSQL servers of different major versions is not supported. Even if the import appears to be successful, there is a good chance that the subsequent server operation will be unstable and the expected execution plan will not be obtained.

## RESTRICTIONS

There are some important poins and restrictions to use pg_dbms_stats.
Expand Down
2 changes: 2 additions & 0 deletions doc/pg_dbms_stats-ja.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 を使用する際には、以下の使用上の注意と制約があります。
Expand Down