ALTER FOREIGN DATA WRAPPER
ALTER FOREIGN DATA WRAPPER — изменить определение обёртки сторонних данных
Синтаксис
ALTER FOREIGN DATA WRAPPERимя
[ HANDLERфункция_обработчик
| NO HANDLER ] [ VALIDATORфункция_проверки
| NO VALIDATOR ] [ OPTIONS ( [ ADD | SET | DROP ]параметр
['значение
'] [, ... ]) ] ALTER FOREIGN DATA WRAPPERимя
OWNER TO {новый_владелец
| CURRENT_USER | SESSION_USER } ALTER FOREIGN DATA WRAPPERимя
RENAME TOновое_имя
Описание
ALTER FOREIGN DATA WRAPPER
изменяет определение обёртки сторонних данных. Первая форма команды меняет вспомогательные функции или общие параметры обёртки (требуется минимум одно предложение), а вторая — владельца обёртки.
Настраивать обёртки сторонних данных могут только суперпользователи и только суперпользователи могут быть их владельцами.
Параметры
имя
Имя существующей обёртки сторонних данных.
HANDLER
функция_обработчик
Задаёт новое имя функции-обработчика для обёртки сторонних данных.
NO HANDLER
Эти ключевые слова указывают, что обёртка сторонних данных теперь не имеет функции-обработчика.
Заметьте, что обращаться к сторонним таблицам, если их обёртка сторонних данных не имеет обработчика, нельзя.
VALIDATOR
функция_проверки
Задаёт новое имя функции проверки для обёртки сторонних данных.
Заметьте, что возможна ситуация, что предыдущие параметры обёртки данных, зависимых серверов, сопоставлений пользователей или сторонних таблиц окажутся неприемлемыми для новой функции проверки. PostgreSQL не проверяет их, поэтому пользователь сам должен убедиться в правильности этих параметров, прежде чем использовать изменённую обёртку данных. Однако параметры, изменяемые в данной команде
ALTER FOREIGN DATA WRAPPER
, будут проверены новой функцией проверки.NO VALIDATOR
Эти ключевые слова указывают, что обёртка сторонних данных теперь не имеет функции проверки.
OPTIONS ( [ ADD | SET | DROP ]
параметр
['значение
'] [, ... ] )Эта форма настраивает параметры обёртки сторонних данных.
ADD
,SET
иDROP
определяют, какое действие будет выполнено (добавление, установка и удаление, соответственно). Если действие не задано явно, подразумеваетсяADD
. Имена параметров должны быть уникальными, они вместе со значениями проверяются функцией проверки, если она установлена.новый_владелец
Имя пользователя, назначаемого новым владельцем обёртки сторонних данных.
новое_имя
Новое имя обёртки сторонних данных.
Примеры
Изменение параметров обёртки сторонних данных dbi
: добавление параметра foo
, удаление bar
:
ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP bar);
Установление для обёртки сторонних данных dbi
новой функции проверки bob.myvalidator
:
ALTER FOREIGN DATA WRAPPER dbi VALIDATOR bob.myvalidator;
Совместимость
ALTER FOREIGN DATA WRAPPER
соответствует стандарту ISO/IEC 9075-9 (SQL/MED), за исключением предложений HANDLER
, VALIDATOR
, OWNER TO
и RENAME
, являющихся расширениями.
DROP AGGREGATE
DROP AGGREGATE — remove an aggregate function
Synopsis
DROP AGGREGATE [ IF EXISTS ]name
(aggregate_signature
) [, ...] [ CASCADE | RESTRICT ] whereaggregate_signature
is: * | [argmode
] [argname
]argtype
[ , ... ] | [ [argmode
] [argname
]argtype
[ , ... ] ] ORDER BY [argmode
] [argname
]argtype
[ , ... ]
Description
DROP AGGREGATE
removes an existing aggregate function. To execute this command the current user must be the owner of the aggregate function.
Parameters
IF EXISTS
Do not throw an error if the aggregate does not exist. A notice is issued in this case.
name
The name (optionally schema-qualified) of an existing aggregate function.
argmode
The mode of an argument:
IN
orVARIADIC
. If omitted, the default isIN
.argname
The name of an argument. Note that
DROP AGGREGATE
does not actually pay any attention to argument names, since only the argument data types are needed to determine the aggregate function's identity.argtype
An input data type on which the aggregate function operates. To reference a zero-argument aggregate function, write
*
in place of the list of argument specifications. To reference an ordered-set aggregate function, writeORDER BY
between the direct and aggregated argument specifications.CASCADE
Automatically drop objects that depend on the aggregate function (such as views using it), and in turn all objects that depend on those objects (see Section 5.14).
RESTRICT
Refuse to drop the aggregate function if any objects depend on it. This is the default.
Notes
Alternative syntaxes for referencing ordered-set aggregates are described under ALTER AGGREGATE.
Examples
To remove the aggregate function myavg
for type integer
:
DROP AGGREGATE myavg(integer);
To remove the hypothetical-set aggregate function myrank
, which takes an arbitrary list of ordering columns and a matching list of direct arguments:
DROP AGGREGATE myrank(VARIADIC "any" ORDER BY VARIADIC "any");
To remove multiple aggregate functions in one command:
DROP AGGREGATE myavg(integer), myavg(bigint);
Compatibility
There is no DROP AGGREGATE
statement in the SQL standard.