CREATE TABLE

説明

CREATE TABLE は新しい、空のテーブルを現在のデータベースに作成します。テーブルはこのコマンドを実行したユーザによって所有されます。

スキーマ名が付けられている場合 (たとえば、CREATE TABLE myschema.mytable ...)、テーブルは指定されたスキーマで作成されます。 スキーマ名がなければ、テーブルは現在のスキーマ (検索パスの前にあるスキーマ。CURRENT_SCHEMA() 参照) で作成されます。 また、TEMP テーブルは特別なスキーマに存在するため、TEMP テーブルの作成時にスキーマ名を与えられない場合もあります。 テーブル名は、同じスキーマ内の他のテーブル、シーケンス、インデックス、もしくはビューとは異なる名前にする必要があります。

CREATE TABLE はまた自動的に、そのテーブルの 1 行に対応するタプル型(構造体型)を表す、データ型を作成します。 したがって、テーブルは、同じスキーマ内の既存のデータ型と同じ名前を持つことができません。

テーブルは 1600 列以上の列を持つことはできません。(実際は、タプル長の制限により実際の制限はもっと低くなります。)

省略可能な制約句は、新しい、または更新された行がその操作を成功させるために満たさなければならない制約(または試験)を指定します。 制約とは名前付きルールであり、テーブルに対する挿入、更新、削除操作の結果に対して制限を持たせることで有効な値集合の定義を補助する SQL オブジェクトです。

制約の定義にはテーブル制約と列制約という 2 つの方法があります。列制約は列定義の一部として定義されます。テーブル制約定義は特定の列には拘束されず、複数の列を含有することができます。また各列制約は、テーブル制約として記述することができます。列制約は、その制約が 1 つの列にのみ影響する場合の、簡便な記述方法にすぎません。

パラメータ

診断

注釈

• アプリケーションがテーブルの特定の行を識別するために OID の使用を行なう場合は、そのテーブルの oid 列に UNIQUE 制約を作成することを推奨します。 これによりカウンタが一周してしまった場合でも一意に行を識別できることが保証されるからです。データベース全体の一意な識別子が必要となる場合、OID がテーブル全体で一意であると仮定することは止めて下さい。 この場合は tableoid と 行の OID の組み合わせを使用して下さい。 (今後の PostgreSQL のリリースでは、各テーブル毎に別々の OID カウンタを使用する予定です。つまり、データベース全体で一意な識別子を得るために tableoid を使用することは、省略できることではなく、必要なことになります。)

  Tip: WITHOUT OIDS の使用は、プライマリキーの無いテーブルでは推奨できません。 OID も一意なデータキーも存在しませんので、特定行の識別を行なうことが難しくなるからです。

• PostgreSQL は自動的に各一意性制約とプライマリキー制約に対してインデックスを作成し、その一意性を確実なものにします。従って、プライマリキーの列に明示的なインデックスを作成することは必要ありません。(より詳細については CREATE INDEX を参照して下さい。)

• SQL92 標準では、CHECK 列制約はそれを適用する列のみを参照でき、CHECK テーブル制約は複数の列を参照できるとしています。PostgreSQL ではこの制限を強制しません。列制約もテーブル制約も同様に扱います。

• 現在の実装では、一意性制約とプライマリキーは継承されません。これは継承と一意性制約の組み合わせはその機能に障害が起こるからです。

例

films テーブルと distributors テーブルを作成します。

CREATE TABLE films (
    code        CHARACTER(5) CONSTRAINT firstkey PRIMARY KEY,
    title       CHARACTER VARYING(40) NOT NULL,
    did         DECIMAL(3) NOT NULL,
    date_prod   DATE,
    kind        CHAR(10),
    len         INTERVAL HOUR TO MINUTE
);

CREATE TABLE distributors (
     did    DECIMAL(3) PRIMARY KEY DEFAULT NEXTVAL('serial'),
     name   VARCHAR(40) NOT NULL CHECK (name <> '')
);

2次元配列をもつテーブルを作成します。

CREATE TABLE array (
    vector  INT[][]
);

films テーブルに 一意性テーブル制約を定義します。一意性テーブル制約はテーブルの 1 つ以上の列に定義することができます。

CREATE TABLE films (
    code        CHAR(5),
    title       VARCHAR(40),
    did         DECIMAL(3),
    date_prod   DATE,
    kind        VARCHAR(10),
    len         INTERVAL HOUR TO MINUTE,
    CONSTRAINT production UNIQUE(date_prod)
);

CHECK 列制約を定義します。

CREATE TABLE distributors (
    did     DECIMAL(3) CHECK (did > 100),
    name    VARCHAR(40)
);

CHECK テーブル制約を定義します。

CREATE TABLE distributors (
    did      DECIMAL(3),
    name    VARCHAR(40)
    CONSTRAINT con1 CHECK (did > 100 AND name <> '')
);

films テーブルにプライマリキーテーブル制約を定義します。プライマリキーテーブル制約はテーブルの 1 つ以上の列に定義することができます。

CREATE TABLE films (
    code        CHAR(5),
    title       VARCHAR(40),
    did      DECIMAL(3),
    date_prod   DATE,
    kind        VARCHAR(10),
    len         INTERVAL HOUR TO MINUTE,
    CONSTRAINT code_title PRIMARY KEY(code,title)
);

distributors テーブルにプライマリキー制約を定義します。以下の 2 つの例は同じものです。 前者はテーブル制約構文を使用し、後者は列制約記法を使用します。

CREATE TABLE distributors (
    did      DECIMAL(3),
    name    CHAR VARYING(40),
    PRIMARY KEY(did)
); 

CREATE TABLE distributors (
    did     DECIMAL(3) PRIMARY KEY,
    name    VARCHAR(40)
);

以下は、name 列のデフォルト値にリテラル定数を割り当て、did 列のデフォルト値をシーケンスオブジェクトの次の値を選択して生成されるように調整しています。modtime のデフォルト値は、その行が挿入された時刻となります。

CREATE TABLE distributors (
    name      VARCHAR(40) DEFAULT 'luso films',
    did       INTEGER DEFAULT NEXTVAL('distributors_serial'),
    modtime   TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

2 つの NOT NULL 列制約を distributors テーブルに定義します。そのうち 1 つは明示的な名前を付けています。

CREATE TABLE distributors (
    did     DECIMAL(3) CONSTRAINT no_null NOT NULL,
    name     VARCHAR(40) NOT NULL
);

name 列に対し、一意性制約を定義します。

CREATE TABLE distributors (
    did      DECIMAL(3),
    name    VARCHAR(40) UNIQUE
);

上のコマンドはテーブル制約として指定した以下のコマンドと等価です。

CREATE TABLE distributors (
    did      DECIMAL(3),
    name     VARCHAR(40),
    UNIQUE(name)
);

互換性

CREATE TABLE は、以下の一覧およびこれまで説明した点を除いて、中級 SQL92 と SQL99 の一部を批准します。

CREATE { GLOBAL | LOCAL } TEMPORARY TABLE table ( ... ) [ ON COMMIT { DELETE | PRESERVE } ROWS ] 

CREATE ASSERTION name CHECK ( condition )

関連項目