Kategorien:

DDL für Benutzer und Sicherheit (Rollen)

ALTER ROLE

Ändert die Eigenschaften einer bestehenden Rolle. Derzeit werden nur die folgenden Operationen unterstützt: Umbenennen einer Rolle oder Hinzufügen, Überschreiben und Entfernen eines Kommentars für eine Rolle.

Siehe auch:

CREATE ROLE, SHOW ROLES

Syntax

ALTER ROLE [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER ROLE [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER ROLE [ IF EXISTS ] <name> UNSET COMMENT

Parameter

Name

Gibt den Bezeichner für die zu ändernde Rolle an. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

RENAME TO neuer_Name

Gibt den neuen Bezeichner für die Rolle an. Dieser muss für Ihr Konto eindeutig sein.

Weitere Details dazu finden Sie unter Anforderungen an Bezeichner.

SET ...

Gibt die Eigenschaften an, die für die Rolle festgelegt werden sollen:

COMMENT = 'Zeichenfolgenliteral'

Fügt einen Kommentar hinzu oder überschreibt einen vorhandenen Kommentar zur Rolle.

UNSET ...

Gibt die Eigenschaften an, die für die Rolle deaktiviert werden sollen, wodurch sie auf die Standardwerte zurückgesetzt werden.

Derzeit können Sie nur die Eigenschaft COMMENT deaktivieren, die den Kommentar, falls vorhanden, für die Rolle entfernt.

Nutzungshinweise

  • Um eine Rolle umzubenennen (mit dem Parameter RENAME TO neuer_Name), müssen Sie der Eigentümer der Rolle sein (d. h. die Rolle mit der Berechtigung OWNERSHIP für die umzubenennende Rolle). Darüber hinaus erfordert diese Aktion eine Rolle mit der Berechtigung CREATE ROLE für das Konto.

Beispiele

Rolle role1 umbenennen in role2:

ALTER ROLE role1 RENAME TO role2;

Einen Kommentar zur Rolle myrole hinzufügen:

ALTER ROLE myrole SET COMMENT = 'New comment for role';