From 53dbf621f22ff6ee907e16836a7a16126ed6ffb8 Mon Sep 17 00:00:00 2001 From: Masahiro Ikeda Date: Fri, 12 Jan 2024 15:12:14 +0900 Subject: [PATCH] Add notes about importing statistics to different major versions --- doc/pg_dbms_stats-en.md | 2 ++ doc/pg_dbms_stats-ja.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/doc/pg_dbms_stats-en.md b/doc/pg_dbms_stats-en.md index cd859d4..2ce3357 100644 --- 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. +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. diff --git a/doc/pg_dbms_stats-ja.md b/doc/pg_dbms_stats-ja.md index ad4bb77..8abf696 100644 --- 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 を使用する際には、以下の使用上の注意と制約があります。