Перейти к основному содержимому

Совместимость утилит клиентской и серверной части

В данном разделе представлено описание совместимости утилит при использовании различных версий клиентской и серверной частей СУБД Pangolin.

Клиент psql​

  1. Клиент psql совместим со всеми поддерживаемыми версиями СУБД Pangolin в рамках функциональности, соответствующей мажорной серверной версии, а также в пределах версий API, предоставляемых операционной системой клиента и СУБД (например, OpenSSL).
  2. Клиент psql обратно совместим с поддерживаемыми версиями СУБД Pangolin, чьи мажорные версии меньше соответствующей мажорной версии CУБД, в пределах жизненного цикла СУБД и версий API, предоставляемых операционной системой клиента и СУБД.
  3. Клиент psql совместим с форматом логического дампа, снятого с помощью pg_dumpall или pg_dump в формате plain, в пределах мажорной версии утилит pg_dumpall и pg_dump.
  4. Метакоманды psql совместимы как с текущей мажорной версией СУБД, так и с предшествующими мажорными версиями СУБД в течение их жизненного цикла.
  5. Содержание встроенной справки (\help) клиента psql соответствует мажорной версии СУБД.

Утилиты pg_dump, pg_dumpall​

Утилиты используются для резервного копирования и восстановления.

Утилиты pg_dump и pg_dumpall имеют обратную совместимость и позволяют создавать логические копии как с соответствующей мажорной версии СУБД, так и с предыдущих, при условии их поддержки в пределах жизненного цикла СУБД и операционной системы.

В случае, если мажорная версия утилиты меньше мажорной версии СУБД будет получена ошибка следующего вида:

pg_dump: error: server version: 15.5; pg_dump version: 13.8
pg_dump: error: aborting because of server version mismatch

Утилита pg_restore​

Утилита pg_restore позволяет восстановить резервную копию, снятую:

  • в формате custom, при условии, что мажорная версия целевой СУБД не меньше мажорной версии СУБД, с которой получена резервная копия.
  • в форматах tar/directory и с использованием утилиты pg_dump мажорной версии, не превышающую мажорную версию утилиты pg_restore на СУБД, чья мажорная версия соответствует мажорной версии утилиты pg_restore.
Внимание!

При восстановлении резервной копии утилитой pg_restore учитывайте не только совместимость утилит и версий СУБД, но и наличие необходимых объектов и атрибутов СУБД и БД:

  • ролей и пользователей;
  • ТП (табличных пространств);
  • активных расширений и их версий, а также сторонних расширений из 3rdparty части;
  • модулей процедурных языков (например, pl/perl);
  • доступности FDW;
  • правил pg_hba.conf;
  • и других.

Библиотека libpq​

Библиотека libpq обратно совместима с поддерживаемыми версиями СУБД Pangolin, чья мажорная версия не выше соответствующей версии библиотеки libpq, в пределах их жизненного цикла.

Внимание!

Выбор протоколов (protocol), версий протоколов (например, TLS 1.3), шифров (cyphers) и алгоритмов (algorithm) обеспечивается библиотеками операционной системы.