dropdb

Name

dropdb --  既存の Postgres データベースの削除

Synopsis

dropdb [options...] dbname

入力

-h, --host host

postmasterが稼働している マシンのホスト名を指定します。ホストがスラッシュから 始まる場合は、UNIXドメインソケットのディレクトリとして 使用されます。

-p, --port port

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

-U, --username username

接続に使用するユーザ名です。

-W, --password

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

-e, --echo

dropdbが生成し、バックエンドに 送信する問い合わせを表示します。

-q, --quiet

メッセージを表示しません。

-i, --interactive

全ての廃棄作業を行なう前に、確認を促すプロンプトを表示します。

dbname

削除するデータベース名を指定します。このデータベースは そのデータベースインスタンス内に存在する Postgresデータベースの1つで ある必要があります。

-h-p-U-W、及び、 -e オプションは、 psqlにそのまま渡されます。

出力

DROP DATABASE

データベースの削除に成功した場合に表示されます。

dropdb: Database removal failed.

何かが正常に動作しなかった場合に表示されます。

エラー条件があれば、バックエンドのエラーメッセージが表示されます。 この場合に表示されるメッセージについては、 DROP DATABASE、 とpsqlを参照して下さい。

説明

dropdbは既存の Postgresデータベースを削除します。 このコマンドを実行するユーザは、データベーススーパユーザ、 もしくは、そのデータベースの所有者でなければなりません。

dropdbは、Postgres の対話式端末プログラムpsqlを使用して SQLコマンドDROP DATABASEを実行するシェルスクリプトです。 従って、この他の方法を使用して削除する場合とでは何も違いはありません。 このことは、このスクリプトからpsqlが 検索できなければならないことと、対象ホスト上でデータベースサーバが 稼働していなければならないことを意味します。また、 psql及びlibpq フロントエンドライブラリで適用される全てのデフォルト設定と環境変数が利用可能です。

使用方法

下記のコマンドは、デフォルトのデータベースサーバ上のdemo データベースを削除します。

$ dropdb demo
DROP DATABASE

下記のコマンドはホスト名eden 、ポート番号5000で動作している postmasterからdemoデータベースを削除します。 この時、削除の確認、及び、バックエンドに送られる問い合わせ の表示を行うものです。

$ dropdb -p 5000 -h eden -i -e demo
Database "demo" will be permanently deleted.
Are you sure? (y/n) y
DROP DATABASE "demo"
DROP DATABASE