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

Précédent | Niveau supérieur | Suivant
ALTER FUNCTION | Sommaire | ALTER INDEX

## ALTER GROUP

ALTER GROUP — Modifier le nom d'un rôle ou la liste de ses membres

## Synopsis

    +ALTER GROUP specification_role ADD USER nom_utilisateur [, ... ]
    ALTER GROUP specification_role DROP USER nom_utilisateur [, ... ]

    où specification_role peut valoir :

        nom_rôle
      | CURRENT_ROLE
      | CURRENT_USER
      | SESSION_USER

    ALTER GROUP nom_groupe RENAME TO nouveau_nom

## Description

`ALTER GROUP` modifie les attributs d'un groupe d'utilisateurs Cette commande est obsolète, mais toujours acceptée pour des raisons de compatibilité ascendante. Les groupes (et les utilisateurs) ont été remplacés par le concept plus général de rôles.

Les deux premières formes ajoutent des utilisateurs à un groupe ou en suppriment. Tout rôle peut être ici « utilisateur » ou « groupe ». Ces variantes sont réellement équivalentes à la promotion ou la révocation de l'appartenance au rôle nommé « groupe » ; il est donc préférable d'utiliser `GRANT` et `REVOKE` pour le faire.

La troisième forme change le nom du groupe. Elle est strictement équivalente au renommage du rôle par `ALTER ROLE`.

## Paramètres

`nom_groupe`

  Le nom du groupe (rôle) à modifier.

`nom_utilisateur`

  Les utilisateurs (rôles) à ajouter au groupe ou à en enlever. Les utilisateurs doivent préalablement exister ; `ALTER GROUP` ne crée pas et ne détruit pas d'utilisateur.

`nouveau_nom`

  Le nouveau nom du groupe.

## Exemples

Ajouter des utilisateurs à un groupe :

    ALTER GROUP staff ADD USER karl, john;

Supprimer des utilisateurs d'un groupe :

    ALTER GROUP workers DROP USER beth;

## Compatibilité

Il n'existe pas de relation `ALTER GROUP` en SQL standard.

## Voir aussi

GRANT, REVOKE, ALTER ROLE