ALTER SERVER — modifier la définition d'un serveur distant
ALTER SERVERnom
[ VERSION 'nouvelle_version
' ] [ OPTIONS ( [ ADD | SET | DROP ]option
['valeur
'] [, ... ] ) ] ALTER SERVERnom
OWNER TO {nouveau_propriétaire
| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER SERVERnom
RENAME TOnouveau_nom
ALTER SERVER
modifie la définition d'un serveur distant.
La première forme modifie la chaîne de version du serveur ou les options
génériques du serveur (au moins une clause est nécessaire). La seconde forme
modifie le propriétaire du serveur.
Pour modifier le serveur, vous devez être le propriétaire du serveur. De
plus, pour modifier le propriétaire, vous devez être capable d'utiliser
SET ROLE
vers le nouveau rôle propriétaire, et vous devez
avoir le
droit USAGE
sur le wrapper de données distantes du
serveur. (Notez que les superutilisateurs satisfont à tous ces critères
automatiquement.)
nom
Le nom d'un serveur existant.
nouvelle_version
Nouvelle version du serveur.
OPTIONS ( [ ADD | SET | DROP ] option
['valeur
'] [, ... ] )
Modifie des options pour le serveur. ADD
,
SET
et DROP
spécifient les actions à
exécuter. Si aucune opération n'est spécifiée explicitement, l'action est
ADD
. Les noms d'options doivent être uniques ; les
noms et valeurs sont aussi validés en utilisant la bibliothèque de wrapper
de données distantes.
nouveau_propriétaire
Le nom du nouveau propriétaire du serveur distant.
nouveau_nom
Le nouveau nom du serveur distant.
Modifier le serveur foo
et lui ajouter des options de
connexion :
ALTER SERVER foo OPTIONS (host 'foo', dbname 'dbfoo');
Modifier le serveur foo
, modifier sa version, modifier son
option host
:
ALTER SERVER foo VERSION '8.4' OPTIONS (SET host 'baz');
ALTER SERVER
est conforme à ISO/IEC 9075-9 (SQL/MED). Les
clauses OWNER TO
et RENAME TO
sont des
extensions PostgreSQL.