CREATE SCHEMA

CREATE SCHEMA输入一个新模式到当前数据库中。

简介

CREATE SCHEMA输入一个新模式到当前数据库中。 该模式名必须与当前数据库中任何现有模式的名称不同。

一个模式本质上是一个名字空间:它包含命令对象(表、数据类型、函数以及操作符), 对象可以与在其他模式中存在的对象重名。可以通过用模式名作为一个前缀 “限定”命名对象的名称来访问它们,或者通过把要求的模式包括在搜索路径中来访问命名对象。一个指定非限定对象名的 CREATE命令在当前模式(搜索路径中的第一个模式,由函数 current_schema决定)中创建对象。

CREATE SCHEMA中可以选择包括子命令用以在新模式中创建对象。这些子命令实际被当作独立的在创建该模式后被发出的命令一样,除非使用AUTHORIZATION子句,所有被创建的对象都会由该用户拥有。

语法

    CREATE SCHEMA schema_name [ AUTHORIZATION role_specification ] [ schema_element [ ... ] ]
    CREATE SCHEMA AUTHORIZATION role_specification [ schema_element [ ... ] ]
    CREATE SCHEMA IF NOT EXISTS schema_name [ AUTHORIZATION role_specification ]
    CREATE SCHEMA IF NOT EXISTS AUTHORIZATION role_specification

    其中 role_specification 可以是:

        user_name
      | CURRENT_USER
      | SESSION_USER

参数

  • schema_name要创建的一个模式名。如果省略, user_name将被用作模式名。 该名称不能以pg_开始,因为这样的名称是用作系统模式的。

  • user_name将拥有新模式的用户的角色名。如果省略,默认为执行该命令的用户。要创建由另一个角色拥有的角色,你必须是那个角色的一个直接或者间接成员, 或者是一个超级用户。

  • schema_element要在该模式中创建的对象定义 SQL 语句。当前,只有CREATE TABLECREATE VIEWCREATE INDEXCREATE SEQUENCECREATE TRIGGER以及GRANT被接受为 CREATE SCHEMA中的子句。其他类型的对象可以在模式被创建之后用单独的命令创建。

  • IF NOT EXISTS如果一个具有同名的模式已经存在,则什么也不做(不过发出一个提示)。 使用这个选项时不能包括 schema_element子命令。

说明

要创建一个模式,调用用户必须拥有当前数据库的CREATE 特权(当然,超级用户可以绕过这种检查)。

示例

创建一个模式:

    CREATE SCHEMA myschema;

为用户joe创建一个模式,该模式也将被命名为 joe

    CREATE SCHEMA AUTHORIZATION joe;

创建一个被用户joe拥有的名为test的模式, 除非已经有一个名为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;