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