他のバージョンの文書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
    [ DEFAULT expression ]
    [ constraint [ ... ] ]

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

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

説明

CREATE DOMAINは新しいデータドメインを作成します。 ドメインを定義したユーザが、その所有者となります。

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

ドメインを使用すると、テーブル間で共通なフィールドを1箇所にまとめることができ、メンテナンスに便利です。 例として、E-mailアドレスを格納する列が複数のテーブルで使用されていて、全て同じプロパティを持っている場合などが考えられます。 このような場合、各テーブルに個別に制約を設定するよりも、ドメインを定義し、ドメインの機能を使用してください。

注意

現時点では、関数の結果の値をドメインとして宣言することは非常に危険です。 結果にドメイン制約を強制する手続き言語は存在しないからです。 関数のコード自体がこの制約を満たしているかどうか確認する必要があります。 PL/pgSQLでは、結果を返す時にその値をそのドメイン型に明示的にキャストするという回避方法を取ることができます。 PL/pgSQLでは、関数内で局所変数にドメイン制約を付けることができません。

パラメータ

name

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

data_type

ドメインの基礎となるデータ型です。 配列指定子が含まれる場合があります。

DEFAULT expression

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

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

CONSTRAINT constraint_name

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

NOT 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 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に準拠しています。

関連項目

ALTER DOMAIN, DROP DOMAIN