Documentation PostgreSQL 14.22 » Référence » Commandes SQL » ALTER SERVER

Précédent | Niveau supérieur | Suivant
ALTER SEQUENCE | Sommaire | ALTER STATISTICS

## 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_ROLE | 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 super-utilisateurs 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, DROP SERVER