ALTER SERVER

ALTER SERVER
Prev	Up	Comandos SQL	Home	Next

ALTER SERVER — cambiar la definición de un servidor foráneo

Synopsis

ALTER SERVER name [ VERSION 'new_version' ]
    [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) ]
ALTER SERVER name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER SERVER name RENAME TO new_name

Descripción

ALTER SERVER cambia la definición de un servidor foráneo. La primera forma cambia la cadena de la versión del servidor o las opciones genéricas del servidor (se requiere al menos una cláusula). La segunda forma cambia el propietario del servidor.

Para modificar el servidor, debes ser el propietario del servidor. Además, para cambiar el propietario, debes ser capaz de hacer SET ROLE al nuevo rol propietario, y debes tener el privilegio USAGE en el envolvedor de datos externos (foreign-data wrapper) del servidor. (Ten en cuenta que los superusuarios cumplen con todos estos criterios automáticamente).

Parámetros

name: El nombre de un servidor existente.
new_version: La nueva versión del servidor.
OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ): Cambiar las opciones para el servidor. ADD, SET y DROP especifican la acción a realizar. Se asume ADD si no se especifica explícitamente ninguna operación. Los nombres de las opciones deben ser únicos; los nombres y valores también se validan utilizando la biblioteca del envolvedor de datos externos del servidor.
new_owner: El nombre de usuario del nuevo propietario del servidor foráneo.
new_name: El nuevo nombre para el servidor foráneo.

Ejemplos

Modificar el servidor foo, agregar opciones de conexión:

ALTER SERVER foo OPTIONS (host 'foo', dbname 'foodb');

Modificar el servidor foo, cambiar la versión, cambiar la opción host:

ALTER SERVER foo VERSION '8.4' OPTIONS (SET host 'baz');

Compatibilidad

ALTER SERVER cumple con ISO/IEC 9075-9 (SQL/MED). Las formas OWNER TO y RENAME son extensiones de PostgreSQL.

Véase también

CREATE SERVER, DROP SERVER