Section courante

A propos

Section administrative du site

CREATE FOREIGN DATA WRAPPER

Crée un enveloppe de données étrangères
PostgreSQL

Syntaxe

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

Paramètres

Nom Description
name Ce paramètre permet d'indiquer le nom de l'enveloppe de données à distances à créer.
HANDLER handler_function Ce paramètre permet d'indiquer la fonction de gestion. Le handler_function est le nom d'une fonction précédemment enregistrée étant appelée pour récupérer les fonctions d'exécution pour les tables étrangères. La fonction de gestion ne doit prendre aucun argument et son type de retour doit être fdw_handler. Il est possible de créer un enveloppe de données à distances sans fonction de gestionnaire, mais les tables à distances utilisant un tel enveloppe peuvent uniquement être déclarées, pas accessibles.
VALIDATOR validator_function Ce paramètre permet d'indiquer la fonction de validation. Le validator_function est le nom d'une fonction précédemment enregistrée étant appelée pour vérifier les options génériques données au enveloppe de données étrangères, ainsi que les options pour les serveurs étrangers, les cartographies d'utilisateurs et les tables étrangères utilisant l'enveloppe de données étrangères. Si aucune fonction de validation ou NO VALIDATOR n'est spécifié, les options ne seront pas vérifiées au moment de la création. (Les enveloppes de données étrangères ignoreront ou rejetteront peut-être les spécifications d'options invalides au moment de l'exécution, selon l'implémentation.) La fonction de validation doit prendre deux paramètres : un de type text[], contenant le tableau d'options tel qu'il est entreposé dans le système catalogues, et un de type oid, étant l'OID du catalogue système contenant les options. Le type de retour est ignoré ; la fonction doit signaler les options non valides à l'aide de la fonction ereport(ERROR).
OPTIONS ( option 'value' [, ... ] ) Ce paramètre permet d'indiquer les options du nouvel enveloppe de données à distances. Les noms et valeurs d'option autorisés sont spécifiques à chaque envelopper de données étrangères et sont validés à l'aide de la fonction de validation de l'enveloppe de données étrangères. Les noms d'options doivent être uniques.

Description

Cette instruction permet de définir un nouvel enveloppe de données étrangères.



Dernière mise à jour : Jeudi, le 14 Octobre 2021