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 posséder le serveur ainsi
qu'être un membre direct ou indirect du nouveau rôle, et vous devez avoir le
droit USAGE
sur le wrapper de données distantes
du serveur. (Notez que les super-utilisateurs satisfont à tout 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.