2024年9月26日: PostgreSQL 17 发布!
支持的版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不支持的版本:11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3

CREATE SCHEMA

CREATE SCHEMA — 定义新的模式

概要

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

where role_specification can be:

    user_name
  | CURRENT_ROLE
  | CURRENT_USER
  | SESSION_USER

描述

CREATE SCHEMA 将新的模式添加到当前数据库中。模式名称必须与当前数据库中任何现有模式的名称不同。

模式本质上是一个命名空间:它包含命名对象(表、数据类型、函数和运算符),这些对象的名称可能与其他模式中存在的其他对象的名称重复。命名对象可以通过用模式名称作为前缀来限定其名称来访问,也可以通过设置包含所需模式的搜索路径来访问。CREATE 命令指定一个非限定的对象名称将在当前模式中创建该对象(搜索路径最前面的模式,可以使用 current_schema 函数确定)。

可选地,CREATE SCHEMA 可以包含子命令来在新的模式中创建对象。这些子命令基本上与在创建模式后发出的独立命令相同,只是如果使用了 AUTHORIZATION 子句,所有创建的对象将由该用户拥有。

参数

schema_name

要创建的模式的名称。如果省略,将使用user_name 作为模式名称。名称不能以 pg_ 开头,因为此类名称保留用于系统模式。

user_name

将拥有新模式的用户角色名称。如果省略,默认为执行该命令的用户。要创建由另一个角色拥有的模式,您必须能够对该角色执行 SET ROLE 操作。

schema_element

定义要在模式中创建的对象的 SQL 语句。目前,CREATE TABLECREATE VIEWCREATE INDEXCREATE SEQUENCECREATE TRIGGERGRANT 被接受为 CREATE SCHEMA 中的子句。其他类型的对象可以在模式创建后通过单独的命令创建。

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 SCHEMADROP SCHEMA

提交更正

如果您在文档中看到任何不正确的内容,与您对特定功能的体验不符,或者需要进一步说明,请使用 此表格 报告文档问题。