Imported upstream version 1.5
[manpages-zh.git] / src / man7 / create_schema.7
blob35e5e7b8a527b5f016e4c3025bf5a4bbfc92246b
1 .\\" auto-generated by docbook2man-spec $Revision: 1.1 $
2 .TH "CREATE SCHEMA" "7" "2003-11-02" "SQL - Language Statements" "SQL Commands"
3 .SH NAME
4 CREATE SCHEMA \- 定义一个新的模式
6 .SH SYNOPSIS
7 .sp
8 .nf
9 CREATE SCHEMA \fIschemaname\fR [ AUTHORIZATION \fIusername\fR ] [ \fIschema_element\fR [ ... ] ]
10 CREATE SCHEMA AUTHORIZATION \fIusername\fR [ \fIschema_element\fR [ ... ] ]
11 .sp
12 .fi
13 .SH "DESCRIPTION 描述"
14 .PP
15 \fBCREATE SCHEMA\fR 将在当前数据库里输入一个新的模式。 该模式名将在当前数据库里现存的所有模式名中唯一。
16 .PP
17  模式实际上是一个名字空间: 它包含命名对象(表,数据类型,函数和操作符)这些名字可以和其它模式里存在的其它对象重名。 命名对象要么是通过用模式名作为前缀"修饰"这些它们的名字进行访问, 要么是通过设置一个搜索路径包含所需要的模式。 无修饰的对象都是在当前模式中创建的(在搜索路径最前面的;可以用函数 current_schema 来判断)。
18 .PP
19  另外,CREATE SCHEMA 可以包括在新模式中创建对象的子命令。 这些子命令和那些在创建完模式后发出的命令没有任何区别,只不过是如果使用了 AUTHORIZATION 子句, 那么所有创建的对象都将被该用户拥有。
20 .SH "PARAMETERS 参数"
21 .TP
22 \fB\fIschemaname\fB\fR
23  要创建的模式名字。如果省略,则使用用户名作为模式名。
24 .TP
25 \fB\fIusername\fB\fR
26  将拥有该模式的用户名。如果省略,缺省为执行该命令的用户名。 只有超级用户才能创建不属于自己的模式。
27 .TP
28 \fB\fIschema_element\fB\fR
29  一个 SQL 语句,定义一个要在模式里创建的对象。 目前,只有 CREATE TABLE,CREATE VIEW, 和 GRANT 是在 CREATE SCHEMA 里面可以接受的子句。 其它类型的对象可以在创建完模式之后的独立的命令里创建。
30 .SH "NOTES 注意"
31 .PP
32  要创建模式,调用该命令的用户必需在当前数据库上有 CREATE 权限。(当然,超级用户绕开这个检查。)
33 .SH "EXAMPLES 例子"
34 .PP
35  创建一个模式:
36 .sp
37 .nf
38 CREATE SCHEMA myschema;
39 .sp
40 .fi
41 .PP
42  为用户 joe 创建模式 --- 模式也会叫 joe:
43 .sp
44 .nf
45 CREATE SCHEMA AUTHORIZATION joe;
46 .sp
47 .fi
48 .PP
49  创建一个模式并且在里面创建一个表:
50 .sp
51 .nf
52 CREATE SCHEMA hollywood
53     CREATE TABLE films (title text, release date, awards text[])
54     CREATE VIEW winners AS
55         SELECT title, release FROM films WHERE awards IS NOT NULL;
56 .sp
57 .fi
58  请注意上面的独立的子命令不是由分号结尾的。
59 .PP
60  下面的命令是实现同样结果的等效语句:
61 .sp
62 .nf
63 CREATE SCHEMA hollywood;
64 CREATE TABLE hollywood.films (title text, release date, awards text[]);
65 CREATE VIEW hollywood.winners AS
66     SELECT title, release FROM hollywood.films WHERE awards IS NOT NULL;
67 .sp
68 .fi
69 .SH "COMPATIBILITY 兼容性"
70 .PP
71  SQL 标准允许在 CREATE SCHEMA 里面有一个 DEFAULT CHARACTER SET 子句,以及比目前 PostgreSQL 可以接受的更多的子命令。
72 .PP
73  SQL 标准声明在 CREATE SCHEMA 里的子命令可以以任意顺序出现。 目前 PostgreSQL  里的实现还不能处理所有子命令里需要提前引用的情况;有时候可能需要重排一下子命令的顺序以避免前向引用。
74 .PP
75  在 SQL 标准里,模式的所有者总是拥有其中的所有对象。 PostgreSQL 允许模式包含非模式所有者所有的对象。 只有在模式所有者 CREATE 了自己的模式的权限给了其它人才可能出现。
76 .SH "SEE ALSO 参见"
77 ALTER SCHEMA [\fBalter_schema\fR(7)], DROP SCHEMA [\fBdrop_schema\fR(l)]
78 .SH "译者"
79 .B Postgresql 中文网站
80 .B 何伟平 <laser@pgsqldb.org>