Поиск
Справочник

Как создать пользователя в PostgreSQL: CREATE USER

Пользователя для сайта создают командой CREATE USER с паролем. Права администратора ему не нужны: хватит того, что он владеет своей базой. Удаляют пользователя командой DROP ROLE, но сначала передают другому то, чем он владеет.

≈ 7 мин чтения
Содержание 12

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Войдите в консоль базы: sudo -u postgres psql. Строка ввода сменится на postgres=#.
  3. Создайте пользователя. Вместо ivan — своё имя латинскими строчными буквами, вместо новый-пароль — свой пароль:
CREATE USER ivan WITH PASSWORD 'новый-пароль';
  1. База ответит CREATE ROLE — пользователь создан.
  2. Создайте ему базу: CREATE DATABASE shop OWNER ivan;. Вместо shop — имя базы. Подробнее — Как создать и удалить базу.
  3. Выйдите командой \q и проверьте вход: psql -h 127.0.0.1 -U ivan shop. psql спросит пароль — введите тот, что задали в CREATE USER. Строка shop=> значит, что вход работает.

В настройках сайта укажите адрес 127.0.0.1 или localhost, порт 5432, имя базы, пользователя и пароль.

Пользователь и роль — одно и то же

В PostgreSQL пользователь называется ролью. CREATE USER и CREATE ROLE создают одно и то же, разница одна:

  • CREATE USER ivan — роль, которой разрешён вход;
  • CREATE ROLE ivan — роль без права входа. Её используют как группу: выдают права роли, а роль — людям.

Поэтому база и отвечает CREATE ROLE на команду CREATE USER. Если создали роль через CREATE ROLE и под ней нужно входить, разрешите вход: ALTER ROLE ivan LOGIN;.

Пользователи базы — не пользователи сервера. Пользователь ivan в PostgreSQL не может войти на сервер по SSH, а пользователь сервера не может войти в базу, пока в ней не создан пользователь с тем же именем.

Одной командой из консоли сервера: createuser

То же самое можно сделать, не заходя в psql:

sudo -u postgres createuser --pwprompt ivan

Программа дважды спросит пароль для нового пользователя: символы при вводе не видны, наберите пароль и нажмите Enter. Если ничего не ответила — пользователь создан.

Какое имя выбрать

  • Пишите латинскими строчными буквами, цифрами и знаком _: ivan, shop_user, site2.
  • Заглавные буквы база превращает в строчные: CREATE USER Ivan создаст пользователя ivan.
  • Имя с дефисом или заглавными буквами придётся каждый раз брать в двойные кавычки: "shop-user". Проще без них.
  • Пароль пишут в одинарных кавычках. Если в пароле есть знак ', напишите его дважды: 'parol''123'.

Какие права дать при создании

Права пишут после WITH через пробел: CREATE USER ivan WITH PASSWORD 'новый-пароль' CREATEDB;.

СловоЧто разрешаетНужно сайту?
LOGINвходить в базу; CREATE USER ставит его самда
CREATEDBсоздавать новые базынет
CREATEROLEсоздавать других пользователейнет
SUPERUSERвсё: суперпользователь не проходит проверку правнет
CONNECTION LIMIT 20не больше 20 подключений сразу; -1 — без пределапо желанию
VALID UNTIL '2027-01-01'пароль действует до этой датынет

Сайту не нужен суперпользователь: если сайт взломают, через суперпользователя доберутся до всех баз сервера. Пользователь, который владеет своей базой, может в ней создавать таблицы и всё остальное.

Убрать лишнее право потом можно той же командой со словом NO: ALTER ROLE ivan NOCREATEDB;.

Как посмотреть список пользователей

В консоли базы:

\du
                             List of roles
 Role name |                         Attributes
-----------+------------------------------------------------------------
 ivan      |
 postgres  | Superuser, Create role, Create DB, Replication, Bypass RLS
  • Пустой столбец Attributes у ivan значит: пользователь с правом входа, без особых прав.
  • Cannot login — у роли нет права входа.
  • postgres — администратор базы, его создаёт установка. Не удаляйте его и не отдавайте сайту.

Если нужен список одной строкой на пользователя: SELECT rolname FROM pg_roles;. В нём будут и служебные роли с именами на pg_ — их создаёт сама база.

Если пользователь уже есть

Команда ответит:

ERROR:  role "ivan" already exists

Пользователь с таким именем уже создан. Если вы забыли его пароль, задайте новый: ALTER USER ivan WITH PASSWORD 'новый-пароль'; — подробнее в разборе Как сменить пароль. Слов IF NOT EXISTS у CREATE USER нет.

Как переименовать пользователя

ALTER USER ivan RENAME TO petr;
  • Переименовать пользователя, под которым вы сейчас вошли, нельзя: войдите как postgres.
  • Пароль, записанный способом scram-sha-256, при переименовании сохраняется. Пароль, записанный старым способом md5, база стирает — его нужно задать заново.
  • После переименования поменяйте имя пользователя в настройках сайта.

Как удалить пользователя

DROP USER ivan;

Если пользователь ничем не владеет, база ответит DROP ROLE. Если ему принадлежат базы или таблицы, придёт ошибка:

ERROR:  role "ivan" cannot be dropped because some objects depend on it

Строки DETAIL ниже перечисляют, чем он владеет. Сначала передайте это другому пользователю. Подключитесь к каждой базе, где у ivan есть таблицы, и выполните в ней две команды:

\c shop
REASSIGN OWNED BY ivan TO postgres;
DROP OWNED BY ivan;

Первая команда передаёт таблицы и базы пользователю postgres. Вторая убирает права, которые ivan выдали на чужие таблицы. Когда так сделано во всех базах, выполните DROP USER ivan; ещё раз.

DROP OWNED удаляет всё, чем пользователь ещё владеет в этой базе. Выполняйте её только после REASSIGN OWNED: тогда у пользователя уже ничего нет, и удалятся одни права.

Если таблицы ivan больше не нужны вместе с базой, удалите базу целиком — Как удалить базу.

Ошибки и как их исправить

Что видитеПричинаЧто делать
ERROR: role "ivan" already existsпользователь уже естьзадайте новый пароль через ALTER USER
ERROR: permission denied to create roleвы вошли не как postgresвойдите sudo -u postgres psql
FATAL: role "ivan" is not permitted to log inроль создана без права входаALTER ROLE ivan LOGIN;
FATAL: role "ivan" does not existпользователя нет или имя с опечаткойразбор ошибки
FATAL: password authentication failed for user "ivan"пароль не тотразбор ошибки
FATAL: Peer authentication failed for user "ivan"вход без -h 127.0.0.1разбор ошибки
ERROR: current user cannot be droppedудаляете себявойдите как postgres
ERROR: role "ivan" cannot be dropped because some objects depend on itпользователь владеет таблицами или базойREASSIGN OWNED и DROP OWNED, выше

Всё сверено с PostgreSQL 16 — эта версия ставится в Ubuntu 24.04.

Источники

Сверено 5 ноября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

Что почитать дальше