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