Menu

PostgreSQL の CREATE TABLE: 構文と使い方の例

CREATE TABLE はテーブルの列、型、制約を定義します。identity のキー、NOT NULL、DEFAULT、UNIQUE、CHECK、IF NOT EXISTS、CREATE TABLE AS、LIKE を扱います。

このページのコードはエディタで実行できます。編集してすぐに結果を確認できます。

CREATE TABLE name (column type constraints, ...) でテーブルを作ります。各列には名前とデータ型を付け、必要に応じて PRIMARY KEY、NOT NULL、DEFAULT、UNIQUE、CHECK などの制約を加えます。

id 列は自動で採番されます。INSERT で plan を省略すると 'free' が入り、created_at には挿入した時刻が記録されます。よく使う列の型は データ型のページ にまとめています。

列の制約

制約効果
PRIMARY KEY一意で NULL 不可。テーブルに 1 つ
NOT NULL列に値が必須
DEFAULT exprINSERT で列を省略したときに使う値
UNIQUE同じ値を持つ行を許さない (NULL は複数可)
CHECK (expr)式が false になる行を拒否する
REFERENCES t (col)別のテーブルへの外部キー

PostgreSQL 15 からは、UNIQUE NULLS NOT DISTINCT を使うと NULL 同士を等しいとみなすので、その列が NULL の行は 1 行しか入れられません。

複数の列にまたがるルール

複数の列に対する制約は、列の定義のあとに独立した行として書きます。CONSTRAINT name で名前を付けると、エラーメッセージが読みやすくなり、あとで名前を指定して削除できます。

クエリは 3 つの制約を表示します。名前を付けなかった制約には、bookings_guests_check と bookings_pkey という名前が自動で付きます。

テーブルがない場合だけ作る

IF NOT EXISTS を付けると、2 回目の CREATE TABLE はエラーではなく通知になります。確認するのは名前だけです。logs という名前のテーブルが別の列構成ですでにあっても、何も変わりません。

クエリや別のテーブルからテーブルを作る

CREATE TABLE ... AS は SELECT の結果からテーブルを作り、結果の列と型をそのまま使います。LIKE は別のテーブルの定義を行なしでコピーし、INCLUDING ALL を付けるとデフォルト値、制約、identity、インデックスも一緒にコピーします。

big_orders には 1 行あります。orders_archive は orders の列と制約を持ち、行はありません。

生成列

生成列は同じ行のほかの列から計算される列で、INSERT で値を書き込むことはできません。PostgreSQL 17 では STORED にする必要があり、値は書き込み時に計算されてディスクに保存されます。

合計は 13.5 と 20 です。

一時テーブルと UNLOGGED テーブル

CREATE TEMP TABLE は現在のセッションからしか見えないテーブルを作り、セッションが終わると削除されます。長いスクリプトの中間結果を置くのに向いています。CREATE UNLOGGED TABLE は先行書き込みログ (WAL) を使わないので、書き込みが速くなります。ただしクラッシュ後は空になり、レプリカにもコピーされないので、作り直せるデータにだけ使ってください。

CREATE TEMP TABLE import_batch (line text);
CREATE UNLOGGED TABLE page_views_staging (path text, seen_at timestamptz);

作成済みのテーブルを変更するには ALTER TABLE を使います。すべてのオプションは CREATE TABLE のリファレンス に載っています。

よくある質問

PostgreSQL のテーブル名は大文字と小文字を区別しますか?

引用符で囲まない名前は小文字に変換されるので、CREATE TABLE Users は users を作ります。"Users" のように引用符で囲んだ名前は大文字小文字がそのまま残り、以後すべてのクエリで引用符が必要になります。そのため小文字のスネークケースが一般的です。

PostgreSQL でテーブルの構造を確認するには?

psql では \d table_name で列、型、デフォルト値、インデックス、制約が表示されます。SQL からは information_schema.columns WHERE table_name = 'table_name' を検索します。

PostgreSQL でテーブルをコピーするには?

CREATE TABLE copy AS TABLE original; は列と行をコピーしますが、制約とインデックスはコピーしません。CREATE TABLE copy (LIKE original INCLUDING ALL); はデフォルト値、制約、インデックスを含む構造をコピーし、行はコピーしません。

PostgreSQL でテーブルを削除するには?

DROP TABLE table_name; でテーブルとデータを削除します。DROP TABLE IF EXISTS table_name; はテーブルがなくてもエラーになりません。CASCADE を付けると、そのテーブルに依存するビューと外部キーも削除します。

Coddyのプログラミング言語のイラスト

Coddyでコードを学ぼう

始める