概要

CREATE TYPE name AS
( attribute_name data_type [ COLLATE collation ] [, ... ] ] )

CREATE TYPE name AS ENUM 
    ( [ 'label' [, ... ] ] )

CREATE TYPE name AS RANGE (
    SUBTYPE = subtype
    [ , SUBTYPE_OPCLASS = subtype_operator_class ]
    [ , COLLATION = collation ]
    [ , CANONICAL = canonical_function ]
    [ , SUBTYPE_DIFF = subtype_diff_function ]
)

CREATE TYPE name (
    INPUT = input_function,
    OUTPUT = output_function
    [, RECEIVE = receive_function]
    [, SEND = send_function]
    [, TYPMOD_IN = type_modifier_input_function ]
    [, TYPMOD_OUT = type_modifier_output_function ]
    [, INTERNALLENGTH = {internallength | VARIABLE}]
    [, PASSEDBYVALUE]
    [, ALIGNMENT = alignment]
    [, STORAGE = storage]
    [, LIKE = like_type
    [, CATEGORY = category]
    [, PREFERRED = preferred]
    [, DEFAULT = default]
    [, ELEMENT = element]
    [, DELIMITER = delimiter]
    [, COLLATABLE = collatable]
    [, COMPRESSTYPE = compression_type]
    [, COMPRESSLEVEL = compression_level]
    [, BLOCKSIZE = blocksize] )

CREATE TYPE name

描述

CREATE TYPE注册一个新的数据类型以供当前数据库使用。 定义类型的用户将成为其所有者。

如果提供了模式名称，则在指定的模式中创建类型。 否则，它将在当前模式中创建。 类型名称必须不同于同一模式中任何现有类型或域的名称。 类型名称还必须与同一模式中任何现有表的名称都不同。

如上面的语法概要所示，有五种形式的CREATE TYPE。 它们分别创建组合类型，枚举类型，范围类型，基础类型或shell类型。 下面依次讨论其中的前四个。 shell类型只是用于稍后定义的类型的占位符； 它是通过发出CREATE TYPE来创建的，除了类型名称外，不带任何参数。 如这些部分所述，在创建范围类型和基础类型时，需要使用Shell类型作为前向引用。

参数

name

要创建的类型的名称（可以由模式指定）。

attribute_name

复合类型的属性（列）的名称。

data_type

要成为复合类型的列的现有数据类型的名称。

collation

与复合类型的列或范围类型关联的现有排序规则的名称。

label

字符串文字，表示与枚举类型的一个值相关联的文本标签。

subtype

范围类型将代表其范围的元素类型的名称。

subtype_operator_class

子类型的b树运算符类的名称。

canonical_function

范围类型的规范化函数的名称。

subtype_diff_function

子类型的差函数的名称。

input_function

将数据从类型的外部文本形式转换为内部形式的函数的名称。

output_function

将数据从类型的内部形式转换为外部文本形式的函数名。

receive_function

将数据从类型的外部二进制形式转换成内部形式的函数名。

send_function

将数据从类型的内部形式转换为外部二进制形式的函数名。

type_modifier_input_function

将类型的修饰符数组转换为内部形式的函数名。

type_modifier_output_function

将类型的修饰符的内部形式转换为外部文本形式的函数名。

internallength

一个数字常量，指定新类型的内部表示形式的长度（以字节为单位）。 默认假设是可变长度。

alignment

该数据类型的存储对齐需求。 如果被指定，它必须是char、int2、 int4或者double。默认是int4。

storage

该数据类型的存储策略。 必须是plain、external、extended或者main。 默认是plain。

like_type

与新类型具有相同表达的现有数据类型的名称。 会从这个类型中复制internallength、passedbyvalue、 alignment以及storage的值， 除非在这个CREATE TYPE命令的其他地方用显式说明覆盖。

category

此类型的类别代码（单个ASCII字符）。 默认值为'U'，表示用户定义的类型。 您可以在pg_type类别代码中找到其他标准类别代码。 您还可以将未使用的ASCII字符分配给您创建的自定义类别。

preferred

如果此类型是其类型类别中的首选类型，则为true，否则为false。 默认值为false。 在现有类型类别中创建新的首选类型时要小心；这可能会导致令人惊讶的行为更改。

default

数据类型的默认值。如果省略，则默认为null。

element

创建的类型是一个数组；这指定了数组元素的类型。

delimiter

在此类型的数组中的值之间使用定界符。

collatable

如果此类型的操作可以使用排序规则信息，则为true。默认为false。

compression_type

设置为ZLIB（默认值），ZSTD， RLE_TYPE或QUICKLZ¹以指定在此类型的列中使用的压缩类型。

Note: ¹QuickLZ压缩仅在Pivotal Greenplum数据库的商业版本中可用。

compression_level

对于Zstd压缩，将其设置为1（最快压缩）到19（最高压缩率）之间的整数值。 对于zlib压缩，有效范围是1到9。 QuickLZ压缩级别只能设置为1。 对于RLE_TYPE，压缩级别可以设置为从1（最快压缩）到4（最高压缩率）的整数值。 默认压缩级别为1。

blocksize

设置为列中每个块的大小（以字节为单位）。 BLOCKSIZE必须介于8192和2097152字节之间，并且是8192的倍数。 默认块大小为32768。

注解

用户定义的类型名称不能以下划线字符（_）开头，并且只能为62个字符长 （或者通常为NAMEDATALEN - 2，而不是其他名称允许的NAMEDATALEN - 1个字符）。 以下划线开头的类型名称保留给内部创建的数组类型名称。

Greenplum数据库不支持为行或复合类型添加存储选项。

在表级和列级定义的存储选项将覆盖为标量类型定义的默认存储选项。

因为一旦创建数据类型就没有使用限制，所以创建基础类型或范围类型无异于授予对类型定义中提到的函数的公共执行权限。 （因此，类型的创建者必须拥有这些函数。） 对于在类型定义中有用的各种函数而言，这通常不是问题。 但是您在设计一种在将其转换为外部格式或从外部格式转换要求使用“秘密”信息的类型时，可能需要三思而后行。

示例

本示例创建一个复合类型并将其用于函数定义中：

CREATE TYPE compfoo AS (f1 int, f2 text);

CREATE FUNCTION getfoo() RETURNS SETOF compfoo AS $$
    SELECT fooid, fooname FROM foo
$$ LANGUAGE SQL;

本示例创建枚举类型mood，并在表定义中使用它。

CREATE TYPE mood AS ENUM ('sad', 'ok', 'happy');
CREATE TABLE person (
    name text,
    current_mood mood
);
INSERT INTO person VALUES ('Moe', 'happy');
SELECT * FROM person WHERE current_mood = 'happy';
 name | current_mood 
------+--------------
 Moe  | happy
(1 row)

CREATE TYPE float8_range AS RANGE (subtype = float8, subtype_diff = float8mi);

本示例创建基础数据类型box，然后在表定义中使用该类型：

CREATE TYPE box;

CREATE FUNCTION my_box_in_function(cstring) RETURNS box AS 
... ;

CREATE FUNCTION my_box_out_function(box) RETURNS cstring AS 
... ;

CREATE TYPE box (
    INTERNALLENGTH = 16,
    INPUT = my_box_in_function,
    OUTPUT = my_box_out_function
);

CREATE TABLE myboxes (
    id integer,
    description box
);

如果box的内部结构是四个float4元素的数组，则可以改用：

CREATE TYPE box (
    INTERNALLENGTH = 16,
    INPUT = my_box_in_function,
    OUTPUT = my_box_out_function,
    ELEMENT = float4
);

这将允许通过下标访问box值的组件号。 否则，该类型的行为与以前相同。

本示例创建一个大型对象类型，并在表定义中使用它：

CREATE TYPE bigobj (
    INPUT = lo_filein, OUTPUT = lo_fileout,
    INTERNALLENGTH = VARIABLE
);

CREATE TABLE big_objs (
    id integer,
    obj bigobj
    );

兼容性

创建复合类型的CREATE TYPE命令的第一种形式符合SQL标准。 其他形式是Greenplum数据库扩展。 SQL标准中的CREATE TYPE语句还定义了Greenplum数据库中未实现的其他形式。

创建具有零属性的复合类型的能力是Greenplum数据库特定于标准的偏差 （类似于CREATE TABLE中的相同情况）。

另见

ALTER TYPE , CREATE DOMAIN , CREATE FUNCTION , DROP TYPE