Man page - createuser(1)

Manual

CREATEUSER

NAME
SYNOPSIS
DESCRIPTION 描 述
OPTIONS 选 项
ENVIRONMENT 环 境
DIAGNOSTICS 诊 断
EXAMPLES 例 子
SEE ALSO 参 见
译 者


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>

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。
中 文 man 手 册 页 计 划 : https://github.com/man-pages-zh/manpages-zh