Provided by: manpages-zh_1.5.2-1_all bug

NAME

       createuser - 定義一個新的 PostgreSQL 使用者帳戶

SYNOPSIS

       createuser [ option... ] [ username ]

DESCRIPTION 描述
       createuser  創建一個新的  PostgreSQL  使用者。只有超級使用者(在  pg_shadow 表中設置了 usesuper
       的使用者)可以創建新的  PostgreSQL  使用者。  因此,   createuser   必須由某位可以以   PostgreSQL
       超級使用者連接的使用者執行。

        作為超級使用者同時也意味著繞開數據庫內訪問檢查的能力, 因此我們應該少賦予超級使用者權限。

       createuser    是    SQL    命令    CREATE   USER   [create_user(7)]   的封裝。
       因此,用那種方法創建新使用者都沒什麼特別的。

OPTIONS 選項
       createuser 接受下列命令行參數:

       username
              聲明要創建的 PostgreSQL 使用者名稱。 該名稱必須在所有 PostgreSQL 使用者中唯一。

       -a

       --adduser
              允許該新建使用者創建其他使用者。(注意:                         實際上這樣做相當於把這個新使用者變成了
              superuser,只不過這個選項命名得比較爛。)

       -A

       --no-adduser
               不允許該新建使用者創建其他使用者。 (也就是說,該使用者是一個普通使用者,不是超級使用者)。

       -d

       --createdb
               允許該新建使用者創建數據庫。

       -D

       --no-createdb
               禁止該新建使用者創建數據庫。

       -e

       --echo
               回顯 createuser 生成的命令並發送給伺服器。

       -E

       --encrypted
               對保存在數據庫裏的使用者口令加密。如果沒有聲明, 則使用預設值。

       -i number

       --sysid number
               允許你給新使用者使用非預設使用者標識。這個也不是必須的,但是有些人喜歡這樣。

       -N

       --unencrypted
               不對保存在數據庫裏的使用者口令加密。如果沒有聲明, 則使用預設值,

       -P

       --pwprompt
               如果給出,createuser 將發出一個提示符要求輸入新使用者的口令。 如果你不打算用口令認証,那麼這是不必要的。

       -q

       --quiet
               不顯示響應。

        如果沒有在命令行上聲明名稱和其他的一些缺少的信息,稿本會提示你輸入。

       createuser 還接受下列命令行參數用作連接參數:

       -h host

       --host host
               聲明運行伺服器的機器的主機名。 如果數值以斜扛開頭,則它被用做到 Unix 域套接字的路徑。

       -p port

       --port port
               聲明伺服器 正在偵聽的網際網路 TCP 端口號或本地Unix域套接字的檔案擴展(描述符)。

       -U username

       --username username
               連接的使用者名(不是要創建的使用者名)。

       -W

       --password
               強制口令提示(與伺服器連接的口令,不是新使用者的口令。)

ENVIRONMENT 環境
       PGHOST

       PGPORT

       PGUSER
               預設連接參數。

DIAGNOSTICS 診斷
        如果出現錯誤,將會顯示後端錯誤訊息。參閱    CREATE   USER   [create_user(7)]   和   psql(1)
       獲取可能信息描述。數據庫伺服器必須在目標主機上運行。 同樣,任何 libpq 前端庫使用的預設連接設置和環境變量都將適用。

EXAMPLES 例子
        在預設數據庫伺服器上創建一個使用者 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上的伺服器創建使用者 joe,端口是 5000,避免提示並且顯示執行的命令:

       $ createuser -p 5000 -h eden -D -A -e joe
       CREATE USER "joe" NOCREATEDB NOCREATEUSER
       CREATE USER

SEE ALSO 參見
       dropuser(1), CREATE USER [create_user(7)]

譯者
       Postgresql 中文網站 何偉平 <laser@pgsqldb.org>