Man page - createdb(1)

Manual

CREATEDB

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

---

NAME

createdb - 创 建 一 个 新 的 PostgreSQL 数 据 库

SYNOPSIS

createdb [ option ... ] [ dbname ] [ description ]

DESCRIPTION 描 述

createdb 创 建 一 个 新 的 PostgreSQL 数 据 库 。

通 常 ， 执 行 这 个 命 令 的 数 据 库 用 户 成 为 新 数 据 库 的 所 有 者 。 不 过 ， 如 果 执 行 用 户 拥 有 合 适 的 权 限 ， 那 么 他 可 以 通 过 -O 指 定 合 适 的 用 户 。

createdb 是 一 个 SQL 命 令 CREATE DATABASE [ create_database (7)] 的 封 装 。 因 此 ， 用 哪 种 方 法 创 建 数 据 库 都 没 什 么 特 别 的 。

OPTIONS 选 项

createdb 接 受 下 列 命 令 行 参 数 ：

dbname

声 明 要 创 建 的 数 据 库 名 。 该 名 称 应 该 在 本 节 点 的 PostgreSQL 所 有 数 据 库 里 面 是 唯 一 的 。 缺 省 是 与 当 前 系 统 用 户 同 名 。

description

这 个 选 项 声 明 一 个 与 新 创 建 的 数 据 库 相 关 的 注 解 。

-D location
--location location

声 明 变 更 了 的 数 据 库 集 群 （ 节 点 ） 的 位 置 。 又 见 initlocation (1).

	-e
	--echo

回 显 createdb 生 成 的 命 令 并 且 把 它 发 送 到 服 务 器 。

-E encoding
--encoding encoding

声 明 用 于 此 数 据 库 的 字 符 编 码 方 式 。

-O owner
--owner owner

指 定 将 拥 有 新 数 据 库 的 数 据 库 用 户 。

-q

--quiet

不 显 示 响 应 。

-T template
--template template

声 明 创 建 此 数 据 库 的 模 板 数 据 库 。

选 项 -h， -p， -U， -W， -e 是 以 文 本 形 式 传 递 给 psql。 选 项 -O ， -D ， -T 和 -E 转 换 为 下 层 的 SQL 命 令 CREATE DATABASE [ create_database (7)] 的 选 项 ； 参 考 该 条 目 获 取 更 多 相 关 信 息 。

createdb 还 接 受 下 列 命 令 行 参 数 作 为 连 接 参 数 ：
-h host
--host host

声 明 运 行 服 务 器 的 主 机 名 。 如 果 数 值 以 斜 扛 开 头 ， 则 它 被 用 做 到 Unix 域 套 接 字 的 路 径 。

-p port
--port port

声 明 服 务 器 侦 听 的 等 待 连 接 的 互 联 网 TCP 端 口 或 一 个 本 地 Unix 域 套 接 字 文 件 扩 展 （ 描 述 符 ） 。

-U username
--username username

进 行 联 接 的 用 户 名 。

-W

--password

强 制 口 令 提 示 符 。

ENVIRONMENT 环 境

PGDATABASE

如 果 设 置 了 ， 那 么 就 是 要 创 建 的 数 据 库 名 字 ， 除 非 在 命 令 行 上 覆 盖 了 。

	PGHOST
	PGPORT
	PGUSER

缺 省 连 接 参 数 。 PGUSER 还 决 定 了 要 创 建 的 数 据 库 名 字 － － 如 果 我 们 没 有 在 命 令 行 上 声 明 数 据 库 名 字 ， 也 没 有 用 PGDATABASE 声 明 的 话 。

DIAGNOSTICS 诊 断

如 果 出 现 错 误 ， 将 会 显 示 后 端 错 误 信 息 。 参 阅 CREATE DATABASE [ create_database (7)] 和 psql (1) 获 取 可 能 信 息 描 述 。 数 据 库 服 务 器 必 须 在 目 标 服 务 器 上 运 行 。 同 样 ， 前 端 库 libpq 使 用 的 缺 省 连 接 设 置 和 环 境 变 量 都 将 适 用 。

EXAMPLES 例 子

用 缺 省 数 据 库 服 务 器 创 建 一 个 数 据 库 demo：

$ createdb demo
CREATE DATABASE

响 应 信 息 与 运 行 CREATE DATABASE SQL 命 令 时 一 样 。

用 在 主 机 eden上 的 服 务 器 创 建 数 据 库 demo， 端 口 是 5000， 使 用 LATIN1 编 码 方 式 ， 并 且 显 示 执 行 的 命 令 ：

$ createdb -p 5000 -h eden -E LATIN1 -e demo
CREATE DATABASE "demo" WITH ENCODING = ’LATIN1’
CREATE DATABASE

SEE ALSO 参 见

dropdb (1), CREATE DATABASE [ create_database (7)]

译 者

Postgresql 中 文 网 站 何 伟 平 <laser@pgsqldb.org>

跋

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

---