↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 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
历史版本。 PostgreSQL 8.0 已结束支持。 请参阅 当前版本手册.

CREATE DOMAIN

CREATE DOMAIN — 定义一个新的域

大纲

CREATE DOMAIN name [AS] data_type
    [ DEFAULT expression ]
    [ constraint [ ... ] ]

where constraint is:

[ CONSTRAINT constraint_name ]
{ NOT NULL | NULL | CHECK (expression) }

描述

CREATE DOMAIN创建一种新的数据域。定义域的用户将成为其拥有者。

如果给定了模式名(例如CREATE DOMAIN myschema.mydomain ...),则该域会在指定模式中创建。否则它会在当前模式中创建。域名在其所在模式中的现有类型和域之间必须唯一。

域适合把多个表之间的公共字段抽象到单一位置进行维护。例如,一个电子邮件地址列可能在多个表中使用,并且属性相同。定义一个域并使用它,而不是在每个表上分别设置约束。

参数

name

要创建的域名(可选地带模式限定)。

data_type

该域的底层数据类型。它可以包含数组说明符。

DEFAULT expression

DEFAULT子句为该域数据类型的列指定默认值。该值可以是任意不含变量的表达式(但不允许子查询)。默认表达式的数据类型必须与该域的数据类型匹配。如果未指定默认值,则默认值为空值。

默认表达式会在任何未为该列指定值的插入操作中使用。如果为某个特定列定义了默认值,它就会覆盖与该域关联的任何默认值。反过来,域默认值又会覆盖与底层数据类型关联的任何默认值。

CONSTRAINT constraint_name

约束的可选名称。如果未指定,系统会生成一个名称。

NOT NULL

该域的值不允许为空值。

NULL

该域的值允许为空值。这是默认行为。

该子句仅用于与非标准 SQL 数据库兼容。不鼓励在新应用中使用它。

CHECK (expression)

CHECK子句指定该域的值必须满足的完整性约束或测试。每个约束都必须是一个产生布尔结果的表达式。它应使用名称VALUE来引用被测试的值。

当前,CHECK表达式不能包含子查询,也不能引用 VALUE之外的其他变量。

示例

这个示例创建us_postal_code数据类型,然后在一个表定义中使用该类型。这里使用正则表达式测试来验证该值看起来是否为一个合法的美国邮政编码。

CREATE DOMAIN us_postal_code AS TEXT
CHECK(
   VALUE ~ '^\d{5}$'
OR VALUE ~ '^\d{5}-\d{4}$'
);

CREATE TABLE us_snail_addy (
  address_id SERIAL NOT NULL PRIMARY KEY
, street1 TEXT NOT NULL
, street2 TEXT
, street3 TEXT
, city TEXT NOT NULL
, postal us_postal_code NOT NULL
);

兼容性

命令CREATE DOMAIN符合 SQL 标准。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.