Manpages

NAME

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

SYNOPSIS

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

DESCRIPTION 描 述

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

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

OPTIONS 选 项

createdb 接 受 下 列 命 令 行 参 数 ：

库 里 面 是 唯 一 的 。 缺 省 是 与 当 前 系 统 用 户 同 名 。

description 这 个 选 项 声 明 一 个 与 新 创 建 的 数 据 库 相 关 的 注 解 。
-D location
--location location 声 明 变 更 了 的 数 据 库 集 群 （ 节 点 ） 的 位 置 。 又 见 initlocation(1).

-E encoding
--encoding encoding 声 明 用 于 此 数 据 库 的 字 符 编 码 方 式 。
-O owner
--owner owner 指 定 将 拥 有 新 数 据 库 的 数 据 库 用 户 。

--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 进 行 联 接 的 用 户 名 。

--password 强 制 口 令 提 示 符 。

ENVIRONMENT 环 境

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

有 在 命 令 行 上 声 明 数 据 库 名 字 ， 也 没 有 用 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 [AT] pgsqldb.org>

跋

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