★PostgreSQLカンファレンス2024 12月6日開催/チケット販売中★
他のバージョンの文書 16 | 15 | 14 | 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 | 7.2

CREATE DOMAIN

名前

CREATE DOMAIN -- 新しいドメインを定義する

概要

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

constraintは、次のようになります。

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

説明

CREATE DOMAINは新しいデータドメインを作成します。 ドメインとは基本的には、特別な制約(設定可能な値集合に対する制限)を持ったデータ型です。 ドメインを定義したユーザが、その所有者となります。

スキーマ名が付けられている場合(例えば、CREATE DOMAIN myschema.mydomain ...)、ドメインは指定されたスキーマで作成されます。 スキーマ名が付けられていなければ、そのドメインは現在のスキーマで作成されます。 ドメイン名は、そのスキーマ内に存在するデータ型およびドメインの間で、一意である必要があります。

ドメインを使用すると、共通な制約を1箇所にまとめることができ、メンテナンスに便利です。 たとえば、E-mailアドレスを格納する列が複数のテーブルで使用されていて、アドレス構文の検証のためすべてが同一のCHECK制約を必要としているような場合です。 このような場合、各テーブルに個別に制約を設定するよりも、ドメインを定義してください。

ドメインを作成するためには、基となる型に対するUSAGEを持たなければなりません。

パラメータ

name

作成するドメインの名前です(スキーマ修飾名でも可)。

data_type

ドメインの基となるデータ型です。 配列指定子を含めることができます。

collation

省略可能なドメインの照合順です。 照合順序の指定がなければ基となるデータ型のデフォルトの照合順序が使用されます。 COLLATEが指定される場合、基礎となる型は照合順序が設定可能な型でなければなりません。

DEFAULT expression

DEFAULT句を使用すると、ドメインデータ型の列にデフォルト値を指定できます。 任意の無変数式を値とすることができます(ただし、副問い合わせは許可されません)。 デフォルト式のデータ型は、そのドメインのデータ型と一致する必要があります。 デフォルト値が指定されない場合、デフォルト値はNULL値となります。

デフォルト式は、挿入操作において該当する列に値が指定されなかった場合に使用されます。 特定の列に対してデフォルト値が定義された場合、ドメインに関連するデフォルト値は上書きされます。 反対に、基となるデータ型に関連するデフォルト値は、ドメインのデフォルト値によって上書きされます。

CONSTRAINT constraint_name

制約の名前です(省略可能です)。 指定されなければ、システムが名前を生成します。

NOT NULL

このドメインの値としてNULLの使用を通常禁止します。 しかしこの制約を持つドメインでは、例えば左外部結合やINSERT INTO tab (domcol) VALUES ((SELECT domcol FROM tab WHERE false))など、NULLとなるドメイン型と一致するように代入された場合、NULLをとることができます。

NULL

ドメインの値としてNULLの使用を許可します。 こちらがデフォルトです。

この句は非標準的なSQLデータベースとの互換性を持つためだけに用意されています。 新しいアプリケーションでこの句を使用するのはお勧めできません。

CHECK (expression)

CHECK句は、整合性制約やドメインの値が満たさなければならない検査を指定します。 各制約は、Boolean型の結果を生成する式である必要があります。 検査される値を参照するには、VALUEというキーワードを使用すべきです。

現時点では、CHECK式に副問い合わせを含めたり、VALUE以外の変数を参照したりすることはできません。

この例では、us_postal_codeデータ型を作成し、その型をテーブル定義の中で使用します。 データが有効なUS郵便番号であるかどうかを検証するために正規表現検査が使用されます。

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 PRIMARY KEY,
  street1 TEXT NOT NULL,
  street2 TEXT,
  street3 TEXT,
  city TEXT NOT NULL,
  postal us_postal_code NOT NULL
);

互換性

CREATE DOMAINコマンドは標準SQLに準拠しています。

関連項目

ALTER DOMAIN, DROP DOMAIN