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

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