# CREATE SCHEMA ## Name CREATE SCHEMA -- 定义一个新模式 ## Synopsis ``` CREATE SCHEMA _schema_name_ [ AUTHORIZATION _user_name_ ] [ _schema_element_ [ ... ] ] CREATE SCHEMA AUTHORIZATION _user_name_ [ _schema_element_ [ ... ] ] CREATE SCHEMA IF NOT EXISTS _schema_name_ [ AUTHORIZATION _user_name_ ] CREATE SCHEMA IF NOT EXISTS AUTHORIZATION _user_name_ ``` ## 描述 `CREATE SCHEMA`在当前数据库里输入一个新模式。 该模式名将在当前数据库里现存的所有模式名中唯一。 模式实际上是一个名字空间：它包含命名对象(表、数据类型、函数、操作符) 这些名字可以和其它模式里存在的其它对象重名。命名对象要么是通过用模式名作为前缀 "修饰"进行访问，要么是通过设置一个搜索路径包含所需要的模式。 一条带着无修饰对象名的`CREATE`命令都是在当前模式中创建创建对象的 (在搜索路径最前面的模式；可以用`current_schema`函数来判断)。 另外，`CREATE SCHEMA`可以包括在新模式中创建对象的子命令。 这些子命令和那些在创建完模式后发出的命令没有任何区别， 只不过是如果使用了`AUTHORIZATION`子句，那么所有创建的对象都将被该用户拥有。 ## 参数 `_schema_name_` 要创建的模式名字。如果省略，则使用 `_user_name_`作为模式名。 这个名字不能以`pg_`开头，因为这样的名字保留给系统模式使用。 `_user_name_` 将拥有该模式的用户的角色名。如果省略，缺省为执行该命令的用户名。 要想创建一个属于其他角色的模式，你必须是那个角色的直接或非直接成员，或是超级用户。 `_schema_element_` 一个 SQL 语句，定义一个要在模式里创建的对象。目前，只有`CREATE TABLE`、 `CREATE VIEW`、`CREATE INDEX`、`CREATE SEQUENCE`、 `CREATE TRIGGER`和`GRANT`是可以接受的子句。 其它类型的对象可以在创建完模式之后的独立命令里创建。 `IF NOT EXISTS` 如果相同名字的模式已经存在，那么什么也不要做（除了发出一个通知）。 当使用此选项时，不能包括`_schema_element_`子命令。 ## 注意 要创建模式，调用该命令的用户必需在当前数据库上有`CREATE`权限。 （当然，超级用户可以绕开这个检查。） ## 例子 创建一个模式： ``` CREATE SCHEMA myschema; ``` 为用户`joe`创建模式，模式名也叫`joe`： ``` CREATE SCHEMA AUTHORIZATION joe; ``` 创建一个名为`test`的模式，该模式被用户`joe`所拥有， 除非已经有一个名为`test`的模式。 （这与`joe`是否拥有早已存在的模式无关。） ``` CREATE SCHEMA IF NOT EXISTS test AUTHORIZATION joe; ``` 创建一个模式并且在里面创建一个表： ``` CREATE SCHEMA hollywood CREATE TABLE films (title text, release date, awards text[]) CREATE VIEW winners AS SELECT title, release FROM films WHERE awards IS NOT NULL; ``` 请注意上面独立的子命令不是由分号结尾的 下面的命令是实现同样结果的等效语句： ``` CREATE SCHEMA hollywood; CREATE TABLE hollywood.films (title text, release date, awards text[]); CREATE VIEW hollywood.winners AS SELECT title, release FROM hollywood.films WHERE awards IS NOT NULL; ``` ## 兼容性 SQL 标准允许在`CREATE SCHEMA`里面有一个 `DEFAULT CHARACTER SET`子句以及比目前PostgreSQL 可以接受的更多的子命令。 SQL 标准声明在`CREATE SCHEMA`里的子命令可以以任意顺序出现。 目前PostgreSQL里的实现还不能处理所有子命令里前向引用的情况； 有时候可能需要重排一下子命令的顺序以避免前向引用。 在 SQL 标准里，模式的所有者总是拥有其中的所有对象。 PostgreSQL允许模式包含非模式所有者拥有的对象。 只有在模式所有者将自己模式的`CREATE`权限给了其他人， 或者超级用户选择在该模式中创建对象时，才可能出现。 `IF NOT EXISTS`选项是一个PostgreSQL扩展。 ## 又见 [ALTER SCHEMA](#calibre_link-43), [DROP SCHEMA](#calibre_link-44)