ALTER FOREIGN DATA WRAPPER

ALTER FOREIGN DATA WRAPPER
Prev	Up	Comandos SQL	Home	Next

ALTER FOREIGN DATA WRAPPER — cambiar la definición de un envolvedor de datos externos

Synopsis

ALTER FOREIGN DATA WRAPPER name
    [ HANDLER handler_function | NO HANDLER ]
    [ VALIDATOR validator_function | NO VALIDATOR ]
    [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ]) ]
ALTER FOREIGN DATA WRAPPER name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER FOREIGN DATA WRAPPER name RENAME TO new_name

Descripción

ALTER FOREIGN DATA WRAPPER cambia la definición de un envolvedor de datos externos. La primera forma del comando cambia las funciones de soporte o las opciones genéricas del envolvedor de datos externos (se requiere al menos una cláusula). La segunda forma cambia el propietario del envolvedor de datos externos.

Solo los superusuarios pueden modificar los envolvedores de datos externos. Adicionalmente, solo los superusuarios pueden ser propietarios de los envolvedores de datos externos.

Parámetros

name

El nombre de un envolvedor de datos externos existente.

HANDLER handler_function

Especifica una nueva función manejadora (handler) para el envolvedor de datos externos.

NO HANDLER

Esto se utiliza para especificar que el envolvedor de datos externos ya no debe tener una función manejadora (handler).

Ten en cuenta que no se puede acceder a las tablas foráneas que utilizan un envolvedor de datos externos sin manejador.

VALIDATOR validator_function

Especifica una nueva función validadora para el envolvedor de datos externos.

Ten en cuenta que es posible que las opciones preexistentes del envolvedor de datos externos, o de los servidores dependientes, mapeos de usuarios o tablas foráneas, sean inválidas según el nuevo validador. PostgreSQL no comprueba esto. Depende del usuario asegurarse de que estas opciones sean correctas antes de utilizar el envolvedor de datos externos modificado. Sin embargo, cualquier opción especificada en este comando ALTER FOREIGN DATA WRAPPER será comprobada utilizando el nuevo validador.

NO VALIDATOR

Esto se utiliza para especificar que el envolvedor de datos externos ya no debe tener una función validadora.

OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] )

Cambia las opciones del envolvedor de datos externos. 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 los valores también se validan utilizando la función validadora del envolvedor de datos externos, si existe.

new_owner

El nombre de usuario del nuevo propietario del envolvedor de datos externos.

new_name

El nuevo nombre del envolvedor de datos externos.

Ejemplos

Modificar un envolvedor de datos externos dbi, agregar la opción foo, eliminar bar:

ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP bar);

Cambiar el validador del envolvedor de datos externos dbi a bob.myvalidator:

ALTER FOREIGN DATA WRAPPER dbi VALIDATOR bob.myvalidator;

Compatibilidad

ALTER FOREIGN DATA WRAPPER cumple con ISO/IEC 9075-9 (SQL/MED), excepto que las cláusulas HANDLER, VALIDATOR, OWNER TO y RENAME son extensiones.

Véase también

CREATE FOREIGN DATA WRAPPER, DROP FOREIGN DATA WRAPPER