createuser
createuser — Ñоздать новую учётную запиÑÑŒ Postgres Pro
СинтакÑиÑ
createuser [параметр-подключениÑ...] [параметр...] [имÑ_пользователÑ]
ОпиÑание
createuser Ñоздаёт нового Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ Postgres Pro, а еÑли точнее — роль. Лишь Ñуперпользователь и пользователи Ñ Ð¿Ñ€Ð¸Ð²Ð¸Ð»ÐµÐ³Ð¸ÐµÐ¹ CREATEROLE могут Ñоздавать новые роли, таким образом, createuser должна запуÑкатьÑÑ Ð¾Ñ‚ их лица.
Чтобы Ñоздать дополнительного ÑуперпользователÑ, необходимо подключитьÑÑ Ð¾Ñ‚ имени ÑущеÑтвующего, одного лишь права CREATEROLE недоÑтаточно. ПоÑкольку Ñуперпользователи могут обходить вÑе Ð¾Ð³Ñ€Ð°Ð½Ð¸Ñ‡ÐµÐ½Ð¸Ñ Ð´Ð¾Ñтупа в базе данных, к назначению Ñтих полномочий не Ñледует отноÑитьÑÑ Ð»ÐµÐ³ÐºÐ¾Ð¼Ñ‹Ñленно.
createuser — Ñто обёртка Ð´Ð»Ñ SQL-команды CREATE ROLE. Создание пользователей Ñ ÐµÑ‘ помощью по Ñути не отличаетÑÑ Ð¾Ñ‚ Ð²Ñ‹Ð¿Ð¾Ð»Ð½ÐµÐ½Ð¸Ñ Ñ‚Ð¾Ð³Ð¾ же дейÑÑ‚Ð²Ð¸Ñ Ð¿Ñ€Ð¸ обращении к Ñерверу другими ÑпоÑобами.
Параметры
createuser принимает Ñледующие аргументы:
имÑ_пользователÑЗадаёт Ð¸Ð¼Ñ Ñоздаваемого Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ Postgres Pro. Ðто Ð¸Ð¼Ñ Ð´Ð¾Ð»Ð¶Ð½Ð¾ отличатьÑÑ Ð¾Ñ‚ имён вÑех ÑущеÑтвующих ролей в данной инÑталлÑции Postgres Pro.
-cномер--connection-limit=номерУÑтанавливает макÑимальное допуÑтимое количеÑтво Ñоединений Ð´Ð»Ñ Ñоздаваемого пользователÑ. По умолчанию ограничение в количеÑтве Ñоединений отÑутÑтвует.
-d--createdbРазрешает новому пользователю Ñоздавать базы данных.
-D--no-createdbЗапрещает новому пользователю Ñоздавать базы данных. Ðто поведение по умолчанию.
-e--echoВывеÑти команды к Ñерверу, генерируемые при выполнении createuser.
-E--encryptedШифровать пароль пользователÑ, хранимый в базе. ЕÑли флаг не указан, то Ð´Ð»Ñ Ð¿Ð°Ñ€Ð¾Ð»Ñ Ð¸ÑпользуетÑÑ Ð¿Ð¾Ð²ÐµÐ´ÐµÐ½Ð¸Ðµ по умолчанию.
-grole--role=roleУказывает роль, к которой будет добавлена Ñ‚ÐµÐºÑƒÑ‰Ð°Ñ Ñ€Ð¾Ð»ÑŒ в качеÑтве члена группы. ДопуÑкаетÑÑ Ð¼Ð½Ð¾Ð¶ÐµÑтвенное иÑпользование флага
-g.-i--inheritÐ¡Ð¾Ð·Ð´Ð°Ð²Ð°ÐµÐ¼Ð°Ñ Ñ€Ð¾Ð»ÑŒ автоматичеÑки унаÑледует права ролей, в которые она включаетÑÑ. Ðто поведение по умолчанию.
-I--no-inheritРоль не будет наÑледовать права ролей, в которые она включаетÑÑ.
--interactiveЗапроÑить Ð¸Ð¼Ñ Ð´Ð»Ñ Ñоздаваемого пользователÑ, а также Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ñ Ð´Ð»Ñ Ñ„Ð»Ð°Ð³Ð¾Ð²
-d/-D,-r/-R,-s/-S, еÑли они Ñвно не указаны в командной Ñтроке. До верÑии PostgreSQL 9.1 включительно Ñто было поведением по умолчанию.-l--loginÐовый пользователь Ñможет подключатьÑÑ Ðº Ñерверу (то еÑÑ‚ÑŒ его Ð¸Ð¼Ñ Ð¼Ð¾Ð¶ÐµÑ‚ быть идентификатором начального Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ ÑеанÑа). Ðто ÑвойÑтво по умолчанию.
-L--no-loginÐовый пользователь не Ñможет подключатьÑÑ Ðº Ñерверу. (Роль без права входа на Ñервер тем не менее полезна Ð´Ð»Ñ ÑƒÐ¿Ñ€Ð°Ð²Ð»ÐµÐ½Ð¸Ñ Ñ€Ð°Ð·Ñ€ÐµÑˆÐµÐ½Ð¸Ñми в базе данных.)
-N--unencryptedÐе шифровать пароль, хранимый в базе. ЕÑли флаг не указан, то Ð´Ð»Ñ Ð¿Ð°Ñ€Ð¾Ð»Ñ Ð¸ÑпользуетÑÑ Ð¿Ð¾Ð²ÐµÐ´ÐµÐ½Ð¸Ðµ по умолчанию.
-P--pwpromptЕÑли флаг указан, то createuser запроÑит пароль Ð´Ð»Ñ Ñоздаваемого пользователÑ. ЕÑли не планируетÑÑ Ð°ÑƒÑ‚ÐµÐ½Ñ‚Ð¸Ñ„Ð¸ÐºÐ°Ñ†Ð¸Ñ Ð¿Ð¾ паролю, то пароль можно не уÑтанавливать.
-r--createroleРазрешает новому пользователю Ñоздавать другие роли, что означает наделение привилегией
CREATEROLE.-R--no-createroleЗапрещает пользователю Ñоздавать новые роли. Ðто поведение по умолчанию.
-s--superuserÐ¡Ð¾Ð·Ð´Ð°Ð²Ð°ÐµÐ¼Ð°Ñ Ñ€Ð¾Ð»ÑŒ будет иметь права ÑуперпользователÑ.
-S--no-superuserÐовый пользователь не будет Ñуперпользователем. Ðто поведение по умолчанию.
-V--versionВывеÑти верÑию createuser и завершить выполнение.
--replicationСоздаваемый пользователь будет наделён правом
REPLICATION. Ðто раÑÑмотрено подробнее в документации по CREATE ROLE.--no-replicationСоздаваемый пользователь не будет иметь привилегии
REPLICATION. Ðто раÑÑмотрено подробнее в документации по CREATE ROLE.-?--helpВывеÑти помощь по команде createuser.
createuser также принимает из командной Ñтроки параметры подключениÑ:
-hÑервер--host=ÑерверУказывает Ð¸Ð¼Ñ ÐºÐ¾Ð¼Ð¿ÑŒÑŽÑ‚ÐµÑ€Ð°, на котором работает Ñервер. ЕÑли значение начинаетÑÑ Ñ ÐºÐ¾Ñой черты, оно определÑет каталог Unix-Ñокета.
-pпорт--port=портУказывает TCP-порт или раÑширение файла локального Unix-Ñокета, через который Ñервер принимает подключениÑ.
-UимÑ_пользователÑ--username=имÑ_пользователÑÐ˜Ð¼Ñ Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ Ð´Ð»Ñ Ð¿Ð¾Ð´ÐºÐ»ÑŽÑ‡ÐµÐ½Ð¸Ñ (не Ð¸Ð¼Ñ Ñоздаваемого пользователÑ).
-w--no-passwordÐе выдавать Ð·Ð°Ð¿Ñ€Ð¾Ñ Ð½Ð° ввод паролÑ. ЕÑли Ñервер требует аутентификацию по паролю и пароль не доÑтупен Ñ Ð¿Ð¾Ð¼Ð¾Ñ‰ÑŒÑŽ других ÑредÑтв, таких как файл
.pgpass, попытка ÑÐ¾ÐµÐ´Ð¸Ð½ÐµÐ½Ð¸Ñ Ð½Ðµ удаÑÑ‚ÑÑ. Ðтот параметр может быть полезен в пакетных заданиÑÑ… и Ñкриптах, где нет пользователÑ, который вводит пароль.-W--passwordПринудительно запрашивать пароль перед подключением к базе данных.
Ðто неÑущеÑтвенный параметр, так как createuser запрашивает пароль автоматичеÑки, еÑли Ñервер проверÑет подлинноÑÑ‚ÑŒ по паролю. Однако чтобы понÑÑ‚ÑŒ Ñто, createuser лишний раз подключаетÑÑ Ðº Ñерверу. ПоÑтому иногда имеет ÑмыÑл ввеÑти
-W, чтобы иÑключить Ñту ненужную попытку подключениÑ.
Переменные окружениÑ
PGHOSTPGPORTPGUSERПараметры Ð¿Ð¾Ð´ÐºÐ»ÑŽÑ‡ÐµÐ½Ð¸Ñ Ð¿Ð¾ умолчанию
Ðта утилита, как и большинÑтво других утилит Postgres Pro, также иÑпользует переменные Ñреды, поддерживаемые libpq (Ñм. Раздел 30.14).
ДиагноÑтика
Ð’ Ñлучае Ð²Ð¾Ð·Ð½Ð¸ÐºÐ½Ð¾Ð²ÐµÐ½Ð¸Ñ Ñ‚Ñ€ÑƒÐ´Ð½Ð¾Ñтей, обратитеÑÑŒ к CREATE ROLE и psql. Переменные Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ Ð¸ параметры Ð¿Ð¾Ð´ÐºÐ»ÑŽÑ‡ÐµÐ½Ð¸Ñ Ð¿Ð¾ умолчанию libpq будут применены при запуÑке утилиты, Ñто Ñледует учитывать при диагноÑтике.
Примеры
Чтобы Ñоздать роль joe на Ñервере, иÑпользуемом по умолчанию:
$createuser joe
Чтобы Ñоздать роль joe на Ñервере, иÑпользуемом по умолчанию, Ñ Ð·Ð°Ð¿Ñ€Ð¾Ñом дополнительных параметров:
$createuser --interactive joeÐазначить роль Ñуперпользователем? (y/n)nРазрешить новой роли Ñоздавать базы данных? (y/n)nРазрешить новой роли Ñоздавать другие роли? (y/n)n
Чтобы Ñоздать того же Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ joe Ñ Ñвно заданными атрибутами, подключившиÑÑŒ к компьютеру eden, порту 5000:
$createuser -h eden -p 5000 -S -D -R -e joeCREATE ROLE joe NOSUPERUSER NOCREATEDB NOCREATEROLE INHERIT LOGIN;
Чтобы Ñоздать роль joe Ñ Ð¿Ñ€Ð°Ð²Ð°Ð¼Ð¸ ÑÑƒÐ¿ÐµÑ€Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ Ð¸ предуÑтановленным паролем:
$createuser -P -s -e joeВведите пароль Ð´Ð»Ñ Ð½Ð¾Ð²Ð¾Ð¹ роли:xyzzyПодтвердите ввод паролÑ:xyzzyCREATE ROLE joe PASSWORD 'md5b5f5ba1a423792b526f799ae4eb3d59e' SUPERUSER CREATEDB CREATEROLE INHERIT LOGIN;
Ð’ приведённом примере введённый пароль отображаетÑÑ Ð»Ð¸ÑˆÑŒ Ð´Ð»Ñ Ð¾Ñ‚Ñ€Ð°Ð¶ÐµÐ½Ð¸Ñ Ñути, на деле же он не выводитÑÑ Ð½Ð° Ñкран. Как видно в выводе журнала команд, пароль зашифрован. ЕÑли же указан флаг --unencrypted, то он отобразитьÑÑ Ð² Ñтом журнале неизменным, а также, возможно, и в других журналах Ñервера. По Ñтой причине в Ñтой Ñитуации Ñтоит иÑпользовать флаг -e Ñ Ð¾Ñобой оÑторожноÑтью.