Zum Inhalt

createdb

Legt eine neue PostgreSQL-Datenbank an, meist mit einer eigenen Rolle als Besitzer.

createdb output

Syntax

createdb [-O BESITZER] [-E KODIERUNG] [-T VORLAGE] [-e] NAME

Optionen

Option Beschreibung
-O ROLLE Besitzer der neuen Datenbank
-E UTF8 Zeichenkodierung
-T template0 Von einer sauberen Vorlage kopieren (nötig für andere Kodierung oder Locale)
--locale= Sortierung und Zeichenklassen, z. B. C.UTF-8
-e Das SQL zeigen, das an den Server geht

createdb ist eine Hülle um CREATE DATABASE. Eine Datenbank löschst du mit dropdb NAME.

Beispiele

Eine Datenbank für eine Anwendung:

sudo -u postgres createdb -e -O app shop
SELECT pg_catalog.set_config('search_path', '', false);
CREATE DATABASE shop OWNER app;

Die Datenbank gibt es schon:

sudo -u postgres createdb shop
createdb: error: database creation failed: ERROR:  database "shop" already exists

Eine Locale, die das System nicht hat:

sudo -u postgres createdb -O app -T template0 --locale=de_DE.UTF-8 wiki
createdb: error: database creation failed: ERROR:  invalid LC_COLLATE locale name: "de_DE.UTF-8"
HINT:  If the locale name is specific to ICU, use ICU_LOCALE.

Erzeuge die Locale vorher (unter Debian mit sudo dpkg-reconfigure locales), starte PostgreSQL neu und versuch es noch einmal. C.UTF-8 gibt es immer.

Eine Datenbank löschen:

sudo -u postgres dropdb -e shop2
SELECT pg_catalog.set_config('search_path', '', false);
DROP DATABASE shop2;

Wann brauche ich das?

  • Beim Einrichten einer neuen Anwendung
  • Um vor dem Zurückspielen eines Backups mit pg_restore eine leere Datenbank anzulegen

Besitzer statt einzelner Rechte

Gehört die Datenbank der Anwendungsrolle (-O app), darf sie dort eigene Tabellen anlegen und braucht kein weiteres GRANT. Andere Rollen bekommen nur, was sie brauchen.

dropdb fragt nicht nach

dropdb shop löscht die Datenbank samt allen Daten sofort. Mach vorher ein frisches pg_dump und nimm dropdb -i für eine Rückfrage.

Unterschiede zwischen Distributionen

Debian Ubuntu RHEL Arch
Paket postgresql-client postgresql-client postgresql postgresql-libs

Verwandte Befehle

createuser · psql · pg_dump · localectl