ALTER FOREIGN DATA WRAPPER — modifier la définition d'un wrapper de données distantes
ALTER FOREIGN DATA WRAPPERnom
[ HANDLERfonction_handler
| NO HANDLER ] [ VALIDATORfonction_validation
| NO VALIDATOR ] [ OPTIONS ( [ ADD | SET | DROP ]option
['valeur
'] [, ... ]) ] ALTER FOREIGN DATA WRAPPERnom
OWNER TO {nouveau_propriétaire
| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER FOREIGN DATA WRAPPERnom
RENAME TOnouveau_nom
ALTER FOREIGN DATA WRAPPER
modifie la définition d'un
wrapper de données distantes. La première forme de la commande modifie les
fonctions de support ou les options génériques du wrapper de données
distantes (au moins une clause est nécessaire). La seconde forme modifie le
propriétaire du wrapper de données distantes.
Seuls les superutilisateurs peuvent modifier les wrappers de données distantes. De plus, seuls les superutilisateurs peuvent être propriétaires de wrappers de données distantes.
nom
Le nom d'un wrapper de données distantes existant.
HANDLER fonction_handler
Spécifie une nouvelle fonction de gestion pour le wrapper de données distantes.
NO HANDLER
Cette clause est utilisée pour spécifier que le wrapper de données distantes ne doit plus avoir de fonction de gestion.
Notez que les tables distantes qui utilisent un wrapper de données distantes, sans fonction de gestion, ne peuvent pas être utilisées.
VALIDATOR fonction_validation
Indique une fonction de validation pour le wrapper de données distantes.
Notez qu'il est possible que des options pré-existantes du wrapper de
données distantes, ou de ses serveurs, correspondances d'utilisateurs ou
tables distantes, soient invalides d'après le nouveau validateur.
PostgreSQL ne vérifie pas ça. C'est à
l'utilisateur de s'assurer que ces options sont correctes avant d'utiliser
le wrapper de données distantes modifié. Néanmoins, toute option précisée
dans cette commande ALTER FOREIGN DATA WRAPPER
sera
vérifiée en utilisant le nouveau validateur.
NO VALIDATOR
Cette option est utilisée pour spécifier que le wrapper de données distantes n'aura plus de fonction de validation.
OPTIONS ( [ ADD | SET | DROP ] option
['valeur
'] [, ... ] )
Modifie les options du wrapper de données distantes.
ADD
, SET
et DROP
spécifient l'action à réaliser. ADD
est pris par défaut
si aucune opération n'est explicitement spécifiée. Les noms des options
doivent être uniques ; les noms et valeurs sont validés en utilisant
la fonction de validation du wrapper de données distantes.
nouveau_propriétaire
Le nom du nouveau propriétaire du wrapper de données distantes.
nouveau_nom
Le nouveau nom du wrapper de données distantes.
Modifier le wrapper de données distantes dbi
, ajouter
l'option foo
, supprimer bar
:
ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP bar);
Modifier la fonction de validation du wrapper de données distantes
dbi
en bob.myvalidator
:
ALTER FOREIGN DATA WRAPPER dbi VALIDATOR bob.myvalidator;
ALTER FOREIGN DATA WRAPPER
se conforme à ISO/IEC 9075-9
(SQL/MED). Néanmoins, les clauses HANDLER
,
VALIDATOR
, OWNER TO
et
RENAME
sont des extensions.