PostgreSQL createdb

PostgreSQL 8.2.3 中文文档
后退	快退		快进	前进

描述

createdb 创建一个新 PostgreSQL 数据库。

通常，执行这个命令的数据库用户将成为新数据库的所有者。不过，如果拥有合适的权限，那么也可以通过 -O 指定其它用户。

createdb 是一个 SQL 命令 CREATE DATABASE 的封装。因此，两种方法创建的数据库都一样。

createdb 接受下列命令行参数：

dbname: 要创建的数据库名。该名称应该在本节点的所有数据库里面必须是唯一的。缺省是与当前系统用户同名。
description: 这个选项声明一个与新创建的数据库相关的注解
-D tablespace --tablespace tablespace: 指定数据库的缺省表空间
-e --echo: 回显 createdb 生成并它发送到服务器的命令。
-E encoding --encoding encoding: 声明此数据库的字符编码。PostgreSQL 服务器支持的字符集在节21.2.1里列出。
-O owner --owner owner: 指定将拥有新数据库的用户
-q --quiet: 不显示响应(安静模式)
-T template --template template: 声明创建此数据库的模板数据库

选项 -D, -E, -O, -T 对应底层 SQL 命令 CREATE DATABASE 的选项，更多信息可以参考该命令的手册页。

createdb 还接受下列命令行参数作为连接参数：

PGDATABASE: 如果设置了，那么就是要创建的数据库名字，除非在命令行上进行了覆盖。
PGHOST PGPORT PGUSER: 缺省连接参数。如果没有在命令行上声明数据库名字，也没有用 PGDATABASE 声明的话，PGUSER 还决定了要创建的数据库名字。

如果出现错误，将会显示后端错误信息。参阅 CREATE DATABASE 和 psql 获取可能信息描述。数据库服务器必须在目标服务器上运行。同样，前端库 libpq 使用的缺省连接设置和环境变量都将适用。

用缺省数据库服务器创建一个 demo 数据库：

$ createdb demo
CREATE DATABASE

应答将会和运行 CREATE DATABASE 命令的结果相同。

在主机 eden 上创建 demo 数据库，端口是 5000 ，使用 LATIN1 编码方式，并且显示执行的命令：

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

后退	首页	前进
clusterdb	上一级	createlang