src/man7/create_type.7

   1 .\" auto-generated by docbook2man-spec $Revision: 1.1 $
   2 .TH "CREATE TYPE" "7" "2003-11-02" "SQL - Language Statements" "SQL Commands"
   3 .SH NAME
   4 CREATE TYPE \- 定义一个新的数据类型
   5
   6 .SH SYNOPSIS
   7 .sp
   8 .nf
   9 CREATE TYPE \fIname\fR AS
  10     ( \fIattribute_name\fR \fIdata_type\fR [, ... ] )
  11
  12 CREATE TYPE \fIname\fR (
  13     INPUT = \fIinput_function\fR,
  14     OUTPUT = \fIoutput_function\fR
  15     [ , RECEIVE = \fIreceive_function\fR ]
  16     [ , SEND = \fIsend_function\fR ]
  17     [ , INTERNALLENGTH = { \fIinternallength\fR | VARIABLE } ]
  18     [ , PASSEDBYVALUE ]
  19     [ , ALIGNMENT = \fIalignment\fR ]
  20     [ , STORAGE = \fIstorage\fR ]
  21     [ , DEFAULT = \fIdefault\fR ]
  22     [ , ELEMENT = \fIelement\fR ]
  23     [ , DELIMITER = \fIdelimiter\fR ]
  24 )
  25 .sp
  26 .fi
  27 .SH "DESCRIPTION 描述"
  28 .PP
  29 \fBCREATE TYPE\fR 为当前数据库注册一个新的数据类型。 定义该类型的用户成为其所有者。
  30 .PP
  31  如果给出模式名，那么该类型是在指定模式中创建。 否则它是在当前模式中创建。类型名必需和同一模式中任何现有的类型或者域不同。 （因为表和数据类型有联系，类型名不能和同模式中的表名字冲突。）
  32 .SS "COMPOSITE TYPES 复合类型"
  33 .PP
  34  第一种形式的 CREATE TYPE 创建一个复合类型。 复合类型是通过一列属性名和数据类型声明的。这样实际上和一个表的行类型一样， 但是如果我们只是想定义一个类型，那么使用 CREATE TYPE 避免了直接创建实际的表。 一个独立的复合类型对于一个函数的返回类型非常有用。
  35 .SS "BASE TYPES 基本类型"
  36 .PP
  37  第二种形式的CREATE TYPE创建一种新的基本类型（标量类型）。 参数可以以任意的顺序出现，而不是上面显示的那样。并且大多数都是可选的。 它要求要在定义类型之前先注册两个函数（用CREATE FUNCTION命令）。 支持函数 input_function 和 output_function 是必须的， 而函数 receive_function 和 send_function 是可选的。 通常，这些函数必须用 C 或者其它低层语言编写。
  38 .PP
  39  函数 input_function  将该类型的外部文本形式转换成可以被对该类型操作的操作符和函数识别的内部形式。 output_function  用做相反用途。 输入函数可以声明为接受一个类型为 c_string 的参数，或者接受三个类型分别为 c_string，oid，integer 的参数。 （第一个参数是 C 字串形式的输入文本，第二个是在该类型为数组类型时其元素的类型， 第三个是目标字段的typmod，如果已知的话。） 它应该返回一个该数据类型本身的数值。 输出函数可以声明为接受一个类型为新数据类型的参数， 或者接受两个类型，第二个参数的类型是 oid。 第二个参数也是用于数组类型的数组元素类型。输出函数应该返回类型 cstring。
  40 .PP
  41  可选的 receive_function 把该类型的外部二进制表现形式转换成内部表现形式。 如果没有提供这个函数，那么该类型不能用二进制输入。二进制格式应该选取那种转换成内部格式比较容易的，同时还有一定移植性的。 （比如，标准的整数数据类型使用网络字节序作为外部的二进制表现形式，而内部表现形式是机器的本机字节序。） 接收函数应该声明为接受一个类型为 internal 的参数，或者两个类型分别为 internal 和 oid 的参数。 它必须返回一个数据类型自身的数值。（第一个参数是一个指向一个 StringInfo 缓冲区的，保存接受字节串的指针； 可选的第二个参数是元素类型——如果类型是一个数组类型的话。）类似的，可选的 send_function  把类型转换为外部二进制表现形式。 如果没有提供这些函数，那么类型就不能用二进制方式输出。发送函数可以声明为接收一个新数据类型， 或者接收两个参数，第二个参数的类型是 oid。第二个参数仍然是用做数组类型的。 发送函数必须返回 bytea。
  42 .PP
  43  这个时候你应该觉得奇怪，就是输入和输出函数怎么可以声明为返回新类型的结果或者是接受新类型的参数， 而且是在新类型创建之前就需要创建它们。 答案是输入函数必须先创建，然后是输出函数，最后是数据类型。 PostgreSQL 将首先把新数据类型的名字看作输入函数的返回类型。 它将创建一个"壳"类型，这个类型只是在 pg_type里面的一个占位符，然后把输入函数定义和这个壳类型连接起来。 类似的是输出函数将连接到（现在已经存在）的壳类型。最后， CREATE TYPE 把这个壳类型替换成完整的类型定义，这样就可以使用新类型了。
  44 .PP
  45  尽管新类型的内部表现形式只有 I/O 函数和其它你创建来使用该类型的函数了解， 但内部表现还是有几个属性必须为 PostgreSQL 声明。 这些中最重要的是 internallength。 基本数据类型可定义成为定长，这时 internallength  是一个正整数，也可以是变长的，通过把 internallength  设置为 VARIABLE 表示。（在内部，这个状态 是通过将typlen设置为 -1 实现的。）所有变长类型的内部形式都必须以一个四字节整数开头，这个整数给出此类型这个数值的全长。
  46 .PP
  47  可选的标记 PASSEDBYVALUE 表明该类型的数值是用值传递的， 而不是用引用。你不能传递那些内部形式大于 Datum （大多数机器上是 4 字节，有些是 8 字节）类型的尺寸的数据类型的值。
  48 .PP
  49 alignment 参数声明该数据类型要求的对齐存储方式。 允许的数值等效于按照 1，2，4，或者 8 字节边界对齐。请注意变长类型必须有至少 4 字节的对齐， 因为它们必须包含一个 int4 作为它们的第一个成份。
  50 .PP
  51 storage 参数允许为变长数据类型选择存储策略。 （定长类型只允许使用 plain）。 plain 声明该数据类型总是用内联的方式而不是压缩的方式存储。 extended 声明系统将首先试图压缩一个长的数据值，然后如果它仍然太长的话就将它的值移出主表的行， 但系统将不会压缩它。 main 允许压缩，但是不赞成把数值移动出主表。 （用这种存储策略的数据项可能仍将移动出主表，如果不能放在一行里的话， 但是它们将比 extended 和 external 项更愿意呆在主表里。）
  52 .PP
  53  如果用户希望字段的数据类型缺省时不是 NULL，而是其它什么东西， 那么你可以声明一个缺省值。 在 DEFAULT 关键字里面声明缺省值。 （这样的缺省可以被附着在特定字段上的明确的 DEFAULT 子句覆盖。）
  54 .PP
  55  要表示一个类型是数组，用 ELEMENT 关键字声明数组元素的类型。 比如，要定义一个 4 字节整数(int4)的数组，声明
  56
  57 ELEMENT = int4
  58
  59 。 有关数组类型的更多细节在下面描述。
  60 .PP
  61  要声明用于这种类型数组的外部形式的数值之间的分隔符，可用 delimiter  声明指定分隔符。缺省的分隔符是逗号（,）。 请注意分隔符是和数组元素类型相关联，而不是数组类型本身。
  62 .SS "ARRAY TYPES 数组类型"
  63 .PP
  64  在创建用户定义数据类型的时候，PostgreSQL  自动创建一个与之关联的数组类型，其名字由该基本类型的名字前缀一个下划线组成。 分析器理解这个命名传统，并且把对类型为 foo[] 的字段的请求转换成对类型为 _foo  的字段的请求。这个隐含创建的数组类型是变长并且使用内建的输入和输出函数 array_in 和 array_out。
  65 .PP
  66  你很可能会问如果系统自动制作正确的数组类型，那为什么有个 ELEMENT选项？使用 ELEMENT 有用的唯一的场合是在你制作的定长类型碰巧在内部是一个一定数目相同事物的数组， 而你又想允许这 N 个事物可以通过脚标直接关联，以及那些你准备把该类型当做整体进行的操作。 比如，类型 name 就允许其构成 char 用这种方法关联。 一个二维的 point 类型也可以允许其两个构成浮点型按照类似 point[0] 和 point[1] 的方法关联。
  67 请注意这个功能只适用与那些内部形式是一个相同的定长域的序列的类型。 一个可以脚标化的变长类型必须有被 array_in 和 array_out 使用的一般化的内部表现形式。 出于历史原因（也就是说，那些明显错误但补救来得太迟的问题），定长数组类型的脚标从零开始，而不是象变长类型那样的从一开始。
  68 .SH "PARAMETERS 参数"
  69 .TP
  70 \fB\fIname\fB\fR
  71  将要创建的类型名（可以有模式修饰）。
  72 .TP
  73 \fB\fIattribute_name\fB\fR
  74  复合类型的一个属性（字段）的名字。
  75 .TP
  76 \fB\fIdata_type\fB\fR
  77  一个要成为一个复合类型的字段的现有数据类型的名字。
  78 .TP
  79 \fB\fIinput_function\fB\fR
  80  一个函数的名称， 将数据从外部类型转换成内部类型。
  81 .TP
  82 \fB\fIoutput_function\fB\fR
  83  一个函数的名称， 将数据从内部格式转换成适于显示的形式。
  84 .TP
  85 \fB\fIreceive_function\fB\fR
  86  把数据从类型的外部二进制形式转换成其内部形式的函数的名字。
  87 .TP
  88 \fB\fIsend_function\fB\fR
  89  把数据从类型的内部形式转换成其外部二进制形式的函数名。
  90 .TP
  91 \fB\fIinternallength\fB\fR
  92  一个数值常量，说明新类型的内部表现形式的长度。缺省的假设是它是变长的。
  93 .TP
  94 \fB\fIalignment\fB\fR
  95  该数据类型的存储对齐要求。如果声明了，必须是 char， int2， int4 或 double； 缺省是 int4。
  96 .TP
  97 \fB\fIstorage\fB\fR
  98  该数据类型的存储策略。如果声明了，必须是 plain，external， extended，或 main； 缺省是 plain。
  99 .TP
 100 \fB\fIdefault\fB\fR
 101  该类型的缺省值。通常是省略它的，所以缺省是 NULL。
 102 .TP
 103 \fB\fIelement\fB\fR
 104  被创建的类型是数组；这个声明数组元素的类型。
 105 .TP
 106 \fB\fIdelimiter\fB\fR
 107  将用做数组的数据元素之间分隔符的字符。
 108 .SH "NOTES 注意"
 109 .PP
 110  用户定义类型名不能以下划线（_） 开头而且只能有 62 个字符长。（或者通常是 NAMEDATALEN-2， 而不是其它名字那样的可以有 NAMEDATALEN-1 个字符）。 以下划线开头的类型名被解析成内部创建的数组类型名。
 111 .PP
 112  在 PostgreSQL 版本 7.3 以前，我们要通过使用占位伪类型 opaque 代替函数的前向引用来避免创建壳类型。 7.3 之前 cstring 参数和结果同样需要声明伪 opaque。 要支持装载旧的转储外那间，CREATE TYPE 将接受那些用 opaque声明的函数， 但是它回发出一条通知并且用正确的类型改变函数的声明。
 113 .SH "EXAMPLES 例子"
 114 .PP
 115  这个例子创建一个复合类型并且在一个函数定义中使用它：
 116 .sp
 117 .nf
 118 CREATE TYPE compfoo AS (f1 int, f2 text);
 119 CREATE FUNCTION getfoo() RETURNS SETOF compfoo AS
 120   'SELECT fooid, fooname FROM foo' LANGUAGE SQL;
 121 .sp
 122 .fi
 123 .PP
 124  这个命令创建box数据类型，并且将这种类型用于一个表定义：
 125 .sp
 126 .nf
 127 CREATE TYPE box (
 128     INTERNALLENGTH = 16,
 129     INPUT = my_box_in_function,
 130     OUTPUT = my_box_out_function
 131 );
 132
 133 CREATE TABLE myboxes (
 134     id integer,
 135     description box
 136 );
 137 .sp
 138 .fi
 139 .PP
 140  如果 box 的内部结构是一个四个 float4 的数组，我们可以说
 141 .sp
 142 .nf
 143 CREATE TYPE box (
 144     INTERNALLENGTH = 16,
 145     INPUT = my_box_in_function,
 146     OUTPUT = my_box_out_function,
 147     ELEMENT = float4
 148 );
 149 .sp
 150 .fi
 151  它允许一个 box 的数值成分成员可以用脚标访问。 否则该类型和前面的行为一样。
 152 .PP
 153  这条命令创建一个大对象类型并将其用于一个表定义：
 154 .sp
 155 .nf
 156 CREATE TYPE bigobj (
 157     INPUT = lo_filein, OUTPUT = lo_fileout,
 158     INTERNALLENGTH = VARIABLE
 159 );
 160 CREATE TABLE big_objs (
 161     id integer,
 162     obj bigobj
 163 );
 164 .sp
 165 .fi
 166 .PP
 167  更多的例子，包括合适的输入和输出函数，在 Chapter 31``Extending SQL'' in the documentation。
 168 .SH "COMPATIBILITY 兼容性"
 169 .PP
 170 \fBCREATE TYPE\fR 命令是 PostgreSQL 扩展。在 SQL99 里有一个 CREATE TYPE 语句，但是细节上和 PostgreSQL 的有比较大区别。
 171 .SH "SEE ALSO 参见"
 172 CREATE FUNCTION [\fBcreate_function\fR(7)], DROP TYPE [\fBdrop_type\fR(l)]
 173 .SH "译者"
 174 .B Postgresql 中文网站
 175 .B 何伟平 <laser@pgsqldb.org>