createuser [ options ] [ username ]
postmaster が動作しているマシ ンのホスト名を指定します。
postmaster が接続要求を監視してい るインターネット TCP/IP ポートもしくはローカルな Unix ドメイ ンソケットファイルの拡張子を指定します。
createdb が生成しバックエンドに送 信する問い合わせを表示します。
応答を表示しません。
新規ユーザによるデータベース作成を許可します。
新規ユーザによるデータベース作成を許可しません。
新規ユーザによる他のユーザ作成を許可します。
新規ユーザによる他のユーザ作成を許可しません。
指定された場合、createuser は 新規ユーザ用のパスワードを促すプロンプトを表示します。 パスワード認証を使用する予定がなければ、これは必要ありま せん。
新規ユーザ用にデフォルト以外のユーザIDを設定することができます。 これは必要なものではありませんが、こういった設定を行なうサイトも あります。
作成する Postgres ユーザの名 前を指定します。 Postgres ユーザ全体で一意な名 前でなければなりません。
-h、-p、及び、 -eオプションは psql にそのまま 渡されます。 psql の -U、 及び、-W オプションも同様に使用できますが、 このコマンドでこのオプションを使用することは混乱を招きます。
正常終了。
何らかの失敗。ユーザは作成されません。
createuser は新規に Postgres ユーザを作成します。 pg_shadow クラスにて usesuper が設定されたユーザのみが、 新規に Postgres ユーザを作 成することができます。
createuser は、その内部で Postgres の対話式端末プログラム psql を使用し て CREATE USER SQL コマンドを実行するシェルスクリプトです。 従って、このプログラムによるユーザの作成とこの他の方法による作 成とでは何も違いはありません。 このことは、このスクリプトから psql が検索できなければならないことと対象ホスト上でデータベースサー バが動作していなければならないことを意味します。 また、psql 及び libpq フロントエンドライブラリで適用 される全てのデフォルト設定と環境変数が利用可能です。
デフォルトのデータベースサーバ上に joe ユーザを作成します。
$ createuser joe Is the new user allowed to create databases? (y/n) n Shall the new user be allowed to create more new users? (y/n) n CREATE USER
ホスト eden 、ポート 5000 で動作している postmaster から joe ユーザを作成します。またこの時、プ ロンプトの表示は行なわれず、そして、バックエンドに送られ る問い合わせが表示されます。
$ createuser -p 5000 -h eden -D -A -e joe CREATE USER "joe" NOCREATEDB NOCREATEUSER CREATE USER