Как создать пользователя в PostgreSQL: CREATE USER
Пользователя для сайта создают командой CREATE USER с паролем. Права администратора ему не нужны: хватит того, что он владеет своей базой. Удаляют пользователя командой DROP ROLE, но сначала передают другому то, чем он владеет.
Содержание 12
- Что сделать прямо сейчас
- Пользователь и роль — одно и то же
- Одной командой из консоли сервера: createuser
- Какое имя выбрать
- Какие права дать при создании
- Как посмотреть список пользователей
- Если пользователь уже есть
- Как переименовать пользователя
- Как удалить пользователя
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Войдите в консоль базы:
sudo -u postgres psql. Строка ввода сменится наpostgres=#. - Создайте пользователя. Вместо ivan — своё имя латинскими строчными буквами, вместо
новый-пароль— свой пароль:
CREATE USER ivan WITH PASSWORD 'новый-пароль';- База ответит
CREATE ROLE— пользователь создан. - Создайте ему базу:
CREATE DATABASE shop OWNER ivan;. Вместо shop — имя базы. Подробнее — Как создать и удалить базу. - Выйдите командой
\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; ещё раз.
Если таблицы 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.
Источники
- PostgreSQL 16: CREATE ROLE — на английском: LOGIN, CREATEDB, CREATEROLE, SUPERUSER, CONNECTION LIMIT и VALID UNTIL.
- PostgreSQL 16: CREATE USER — на английском: то же, что CREATE ROLE, но с правом входа.
- PostgreSQL 16: createuser — на английском: ключ --pwprompt и пример с вводом пароля.
- PostgreSQL 16: ALTER ROLE — на английском: RENAME TO и почему при переименовании стирается пароль md5.
- PostgreSQL 16: DROP ROLE — на английском: роль нельзя удалить, пока на неё что-то ссылается.
- PostgreSQL 16: Dropping Roles — на английском: REASSIGN OWNED и DROP OWNED в каждой базе, затем DROP ROLE.
- PostgreSQL 16: Role Attributes — на английском: суперпользователь не проходит проверку прав.
- PostgreSQL 16: psql — на английском: команда \du.
- PostgreSQL 16: Release Notes — на английском: столбец Member of убран из \du.
- Исходный код PostgreSQL 16: user.c — тексты ошибок already exists, permission denied to create role, current user cannot be dropped и cannot be dropped because some objects depend on it.
- Исходный код PostgreSQL 16: miscinit.c — тексты ошибок role does not exist и is not permitted to log in.
Сверено 5 ноября 2026 года.
Что почитать дальше
- Как выдать праваGRANT и REVOKE, если пользователю нужна чужая база.
- Как установить PostgreSQL на Ubuntuустановка и первый вход.
- Настройки PostgreSQLгде лежат файлы настроек.
- Ошибки PostgreSQLразборы ошибок по тексту.