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

このデータベースを構築するテンプレートデータベースを指定します。

-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 データベースを作成します。 このコマンドを実行するユーザはデータベースの所有者になります。

createdb は Postgres の対話的ターミナル 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