CREAR ENVOLTURADOR DE DATOS EXTRANJEROS: defina un nuevo contenedor de datos externos

Sinopsis

CREATE FOREIGN DATA WRAPPER name
    [ HANDLER handler_function | NO HANDLER ]
    [ VALIDATOR validator_function | NO VALIDATOR ]
    [ OPTIONS ( option 'value' [, ... ] ) ]

Descripción

CREATE FOREIGN DATA WRAPPER crea un nuevo contenedor de datos externos. El usuario que define un contenedor de datos externos se convierte en su propietario.

El nombre del contenedor de datos externos debe ser exclusivo dentro de la base de datos.

Solo los superusuarios pueden crear envoltorios de datos externos.

Parámetros

name

El nombre del contenedor de datos externos que se creará.

HANDLER handler_function

handler_function es el nombre de una función previamente registrada que se llamará para recuperar las funciones de ejecución para tablas externas. La función de controlador no debe tomar argumentos y su tipo de retorno debe ser fdw_handler.

Es posible crear un contenedor de datos externos sin función de controlador, pero las tablas externas que usan dicho contenedor solo se pueden declarar, no se puede acceder a ellas.

VALIDATOR validator_function

validator_function es el nombre de una función registrada previamente que se llamará para verificar las opciones genéricas dadas al contenedor de datos externos, así como las opciones para servidores externos, asignaciones de usuarios y tablas externas utilizando el contenedor de datos externos. Si no hay función de validador o NO VALIDATOR se especifica, las opciones no se comprobarán en el momento de la creación. (Los contenedores de datos externos posiblemente ignorarán o rechazarán especificaciones de opciones no válidas en tiempo de ejecución, según la implementación). La función de validación debe tomar dos argumentos: uno de tipo text[], que contendrá la matriz de opciones almacenada en los catálogos del sistema, y ​​una de tipo oid, que será el OID del catálogo del sistema que contiene las opciones. Se ignora el tipo de retorno; la función debe informar las opciones no válidas utilizando el ereport(ERROR) función.

OPTIONS ( option 'value' [, ... ] )

Esta cláusula especifica opciones para el nuevo contenedor de datos externos. Los nombres y valores de las opciones permitidas son específicos de cada contenedor de datos externos y se validan mediante la función de validación del contenedor de datos externos. Los nombres de las opciones deben ser únicos.

Notas

La funcionalidad de datos externos de PostgreSQL aún está en desarrollo activo. La optimización de las consultas es primitiva (y en su mayoría también se deja al contenedor). Por lo tanto, hay un margen considerable para futuras mejoras de rendimiento.

Ejemplos de

Crear un contenedor de datos foráneos inútil dummy:

CREATE FOREIGN DATA WRAPPER dummy;

Crear un contenedor de datos externos file con función de manipulador file_fdw_handler:

CREATE FOREIGN DATA WRAPPER file HANDLER file_fdw_handler;

Crear un contenedor de datos externos mywrapper con algunas opciones:

CREATE FOREIGN DATA WRAPPER mywrapper
    OPTIONS (debug 'true');

Compatibilidad

CREATE FOREIGN DATA WRAPPER cumple con ISO / IEC 9075-9 (SQL / MED), con la excepción de que el HANDLER y VALIDATOR las cláusulas son extensiones y las cláusulas estándar LIBRARY y LANGUAGE no están implementados en PostgreSQL.

Sin embargo, tenga en cuenta que la funcionalidad SQL / MED en su conjunto aún no está conforme.

Ver también

MODIFICAR EL ENVOLTADOR DE DATOS EXTRANJEROS, ELIMINAR EL ENVOLTADOR DE DATOS EXTRANJEROS, CREAR SERVIDOR, CREAR MAPEO DE USUARIOS, CREAR TABLA EXTRANJERA

Anterior

Hasta próximo
CREAR EXTENSIÓN Hogar CREAR MESA EXTRANJERA