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 [ TAG <TAG_NAME> = '<string_literal>' [ , <TAG_NAME> = '<string_literal>' ... ] ]
                                    [ COMMENT = '<string_literal>' ]

ALTER ROLE [ IF EXISTS ] <name> UNSET {
                                        TAG <TAG_NAME> [ , <TAG_NAME> ... ] |
                                        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:

TAG TAG_NAME = 'Zeichenfolgenliteral' [ , TAG_NAME = '<string_literal>' ... ]

Gibt den Tag-Namen (d. h. den Schlüssel) und den Tag-Wert an.

Der Tag-Wert ist immer eine Zeichenfolge, die maximale 256 Zeichen lang sein kann.

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.

  • TAG TAG_NAME [ , TAG_NAME ... ]

  • COMMENT

Nutzungshinweise

  • Nur der Rolleneigentümer (d. h. die Rolle mit der Berechtigung OWNERSHIP für die Rolle) oder eine höhere Rolle kann diesen Befehl ausführen.

  • Zum Umbenennen einer Rolle (mit dem Parameter RENAME TO Neuer_Name) muss die Rolle, die diesen Befehl ausführt, auch über die globale Berechtigung CREATE ROLE verfügen.

Beispiele

Rolle role1 in role2 umbenennen:

ALTER ROLE role1 RENAME TO role2;

Einen Kommentar zur Rolle myrole hinzufügen:

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