createdb

Name

createdb --  Postgres データベースの新規作成

Synopsis

createdb [options...] [dbname] [description]

入力

-h, --host host

postmaster が稼働している マシンのホスト名を指定します。ホスト名がスラッシュ (/) で始まる場合、Unix ドメインソケット用のディレクトリ として使われます。

-p, --port port

postmaster が接続要求を監視しているインター ネットの TCP/IP ポートあるいは、ローカルの Unix ドメイン ソケットファイルの拡張子部分を指定します。

-U, --username username

接続をするユーザ名です。

-W, --password

パスワード入力を強制します。

-e, --echo

createdb が作る問い合わせを Echo し、バックエンドに送ります。

-q, --quiet

応答を表示しません。

-D, --location datadir

データベースの代替位置を指定します。initlocation も参照して下さい。

-T, --template template

このデータベースを構築する template データベースを指定します。

-E, --encoding encoding

このデータベースの中で使われる文字エンコードスキームを 指定します。

dbname

作成するデータベースの名前を指定します。その名前は全ての Postgres データベースの中で一意なもの でなければなりません。デフォルトでは現在のシステムユーザと同じ 名前でデータベースを作ります。

description

これにより新規に作成されるデータベースに関連付けされるコメントを指定することができます。

オプション -h-p-U-W そして -e はそのまま psql に渡されます。 オプション -D-T、そして -E は根底にある SQL コマンド CREATE DATABASE のためのオプションに変換 されます。詳細はそちらを見て下さい。

出力

CREATE DATABASE

データベースの作成に成功しました。

createdb: Database creation failed.

データベースの作成に失敗しました。

createdb: Comment creation failed. (Database was created.)

データベースのコメント/説明が作成できませんでした。 データベース自身は既に作られています。後でコメントをつける には SQL コマンド COMMENT ON DATABASE を使うことができます。

エラー条件がある場合、バックエンドメッセージが表示されます。 可能性は CREATE DATABASE psql を見て下さい。

説明

createdb は新しい Postgres データベースを作成します。 このコマンドを実行するユーザはデータベースの所有者になります。

createdbPostgres の対話的ターミナル psql による SQL コマンド CREATE DATABASE を包む shell スクリプトラッパーです。したがって、この方法もしくは別 の方法でデータベースを作成しても何も違いはありません。これはこのス クリプトからpsqlプログラムが参照できなけ ればならないことと、データベースサーバが目的のポートで稼働していな ければならないことを意味しています。また、 psql 及び libpq フロントエンドライブラリで適用され るすべてのデフォルト設定と環境変数が利用可能です。

使用方法

デフォルトデータベースサーバを使ったデータベース demo を作成します。

$ createdb demo
CREATE DATABASE
応答は CREATE DATABASE SQL コマンドを実行したときに得られるものと同じです。

ホスト eden のポート番号 5000 上の postmaster で、基になる 問い合わせを見て LATIN1 エンコードスキーム を使ってデータベース demo を作ります。

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