Manpages

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 [AT] pgsqldb.org>

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 中 文 man 手 冊 頁 計 劃 : https://github.com/man-pages-zh/manpages-zh