ALTER STATISTICS
ALTER STATISTICS — изменить определение объекта расширенной статистики
Синтаксис
ALTER STATISTICSимяOWNER TO {новый_владелец| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER STATISTICSимяRENAME TOновое_имяALTER STATISTICSимяSET SCHEMAновая_схемаALTER STATISTICSимяSET STATISTICSновый_ориентир
Описание
ALTER STATISTICS меняет параметры существующего объекта расширенной статистики. Параметры, не определённые явно в команде ALTER STATISTICS, сохраняют свои предыдущие значения.
Выполнить ALTER STATISTICS может только владелец объекта статистики. Чтобы сменить схему объекта статистики, необходимо также иметь право CREATE в новой схеме. Чтобы сменить владельца, необходимо иметь право SET ROLE для новой роли-владельца, и эта роль должна иметь право CREATE в схеме объекта статистики. (С такими ограничениями при смене владельца не происходит ничего такого, что нельзя было бы сделать, имея право удалить и вновь создать объект статистики. Однако суперпользователь может сменить владельца объекта статистики в любом случае.)
Параметры
имяИмя (возможно, дополненное схемой) объекта статистики, подлежащего изменению.
новый_владелецИмя пользователя, назначаемого новым владельцем объекта статистики.
новое_имяНовое имя объекта статистики.
новая_схемаНовая схема объекта статистики.
новый_ориентирОриентир сбора статистики для данного объекта, который будет учитываться при последующих операциях
ANALYZE. Значение ориентира может лежать в диапазоне от 0 до 10000. Также оно может равняться -1; в этом случае используется максимум из ориентиров статистики, заданных для целевых столбцов, а если таковые не заданы, используется системный ориентир статистики по умолчанию (default_statistics_target). За дополнительными сведениями об использовании статистики планировщиком запросов Postgres Pro обратитесь к Разделу 14.2.
Совместимость
Оператор ALTER STATISTICS отсутствует в стандарте SQL.
См. также
CREATE STATISTICS, DROP STATISTICSALTER STATISTICS
ALTER STATISTICS — change the definition of an extended statistics object
Synopsis
ALTER STATISTICSnameOWNER TO {new_owner| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER STATISTICSnameRENAME TOnew_nameALTER STATISTICSnameSET SCHEMAnew_schemaALTER STATISTICSnameSET STATISTICSnew_target
Description
ALTER STATISTICS changes the parameters of an existing extended statistics object. Any parameters not specifically set in the ALTER STATISTICS command retain their prior settings.
You must own the statistics object to use ALTER STATISTICS. To change a statistics object's schema, you must also have CREATE privilege on the new schema. To alter the owner, you must be able to SET ROLE to the new owning role, and that role must have CREATE privilege on the statistics object's schema. (These restrictions enforce that altering the owner doesn't do anything you couldn't do by dropping and recreating the statistics object. However, a superuser can alter ownership of any statistics object anyway.)
Parameters
nameThe name (optionally schema-qualified) of the statistics object to be altered.
new_ownerThe user name of the new owner of the statistics object.
new_nameThe new name for the statistics object.
new_schemaThe new schema for the statistics object.
new_targetThe statistic-gathering target for this statistics object for subsequent
ANALYZEoperations. The target can be set in the range 0 to 10000; alternatively, set it to -1 to revert to using the maximum of the statistics target of the referenced columns, if set, or the system default statistics target (default_statistics_target). For more information on the use of statistics by the Postgres Pro query planner, refer to Section 14.2.
Compatibility
There is no ALTER STATISTICS command in the SQL standard.
