文档首页/ 数据仓库服务 GaussDB(DWS)/ SQL语法参考/ SQL语法参考(9.1.0.x)/ DDL语法/ CREATE SCHEMA
更新时间：2024-09-02 GMT+08:00
查看PDF
分享

CREATE SCHEMA

功能描述

创建模式。

访问命名对象时可以使用模式名作为前缀进行访问，如果无模式名前缀，则访问当前模式下的命名对象。创建命名对象时也可用模式名作为前缀修饰。

另外，CREATE SCHEMA可以包括在新模式中创建对象的子命令，这些子命令和那些在创建完模式后发出的命令没有任何区别。如果使用了AUTHORIZATION子句，则所有创建的对象都将被该用户所拥有。

注意事项

  • 只要用户对当前数据库有CREATE权限，就可以创建模式。
  • 系统管理员在普通用户同名Schema下创建的对象，所有者为Schema的同名用户（非系统管理员）。

语法格式

  • 根据指定的名字创建模式： 
    1
2
3
4
    		 
    CREATE SCHEMA schema_name 
    [ AUTHORIZATION user_name ] [ WITH PERM SPACE 'space_limit'] [ schema_element [ ... ] ];
CREATE SCHEMA IF NOT EXISTS schema_name 
    [ AUTHORIZATION user_name ] [ WITH PERM SPACE 'space_limit'] ;
  • 根据用户名创建模式： 
    1
2
    		 
    CREATE SCHEMA AUTHORIZATION user_name [ WITH PERM SPACE 'space_limit'] [ schema_element [ ... ] ];
CREATE SCHEMA IF NOT EXISTS AUTHORIZATION user_name [ WITH PERM SPACE 'space_limit'] ;

参数说明

  • schema_name

    模式名字。

    • 模式名不能和当前数据库里其他的模式重名。
    • 模式的名字不可以“pg_”开头。

    取值范围：字符串，要符合标识符的命名规范。

  • AUTHORIZATION user_name

    指定模式的所有者。当不指定schema_name时，把user_name当作模式名，此时user_name只能是角色名。

    取值范围：已存在的用户名/角色名。

  • WITH PERM SPACE 'space_limit'

    指定模式的永久表存储空间上限。当不指定space_limit时，则不限制。

    取值范围：字符串格式为正整数+单位，单位当前支持K/M/G/T/P。解析后的数值以K为单位，且范围不能够超过64比特表示的有符号整数，即1KB~9007199254740991KB。

  • schema_element

    在模式里创建对象的SQL语句。目前仅支持CREATE TABLE、CREATE VIEW、CREATE INDEX、CREATE PARTITION、GRANT子句。

    子命令所创建的对象都被AUTHORIZATION子句指定的用户所拥有。

  • IF NOT EXISTS

    指定IF NOT EXISTS时，若不存在同名SCHEMA，则可以成功创建SCHEMA。若已存在同名SCHEMA，创建时不会报错，仅会提示该SCHEMA已存在，且不执行任何操作。当使用该参数时，不能包括Schema_element子命令。

    IF NOT EXISTS参数仅9.1.0及以上版本支持。

如果当前搜索路径上的模式中存在同名对象时，需要明确指定引用对象所在的模式。可以通过命令SHOW SEARCH_PATH来查看当前搜索路径上的模式。

示例

创建一个角色role1：

1
 
CREATE ROLE role1 IDENTIFIED BY '{password}';

为用户role1创建一个同名schema，子命令创建的表films和winners的拥有者为role1：

1
2
3
4
 
CREATE SCHEMA AUTHORIZATION role1
     CREATE TABLE films (title text, release date, awards text[])      
     CREATE VIEW winners AS         
     SELECT title, release FROM films WHERE awards IS NOT NULL;

相关链接

ALTER SCHEMA，DROP SCHEMA

父主题： DDL语法