ALTER SERVER

ALTER SERVER — modifier la définition d'un serveur distant

Synopsis

ALTER SERVER nom [ VERSION 'nouvelle_version' ]
    [ OPTIONS ( [ ADD | SET | DROP ] option ['valeur'] [, ... ] ) ]
ALTER SERVER nom OWNER TO { nouveau_propriétaire | CURRENT_USER | SESSION_USER }
ALTER SERVER nom RENAME TO nouveau_nom
  

Description

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 superutilisateurs satisfont à tout ces critères automatiquement.)

Paramètres

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.

Exemples

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');
   

Compatibilité

ALTER SERVER est conforme à ISO/IEC 9075-9 (SQL/MED). Les clauses OWNER TO et RENAME TO sont des extensions PostgreSQL.

Voir aussi

CREATE SERVER(7), DROP SERVER(7)