F.15. dump_stat
Модуль dump_stat предоставляет функции, позволяющие выгрузить и восстановить содержимое таблицы pg_statistic. При выполнении выгрузки/восстановления данных вы можете воспользоваться dump_stat для переноса существующей статистики на новый сервер, обойдясь без выполнения команды ANALYZE для всего кластера, что может значительно сократить время простоя для больших баз данных. Функция dump_statistic выдаёт операторы INSERT, которые затем можно применить к совместимой базе данных. Чтобы успешно восстановить статистические данные, вы должны установить это расширение и на исходном, и на целевом сервере, так как эти операторы будут задействовать функции, реализованные в dump_stat.
Заметьте, что определение таблицы pg_statistic может поменяться, в результате чего сгенерированный скрипт может оказаться несовместимым с будущими выпусками Postgres Pro.
F.15.1. Установка
Расширение dump_stat включено в состав Postgres Pro. Установив Postgres Pro, вы должны выполнить команду CREATE EXTENSION, чтобы подготовить dump_stat к работе, следующим образом:
CREATE EXTENSION dump_stat;
F.15.2. Функции
-
anyarray_to_text(array anyarray) returns text Возвращает данный массив в виде значения
text.-
dump_statistic() returns setof text Функция
dump_statisticвыгружает содержимое системного каталогаpg_statistic. Она выдаётINSERTдля каждого кортежа вpg_statistic, кроме тех, что содержат статистические данные о таблицах в схемахinformation_schemaиpg_catalog.Оператор
INSERTпринимает следующую форму:WITH upsert as ( UPDATE pg_catalog.pg_statistic SET
имя_столбца=выражение[, ...] WHERE starelid =t_relname::regclass AND to_attname(t_relname, staattnum) =t_attnameAND to_atttype(t_relname, staattnum) =t_atttypeAND stainherit =t_stainheritRETURNING *) ins as ( SELECTвыражение[, ...] WHERE NOT EXISTS (SELECT * FROM upsert) AND to_attnum(t_relname,t_attname) IS NOT NULL AND to_atttype(t_relname,t_attname) =t_atttype) INSERT INTO pg_catalog.pg_statistic SELECT * FROM ins; гдевыражениеможет быть следующим: array_in(текст_массива,имя_типа::regtype::oid, -1)значение::имя_типаЧтобы сохранить выданные операторы, направьте вывод psql в файл, используя стандартные возможности psql. Аргументы psql подробно рассматриваются в psql. Метакоманды, начинающиеся с обратной косой черты, не поддерживаются.
Например, чтобы сохранить статистику базы данных
имя_базыв файлеdump_stat.sql, выполните:$ psql -XAtq -c "SELECT dump_statistic()"
имя_базы> dump_stat.sql-
dump_statistic(schema_name text) returns setof text dump_statisticвыгружает содержимое системного каталогаpg_statistic. Она выдаёт операторINSERTдля каждого кортежа вpg_statistic, относящегося к какой-либо таблице в схемеschema_name.-
dump_statistic(schema_name text, table_name text) returns setof text dump_statisticвыгружает содержимое системного каталогаpg_statistic. Она формирует операторINSERTдля каждого кортежа вpg_statistic, относящегося к указанной таблицеschema_name.table_name.-
dump_statistic(relation regclass) returns setof text dump_statisticвыгружает содержимое системного каталогаpg_statistic. Она формирует операторINSERTдля каждого кортежа вpg_statistic, содержащего статистические данные отношенияrelation.-
to_schema_qualified_operator(opid oid) returns text Выдаёт дополненное схемой имя оператора по его идентификатору
opid. Например:test=# SELECT to_schema_qualified_operator('+(int,int)'::regoperator); to_schema_qualified_operator ------------------------------------------------ pg_catalog.+(pg_catalog.int4, pg_catalog.int4) (1 row)-
to_schema_qualified_type(typid oid) returns text Выдаёт дополненное схемой имя типа по его идентификатору
typid.-
to_schema_qualified_relation(relid oid) returns text Выдаёт дополненное схемой имя отношения по его идентификатору
relid.-
anyarray_elemtype(arr anyarray) returns oid Возвращает тип элемента массива, заданного по
oid. Например:test=# SELECT anyarray_elemtype(array_in('{1,2,3}', 'int'::regtype, -1)); anyarray_elemtype ------------------- 23 (1 row)-
to_attname(relation regclass, colnum int2) returns text Для отношения с заданным именем
relationи номером столбцаcolnumвозвращает имя столбца в виде значенияtext.-
to_attnum(relation regclass, col text) returns int2 Для отношения с заданным именем
relationи столбца с именемcolвозвращает номер столбца в виде значенияint2.-
to_atttype(relation regclass, col text) returns text Для отношения с заданным именем
relationи столбца с именемcolвозвращает дополненное схемой имя типа столбца в виде значенияtext.-
to_atttype(relation regclass, colnum int2) returns text Для отношения с заданным именем
relationи столбца с номеромcolnumвозвращает дополненное схемой имя типа столбца в виде значенияtext.-
to_namespace(nsp text) returns oid to_namespaceповторяет поведение приведения к типуregnamespace, которое отсутствует в PostgreSQL версии 9.4 (и предыдущих). Эта функция возвращаетoidданной схемы.-
get_namespace(relation oid) returns oid get_namespaceвозвращает схему заданного отношения в видеoid.
F.15. dump_stat
The dump_stat module provides functions that allow you to backup and recover the contents of the pg_statistic table. When performing a dump/restore, you can use dump_stat to migrate the original statistics to the new server instead of running the ANALYZE command for the whole database cluster, which can significantly reduce downtime for large databases. The dump_statistic function generates INSERT statements which can later be applied to a compatible database. To successfully restore statistical data, you must install the extension on both the original and the recipient servers since these statements rely on the provided dump_stat functions.
Note that the definition of the pg_statistic table might change occasionally, which means that generated dump might be incompatible with future releases of Postgres Pro.
F.15.1. Installation
The dump_stat extension is included into Postgres Pro. Once you have Postgres Pro installed, you must execute the CREATE EXTENSION command to enable dump_stat, as follows:
CREATE EXTENSION dump_stat;
F.15.2. Functions
-
anyarray_to_text(array anyarray) returns text Returns the given array as
text.-
dump_statistic() returns setof text dump_statisticdumps the contents of thepg_statisticsystem catalog. It produces anINSERTstatement per each tuple of thepg_statistic, excluding the ones that contain statistical data for tables in theinformation_schemaandpg_catalogschemas.The
INSERTstatement takes form ofWITH upsert as ( UPDATE pg_catalog.pg_statistic SET
column_name=expression[, ...] WHERE starelid =t_relname::regclass AND to_attname(t_relname, staattnum) =t_attnameAND to_atttype(t_relname, staattnum) =t_atttypeAND stainherit =t_stainheritRETURNING *) ins as ( SELECTexpression[, ...] WHERE NOT EXISTS (SELECT * FROM upsert) AND to_attnum(t_relname,t_attname) IS NOT NULL AND to_atttype(t_relname,t_attname) =t_atttype) INSERT INTO pg_catalog.pg_statistic SELECT * FROM ins; whereexpressioncan be one of: array_in(array_text,type_name::regtype::oid, -1)value::type_nameTo save the produced statements, redirect the psql output into a file using standard psql options. For details on the available psql options, see psql. Meta-commands starting with a backslash are not supported.
For example, to save statistics for the
dbnamedatabase into adump_stat.sqlfile, run:$ psql -XAtq -c "SELECT dump_statistic()"
dbname> dump_stat.sql-
dump_statistic(schema_name text) returns setof text dump_statisticdumps the contents of thepg_statisticsystem catalog. It produces anINSERTstatement per each tuple of thepg_statisticthat relates to some table in theschema_nameschema.-
dump_statistic(schema_name text, table_name text) returns setof text dump_statisticdumps the contents of thepg_statisticsystem catalog. It produces anINSERTstatement per each tuple of thepg_statisticthat relates to the specifiedschema_name.table_nametable.-
dump_statistic(relation regclass) returns setof text dump_statisticdumps the contents of thepg_statisticsystem catalog. It produces anINSERTstatement per each tuple of thepg_statisticthat contains statistical data for the specifiedrelation.-
to_schema_qualified_operator(opid oid) returns text Fetches the schema-qualified operator name by operator id
opid. For example:test=# SELECT to_schema_qualified_operator('+(int,int)'::regoperator); to_schema_qualified_operator ------------------------------------------------ pg_catalog.+(pg_catalog.int4, pg_catalog.int4) (1 row)-
to_schema_qualified_type(typid oid) returns text Fetches the schema-qualified type name by type id
typid.-
to_schema_qualified_relation(relid oid) returns text Fetches the schema-qualified relation name by relation id
relid.-
anyarray_elemtype(arr anyarray) returns oid Returns the element type of the given array as
oid. For example:test=# SELECT anyarray_elemtype(array_in('{1,2,3}', 'int'::regtype, -1)); anyarray_elemtype ------------------- 23 (1 row)-
to_attname(relation regclass, colnum int2) returns text Given a relation name
relationand a column numbercolnum, returns the column name astext.-
to_attnum(relation regclass, col text) returns int2 Given a relation name
relationand a column namecol, returns the column number asint2.-
to_atttype(relation regclass, col text) returns text Given a relation name
relationand a column namecol, returns the schema-qualified column type astext.-
to_atttype(relation regclass, colnum int2) returns text Given a relation name
relationand a column numbercolnum, returns the schema-qualified column type astext.-
to_namespace(nsp text) returns oid to_namespaceduplicates the behavior of the cast to theregnamespacetype, which is not present in the PostgreSQL 9.4 release (and prior releases). This function returns theoidof the given schema.-
get_namespace(relation oid) returns oid get_namespacereturns the schema of the given relation asoid.