createuser¶
Legt eine neue PostgreSQL-Rolle (Benutzer) an, auf Wunsch mit Passwort und dem Recht, Datenbanken anzulegen.

Syntax¶
createuser [-P] [-d] [-r] [-s] [-e] ROLLE
Optionen¶
| Option | Beschreibung |
|---|---|
-P, --pwprompt |
Nach einem Passwort für die neue Rolle fragen |
-d |
Die Rolle darf Datenbanken anlegen |
-r |
Die Rolle darf andere Rollen anlegen |
-s |
Superuser: darf alles |
-e |
Das SQL zeigen, das an den Server geht |
--interactive |
Nach den Rechten fragen statt Standardwerte zu nehmen |
createuser ist eine Hülle um CREATE ROLE … LOGIN. Führ es als Linux-Benutzer postgres aus: sudo -u postgres createuser …. Rollen löschst du mit dropuser.
Beispiele¶
Eine Rolle mit Passwort für eine Anwendung:
sudo -u postgres createuser --pwprompt app
Enter password for new role:
Enter it again:
Zeigen, was an den Server geht:
sudo -u postgres createuser -e nox
SELECT pg_catalog.set_config('search_path', '', false);
CREATE ROLE nox NOSUPERUSER NOCREATEDB NOCREATEROLE INHERIT LOGIN NOREPLICATION NOBYPASSRLS;
Ohne Optionen darf sich die Rolle anmelden, aber keine Datenbanken oder Rollen anlegen.
Eine Rolle, die Datenbanken anlegen darf:
sudo -u postgres createuser -d -P shopadmin
Enter password for new role:
Enter it again:
Die Rolle gibt es schon:
sudo -u postgres createuser app
createuser: error: creation of new role failed: ERROR: role "app" already exists
Ein neues Passwort für eine vorhandene Rolle setzt du mit sudo -u postgres psql -c '\password app'.
Das Ergebnis prüfen:
sudo -u postgres psql -c '\du'
List of roles
Role name | Attributes
-----------+------------------------------------------------------------
app |
nox |
postgres | Superuser, Create role, Create DB, Replication, Bypass RLS
shopadmin | Create DB
Wann brauche ich das?¶
- Für jede neue Anwendung, die eine eigene Datenbank bekommt
- Um einer Kollegin oder einem Kollegen einen eigenen Zugang zu geben, passend zum Linux-Benutzernamen für
peer
Eine Rolle pro Linux-Benutzer
Eine Rolle mit demselben Namen wie ein Linux-Benutzer (sudo -u postgres createuser nox)
kann sich lokal ohne Passwort anmelden. nox tippt dann einfach psql -d shop.
Kein Superuser für Anwendungen
Eine Anwendung mit -s kann jede Datenbank lesen, alles löschen und über COPY … PROGRAM
Programme auf dem Server starten. Anwendungen bekommen eine normale Rolle, der ihre eigene
Datenbank gehört.
Unterschiede zwischen Distributionen¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
| Paket | postgresql-client |
postgresql-client |
postgresql |
postgresql-libs |
Verwandte Befehle¶
createdb · psql · pg_isready · useradd